previous next Up Title Contents

Basilar Membrane Model ModulesBasilarM_Carney: Non-linear BM (1993)


File name
MoBMCarney.[ch]


Description
This is the Carney ([3.]) non-linear basilar membrane filter model, revised from her original C code. The centre frequeny mode is controlled using the UtCFList modulesee 0 Using the Basilar Membrane Filter Modules.


Example parameter file format
4	Order for the gamma tone filters - BM model.
single	Centre frequency mode for filter.
1000.0	Centre frequency of gamma-tone filter bank.
1100	Cut-off frequency for OHC low-pass filter, Fc (Hz).
5000	Operating point of OHC (feedback) non-linearity, P_Dfb (Pa).
0.462	Asymmetrical bias for OHC non-linearity, P0 (rad).
10.0	Maximum depolarising hair cell voltage, Vmax (V).



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

Syntax
BOOLN RunModel_BasilarM_Carney(EarObjectPtr data);


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

The GetCFList_BasilarM_Carney(...) Routine

Syntax
CFListPtr GetCFList_BasilarM_Carney(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 SetAsymmetricalBias_BasilarM_Carney(...) Routine

Syntax
BOOLN SetAsymmetricalBias_BasilarM_Carney(double theAsymmetricalBias);


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

The SetCFList_BasilarM_Carney(...) Routine

Syntax
BOOLN SetCFList_BasilarM_Carney(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 SetCutOffFrequency_BasilarM_Carney(...) Routine

Syntax
BOOLN SetCutOffFrequency_BasilarM_Carney(double theCutOffFrequency);


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

The SetMaxHCVoltage_BasilarM_Carney(...) Routine

Syntax
BOOLN SetMaxHCVoltage_BasilarM_Carney(double theMaxHCVoltage);


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

The SetHCoperatingPoint_BasilarM_Carney(...) Routine

Syntax
BOOLN SetHCoperatingPoint_BasilarM_Carney(double theHCoperatingPoint);


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

The SetOrder_BasilarM_Carney(...) Routine

Syntax
BOOLN SetOrder_BasilarM_Carney(double theOrder);


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

The SetPars_BasilarM_Carney(...) Routine

Syntax
BOOLN SetPars_BasilarM_Carney(int order, double cutOffFrequency, double hCOperatingPoint, double asymmetricalBias, double maxHCVoltage, CFListPtr cFList);


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 paradigm.
SimSpecs/BM/CarneyInt.sim	Utility_SimulationSpec		Simulation
specification.

# 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 [56] Filter function at CF = 1 kHz for the Carney 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/CarneyInt.sim	Utility_SimulationSpec		Simulation spec.

# Miscellaneous parameters

100.0	Lowest test centre frequency (Hz).
2000.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 [57] Tuning Curve at CF = 1 kHz for Carney BM model. This particular Carney model is unstable above ~ 4 kHz. (see [3.])

Example: Tests/SSPrograms/ModelResp.c

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

output.dat	Output file.

SimSpecs/BM/CarneyResp.sim	Simulation Specification file.

# Misc. parameters.

1		Number of repeat runs.
Output

Figure [58] The impulse response of the Carney 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		null				Outer-/middler-ear filter model.
Carney1k.par		BasilarM_Carney		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

Figure [59] The input-output response of all the BM models. The "GammaT" and "Cooke" functions show the linear 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		null				Outer-/middler-ear filter model.
Carney1k.par		BasilarM_Carney		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 [60] The input-output functions for the Carney 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.
Carney1k.par		BasilarM_Carney		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

Figure [61] Input-output (I/O) ratio functions for all the BM models, showing the I/O characteristics with changing frequency.

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.
CarneyLog1par	BasilarM_Carney		Basilar membrane filter.

FindInd1.par	Find indexes analysis module parameter file.

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

Figure [62] Latency of response for the BM models. All the functioncs compare well with experimental observations.

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.
Carney1k.par		BasilarM_Carney		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

Figure [63] The Q10 tuning characteristics for the BM models. The DRNL response is the only one which shows the fall at high frequencies observed in experimental data (see ??).

Example: Tests/Model/Basilar_M/DistortProds.c

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

# Module specifications.

#Par. file		Name				Description
#---------		-----				-------------
MPTone5.par		PureTone_Multi		Stimulus generation paradigm.
GPigChinPE.par	null				Outer-/middler-ear filter model.
Carney1k.par		BasilarM_Carney		Basilar membrane filter.

# Miscellaneous parameters

18		Number of readings to calculate.
0		Output intensity reference mode (0/1 = unity/input level).
1.1		Frequency ratio, f2/f1.
0.0		Pure tone 1 intensity increment (dB).
3.0		Pure tone 2 intensity increment (dB).
2		Pure tone 1 multiplier (m1).
1		Pure tone 2 multiplier (m2).
2.5e-3	Ramp rise time (seconds).
Output

Figure [64] Distortion products investigation for the Carney BM model. Paradigm??. The response is similar to that of the DRNL filter, and both compare well with experimental data (see ??).

Example: Tests/Model/Basilar_M/FTAnalysis.c

Parameter file:FTAnalysis.par:
#
# Main Parameter file
#
output.dat	Name of output file.
#
# Module specifications.
#
#Par. file		Name				Description
#---------		-----				-------------
MPTone4.par		PureTone_Multi		Stimulus generation paradigm.
Carney1k.par		BasilarM_Carney		Basilar membrane filter.
#
# Miscellaneous parameters
#
2.5e-3			Ramp rise time (seconds).
Output

Figure [65] A fourier analysis of the Carney BM model response to a two-tone stimulus at CF = 1 kHz. Note that distortion products occur well away from CF, which does not occur in experimental data.

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		null				Outer-/middler-ear filter model.
Carney1k.par		BasilarM_Carney		basilar membrane filter model.
#
# Miscellaneous parameters
#
2.5e-3		Ramp up rise time for signal (s).
Output

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

Example: Tests/Model/Basilar_M/TwoTSuppress.c

Parameter file:TwoTSuppress.par:
#
# Main Parameter file
#

output.dat	Name of output file.

# Module specifications.

#Par. file		Name				Description
#---------		-----				-------------
MPTone6.par		PureTone_Multi		Stimulus generation paradigm.
PreEmph1.par		null				Outer-/middler-ear filter model.
Carney1k.par		BasilarM_Carney		basilar membrane filter model.

# Miscellaneous parameters

20		Number of test frequencies.
2000.0	Lowest test frequency (Hz).
15170.0	Highest test frequency (Hz).
80.0		Test pure tone initial intensity (dB SPL).
0.0		Final test stimulus Intensity step (dB SPL).
10.0		Test stimulus intensity decrement (dB).
2.5e-3	Ramp up rise time for signal (s).
Output


Figure [67] Two-tone suppression response for the Carney BM model. Note that there the characteristic areas of suppresion around CF are not evident.


previous next Up Title Contents