How to install MeloSpySuite (Mac OSX)¶
Simply follow these steps¶
After you downloaded the latest version of the MeloSpySuite (
MeloSpySuite_V_[X.X].zip(here), open the
Finderapplication under Mac OSX (You can start the
Finderapplication for instance by pressing cmd + space on your keyboard to open
Spotlightand then simply type ‘’Finder’’).
Browse to your Download folder (this is usually
Unzip the file
MeloSpySuite_V_[X.X].zipby double-clicking on it. This will create a folder in your Downloads folder.
Feel free to move the MeloSpySuite folder to any other place on your hard drive.
After unzipping, the following folder structure should be found in your installation directory:
../MeloSpySuite_V_[X.X]/ analysis bin config/ feature_definitions melconv melfeature melpat data demo docs/ html scripts/ matlab
analysisfolder is empty and just a suggestion, but is actually used by the demo batches in the
binsubfolder contains the executables of
melconv, i.e., the actual tools included in the MeloSpySuite.
configfolder contains several subfolders for each of the MeloSpySuite tools. Each subfolder contains sample configuration files, which are used by the demos and which can also serve as a starting point for own analyses. Moreover, the
configfolder contains the sub-directory
feature_definitionswith 69 Feature Definition Files that are to be used with melfeature.
datasubfolder contains only two single files:
esac.dbwhich contains the Weimar Jazz Database and a version of the well-known Essen Folk Song Collection. Both files are SQLITE3 databases.
demofolder contains four demo batches, cf. Demo scripts below.
docsfolder contains this documentation for the MeloSpySuite and MeloSpyLib as an offline usable HTML version. Just open the file
htmlfolder in your browser.
scripts/matlabfolder contains a wrapper script for Matlab to read CSV files that are created by
melfeature(and usually can contain various data types of features).
The demo scripts were included to give a first impression about the possibilites of the MeloSpySuite. In order to run the demo scripts, proceed as follows:
Terminalapplication (again, you can use
Spotlightto find it by pressing cmd + space on your keyboard and typing “Terminal”)
Navigate to the folder location of
MeloSpySuite_V_[X.X](most likely here:
/Users/[YourName]/Downloads/MeloSpySuite_V_[X.X]). You only need the commands
pwd(to find out your current location),
cd ..(to move to the parent directory) and
cd [subdirectory]to move to the desired subdirectory.
Once you navigated to the
demosubfolder in the MeloSpySuite folder, you can run
./demo_pattern_search.shto perform some first tasks with the three applications.
If you want also a nifty explanation of this demos, have a look at the melfeature tutorial for the first two demos, tutorial for the other demos will follow soon, in the mean time you migth refer to the corresponding documentation of melconv and melpat.
If you want to be able to call the applications
melconv from arbitrary locations, you need to add the folder
to the PATH (adapt the folder name to your installation if necessary).
When you are in the terminal, call
open -e /Users/[YourName]/.profile to open the
file in the text editor and add the line
export PATH="/Users/[YourName]/Downloads/melospy/MeloSpySuite_V_[X.X]/bin:$PATH" in the end of the file and save it.
Finally, you need to close and restart the terminal application. Now you can call the three applications from all locations.
Have fun with the first release of MeloSpySuite!