(8.D.2.5) BandToBin
Overview
Expand frequency domain bands into individual bins
Discussion
The Band to Bin Module is a module that expands frequency bands into more bins by copying the value of each band into each individual bin. The number of input bands is determined by the input wire block size. It expands each input band into multiple bins as per the user defined bandSize array and this module only accepts real numbers as inputs. If the total number of bins in .bandSize is smaller than the .numBins argument, the module will output zeros for the missing bins. If the total number of bins in .bandSize is greater than the .numBins argument, the module will ignore the value of any band that is larger than the last bin. This module is meant to be used after the Bin to Band module to restore the original number of bins after doing processing a fewer number of bands. The module supports multichannel inputs and separately expands the bins for each channel. That is, if the input has N channels then the output will also have N channels.
Example: We have a 12 bin system that we want to combine into 4 bands. We would start off by using the Bin to Band module with 4 output bands, setting each element of the bandSize array to 3 to combine 3 bins each. If the input x[n] = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11], then the output would be (if using the maximum value processing mode) y[n] = [2, 5, 8, 11]. At this point you could do processing over these 4 bands. But if you sent this as an input to the Band to Bin module and set it to expand to 12 bins, with each band expanding to 3 bins, then for an input x[n] = [2, 5, 8, 11] you would get an output of y[n] = [2, 2, 2, 5, 5, 5, 8, 8, 8, 11, 11, 11].
Type Definition
typedef struct _ModuleBandToBin
{
ModuleInstanceDescriptor instance; // Common Audio Weaver module instance structure
INT32* bandSize; // Number of output bins to expand per input band.
INT32* startIndex; // Starting bin index for each band.
INT32* endIndex; // Ending bin index for each band.
} ModuleBandToBinClass;
Variables
Properties
Name | Type | Usage | isHidden | Default value | Range | Units |
bandSize | int* | parameter | 0 | [32 x 1] | Unrestricted | Â |
startIndex | int* | derived | 1 | [32 x 1] | Unrestricted | Â |
endIndex | int* | derived | 1 | [32 x 1] | Unrestricted | Â |
Pins
Input Pins
Name: in
Description: audio input
Data type: float
Channel range: Unrestricted
Block size range: Unrestricted
Sample rate range: Unrestricted
Complex support: Real
Output Pins
Name: out
Description: audio output
Data type: float
MATLAB Usage
File Name: band_to_bin_module.m
M = band_to_bin_module(NAME, NUMBINS)
Creates a module which expands frequency bands to individual frequency
bins. Arguments:
NAME - name of the module.
NUMBINS - number of output bins
Â