previous next Up Title Contents

BasilarM_DRNL: Non-linear BM (1995)


File name
MoBMDRNL.[ch]


Description
This model implements the Dual Resonance Non-linear (DRNL) filter-bank model (ref ??)


Example parameter file format
4		Total order for the gamma tone filters - BM model.
single		Frequency mode.
1000		Centre frequency of gamma-tone filter for basilar membrane.
Nonlinear	Band width (3 dB down) mode for filters.
1.0		Narrow filter broadening coefficient.
15.47		Threshold above which compression takes place (dB SPL).
0.58		Compression ratio.
1.0		Wide filter broadening coefficient.
2.5		Narrow filter low-pass cut-off scale.



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

Syntax
BOOLN RunModel_BasilarM_DRNL(EarObjectPtr data);


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

The GetCFList_BasilarM_DRNL(...) Routine

Syntax
CFListPtr GetCFList_BasilarM_DRNL(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_DRNL(...) Routine

Syntax
BOOLN SetBandwidths_BasilarM_DRNL(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_DRNL(...) Routine

Syntax
BOOLN SetCFList_BasilarM_DRNL(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 SetCompressionExponent_BasilarM_DRNL (...) Routine

Syntax
BOOLN SetCompressionExponent_BasilarM(double theCompressionExponent);


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

The SetCompressionThreshold_BasilarM_DRNL(...) Routine

Syntax
BOOLN SetCompressionThreshold_BasilarM_DRNL(double theCompressionThreshold);


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

The SetNarrowBroadeningCoeff_BasilarM_DRNL(...) Routine

Syntax
BOOLN SetNarrowBroadeningCoeff_BasilarM_DRNL(double theNarrowBroadeningCoeff);


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

The SetNarrowFLPCutOffScale_BasilarM_DRNL(...) Routine

Syntax
BOOLN SetNarrowFLPCutOffScale_BasilarM_DRNL(double theNarrowFLPCutOffScale);


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

The SetOrder_BasilarM_DRNL(...) Routine

Syntax
BOOLN SetOrder_BasilarM_DRNL(double theOrder);


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

The SetPars_BasilarM_DRNL(...) Routine

Syntax
BOOLN SetPars_BasilarM_DRNL(int theOrder, double theNarrowBroadeningCoeff, double theCompressionThreshold, double theCompressionExponent, double wideBroadeningCoeff, double narrowFLPCutOffScale, CFListPtr theCFs);


Special Values



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

The SetWideBroadeningCoeff_BasilarM_DRNL(...) Routine

Syntax
BOOLN SetWideBroadeningCoeff_BasilarM_DRNL(double theWideBroadeningCoeff);


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/PTone5.par		PureTone				Stimulus generation.
SimSpecs/BM/DRNLInt.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 [73] Filter function at CF = 1 kHz for the DRNL 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/PTone5.par		PureTone				Stimulus generation.
SimSpecs/BM/DRNLInt.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 [74] Tuning Curve at CF = 1 kHz for DRNL BM model.

Example: Tests/SSPrograms/ModelResp.c

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

output.dat	Output file.

SimSpecs/BM/DRNLResp.sim	Simulation Specification file.

# Misc. parameters.

1		Number of repeat runs.
Output

Figure [75] The impulse response of the DRNL BM model, CF = 1 kHz. This models "ringing" response is shorter than that for the linear gammatone filter.

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
#---------		-----				-------------
PTone2.par		PureTone			Stimulus generation paradigm.
GPigChinPE.par	PreEmphasis_BandPass	Outer-/middler-ear filter model.
DRNL1k.par		BasilarM_DRNL		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 the input-output function for this filter has a "compression elbow" at ~30 dB SPL..

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
#---------		-----				-------------
PTone4.par		PureTone			Stimulus generation paradigm.
GPigChinPE1.par	PreEmphasis_Bandpass	Outer-/middler-ear filter model.
DRNL1k.par		BasilarM_DRNL		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 [76] The input-output functions for the DRNL BM model. Both on and off CF functions are shown. Note that the off-CF input-output functions show compression at higher intensities.

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.
DRNL1k.par		BasilarM_DRNL		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.
DRNLLog1.par	BasilarM_DRNL		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.
DRNL8k.par		BasilarM_DRNL		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/DistortProds.c

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

# Module specifications.

#Par. file		Name				Description
#---------		-----				-------------
MPTone3.par		PureTone_Multi		Stimulus generation paradigm.
GPigChinPE.par	PreEmphasis_BandPass	Outer-/middler-ear filter model.
DRNLx.par		BasilarM_DRNL		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 [77] Distortion products investigation for the DRNL BM model. Paradigm??. The response is similar to that of the Carney 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.
DRNL1k.par		BasilarM_DRNL		Basilar membrane filter.
#
# Miscellaneous parameters
#
2.5e-3			Ramp rise time (seconds).
Output

Figure [78] A fourier analysis of the DRNL BM model response to a two-tone stimulus at CF = 1 kHz.

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

Figure [79] Fourier Analysis of the DRNL 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
#---------		-----				-------------
MPTone2.par		PureTone_Multi		Stimulus generation paradigm.
GPigChinPE.par	PreEmphasis_BandPass	Outer-/middler-ear filter model.
DRNL8k.par		BasilarM_DRNL		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 [80] Two-tone suppression response for the DRNL BM model.


previous next Up Title Contents