previous next Up Title Contents

BasilarM_GammaT: Linear BM


File name
MoBMGammaT.[ch]


Description
Simple, linear gamma tone filter basilar membrane model.


Example parameter file format
4	Order for the gamma tone filters - basilar membrane model.
single	Centre frequency mode for filter.
1000.0	Initial centre frequency of gamma-tone filter bank.
ERB	Band width (3 dB down) mode for filters.



Test program directory
Tests/Models/Basilar_M, Tests/SSPrograms

Generic Module Routines

This module has the standard Generic Module Routines (see Basic Module Routines used in Generic Programming, page 52).

The RunModel_BasilarM_GammaT(...) Process Routine

Syntax
BOOLN RunModel_BasilarM_GammaT(EarObjectPtr data);


Returns
TRUE if the process is successful, otherwise it returns FALSE.

The RunModel_BasilarM_GammaT(...) Process Routine

Syntax
BOOLN _BasilarM_GammaT(EarObjectPtr data);


Returns
TRUE if the process is successful, otherwise it returns FALSE.

The GetCFList_BasilarM_GammaT(...) Routine

Syntax
CFListPtr GetCFList_BasilarM_GammaT(void);


Special Values
(The CFList structure is controlled by the UtCFList module routinessee 0 Using the Basilar Membrane Filter Modules.


Returns
Pointer to the modules CFList structure.

The SetBandwidths_BasilarM_GammaT(...) Routine

Syntax
BOOLN SetBandwidths_BasilarM_GammaT(char *theBandwidthMode, double *theBandWidths);


Special Values
(The bandwidth mode is controlled by the UtBandwidth module routines).


Returns
TRUE if the function is successful, otherwise it returns FALSE.

The SetCFList_BasilarM_GammaT(...) Routine

Syntax
BOOLN SetCFList_BasilarM_GammaT(CFListPtr *theCFList);


Special Values
(The CFList structure is controlled by the UtCFList module routinessee 0 Using the Basilar Membrane Filter Modules.


Returns
TRUE if the function is successful, otherwise it returns FALSE.

The SetOrder_BasilarM_GammaT(...) Routine

Syntax
BOOLN SetOrder_BasilarM_GammaT(double theOrder);


Returns
TRUE if the function is successful, otherwise it returns FALSE.

The SetPars_BasilarM_GammaT(...) Routine

Syntax
BOOLN SetPars_BasilarM_GammaT(int theOrder, CFListPtr theCFs);


Returns
TRUE if the function is successful, otherwise it returns FALSE.

Example: Tests/SSPrograms/FilterShape.c

Parameter file:FilterShape.par:
#
# Main Parameter file
#

output.dat		Name of output file.

# Module specifications.

#Par. file				Name					Description
#---------				-----					-------------
ParFiles/St/PTone3.par		PureTone				Stimulus generation.
SimSpecs/BM/GTInt.sim		Utility_SimulationSpec	Simulation spec.

# Miscellaneous parameters

100.0		Lowest frequency for pure tone probe stimulus (Hz).
3000.0		Highest frequency for pure tone probe stimulus (Hz).
40			No. of frequencies within range (logarithmic).
2.5e-3		Ramp up rise time for signal (s).
Output

Figure [84] Filter function at CF = 1 kHz for the Gammatone BM model.

Example: Tests/SSPrograms/TuningCurve.c

Parameter file:TuningCurve.par:
#
# Main Parameter file
#
output.dat	Name of output file.

#
# Module specifications.
#
#Par. file				Name					Description
#---------				-----					-------------
ParFiles/St/PTone3.par		PureTone				Stimulus generation.
SimSpecs/BM/GTInt.sim		Utility_SimulationSpec	Simulation spec.

# Miscellaneous parameters

100.0	Lowest test centre frequency (Hz).
10000.0	Highest test centre frequency (Hz).
40		The no. of channels within the frequency range.
5000.0	Minimum frequency for sampling interval setting (Hz).
2.5e-3	Ramp up rise time for signal (s).
0		Conversion mode (0 = unity mode, 1 = (mm/s?), 2 = (nm?).
0		Target threshold (?).
0.1	Target accuracy (?).
0.009	Conversion scale factor (? - not used with unity mode).
Output

Figure [85] Tuning Curve at CF = 1 kHz for Gammatone BM model.

Example: Tests/SSPrograms/ModelResp.c

Parameter file:ModelResp.par:
#
# SimulationSpec main parameter file.
#

output.dat	Output file.

SimSpecs/BM/GammaTResp.sim	Simulation Specification file.

# Misc. parameters.

1		Number of repeat runs.
Output

Figure [86] The impulse response of the Gammatone BM model, CF = 1 kHz.

Example: Tests/Model/Basilar_M/InputvsOut.c

Parameter file:InputvsOut.par:
#
# Main Parameter file
#
output.dat	Name of output file.
#
# Module specifications.
#
#Par. file		Name				Description
#---------		-----				-------------
PTone1.par		PureTone			Stimulus generation paradigm.
PreEmph1.par		PreEmphasis_BandPass	Outer-/middler-ear filter model.
GammaT1k.par		BasilarM_GammaT		Basilar membrane filter.
#
# Miscellaneous parameters
#
10		No. of intensity level readings calculated.
0		Initial intensity value (dB SPL).
10.0	Incremental change in intensity.
2.5e-3	Ramp up rise time for signal (s).
Output

See figure [59] on page Error! Bookmark not defined.. The input-output function for this filter is linear.

Example: Tests/Model/Basilar_M/MultiInvsOut.c

Parameter file:MultiInvsOut.par:
#
# Main Parameter file
#
output.dat	Name of output file.
#
# Module specifications.
#
#Par. file		Name				Description
#---------		-----				-------------
PTone2.par		PureTone			Stimulus generation paradigm.
PreEmph1.par		PreEmphasis_Bandpass 	Outer-/middler-ear filter model.
GammaT1k.par		BasilarM_GammaT		Basilar membrane filter.
#
# Miscellaneous parameters
#
10		No. of intensity level readings calculated.
0		Initial intensity value (dB SPL).
10.0	Incremental change in intensity.
2000.0	Initial stimulus frequency (Hz).
200.0	Final stimulus frequency (Hz).
200.0	Stimulus frequency decrement (Hz).
2.5e-3	Ramp up rise time for signal (s).
Output

Figure [87] The input-output functions for the Gammatone BM model. Both on and off CF functions are shown. Note that none of the input-output functions show compression.

Example: Tests/Model/Basilar_M/IORatiovsFreq.c

Parameter file:IORatiovsFreq.par:
#
# Main Parameter file
#
output.dat		Name of output file.
#
# Module specifications.
#
#Par. file		Name				Description
#---------		-----				-------------
PTone3.par		PureTone			Stimulus generation paradigm.
GammaT1k.par		BasilarM_GammaT		Basilar membrane filter.
#
# Miscellaneous parameters
#
100.0		Lowest frequency for pure tone probe stimulus (Hz).
10000.0		Highest frequency for pure tone probe stimulus (Hz).
10			No. of frequencies within range (logarithmic).
2.5e-3		Ramp up rise time for signal (s).
Output

See figure [61] on page Error! Bookmark not defined..

Example: Tests/Model/Basilar_M/Latency.c

Parameter file:Latency.par:
#
# Main Parameter file
#
output.dat	Name of output file.

# Module specifications.

#Par. file		Name				Description
#---------		-----				-------------
Click1.par		Click				Stimulus generation paradigm.
GammaTLog1.par	BasilarM_GammaT		Basilar membrane filter.

FindInd1.par	Find indexes analysis module parameter file.

# Miscellaneous parameters
2.5e-3		Ramp up rise time for signal (s).

Output

See figure [62] on page 127. The latency for this model compares very well with experiment (see ??)

Example: Tests/Model/Basilar_M/QvsFrequency.c

Parameter file:QvsFrequency.par:
#
# Main Parameter file
#
output.dat		Name of output file.
#
# Module specifications.
#
#Par. file		Name				Description
#---------		-----				-------------
PTone4.par		PureTone			Stimulus generation paradigm.
GammaT1k.par		BasilarM_GammaT		Basilar membrane filter.
#
# Miscellaneous parameters
#
200.0		Lowest test centre frequency (Hz).
30000.0		Highest test centre frequency (Hz).
10			The no. of frequencies used within range.
0.5		Fractional variation from centre frequency during readings.
100.0		Initial incremental change in the frequency.
20000.0		Minimum frequency for sampling interval setting (Hz).
10.0		Intensity difference from maximum for Q calculation (dB).
2.5e-3		Ramp up rise time for signal (s).
Output

See figure [63] on page 128.

Example: Tests/Model/Basilar_M/ResponseGain.c

Parameter file:ResponseGain.par:
#
# Main Parameter file
#
output.dat		Name of first output file.
#
# Module specifications.
#
#Par. file		Name				Description
#---------		-----				-------------
Click2.par		Click				Stimulus generation paradigm.
PreEmph1.par		PreEmphasis_BandPass	Outer-/middler-ear filter model.
GammaT1k.par		BasilarM_GammaT		basilar membrane filter model.
#
# Miscellaneous parameters
#
2.5e-3		Ramp up rise time for signal (s).
Output

Figure [88] Fourier Analysis of the Gammatone BM model, CF = 1 kHz response to a single pure tone stimulus.


previous next Up Title Contents