previous next Up Title Contents

Utility_AmpMod: Amplitude Modulation Transformation


File name
UtAmpMod.[ch]


Description
This module generates an amplitude modulated output signal from the connected input signal. A number of amplitude modulations can be specified.


Example parameter file format
1	Number of modulation frequencies.

#Modulation Specifications.
#Mod. Index	Frequency	Phase
#	(%)	(Hz)		(degrees)
#----------	-----		-----
50.0		100		0
0.0		200		0



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_AmpMod(...) Process Routine

Syntax
BOOLN Process_Utility_AmpMod(EarObjectPtr data);


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

The SetFrequencies_Utility_AmpMod(...) Routine

Syntax
BOOLN SetFrequencies_Utility_AmpMod(double *theFrequencies);


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

The SetIndividualFreq_Utility_AmpMod(...) Routine

Syntax
BOOLN SetIndividualFreq_Utility_AmpMod(int theIndex, double theFrequency);


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

The SetIndividualDepth_Utility_AmpMod(...) Routine

Syntax
BOOLN SetIndividualDepth_Utility_AmpMod(int theIndex, double theModDepth);


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

The SetIndividualPhase_Utility_AmpMod(...) Routine

Syntax
BOOLN SetIndividualPhase_Utility_AmpMod(int theIndex, double thePhase);


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

The SetModulationDepths_Utility_AmpMod(...) Routine

Syntax
BOOLN SetModulationDepths_Utility_AmpMod(double *theModulationDepths);


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

The SetNumFrequencies_Utility_AmpMod(...) Routine

Syntax
BOOLN SetNumFrequencies_Utility_AmpMod(int theNumFrequencies);


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

The SetPars_Utility_AmpMod(...) Routine

Syntax
BOOLN SetPars_Utility_AmpMod(int numFrequencies, double *modulationDepths, double *frequencies, double *phases);


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

The SetPhases_Utility_AmpMod(...) Routine

Syntax
BOOLN SetPhases_Utility_AmpMod(double *thePhases);


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

Example: Tests/Utilities/AmpModulation.c

Parameter file: AmpModulation.par:
#
# Main Parameter file
#

output.dat	Name of output file.

# Module specifications.

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

AmpMod1.par	Amplitude modulation utility module parameter file.

# Miscellaneous parameters

1		No. of repeated runs.
Output

Figure [149] An amplitude modulated pure tone using the Amplitude modulation utility.


previous next Up Title Contents