LUTEar 2.0.9 Manual - PureTone_AM: Amplitude Modulated Pure Tone

PureTone_AM: Amplitude Modulated Pure Tone

Generic Module Routines
The GenerateSignal_PureTone_AM(...) Process Routine
The SetCarrierFrequency_PureTone_AM(...) Routine
The SetDuration_PureTone_AM(...) Routine
The SetIntensity_PureTone_AM(...) Routine
The SetModulationFrequency_PureTone_AM(...) Routine
The SetPars_PureTone_AM(...) Routine
The SetPercentAM_PureTone_AM(...) Routine
The SetSamplingInterval_PureTone_AM(...) Routine
Example: Tests/Combinations/StimulusResp.c
- Parameter file: StimulusResp.par:
- Output

File name	StAMTone.[ch]

Description	Amplitude modulated pure tone generation algorithm.

Example parameter file format	1000.0 Stimulus carrier frequency (Hz). 200.0 Stimulus modulation frequency (Hz). 50.0 Stimulus percent amplitude modulation. 20.0 Stimulus signal intensity (dB SPL). 10.0e-3 Stimulus signal duration (seconds). 0.1e-3 Stimulus sampling interval, dt (seconds).

Test program directory	Tests/Combinations

Generic Module Routines

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

The GenerateSignal_PureTone_AM(...) Process Routine

Syntax	BOOLN GenerateSignal_PureTone_AM (EarObjectPtr theObject);

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

The SetCarrierFrequency_PureTone_AM(...) Routine

Syntax	BOOLN SetCarrierFrequency_PureTone_AMdouble theCarrierFrequency);

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

The SetDuration_PureTone_AM(...) Routine

Syntax	BOOLN SetDuration_PureTone_AM(double theDuration);

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

The SetIntensity_PureTone_AM(...) Routine

Syntax	BOOLN SetIntensity_PureTone_AM(double theIntensity);

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

The SetModulationFrequency_PureTone_AM(...) Routine

Syntax	BOOLN SetModulationFrequency_PureTone_AM(double theModulationFrequency);

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

The SetPars_PureTone_AM(...) Routine

Syntax	BOOLN SetPars_PureTone_AMdouble theCarrierFrequency, double theModulationFrequency, double thePercentAM, double theIntensity, double theDuration, double theSamplingInterval);

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

The SetPercentAM_PureTone_AM(...) Routine

Syntax	BOOLN SetPercentAM_PureTone_AMdouble thePercentAM);

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

The SetSamplingInterval_PureTone_AM(...) Routine

Syntax	BOOLN SetSamplingInterval_PureTone_AM(double theSamplingInterval);

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

Example: Tests/Combinations/StimulusResp.c

Parameter file: StimulusResp.par:

#
# Main Parameter file
#

output.dat	Name of output file.

# Module specifications
#Par. file				Name			Description
#---------				-----			-------------
ParFiles/St/AMPTone1.par		PureTone_AM	Stimulus generation paradigm.
ParFiles/PE/PreEmph1.par	null			Outer-/middler-ear model.
ParFiles/BM/GammaT5k.par	null			Basilar membrane filter model.
ParFiles/IHC/CarneyRP1.par	null			IHC receptor potential model.
ParFiles/IHC/Meddis86.par	null			Inner hair cell (IHC) model.
ParFiles/AN/BinomSG1.par	null			Auditory nerve spike gen.
ParFiles/NC/Dendrite3.par	null			Dendritic filtering.
ParFiles/NC/MG92Stellate.par	null			Neural cell model.

# Miscellaneous parameters

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




Output

Figure [140] A stimulus generated by the PureTone_AM module.