IPEM Toolbox

Description

In one line:

An auditory toolbox for perception-based music analysis.

In short:

Aims

As auditory modeling increases in complexity there is a thorough need for higher-level working tools and companion manuals. The IPEM Toolbox provides foundations and tools for perception-based music analysis within a modern laboratory environment (Matlab).
It departs from sound and takes human perception as the basis for musical feature extraction and higher-level conceptualisation and representation, combining experimental results in sound/music perception and modeling techniques into a powerful paradigm for music research.

The IPEM Toolbox aims at:

  • Providing researchers who work on projects inspired by auditory processing in Matlab with a working tool for music analysis.
  • Offering students an opportunity to become acquainted with auditory processing in Matlab.
  • Helping students to understand the mechanisms involved with the perception of sound.
  • Permit consolidation and improvement by inviting users to evaluate the IPEM Toolbox. We encourage cooperation and solicit feedback.

Content

The IPEM Toolbox consists of a set of Matlab functions for musical auditory modeling which will allow users to incorporate these tools into their own research.
The PDF manual that comes with the IPEM Toolbox documents both the concepts of the implemented models and the usage of the functions.

The IPEM Toolbox is useful to researchers interested in music content analysis and automatic extraction and description of musical features. As already mentioned above, it is our aim to provide functions that allow researchers to deal with different aspects of feature extraction in the field of perception (i.e. of chord and tonality, pitch, sensory dissonance, onset detection, beat and meter extraction, timbre characteristics).

More detailed info:

Introduction to the IPEM Toolbox, M. Leman, M. Lesaffre, K. Tanghe, in: Proceedings of the XIII Meeting of the FWO Research Society on Foundations of Music Research, Ghent, Belgium, March 2, 2001 (PDF)

PowerPoint presentation and examples, 2001 (in Dutch, ZIP)


System requirements

Hardware:

  • same as the hardware requirements for your Matlab version on PC
  • as much memory and processing speed as you can get (128 MB and 500 MHz or more)

Software:

  • same as the software requirements for your Matlab version on PC (only tested on Windows 95/98/NT/2000 though...)
  • Matlab 5.3.1 (R11.1) or Matlab 6.0 (R12) (depending on the release you choose below)
  • Matlab Signal Processing Toolbox

Download

Originally, the IPEM Toolbox was a closed-source package for Matlab 5.3.1 and 6.0 on Windows. The project has now finished, but we kept getting requests from people who wanted to use it on other platforms and Matlab versions, so we finally decided to open up the source code. This way, it will hopefully become possible for these people to change and/or recompile some files to make it work in their setup.
So, now we provide the following releases:

IPEM Toolbox 1.00

This was the original release for Matlab 5.3.1 and 6.0 and was a closed-source release with an installer. You can still download it here.
Important: if you're using the original release for Matlab 6.0, make sure to download an important fix from this page.
Also note that the contact info in this release is not accurate any longer: see below for the correct contact info.

IPEM Toolbox 1.01

This is essentially exactly the same as the original 1.00 version for Matlab 6.0 (including the fix mentioned above), but contains all the sources and was slightly modified to make it suitable for an open source release. The Matlab and C/C++ code is distributed under the GNU General Public License and the manual is distributed under the GNU Free Documentation License.

File Size Description
IPEMToolbox1.01.zip 6.04 MB Contains all source files, for code (Matlab files) and manual (LaTeX and sound files).
IPEMToolbox_AuditoryModel_C_CPP.zip 89 KB Contains source code needed to build the auditory model used by the IPEM Toolbox (for Matlab 5.3.1 and 6.0). Also contains an MSVC++ 6 workspace with two projects for building the dll's on Windows (see the .txt file in IPEMToolbox\Common\PRIVATE in the code tree for more details).
IPEMToolbox_AuditoryModel_C_CPP_linux_OSX.tar.gz 48 KB Modified version of the above code that allows you to compile things on Linux and MacOSX, supplied by Stefan Tomic (thanks!). Please contact Stefan (sttomic[at]ucdavis[dot]edu) for info on this package.

IPEM Toolbox 1.02 (beta) - latest snapshot (20050121)

This is the latest snapshot of the sources that we are using here at IPEM. It contains several new files that have been added in the years after the original release in 2001. The code files should be stable (they have been used internally), but the manual files are not up to date or might reference to functions that are not in the code because they were not stable enough yet to be included. It reflects the current internal state of the toolbox at the mentioned date.
If you make modifications to the source files that you would like to see included in a next release, you should start from here. In between this release and version 1.01, we started using CVS for keeping track of the code and manual files, so all new changes should start from here. In the future, we might provide public access to a CVS repository or move everything over to SourceForge.

File Size Description
IPEMToolbox1.02beta_20050121.zip 18 MB Contains all source files, for code (Matlab files) and manual (LaTeX and sound files). This is a snapshot of our CVS repository taken on January 21st 2005.
IPEMToolbox_AuditoryModel_C_CPP.zip 89 KB (same as for version 1.01)
IPEMToolbox_AuditoryModel_C_CPP_linux_OSX.tar.gz 48 KB (same as for version 1.01)

Note:
As you may have noticed, all open source releases are meant for use with Matlab 6.0. It should still work fine with Matlab 5.3.1 too though, if you make the changes described in the ReadMe.txt file in the IPEMToolbox code tree directory.

IPEM Toolbox auditory model - Port for Linux (Matlab 6,7) and OS X (Matlab 6) - Feb 20 2008

This is the latest version of the IPEM Toolbox auditory model posted by Stefan Tomic.

File Size Description
IPEMToolbox1.02beta_20050121.zip 52 KB Version posted by Stefan Tomic on Feb 20 2008.

Installation instructions

For the original release with the installer

After downloading, unzip to a temporary folder and run Setup.exe.

The created directory structure should look like:

\IPEM
\IPEM\IPEM Toolbox
\IPEM\IPEM Toolbox\IPEMToolbox
\IPEM\IPEM Toolbox\IPEMToolboxManual

If you installed the "Help files", you should have a link to the manual file on your desktop.

If you installed the "Program files", you should now first read the section called "Preparing Matlab for using the IPEM Toolbox" in the "ReadMe.txt" file, located in the installed "IPEMToolbox" folder. The installer has eliminated step 1 for you, so you can start at step 2. The folder you should add to the Matlab search path is the same folder where you found the "ReadMe.txt" file.

For the open source releases

Just unzip the IPEMToolbox......zip file. You will get two subdirectories in your top-level directory: IPEMToolbox (contains the code tree) and Manual (contains the files for the manual). Just follow the steps in the ReadMe.txt file in the IPEMToolbox code tree directory.


Frequently asked questions

You can read the FAQ here.


Update notification list

If you would like to be informed by email about important updates or changes related to the IPEM Toolbox, please subscribe to our IPEM Toolbox update notification list. This is a very low-traffic list, you'll only receive a couple of messages per year (at most).

First name
Last name
Email address

Remarks
This information will only be used internally and will not be given away to instances outside IPEM! Trust us, we hate as much as you do...
If you ever want to be removed from this list, please send an email to with as subject: "remove me from IPEM Toolbox list".


Contact info

The IPEM Toolbox project has ended. We do not officially provide any support at all, however we might do an effort to answer your questions if you ask politely and we find some time ;-)

You can contact us by sending an email to the following email address:

or you can write to the following paper mail address:

IPEM, Ghent University, Blandijnberg 2, 9000 Ghent, Belgium

The "official" link to the IPEM Toolbox website is:

http://www.ipem.ugent.be/Toolbox


Last updated on 20050122
Uses modified counters provided by www.skaro.net