Overview

Computes sample statistics over multichannel fract32 signals

Discussion

This module calculates the sample statistics of the input fract32 signal on a sample-by-sample basis. The input pin can have an arbitray number of interleaved channels and the sample statistics calculation occurs over all channels. The output pin has only a single channel and a blockSize equal to that of input.

For each channel, the module calculates the type of statistics depending on the variable statisticsType selection. The available options are: 0=maximum, 1=minimum, 2=maximum absolute value, and 3=minimum absolute value. This includes all channels and the entire block.

If the argument OUTPUTINDEX is checked, then a 2nd output pin will be created. The 2nd output is the corresponding index value of the output operation. The index starts at 0. So an output value of 0 corresponds to the 1st channel. The optional 2nd output pin is single channel, int, with the same block size as the input.

The module also exposes the computed signal as a state variable. The variable instantaneousValue holds the block statistics of the block.

Type Definition

typedef struct _ModuleSampleStatisticsFract32
{
    ModuleInstanceDescriptor instance;            // Common Audio Weaver module instance structure
    INT32 statisticsType;                         // Type of statistics calculated: 0=maximum, 1=minimum, 2=maximum absolute value, 3=minimum absolute value.
    fract32 instantaneousValue;                   // Instantaneous output value.
} ModuleSampleStatisticsFract32Class;

Variables

Properties

Name	Type	Usage	isHidden	Default value	Range	Units
statisticsType	int	parameter	0	0	0:3
instantaneousValue	fract32	state	0	0	-60:10

Pins

Input Pins

Name: in

Description: Audio input

Data type: fract32

Channel range: Unrestricted

Block size range: Unrestricted

Sample rate range: Unrestricted

Complex support: Real

Output Pins

Name: out

Description: Sample statistics output

Data type: fract32

Name: index

Description: Index value

Data type: int

MATLAB Usage

File Name: sample_statistics_fract32_module.m

 M=sample_statistics_fract32_module(NAME, OUTPUTINDEX)
 Fixed point sample statistics module calculates the maximum, minimum,
 maximum absolute value and minimum absolute value on sample-by-sample 
 basis of an arbitrary number of interleaved channels.
 
 Arguments:
    NAME - name of the module.
    OUTPUTINDEX - boolean value which specifies whether the module will
    have an optional 2nd output which outputs the channel index value of 
    the sample value is outputed. By default, OUTPUTINDEX = 0, which means
    no 2nd output channel will be created. The 2nd output will be of the 
    data type int. The index starts at 0. So an output value of 0 means
    channel 1 of the input.