previous next Up Title Contents

PureTone_MultiPulse:


File name
StMPPTone.h.[ch]


Description
The module generates a signal which contains multiple puretone pulses at different frequencies.


Example parameter file format
2	Number of Pulse Frequencies.

#Frequency (Hz).
1000.0		First pure tone.
500.0		Second pure tone.

20.0		Stimulus intensity (dB SPL).
50.0e-3		Stimulus signal duration (seconds).
1.0e-3		Beginning silence, before first pulse (s).
5.0e-3		Pulse duration (s).
7.0e-3		Repetition period (s).
0.05e-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_MultiPulse(...) Process Routine

Syntax
BOOLN GenerateSignal_PureTone_MultiPulse(EarObjectPtr theObject);


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

The GetIndividualFreq_PureTone_MultiPulse(...) Routine

Syntax
double GetIndividualFreq_PureTone_MultiPulse(int index);


Returns
Frequency (Hz).

The SetBeginPeriodDuration_PureTone_MultiPulse(...) Routine

Syntax
BOOLN SetBeginPeriodDuration_PureTone_MultiPulse(double theBeginPeriodDuration);


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

The SetDuration_PureTone_MultiPulse(...) Routine

Syntax
BOOLN SetDuration_PureTone_MultiPulse(double theDuration);


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

The SetIntensity_PureTone_MultiPulse(...) Routine

Syntax
BOOLN SetIntensity_PureTone_MultiPulse(double theIntensity);


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

The SetIndividualFreq_PureTone_MultiPulse(...) Routine

Syntax
BOOLN SetIndividualFreq_PureTone_MultiPulse(int theIndex, double theFreq);


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

The SetFrequencies_PureTone_MultiPulse(...) Routine

Syntax
BOOLN SetFrequencies_PureTone_MultiPulse(double *theFrequencies);


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

The SetNumPulses_PureTone_(...) Routine

Syntax
BOOLN SetNumPulses_PureTone_MultiPulse(int theNumPulses);


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

The SetPars_PureTone_MultiPulse(...) Routine

Syntax
BOOLN SetPars_PureTone_MultiPulse(int theNumPulses, double theIntensity, double *theFrequencies, double theDuration, double theSamplingInterval, double theBeginPeriodDuration, double thePulseDuration, double theRepetitionPeriod);


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

The SetPulseDuration_PureTone_MultiPulse(...) Routine

Syntax
BOOLN SetPulseDuration_PureTone_MultiPulse(double thePulseDuration);


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

The SetRepetitionPeriod_PureTone_MultiPulse(...) Routine

Syntax
BOOLN SetRepetitionPeriod_PureTone_MultiPulse(double theRepetitionPeriod);


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

The SetSamplingInterval_PureTone_MultiPulse(...) Routine

Syntax
BOOLN SetSamplingInterval_PureTone_MultiPulse(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/MPPTone1.par	PureTone_MultiPulse	Stimulus generation.
ParFiles/PE/PreEmph1.par	null				Outer-/middler-ear model.
ParFiles/BM/GammaT5k.par	null				Basilar membrane model.
ParFiles/IHC/CarneyRP1.par	null				IHC receptor potential.
ParFiles/IHC/Meddis86.par	null				Inner hair cell 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 [144] A stimulus generated by the PureTone_MultiPulse module. The stimulus consists of a series of pulses, indivudually specified, which are repeated. The figure illustrates a stimulus which has a series of two pulses of different frequency.


previous next Up Title Contents