previous next Up Title Contents

WhiteNoise


File name
StWhiteNoise.[ch]


Description
This module generates a monaural or binaural white noise stimulus.


Example parameter file format
2	Number of Sound Channels (Binaural = 2; Monaural = 1).
1	Degree of Binaural noise correlation (Correlated = 1; Uncorrelated = -1).
36	Noise Randomization Index (greater than 12).
1	Random Number Seed.
30	Intensity of the Noise in dB (SPL).
10.0e-3	Duration of the Noise (seconds).
0.05e-3	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_WhiteNoise(...) Process Routine

Syntax
BOOLN GenerateSignal_WhiteNoise(EarObjectPtr theObject);


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

The SetDuration_WhiteNoise(...) Routine

Syntax
BOOLN SetDuration_WhiteNoise(double theDuration);


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

The SetIntensity_WhiteNoise(...) Routine

Syntax
BOOLN SetIntensity_WhiteNoise(double theIntensity);


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

The SetPars_WhiteNoise(...) Routine

Syntax
BOOLN SetPars_WhiteNoise(int numChannels, double theIntensity, double theDuration, double theSamplingInterval, int theCorrelationDegree, int theRandomizationIndex, long theRanSeed);


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

The SetNumChannels_WhiteNoise(...) Routine

Syntax
BOOLN SetNumChannels_WhiteNoise(int theNumChannels);


Special Values
Options: "1" = Monaural, "2" = Binaural.


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

The SetSamplingInterval_WhiteNoise(...) Routine

Syntax
BOOLN SetSamplingInterval_WhiteNoise(double theSamplingInterval);


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

The SetCorrelationDegree_WhiteNoise(...) Routine

Syntax
BOOLN SetCorrelationDegree_WhiteNoise(int theCorrelationDegree);


Special Values
Options: postive number = Correlated, negative number = uncorrelated.


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

The SetRandomizationIndex_WhiteNoise(...) Routine

Syntax
BOOLN SetRandomizationIndex_WhiteNoise(int theRandomizationIndex);


Special Values
A number greater than 12 should be used.


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

The SetRanSeed_WhiteNoise(...) Routine

Syntax
BOOLN SetRanSeed_WhiteNoise(long theRanSeed);


Special Values
A negative random number seed will change the sequence of random numbers used.


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/WNoise1.par		WhiteNoise	Stimulus generation paradigm.
ParFiles/PE/PreEmph1.par	null		Outer-/middler-ear filter 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 generation.
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 [147] A stimulus generated by the WhiteNoise module.


previous next Up Title Contents