previous next Up Title Contents

PureTone_Multi:


File name
StMPTone.[ch]


Description
This module generates a multiple pure tone stimulus. Each pure tone is specified individually.


Example parameter file format
2	Number of pure tones.

#Frequency	Intensity	Phase
#(Hz)		(dB SPL)	(degrees).
100.0		20.0		0.0		First pure tone.
200.0		20.0		0.0		Second pure tone.

10.0e-3		Stimulus signal duration (seconds).
0.25e-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_Multi(...) Process Routine

Syntax
BOOLN GenerateSignal_PureTone_Multi(EarObjectPtr theObject);


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

The GetIndividualFreq_PureTone_Multi(...) Routine

Syntax
double GetIndividualFreq_PureTone_Multi(int index);


Returns
Frequency (Hz)

The GetIndividualIntensity_PureTone_Multi(...) Routine

Syntax
double GetIndividualIntensity_PureTone_Multi(int index);


Returns
Intensity (dB SPL).

The SetDuration_PureTone_Multi(...) Routine

Syntax
BOOLN SetDuration_PureTone_Multi(double theDuration);


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

The SetFrequencies_PureTone_Multi(...) Routine

Syntax
BOOLN SetFrequencies_PureTone_Multi(double *theFrequencies);


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

The SetIndividualFreq_PureTone_Multi(...) Routine

Syntax
BOOLN SetIndividualFreq_PureTone_Multi(int theIndex, double theFrequency);


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

The SetIndividualIntensity_PureTone_Multi(...) Routine

Syntax
BOOLN SetIndividualIntensity_PureTone_Multi(int theIndex, double theIntensity);


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

The SetIndividualPhase_PureTone_Multi(...) Routine

Syntax
BOOLN SetIndividualPhase_PureTone_Multi(int theIndex, double thePhase);


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

The SetIntensities_PureTone_Multi(...) Routine

Syntax
BOOLN SetIntensities_PureTone_Multi(double *theIntensities);


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

The SetNumPTones_PureTone_Multi(...) Routine

Syntax
BOOLN SetNumPTones_PureTone_Multi(int theNumPTones);


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

The SetPhases_PureTone_Multi(...) Routine

Syntax
BOOLN SetPhases_PureTone_Multi(double *thePhases);


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

The SetPars_PureTone_Multi(...) Routine

Syntax
BOOLN SetPars_PureTone_Multi(int theNumPTones, double *theFrequencies, double *theIntensities, double *thePhases, double theDuration, double theSamplingInterval);


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

The SetSamplingInterval_PureTone_Multi(...) Routine

Syntax
BOOLN SetSamplingInterval_PureTone_Multi(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/MPTone1.par		PureTone_Multi	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 [143] A stimulus generated by the PureTone_Multi module. This stimulus consists of individually specified pure tones which are added together to form a composite signal.


previous next Up Title Contents