tomwalters@0: aimDemonstrations
tomwalters@0: 
tomwalters@0: The following is a list of demonstration scripts available to
tomwalters@0: illustrate the operation of AIM and the different auditory
tomwalters@0: representations that it produces. The scripts are stored in
tomwalters@0: [aimdirectory]/scripts.
tomwalters@0: 
tomwalters@0: The syntax for the demos can be obtained by typing 
tomwalters@0: 
tomwalters@0: > aimdemo_???_??? help 
tomwalters@0: 
tomwalters@0: where '???_???' is one of the extensions listed below.  The simplest
tomwalters@0: way to begin is to copy the wave file "cegc" from the waves directory
tomwalters@0: to the current working directory, and type 
tomwalters@0: 
tomwalters@0: > aimdemo_gtf_all cegc
tomwalters@0: 
tomwalters@0: NOTE: The byte order for cegc is "little endian" (used by DEC,
tomwalters@0: IBM and SGI machines).  A byte reversed version with "big-endian"
tomwalters@0: order is the wave "cegc_br". (This is the order used in SUN and HP
tomwalters@0: machines.)
tomwalters@0: 
tomwalters@0: The sound in cegc is a set of stationary and gliding click trains that
tomwalters@0: play a lazy major triad (C-E-G) and its octave (C) over 2.1 sec.  The
tomwalters@0: click train at the start (C) is a particularly useful test and demo
tomwalters@0: stimulus. 
tomwalters@0: 
tomwalters@0: Once one or two of the aimdemos have been shown to work with cegc, you
tomwalters@0: should be in a position to try them on your own waves.
tomwalters@0: 
tomwalters@0: 
tomwalters@0: 
tomwalters@0: I. The Funcional Version of AIM:
tomwalters@0: 
tomwalters@0: 
tomwalters@0: 1. aimdemo_gtf_all   <wave_file>
tomwalters@0:    
tomwalters@0:    This script illustrates all stages of the functional version of AIM
tomwalters@0:    using the "auditory route". It focuses on landscape displays and
tomwalters@0:    the instructions involved are:
tomwalters@0: 
tomwalters@0: 	       genwav (display input waveform), 
tomwalters@0:                genstp (generate stapes velocity),
tomwalters@0:                genbmm (generate basilar membrane motion),
tomwalters@0:                gennap (generate neural activity pattern),
tomwalters@0:                gensai (generate stabilized auditory image) and
tomwalters@0:                genspl (generate spiral version of auditory image).  
tomwalters@0: 
tomwalters@0: 
tomwalters@0: 2. aimdemo_gtf_sai  <wave_file>
tomwalters@0: 
tomwalters@0:    This script presents the wave in <wave_file> using genwav, and
tomwalters@0:    then produces its rectangular auditory image using gensai. It is
tomwalters@0:    the simplest auditory image demo.
tomwalters@0: 
tomwalters@0: 
tomwalters@0: 3. aimdemo_gtf_spectra   <wave_file>
tomwalters@0:    
tomwalters@0:    This script illustrates the functional version of AIM using the
tomwalters@0:    "spectral route".  It focuses on spactral displays and the
tomwalters@0:    instructions involved are:
tomwalters@0: 
tomwalters@0: 	       genwav (display input waveform), 
tomwalters@0:                genasa (generate auditory spectral analysis), and
tomwalters@0:                genepn (generate excitation pattern)
tomwalters@0: 
tomwalters@0: 
tomwalters@0: 4. aimdemo_gtf_2dat  <wave_file>
tomwalters@0: 
tomwalters@0:    The script illustrates 2-dimensional adaptive-thresholding
tomwalters@0:    (2D-AT) using genwav, genstp, genbmm and finally gennap. 
tomwalters@0: 
tomwalters@0: 
tomwalters@0: 
tomwalters@0: II. The Physiological Version of AIM:
tomwalters@0: 
tomwalters@0: 
tomwalters@0: 1. aimdemo_tlf_all    <wave_file>
tomwalters@0:  
tomwalters@0:    This demo script illustrates the entire physiological
tomwalters@0:    version of AIM using the "auditory route".  It uses the
tomwalters@0:    transmission-line filterbank (option filter=tlf) and the Meddis
tomwalters@0:    neural transduction module (option transduction=Meddis).  The
tomwalters@0:    instructions involved are:
tomwalters@0: 
tomwalters@0:                genwav (display input waveform), 
tomwalters@0:                genstp (generate stapes velocity),
tomwalters@0:                genbmm (generate basilar membrane motion),
tomwalters@0:                gennap (generate neural activity pattern),
tomwalters@0:                acgram (generate autocorrelogram).
tomwalters@0: 
tomwalters@0:    
tomwalters@0: 2. aimdemo_tlf_med  <wave_file>
tomwalters@0: 
tomwalters@0:    The script illustrates the Meddis Haircell module.  The AIM
tomwalters@0:    functions involved are genwav, genbmm and gennap.
tomwalters@0: 
tomwalters@0: 
tomwalters@0: 3. aimdemo_tlf_spectra   <wave_file>
tomwalters@0: 
tomwalters@0:    This script illustrates the "spectral route" through the
tomwalters@0:    physiological version of AIM.  It focuses on spectral displays and
tomwalters@0:    the instructions involved are genwav, genasa and genepn.
tomwalters@0:    
tomwalters@0: 
tomwalters@0: 4. aimdemo_tlf_lowhigh <wave_file>
tomwalters@0: 
tomwalters@0:    This script illustrates the level dependancies in the physiological
tomwalters@0:    version of AIM, and its ability to simulate cochlear damage. The
tomwalters@0:    instructions involved are:
tomwalters@0: 
tomwalters@0:    genwav [display input wave], 
tomwalters@0:    genbmm [cochlea level = 30dB], 
tomwalters@0:    genbmm [cochlea level = 90dB],
tomwalters@0:    genbmm [total OHC destruction, cochlea level = 60dB],
tomwalters@0:    gennap [Normal cochlea + Meddis high spont-rate fibre] and
tomwalters@0:    genasa [total OHC destruction, with no feedback]
tomwalters@0:           Note: - very poor frequency resolution.
tomwalters@0: 
tomwalters@0: 
tomwalters@0: 5. aimdemo_tlf_std  <wave_file>
tomwalters@0: 
tomwalters@0:    The script illustrates the standard level outputs in the physiological
tomwalters@0:    version of AIM.  It shows the simulations of a normal cochlea.
tomwalters@0:    The AIM functions involved are:
tomwalters@0: 
tomwalters@0:    genwav [display input wave],
tomwalters@0:    genbmm [normal cochlea level = 60dB],
tomwalters@0:    gennap [normal cochlea level = 60dB],
tomwalters@0:    genasa [norma cochlea, without log compression].
tomwalters@0: