AMTSTART - Start the Auditory Modeling Toolbox

Usage

amtstart;
amtstart(flags);

amtstart starts the AMT. This command must be run before using any of the function in the AMT.

Requirements to run the AMT

Linear Time Frequency Analysis Toolbox (LTFAT): Download LTFAT from <http://ltfat.sourceforge.net/> and unpack to the prepared directory thirdparty/ltfat. Alternatively, save the LTFAT anywhere and add the root LTFAT (just the root!) path to the search path.
The SOFA API (version >= 1.0): Download the SOFA API from <http://sourceforge.net/projects/sofacoustics> and unpack to the prepared directory thirdparty/SOFA. Alternatively, save the SOFA API anywhere and add the root path of the SOFA API (just the root!) to the search path.
The SFS Toolbox (version >= 1.0). Download from <https://github.com/sfstoolbox/sfs> and unpack to the prepared directory thirdparty/sfs. Alternatively, save the SFS Toolbox anywhere and add the path to the search path.
Python (version >= 2.6 but < 3) with the packages numpy and scipi. On Linux, type sudo apt-get install python-scipy python-numpy. On Windows, intall python from <https://www.python.org/>, add python.exe to the Windows search path, and install the packages separately.
amtmex executed without any errors. See amtmex for compiler requirements.

Note that some models may further require other toolboxes. See the corresponding documentation for more details.

Cache:

AMT uses cache to store precalculated results because some of the AMT functions require large processing time. Depending on the machine and the model, it might take even days. The global cache mode is controlled on start-up of the AMT. To change the global cache mode choose a flags:

`'normal'`	Use cached package as far as possible. This is default. This is kind of demonstration mode and very convenient for fast access of results like plotting figures. This option, however, may by-pass the actual processing and thus does not always test the actual functionality of a model. If the cached package locally not available, downloaded from the internet. If remotely not available, enforce recalculation.
`'cached'`	Enforce to use cached package. If the cached package is locally not available, it will be downloaded from the internet. If it is remotely not available, an error will be thrown.
`'redo'`	Enforce the recalculation of the package. This option actually tests the calculations.
`'localonly'`	Package will be recalculated when locally not available. Do not connect to the internet.

Many AMT functions support the cache mode as input flag in order to overwrite the global cache mode. See amtcache for more details.

Auxiliary data

Most of the models require auxiliary data. The AMT will download these data on-demand. The download URL for the auxiliary data is given by amtauxdataurl. The target directory for the auxiliary data is given by amtauxdatapath. If you want to run the AMT offline, download the auxiliary data first.

Some of the auxiliary data are HRTFs. The AMT will download the HRTFs on-demand. The download URL for the HRTFs is given by SOFAdbURL. The target directory for the HRTFs is given by SOFAdbPath. If you want to run the AMT offline, download the HRTFs first.

Output

The output of the messages to the command line can be controlled by one of the following flags:

`'verbose'`	All output will be displayed. This is default.
`'documentation'`	starts the AMT in the documentation compiling mode. The output of calculation progress will be suppressed.
`'silent'`	All output will be suppressed.