https://github.com/julian-urbano/MelodyShape

 branch: master 

/

 

 authored on 24 Oct 2014

			3 months ago
			a year ago
			3 months ago
			3 months ago
			3 months ago
			3 months ago
			3 months ago
			3 months ago

 README.md

MelodyShape

MelodyShape is an open source Java library and tool to compute the melodic similarity between monophonic music pieces. It implements several algorithms that compute similarity based on the geometric shape that melodies describe in the pitch-time plane.

All these algorithms have obtained the best results in the  Symbolic Melodic Similarity task in 2010, 2011, 2012, 2013 and 2014 editions, as well as the best results reported for the 2005 collection.

MelodyShape can be run both as a graphical user interface and as a command line tool:

$ java -jar melodyshape-1.2.jarusage: melodyshape-1.2 -q 
     
       -c 
      
        -a 
       
         [-k 
        
         ] [-l] [-t 
         
          ] [-v] [-vv] [-gui] [-h]-q 
          
            path to the query melody or melodies.-c 
           
             path to the collection of documents.-a 
            
              algorithm to run: - 2010-domain, 2010-pitchderiv, 2010-shape - 2011-shape, 2011-pitch, 2011-time - 2012-shapeh, 2012-shapel, 2012-shapeg, 2012-time, 2012-shapetime - 2013-shapeh, 2013-time, 2013-shapetime - 2014-shapeh, 2014-time, 2014-shapetime-k 
             
               number of documents to retrieve.-l show results in a single line (omits similarity scores).-t 
              
                run a fixed number of threads.-v verbose, to stderr.-vv verbose a lot, to stderr.-gui run with graphical user interface.-h show this help message.MelodyShape 1.2 Copyright (C) 2014 Julian Urbano 
               
                This program comes with ABSOLUTELY NO WARRANTY.This is free software, and you are welcome to redistribute itunder the terms of the GNU General Public License version 3.
               
              
             
            
           
          
         
        
       
      
     

A detailed user manual in PDF is available from the .

Dependencies

• The MelodyShape library uses the  from Apache Commons.
• The command line tool uses the  from Apache Commons.

Current Version

The current version is , and it is compiled for Java 7. It can be redistributed and/or modified under the terms of the GNU General Public License version 3. Javadoc documentation and a user manual are available as well.