Installation guideΒΆ

To install the Two!Ears Auditory Model download version 1.0.1, unzip it, and store it somewhere on your PC. The download includes only the files needed to run it in Matlab. Additional files such as HRTF data will be downloaded later by the model on-the-fly if needed.

We have tested the software with Matlab versions from 2012b to 2015a. 2015b is not working at the moment due to the removal of wavwrite. A HOTFIX has been found and will be part of the next release. You will also need the Signal Processing toolbox. Currently the Statistics toolbox is also required for some plotting functions, but we expect to remove this dependency in a future release.

When stored on your PC, you should add the main folder to your Matlab path and then run the startTwoEars function, which will add the necessary sub-folders. From within the main folder do the following:

>> addpath(pwd)
>> startTwoEars

When you are planning to use the Binaural simulator module you have to prepare the following things:

  • Linux/Mac: install the packages make, g++ (at least version 4.7.3), libsndfile1-dev, libxml2-dev, libfftw3-dev
  • Windows: add TwoEarsDir\BinauralSimulator\src\mex\dll folder to PATH environment variable (HOWTO). We have experienced some issues regarding the precompiled *.mex binaries for Windows on some machines. If you get error messages related to the *.mex files, please remove the directory of your PATH again and try to compile the mex binaries by yourself. A tutorial for this is given in Windows 7 64bit.

Finally, in order to use the location knowledge source LocationKS(), you need to download GMTK binaries for your operating system:

  • Linux: download GMTK for Linux and put the unzipped binaries in /usr/local/bin
  • Mac: download GMTK for MacOS X and put the unzipped binaries in /usr/local/bin
  • Windows: you need to use Cygwin. During the Cygwin installation in the Select Packages dialogue, select the gcc-core package as this has to be installed as well. Afterwards download GMTK for Cygwin and put the unzipped binaries in c:\cygwin64\usr\local\bin. Be sure to use c:\cygwin64\usr\local\bin as our GMTK-Matlab function gmtkEngine.m will only look there.

To test if GMTK works for you, open a shell and do the following:

$ /usr/local/bin/gmtkTriangulate -version

In most the cases the GMTK binaries provided should work for you. If you have any trouble, try compiling GMTK from source code:

  1. Download the latest GMTK source code
  2. Unpack the source code package and switch to the extracted directory
  3. Compile the GMTK binaries in a shell as follows:
$ ./configure && make && make install

Now everything is setup and you can use the model. We suggest that you start by trying one of the examples provided:

>> cd Examples/localisation_w_and_wo_head_movements
>> localise;