Mercurial > hg > aim92

annotate docs/aimDemonstrations @ 0:5242703e91d3 tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Initial checkin for AIM92 aimR8.2 (last updated May 1997).
author tomwalters
date Fri, 20 May 2011 15:19:45 +0100
parents
children
rev   line source
tomwalters@0 1 aimDemonstrations
tomwalters@0 2
tomwalters@0 3 The following is a list of demonstration scripts available to
tomwalters@0 4 illustrate the operation of AIM and the different auditory
tomwalters@0 5 representations that it produces. The scripts are stored in
tomwalters@0 6 [aimdirectory]/scripts.
tomwalters@0 7
tomwalters@0 8 The syntax for the demos can be obtained by typing
tomwalters@0 9
tomwalters@0 10 > aimdemo_???_??? help
tomwalters@0 11
tomwalters@0 12 where '???_???' is one of the extensions listed below. The simplest
tomwalters@0 13 way to begin is to copy the wave file "cegc" from the waves directory
tomwalters@0 14 to the current working directory, and type
tomwalters@0 15
tomwalters@0 16 > aimdemo_gtf_all cegc
tomwalters@0 17
tomwalters@0 18 NOTE: The byte order for cegc is "little endian" (used by DEC,
tomwalters@0 19 IBM and SGI machines). A byte reversed version with "big-endian"
tomwalters@0 20 order is the wave "cegc_br". (This is the order used in SUN and HP
tomwalters@0 21 machines.)
tomwalters@0 22
tomwalters@0 23 The sound in cegc is a set of stationary and gliding click trains that
tomwalters@0 24 play a lazy major triad (C-E-G) and its octave (C) over 2.1 sec. The
tomwalters@0 25 click train at the start (C) is a particularly useful test and demo
tomwalters@0 26 stimulus.
tomwalters@0 27
tomwalters@0 28 Once one or two of the aimdemos have been shown to work with cegc, you
tomwalters@0 29 should be in a position to try them on your own waves.
tomwalters@0 30
tomwalters@0 31
tomwalters@0 32
tomwalters@0 33 I. The Funcional Version of AIM:
tomwalters@0 34
tomwalters@0 35
tomwalters@0 36 1. aimdemo_gtf_all <wave_file>
tomwalters@0 37
tomwalters@0 38 This script illustrates all stages of the functional version of AIM
tomwalters@0 39 using the "auditory route". It focuses on landscape displays and
tomwalters@0 40 the instructions involved are:
tomwalters@0 41
tomwalters@0 42 genwav (display input waveform),
tomwalters@0 43 genstp (generate stapes velocity),
tomwalters@0 44 genbmm (generate basilar membrane motion),
tomwalters@0 45 gennap (generate neural activity pattern),
tomwalters@0 46 gensai (generate stabilized auditory image) and
tomwalters@0 47 genspl (generate spiral version of auditory image).
tomwalters@0 48
tomwalters@0 49
tomwalters@0 50 2. aimdemo_gtf_sai <wave_file>
tomwalters@0 51
tomwalters@0 52 This script presents the wave in <wave_file> using genwav, and
tomwalters@0 53 then produces its rectangular auditory image using gensai. It is
tomwalters@0 54 the simplest auditory image demo.
tomwalters@0 55
tomwalters@0 56
tomwalters@0 57 3. aimdemo_gtf_spectra <wave_file>
tomwalters@0 58
tomwalters@0 59 This script illustrates the functional version of AIM using the
tomwalters@0 60 "spectral route". It focuses on spactral displays and the
tomwalters@0 61 instructions involved are:
tomwalters@0 62
tomwalters@0 63 genwav (display input waveform),
tomwalters@0 64 genasa (generate auditory spectral analysis), and
tomwalters@0 65 genepn (generate excitation pattern)
tomwalters@0 66
tomwalters@0 67
tomwalters@0 68 4. aimdemo_gtf_2dat <wave_file>
tomwalters@0 69
tomwalters@0 70 The script illustrates 2-dimensional adaptive-thresholding
tomwalters@0 71 (2D-AT) using genwav, genstp, genbmm and finally gennap.
tomwalters@0 72
tomwalters@0 73
tomwalters@0 74
tomwalters@0 75 II. The Physiological Version of AIM:
tomwalters@0 76
tomwalters@0 77
tomwalters@0 78 1. aimdemo_tlf_all <wave_file>
tomwalters@0 79
tomwalters@0 80 This demo script illustrates the entire physiological
tomwalters@0 81 version of AIM using the "auditory route". It uses the
tomwalters@0 82 transmission-line filterbank (option filter=tlf) and the Meddis
tomwalters@0 83 neural transduction module (option transduction=Meddis). The
tomwalters@0 84 instructions involved are:
tomwalters@0 85
tomwalters@0 86 genwav (display input waveform),
tomwalters@0 87 genstp (generate stapes velocity),
tomwalters@0 88 genbmm (generate basilar membrane motion),
tomwalters@0 89 gennap (generate neural activity pattern),
tomwalters@0 90 acgram (generate autocorrelogram).
tomwalters@0 91
tomwalters@0 92
tomwalters@0 93 2. aimdemo_tlf_med <wave_file>
tomwalters@0 94
tomwalters@0 95 The script illustrates the Meddis Haircell module. The AIM
tomwalters@0 96 functions involved are genwav, genbmm and gennap.
tomwalters@0 97
tomwalters@0 98
tomwalters@0 99 3. aimdemo_tlf_spectra <wave_file>
tomwalters@0 100
tomwalters@0 101 This script illustrates the "spectral route" through the
tomwalters@0 102 physiological version of AIM. It focuses on spectral displays and
tomwalters@0 103 the instructions involved are genwav, genasa and genepn.
tomwalters@0 104
tomwalters@0 105
tomwalters@0 106 4. aimdemo_tlf_lowhigh <wave_file>
tomwalters@0 107
tomwalters@0 108 This script illustrates the level dependancies in the physiological
tomwalters@0 109 version of AIM, and its ability to simulate cochlear damage. The
tomwalters@0 110 instructions involved are:
tomwalters@0 111
tomwalters@0 112 genwav [display input wave],
tomwalters@0 113 genbmm [cochlea level = 30dB],
tomwalters@0 114 genbmm [cochlea level = 90dB],
tomwalters@0 115 genbmm [total OHC destruction, cochlea level = 60dB],
tomwalters@0 116 gennap [Normal cochlea + Meddis high spont-rate fibre] and
tomwalters@0 117 genasa [total OHC destruction, with no feedback]
tomwalters@0 118 Note: - very poor frequency resolution.
tomwalters@0 119
tomwalters@0 120
tomwalters@0 121 5. aimdemo_tlf_std <wave_file>
tomwalters@0 122
tomwalters@0 123 The script illustrates the standard level outputs in the physiological
tomwalters@0 124 version of AIM. It shows the simulations of a normal cochlea.
tomwalters@0 125 The AIM functions involved are:
tomwalters@0 126
tomwalters@0 127 genwav [display input wave],
tomwalters@0 128 genbmm [normal cochlea level = 60dB],
tomwalters@0 129 gennap [normal cochlea level = 60dB],
tomwalters@0 130 genasa [norma cochlea, without log compression].
tomwalters@0 131