SbDOAV2

typedef struct _ModuleSbDOAV2
{
    ModuleInstanceDescriptor instance;            // Common Audio Weaver module instance structure
    FLOAT32 Fs;                                   // Sample rate of time domain data entering WOLA analysis block
    INT32 fftSize;                                // FFT size used in computing WOLA block
    INT32 micGeometry;                            // Specifies which 4 mic geometry we are working with
    INT32 MultiSource;                            // MultiSource = 1, multiple audio sources reported each block. = 0, one audio source reported
    INT32 OutputAngles;                           // OutputAngles = 0, angles in range 0-360 reported, = 1 180-360 reported
    INT32 LowerBin;                               // Frequ bin index of lowest frequ component in the WOLA block
    FLOAT32 MicGeomSize;                          // Length in meters of each side of square mic array
    FLOAT32 DT1;                                  // Dynamic threshold level
    INT32 BlocksPerHistogram;                     // Number of blocks used to fill histogram before doing smoothing and averaging
    INT32 boxcarDelay;                            // Half length of rectangular window for histogram smoothing
    INT32 gaussDelay;                             // Half length of gaussian window for histogram smoothing
    FLOAT32 gaussSigma;                           // Standard Deviation for Gaussian window
    INT32 NumHistogramStates;                     // Number of full histograms used for temporal averaging
    INT32 numStates;                              // Number of states in state buffer
    INT32 Opt;                                    // Optimization level
    INT32 numMics;                                // Number of microphones for this mic geometry
    INT32 maxDelay;                               // Maximum of gaussDelay, boxcarDelay
    INT32 HistStatePtr;                           // Index of oldest entry in histogram buffer
    INT32 XStatePtr;                              // Index of oldest entry in state buffer
    INT32 blockCtr;                               // Counter to keep track of number of blocks used to update histogram
    INT32 blockCtrReset;                          // Counter to keep track of number of blocks used between reset to zero of Rxx and avgHistogram
    INT32 aboveThresh;                            // Input signal dBA greater than noise floor dBA. Changes once per BlocksPerHistogram blocks
    INT32 doHistSmoothing;                        // Specifies whether to do smoothing of histogram
    INT32 doHistAveraging;                        // Specifies whether to do temporal smoothing of histogram
    INT32 doNFTracking;                           // Specifies whether to do noise floor tracking
    INT32 doOnsetTracking;                        // Specifies whether to do onset tracking
    FLOAT32 speedSound;                           // Speed of sound in m/s
    FLOAT32 Test2Thresh;                          // Threshold for passing square mic array steering vector test 2
    FLOAT32 Test1Thresh;                          // Threshold for passing square mic array steering vector test 1
    FLOAT32 CTFact;                               // Coherence Test Factor, scale factor specifying how much larger dominant eigenvalue must be than the sum of all the other eigenvalues
    FLOAT32 MinPeakThresh;                        // Minimum height of a histogram peak to be eligible to be reported as a DOA
    INT32 MinDist;                                // Distance in integer units of degrees, between peaks in histogram to count as a distinct DOA
    INT32 BlocksPerReset;                         // Number of blocks between resets to zero of Rxx and avgHistogram
    FLOAT32 NFUp;                                 // Noise floor ramp up coefficient
    FLOAT32 NFUpSlow;                             // Noise floor ramp up slow coefficient
    FLOAT32 NFDown;                               // Noise floor ramp down coefficient
    FLOAT32 NFMin;                                // Minimum allowable value for noise floor
    FLOAT32 NFSNR;                                // Noise Floor SNR
    INT32 NFFrameCount;                           // Max number of frames to ramp up fast
    FLOAT32 OSUp;                                 // Onset ramp up coefficient
    FLOAT32 OSDown;                               // Onset ramp down coefficient
    FLOAT32 OSJump;                               // Onset jump coefficient
    INT32 OSDur;                                  // Number of frames for onset decay
    FLOAT32* Rxx;                                 // Holds current estimate of Rxx
    FLOAT32* RxxTemp;                             // Temporary buffer needed for squaring Rxx
    FLOAT32* RxxTemp2;                            // Temporary buffer needed for squaring Rxx
    FLOAT32* XState;                              // Holds numStates sets of numMics input data
    FLOAT32* HistState;                           // Holds NumHistogramStates histograms
    FLOAT32* TempReal;                            // Scratch array of numSB real values
    FLOAT32* noise_floor;                         // Noise floor per bin, array of numSB real values
    INT32* sig_count_bw;                          // Frame count for fast ramp up per bin, array of numSB real values
    FLOAT32* onset_threshold;                     // Onset threshold per bin, array of numSB real values
    INT32* count_onset;                           // Onset count per bin, array of numSB real values
    FLOAT32* xMagAvg;                             // Average magnitude per bin, array of numSB real values
    FLOAT32* NFAvg;                               // Noise floor average per bin, array of numSB real values
    FLOAT32* AWeights;                            // A weighting values
    FLOAT32* TempComplex;                         // Scratch array of numSB complex values
    FLOAT32* EvalEst;                             // Scratch array to hold estimates of dominant eigenvalues
    FLOAT32* Trace;                               // Scratch array to hold trace of Rxx for each subband
    INT32* freqBinMap;                            // Scratch array to hold mapping between valid bins and discrete frquency indices
    FLOAT32* avgHistogram;                        // Scratch array to hold average histogram
    FLOAT32* currentHistogram;                    // Scratch array to hold current histogram
    FLOAT32* smoothedHistogram;                   // Scratch array to hold smoothed histogram
    FLOAT32* histExt;                             // Scratch array to hold smoothed histogram
    FLOAT32* histCnv;                             // Scratch array to hold smoothed histogram
    INT32* histSortedAngles;                      // Scratch array for histogram peak picking
    FLOAT32* histSortedValues;                    // Scratch array for histogram peak picking
    INT32* histAnglesUsed;                        // Scratch array for histogram peak picking
    FLOAT32* valuesOutState;                      // Scratch array to hold output histogram counts
    INT32* anglesOutState;                        // Scratch array to hold output angles
    FLOAT32* GaussianWindow;                      // Gaussian window for smoothing histogram
    FLOAT32* BoxcarWindow;                        // Rectangular window for smoothing histogram
} ModuleSbDOAV2Class;

Name: Audio
Description: audio input
Data type: float
Channel range: 4
Block size range: Unrestricted
Sample rate range: Unrestricted
Complex support: Complex

Name: BitMap
Description: bit map
Data type: int
Channel range: 1
Block size range: Unrestricted
Sample rate range: Unrestricted
Complex support: Real

Name: Angle
Description: DOA Angle
Data type: float
Name: ConfidenceValue
Description: DOA Confidence Value
Data type: float
Name: Histogram
Description: Histogram Data
Data type: float

 M=sb_doa_v2_module(NAME, MICGEOM, FFTSIZE, FS, MICGEOMSIZE, LOWERBIN, MULTISOURCE, OUTPUTANGLES)
 SbDOAV2 module identifies the 2D angular direction of an audio source received at the mic array.  
 The module takes multichannel frequency domain data as input, (usually the output of a WOLA 
 Analysis module).  The module produces 2 outputs per block: 
 1.)Angle = estimated angular direction of arrival in degrees. This will be an integer between 0 and 360.
 2.)Confidence value for this angle estimate.  Larger values mean more confidence in the angle estimate.  
 Arguments:
 NAME            - Name of the module.
 MICGEOM         - Specifies the mic geometry of the multichannel input data 
 FFTSIZE         - FFTSize used by WOLA Analysis block preceding the SbDOAV2 module
 FS              - Sampling rate of time domain data entering WOLA Analysis block
 MICGEOMSIZE     - Dimension in meters of selected mic geometry
 LOWERBIN        - Frequency bin index of lowest WOLA bin entering SbDOAV2 input pin
 MULTISOURCE     - MULTISOURCE = 1 ---> Report multiple audio sources per block, (MIPS intensive), 
                 - MULTISOURCE = 0 ---> Report one audio source per block, (Low MIPS)
 OUTPUTANGLES    - OUTPUTANGLE = 0 ---> Report angles from 0 to 360
                 - OUTPUTANGLE = 1 ---> Report angles from 180 to 360