updated README

README.md

-# Name: onsets_ISMIR2012_paper
+# Onset dataset
 
-## Contact: Sebastian Böck <sebastian.boeck@jku.at>
+This dataset is described in [1][1].
 
-## Description: collection of 321 audio excerpts with onset annotations
+## Contact:
 
-## Creator: Sebastian Böck and others
+Sebastian Böck <sebastian.boeck@jku.at>
 
-## Reference: Boeck_ISMIR_2012.pdf
+## Description:
 
------
+Collection of 321 audio excerpts with onset annotations.
 
-### Content:
+## Content:
+
+```
 audio/                  original audio files converted to .flac format
 annotations/onsets/     onset annotations
 annotations/giantsteps/ annotations in the GiantSteps project format
 annotations/.git/       git repo with annotations 
 splits/                 file splitting definitions
-
------
+```
 
 To convert the audio files to .wav use 'flac -d *.flac'
 
 If you use this dataset for comparison of the results, please cite the above
-paper. The same dataset is also used in the DAFx-13 and various other papers.
+paper. The same dataset is also used in [2]_ and various other papers.
 
-ah_* taken from the data set introduced by Andre Holzapfel in:
+- ah_* taken from the data set introduced by Andre Holzapfel in:
   Three dimensions of pitched instrument onset detection.
   A. Holzapfel, Y. Stylianou, A.C. Gedik, and B. Bozkurt.
   IEEE Transactions on Audio, Speech, and Language Processing, 18(6), 2010
 
-al_* taken from the data set introduced by Alexandre Lacoste in:
+- al_* taken from the data set introduced by Alexandre Lacoste in:
   A supervised classification algorithm for note onset detection.
   A. Lacoste, and D. Eck.
   EURASIP Journal on Applied Signal Processing, 1, 2007.
@@ -38,51 +39,60 @@ al_* taken from the data set introduced by Alexandre Lacoste in:
   The audio files are taken from the ISMIR 2004 ballroom data set located
   at: <http://mtg.upf.edu/ismir2004/contest/tempoContest/node5.html>.
 
-api_*
+- api_*
   files / annotations by Antonio Pertusa Ibáñez
   http://grfia.dlsi.ua.es/cm/worklines/pertusa/onset/ODB/
 
-ff123_*
+- ff123_*
   samples for testing audio codecs
   retrieved from http://ff123.net/samples.html
 
-gs_*
+- gs_*
   files by Georgios Siamantas
 
-jpb_* taken from the data set introduced by Juan Pablo Bello in:
+- jpb_* taken from the data set introduced by Juan Pablo Bello in:
   A tutorial on onset detection in music signals.
   J. Bello, L. Daudet, S. Abdallah, C. Duxbury, M. Davies, and M. Sandler.
   IEEE Transactions on Speech and Audio Processing, 13(5), 2005
 
-lame_*
+- lame_*
   files used by the lame dev crew to test the lame mp3 encoder
   retrieved from http://lame.sourceforge.net/quality.php
 
-mck_*
+- mck_*
   public part of Martin McKinney's beat/tempo set
   retrieved from:
   http://www.music-ir.org/mirex/wiki/2006:Audio_Tempo_Extraction
 
-mit_*
+- mit_*
   files taken from the MIT media lab
   retrieved from http://sound.media.mit.edu/media.php
 
-sb_* taken from the data set introduced by Sebastian Böck in:
+- sb_* taken from the data set introduced by Sebastian Böck in:
   Universal Onset Detection with Bidirectional Long Short-Term Memory Neural
   Networks.
   F. Eyben, S. Böck, B. Schuller, and A. Graves.
   Proceedings of the 11th International Society for Music Information Retrieval
   Conference (ISMIR), 2010.
 
-SoundCheck2_*
+- SoundCheck2_*
   files taken from the Alan Parson Sound Check 2 audio test CD
 
-vorbis_*
+- vorbis_*
   files used for a OGG Vorbis listening test
   retrieved from http://hem.passagen.se/ingets1/vorbis.htm
 
-The origin of the violin sample is unknown.
+- The origin of the violin sample is unknown.
+
+References
+==========
 
-If you find this dataset useful, think about donating beer to the contact
-person :)
+[1]: Sebastian Böck, Florian Krebs and Markus Schedl,
+    *Evaluating the Online Capabilities of Onset Detection Methods*,
+    Proceedings of the 13th International Society for Music Information
+    Retrieval Conference (ISMIR), 2012.
 
+[2]: Sebastian Böck and Gerhard Widmer,
+    *Maximum Filter Vibrato Suppression for Onset Detection*,
+    Proceedings of the 16th International Conference on Digital Audio Effects
+    (DAFx), 2013.