previous next Up Title Contents

Utility_IteratedRipple: Signal Transformation


File name
UtIterRipple.[ch]


Description
This module uses the input signal from its process EarObject to generated an output signal using the Iterated Ripple algorithm as described in [19.].


Example parameter file format
2	Iterations number
IRSO	Iterated ripple mode: "IRSO" - add original, "IRSS", add-same.
4e-3	delay (s).
-1	Signal multiplier (Gain).



Test program directory
Tests/Utilities

Generic Module Routines

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

The Process_Utility_IteratedRipple(...) Process Routine

Syntax
BOOLN Process_Utility_IteratedRipple(EarObjectPtr data);


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

The SetDelay_Utility_IteratedRipple(...) Routine

Syntax
BOOLN SetDelay_Utility_IteratedRipple(double theDelay);


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

The SetSignalMultiplier_Utility_IteratedRipple(...) Routine

Syntax
BOOLN SetSignalMultiplier_Utility_IteratedRipple(double theSignalMultiplier);


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

The SetMode_Utility_IteratedRipple(...) Routine

Syntax
BOOLN SetMode_Utility_IteratedRipple(char *theMode);


Special Values
Mode options: "IRSO" = Iterated Rippled Signal Add-Original, "IRSS" = Iterated Rippled signal Add-Same.


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

The SetNumIterations_Utility_IteratedRipple(...) Routine

Syntax
BOOLN SetNumIterations_Utility_IteratedRipple(int theNumIterations);


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

The SetPars_Utility_IteratedRipple(...) Routine

Syntax
BOOLN SetPars_Utility_IteratedRipple(int numIterations, char *mode, double delay, double signalMultiplier);


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

Example: Tests/Utilities/IterRipple.c

Parameter file: IterRipple.par:
#
# Main Parameter file
#

output.dat	Name of output file.

# Module specifications.

#Par. file		Name			Description
#---------		-----			-------------
WNoise1.par		WhiteNoise		Stimulus generation paradigm.

IterRip1.par	Iterated ripple utility module parameter file.

# Miscellaneous parameters

1		No. of repeated runs.
Output

Figure [155] A white noise stimulus subjected to the "Iterated Ripple" utility module. The data shown has been fourier transformed.


previous next Up Title Contents