tomwalters@0: tomwalters@0: tomwalters@0: tomwalters@0: AIM-MAT Readme tomwalters@0: tomwalters@0: tomwalters@0: tomwalters@0: tomwalters@0:

Getting started with AIM-MAT

tomwalters@0:

tomwalters@0:   AIM-MAT v 1.5
tomwalters@0: $Date: 20011-04-06 $
tomwalters@0:

tomwalters@0:

To install AIM-MAT, recursively add the aim-mat, tomwalters@0: tools and demo tomwalters@0: folders to your MATLAB path
To test the installation, run demo_aim2006_gtfb tomwalters@0: from the demo folder, this tomwalters@0: runs the analysis of the four scaled vowel sounds seen in the documentation. tomwalters@0: The script opens six figure windows, one for each stage of the model, and tomwalters@0: plots the output of each stage for the four vowels.
To run AIM with a GUI type aim tomwalters@0: at the prompt

tomwalters@0:

System Requirements

tomwalters@0:

AIM-MAT was developed using MATLAB 7 and above.

tomwalters@0:

The package should work on any platform supporting MATLAB 6.5 or above, with tomwalters@0: the Signal Processing Toolbox installed.

tomwalters@0:

AIM-MAT has been tested while in development on the following platforms:

tomwalters@0:

Windows XP with MATLAB versions 6.5, 7.1, R2006a
Mac OS X (version 10.4 onwards) with MATLAB version 7.1 and R2007b
Ubuntu Linux with MATLAB versions 7.1, R2007b and R2008a

tomwalters@0:

Tips for getting started

tomwalters@0:

If AIM-MAT is started from the command-line with no parameters, a file-open dialogue box will be displayed. Select the .wav or .aiff file you wish to process using this box.
AIM-MAT is a MATLAB implementation of the Auditory Image Model. The buttons tomwalters@0: along the top of the main AIM-MAT window correspond to stages of this model. tomwalters@0: The model runs from left to right across the window. The calculation of any tomwalters@0: section of the model is contingent upon the calculation of the stage before tomwalters@0: it.
To enable any of the buttons at the top of the AIM-MAT window, simply check tomwalters@0: the 'recalculate' checkbox below that button. This will automatically check tomwalters@0: any other parts of the module that need recalculating.
If any section of the model needs calculating, the surround of the button tomwalters@0: for that section will light up blue. If the section tomwalters@0: needs recalculating the button surround will light up red. tomwalters@0: Sections of the model which have been calculated have button surrounds in tomwalters@0: dark green. The section whose output is currently tomwalters@0: displayed has the button surround illumninated in bright tomwalters@0: green.
To get the contents of the AIM-MAT workspace into the MATLAB command line workspace at any point, simply select 'Copy current data to workspace (data)' from the 'Edit' menu.
The plot window will show no activity for the first few frames of the output tomwalters@0: of the SAI module. This is because it takes a finite time for the stabilised tomwalters@0: image to build up. Use the 'Frame #' slider in the bottom left of the GUI tomwalters@0: to move on a few frames and see the image to build up.
The autoscaling function should scale each plot to a reasonable level, however, tomwalters@0: if the activity in the plot window looks to large or too small, you can use tomwalters@0: the 'autoscale' button to re-run the autoscaling, or use the scaling slider tomwalters@0: to choose a suitable scale for the plot.
AIM-MAT plots are just MATLAB figures; they can be manipulated using the tomwalters@0: MATLAB 7 plot tools, or command line functions.
AIM-MAT stores parameters for a processed file in a subdirectory of that tomwalters@0: file's directory, named after the file without the extension. If you wish tomwalters@0: AIM-MAT to start afresh on working on a file, delete this subdirectory.

tomwalters@0: tomwalters@0: