Overview

Frequency domain based beamformer

Discussion

This module implements a frequency domain based beamformer. The module has a multichannel input pin "in" which correspond to N microphone signals. The microphone signals must already be in the frequency domain (e.g., after an FFT or WOLA filterbank). The module has an internal table of complex filter coefficients of size [numMics, numBins]. The module multiples each microphone signal by complex coefficients and then sums across all microphone channels. This corresponds to filtering each microphone signal and summing the results.

The module has the ability to store multiple coefficient sets. The argument NUMBEAMS specifies how many different beams to store. The first input pin index is an integer value and specifies which set of beamformer coefficients to use. The index is zero based and must be in the range [0 NUMBEAMS-1]. The function will automatically clip index so that it is in a valid range.

By default, the module outputs a single beam. The third argument OUTPUTALL allows you to output all beams simultaneously. In this case, the module will have a single multichannel output pin with NUMBEAMS channels. In the multichannel case, the input index pin is removed.

The coefficients are ordered as follows. The first 2 * numBins * numMics coefficients correspond to the first beamformer. The coefficient are ordered first based on input channel and then on frequency bin. The coefficient are interleaved real / imag values. The beamformer coefficients can be loaded using the function sb_beamformer_config.m

Type Definition

typedef struct _ModuleSbBeamformerV3
{
    ModuleInstanceDescriptor instance;            // Common Audio Weaver module instance structure
    INT32 numBeams;                               // Number of beams allocated.
    INT32 numCoeffs;                              // Number of coefficients to allocate
    FLOAT32* coeffs;                              // Complex beamformer coefficients.
} ModuleSbBeamformerV3Class;

Variables

Properties

Name	Type	Usage	isHidden	Default value	Range	Units
numBeams	int	const	1	1	Unrestricted
numCoeffs	int	const	1	132	Unrestricted
coeffs	float*	parameter	0	[2 x 33]	Unrestricted

Pins

Input Pins

Name: in

Description: Complex data

Data type: float

Channel range: 2

Block size range: Unrestricted

Sample rate range: Unrestricted

Complex support: Complex

Output Pins

Name: out

Description: Beam output