previous next Up Title Contents

Utility_ReduceChannels:


File name
UtRedceChans.[ch]


Description
This module reduces multiple channel data to a lower number of channels. The process EarObject's input channels are divided over the output channels. Each sample of the appropriate number of channels of the input signal is summed, then the average is calculated by dividing by the number of channels summed.

The input channels are divided over the output channels. Therefore the number of output channels must be a multiple of the number of input channels



Example parameter file format
Average		Mode - "average" or simple "sum".
1		Number of channels signal is to be averaged to.



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

Syntax
BOOLN Process_Utility_ReduceChannels(EarObjectPtr data);


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

The SetMode_Utility_ReduceChannels(...) Routine

Syntax
BOOLN SetMode_Utility_ReduceChannels(char *theMode);


Special Values
Mode options: "AVERAGE"-across channels, or simple "SUM".


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

The SetNumChannels_Utility_ReduceChannels(...) Routine

Syntax
BOOLN SetNumChannels_Utility_ReduceChannels(int theNumChannels);


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

The SetPars_Utility_ReduceChannels(...) Routine

Syntax
BOOLN SetPars_Utility_ReduceChannels(char *mode, int numChannels);


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

Example: Tests/Utilities/ReduceChans.c

Parameter file: ReduceChans.par:
#
# Main Parameter file
#

output1.dat	Name of output file.
output2.dat	Name of output file.

# Module specifications.

#Par. file		Name				Description
#---------		-----				-------------
PTone2.par		PureTone			First stimulus generation paradigm.
BPTone2.par		PureTone_Binaural	Second stimulus generation paradigm.
GammaTL1.par		BasilarM_GammaT		Basilar membrane filter.

RedceCh1.par	Reduce channels utility module parameter file.

# Miscellaneous parameters

1		No. of repeated runs.
2.5e-3	Ramp up rise time for signal (s).
Output

Figure [156] Output1 for test.

Figure [157] Output2 for test.


previous next Up Title Contents