Problem
Error while executing functions using ANI calculation (a.o. IPEMCalcANI and IPEMCalcANIFromFile) on WinNT or Win2000.

Explanation
The auditory model needs to write intermediate results to files on the hard disk, which are deleted afterwards. The directory where these temporary files are stored is IPEMToolbox\Temp.
If you don't have write permission to this directory, functions that calculate an auditory nerve image (ANI) will fail.

Solution
Make sure you have permission to write to the IPEMToolbox\Temp directory and that there is enough space left on the disk containing this directory.
We might think of changing this to the Windows' Temp directory in future versions, or give the user the option to select a Temp directory him/herself.

Problem
Installation problems

Explanation
Matlab works with paths: these are directory paths that Matlab will search when you enter the name of a function. The IPEM Toolbox contains several such directories that should be added to Matlab's search path in order to work properly. Make sure to extract the .zip file so that the directory structure on your hard disk is the same as the one in the .zip file (if you use WinZip, check the "Use folder names" checkbox upon unzipping).
You only need to add the IPEMToolbox root directory manually to Matlab's search path, the other directories will be added automatically when you type IPEMSetup at the Matlab command prompt.

Solution
Read the section "Preparing Matlab for using the IPEM Toolbox" (and the other sections) in the file ReadMe.txt in the root of the IPEMToolbox directory.

Problem
Errors when executing a function of the IPEM Toolbox.

Explanation
Each function must have a certain number of input (and output) arguments.
Sometimes a specific type of argument is expected.

Solution
Type help IPEMFunction (where IPEMFunction is the name of the function you're calling) at the Matlab command prompt to get an explanation about what a function does and how you should use it.

Problem
Error: Data compression format (Microsoft ADPCM) is not supported.

Explanation
Currently, Matlab only supports Microsoft PCM data format.
The sound file you're trying to read is saved in an other format.
See also: help wavread

Solution
Save your sound file in the Microsoft ADPCM data format.

Problem
Cannot find...
Cannot open...

Explanation
May occur when you specified an invalid directory path.
Paths are strings, so they must be written between single quotes.
Make sure you specify a complete path if that is stated in the documentation of the function you're using (a complete path includes a drive letter). Most functions use your standard input directory as base directory if you don't specify a path for your file.
For functions that read sound files you can specify a path to the sound file. If the path is not given, the default IPEMRootDir('input')\Sounds is used. So, if you don't specify the path to the sound file, your sound files should be located in the Sounds subdirectory of your default input directory IPEMRootDir('input').
Again, check the usage of the function you're calling to be sure you're using it in the right way.

Solution
Make sure the file exists and the path you specified is valid.

Problem
Errors like: "DLL load failed for mex file .....dll. A device attached to the system is not functioning. ??? Invalid MEX-file" whenever a function from the IPEM Toolbox is used.

Explanation
There are two versions of the IPEM Toolbox: one for Matlab 5.3.1 and one for Matlab 6.0.
All (or better: most of) the functions in the IPEM Toolbox have been compiled to mex files, and mex files for Matlab 5.3.1 and Matlab 6.0 are not compatible (nothing to do about that: it's Matlab's policy).
You are probably using the wrong version of the IPEM Toolbox with your version of Matlab.
We have also heard that there are problems of this kind when trying to run the 6.0 version of the IPEM Toolbox with a Matlab version higher than 6.0. Again, this is due to incompatibilities between mex file compilation for Matlab 6.0 and for higher versions (seems like backwards mex file compatibility is not of primary concern to the Mathworks...) If we find some time to fix this, it will certainly be done. In the meantime, the only option is to use either Matlab 5.3.1 or 6.0 with the appropriate IPEM Toolbox version.

Solution
Download the appropriate version of the IPEM Toolbox for your Matlab version, or if you already did, make sure the Matlab version you're using is either 5.3.1 or 6.0.

Problem
The results returned by IPEMPeriodicityPitch are incorrect when using IPEM Toolbox version 1.00 (20010228) for Matlab 6.0.

Explanation
Due to a compatibility problem with the xcorr function between Matlab 5.3.1 and Matlab 6.0, results for the above mentioned release version will be incorrect...

Solution
You can find an updated file if you follow the link in the "Where can I get it ?" section on the IPEM Toolbox web page (FIX20011205). Only for use with the Matlab 6.0 version !

Problem
I don't have Matlab version 5.3.1 or 6.0 or Windows but would still like to use the IPEM Toolbox...

Solution
In January 2005, the IPEM Toolbox was released as an open source distribution. Please try and see if you can get it to work with your Matlab version and operating system. The IPEM Toolbox project has ended now and 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 ;-)