Matthias Mauch MIREX Submissions 2010
=====================================

This README file contains instructions to run three different methods:

1) chord estimation with a DBN (doChordID.sh)
2) simple chord estimation (doChordID-simple.sh)
3) structural segmentation (doSegmentation.sh)

Each method is called through the respective bash script.

All methods use Sonic Annotator. A Sonic Annotator binary for 64bit Linux is in this directory. Please contact me (mail@matthiasmauch.net) or Chris Cannam (chris.cannam@eecs.qmul.ac.uk) if you need a different version. 

All methods use just one core, as far as I'm aware. Whatever MATLAB does implicitly I don't know.

Please find more detailed information on the individual methods below.

1. Chord Estimation with a DBN
------------------------------

Example call to the bash shell script "doChordID.sh":

  ./doChordID.sh wavfilelist.txt outputdirectory

This method requires MATLAB.  
This method uses a lot of memory (expected up to 17GB for long songs). 
Expected running time is roughly real-time for most songs +/- 40%.

2. Simple Chord Estimation
---------------------------

Example call to the bash shell script "doChordID-simple.sh":
  
  ./doChordID-simple.sh wavfilelist.txt outputdirectory
  
No special memory requirements.
This method is quite quick, takes roughly a third of the real duration.

3. Structural Segmentation
--------------------------

Example call to the bash shell script "doSegmentation.sh":

  ./doSegmentation.sh wavfilelist.txt outputdirectory

This method requires MATLAB.  
No special memory requirements.
This method is quicker than real-time, takes roughly 70% of the real duration.