previous next Up Title Contents

PureTone_AM: Amplitude Modulated Pure Tone


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.


previous next Up Title Contents