changeset 3:08509620ebcf

updated readme
author Maria Panteli
date Mon, 01 Aug 2016 21:31:57 -0400
parents 6786a861575f
children 51db426e413e
files README.md README.rtf
diffstat 2 files changed, 20 insertions(+), 28 deletions(-) [+]
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README.md	Mon Aug 01 21:31:57 2016 -0400
@@ -0,0 +1,20 @@
+Scripts to assess invariance of rhythmic and melodic descriptors as described in [1]. This code extracts rhythmic and melodic audio features for a dataset of synthesised rhythms and melodies. It assesses the invariance of the features to transformations of the timbre, recording quality, tempo and pitch via a classification and retrieval experiment. 
+You can download the dataset of synthesised rhythms and melodies from [2]. 
+If you use this software or dataset for research please cite [1]. 
+
+For any questions please contact m.x.panteli{at}gmail.com.
+This code is licensed under the terms of the MIT License. 
+Copyright (c) 2016 Maria Panteli.
+
+Usage: 
+1) extract_features.py: Extracts the scale transform rhythmic descriptor and pitch bihistogram melodic descriptor for audio recordings located in audio/rhythms and audio/melodies. Requires the dataset to be downloaded in directory ‘audio’.
+
+2) evaluate.py: Assesses the performance of each descriptor with respect to the different transformations and transformation values by a classification and retrieval experiment. The classification experiment runs a 5-fold cross-validation on the dataset with 30 rhythm/melody classes and 100 instances each. The retrieval experiment queries one instance from each rhythm/melody class and assesses the recall rate in the top 99 positions. 
+
+3) results.py: Prints results from the classification and retrieval experiments to Latex tables and assesses the effect of music style and monophonic versus polyphonic character via box plots and paired t-tests. 
+
+
+[1] M. Panteli and S. Dixon. On the Evaluation of Rhythmic and Melodic Descriptors for Music Similarity. In Proceedings of the 17th International Society for Music Information Retrieval Conference, pages 468-474, 2016.
+
+[2] Rhythms - https://archive.org/details/panteli_maria_rhythm_dataset  
+     Melodies - https://archive.org/details/panteli_maria_melody_dataset
--- a/README.rtf	Mon Aug 01 21:11:34 2016 -0400
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,28 +0,0 @@
-{\rtf1\ansi\ansicpg1252\cocoartf1348\cocoasubrtf170
-{\fonttbl\f0\fswiss\fcharset0 Helvetica;}
-{\colortbl;\red255\green255\blue255;}
-\paperw11900\paperh16840\margl1440\margr1440\vieww15240\viewh8400\viewkind0
-\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural
-
-\f0\fs24 \cf0 Scripts to assess invariance of rhythmic and melodic descriptors as described in [1]. This code extracts rhythmic and melodic audio features for a dataset of synthesised rhythms and melodies. It assesses the invariance of the features to transformations of the timbre, recording quality, tempo and pitch via a classification and retrieval experiment. \
-You can download the dataset of synthesised rhythms and melodies from [2]. \
-If you use this software or dataset for research please cite [1]. \
-\
-For any questions please contact m.x.panteli\{at\}gmail.com.\
-This code is licensed under the terms of the MIT License. \
-Copyright (c) 2016 Maria Panteli.\
-\
-Usage: \
-1) extract_features.py: Extracts the scale transform rhythmic descriptor and pitch bihistogram melodic descriptor for audio recordings located in audio/rhythms and audio/melodies. Requires the dataset to be downloaded in directory \'91audio\'92.\
-\
-2) evaluate.py: Assesses the performance of each descriptor with respect to the different transformations and transformation values by a classification and retrieval experiment. The classification experiment runs a 5-fold cross-validation on the dataset with 30 rhythm/melody classes and 100 instances each. The retrieval experiment queries one instance from each rhythm/melody class and assesses the recall rate in the top 99 positions. \
-\
-3) results.py: Prints results from the classification and retrieval experiments to Latex tables and assesses the effect of music style and monophonic versus polyphonic character via box plots and paired t-tests. \
-\
-\
-[1] M. Panteli and S. Dixon. On the Evaluation of Rhythmic and Melodic Descriptors for Music Similarity. In 
-\i Proceedings of the 17th International Society for Music Information Retrieval Conference
-\i0 , pages 468-474, 2016.\
-\
-[2] Rhythms - {\field{\*\fldinst{HYPERLINK "https://archive.org/details/panteli_maria_hotmail_rhythm"}}{\fldrslt https://archive.org/details/panteli_maria_rhythm_dataset}}  \
-     Melodies - {\field{\*\fldinst{HYPERLINK "https://archive.org/details/panteli_maria_hotmail_melody"}}{\fldrslt https://archive.org/details/panteli_maria_melody_dataset}}}
\ No newline at end of file