previous next Up Title Contents

BasilarM_Cooke: Linear BM (1991)


File name
MoBMCooke.[ch]


Description
An implementation of Martin Cooke's model of the response of the Basilar Membrane. This module uses sine and cosine tables, so it requires alot of memory. It has three different output options.


Example parameter file format
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.
1.019		ERB Bandwidth correction 4th order.
BM		Output option (BM, POW, AMP).



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_Cooke(...) Process Routine

Syntax
BOOLN RunModel_BasilarM_Cooke(EarObjectPtr data);


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

The GetCFList_BasilarM_Cooke(...) Routine

Syntax
CFListPtr GetCFList_BasilarM_Cooke(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 GetOutputOption_BasilarM_Cooke(...) Routine

Syntax
OutputOptionPtr GetOutputOption_BasilarM_Cooke(void);


Returns
See header (MoBMCooke.h) for information on the return value type.

The SetBandwidths_BasilarM_Cooke(...) Routine

Syntax
BOOLN SetBandwidths_BasilarM_Cooke(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_Cooke(...) Routine

Syntax
BOOLN SetCFList_BasilarM_Cooke(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 SetOutputOption_BasilarM_Cooke(...) Routine

Syntax
BOOLN SetOutputOption_BasilarM_Cooke(char *theOutputOption);


Special Values
Output mode options: "BM"BM detail (standard), "POW"power spectrum and "AMP"amplitude envelope.


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

The SetPars_BasilarM_Cooke(...) Routine

Syntax
BOOLN SetPars_BasilarM_Cooke(char *theOutputOption, double theBroadeningCoeff, CFListPtr theCFs);


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

The SetBroadeningCoeff_BasilarM_Cooke(...) Routine

Syntax
BOOLN SetBroadeningCoeff_BasilarM_Cooke(double theBroadeningCoeff);


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/CookeInt.sim	Utility_SimulationSpec	Simulation spec.

# Miscellaneous parameters

100.0		Lowest frequency for pure tone probe stimulus (Hz).
10000.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 [68] Filter function at CF = 1 kHz for the Cooke 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/CookeInt.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 [69] Tuning Curve at CF = 1 kHz for Cooke BM model.

Example: Tests/SSPrograms/ModelResp.c

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

output.dat	Output file.

SimSpecs/BM/CookeResp.sim	Simulation Specification file.

# Misc. parameters.

1		Number of repeat runs.
Output

Figure [70] The impulse response of the Cooke 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.
CookeBM1k.par	BasilarM_Cooke		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.. Note that this filter has a linear input-output response.

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.
CookeBM1k.par	BasilarM_Cooke		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 [71] The input-output functions for the Cooke BM model. Both on and off CF functions are shown.

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.
CookeBM1k.par	BasilarM_Cooke		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.. As this is a purely functional model, the fact that it attenuates signals is not important. It is the qualitative behaviour which is significant, rather than the quantative behaviour.

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.
CookeBMLog1.par		BasilarM_Cooke		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.

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.
CookeBMk.par		BasilarM_Cooke		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.
CookeBM1k.par	BasilarM_Cooke			basilar membrane filter model.
#
# Miscellaneous parameters
#
2.5e-3		Ramp up rise time for signal (s).
Output

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


previous next Up Title Contents