Single band of a cascade graphic equalizer
This module implements a single stage of a graphic equalizer. The stage provides boost or cut over a specified frequency range. A multistage graphic EQ subsystem is constructed as a series cascade of these modules. The multistage graphic EQ is contained within graphic_eq_subsystem.m. This module is typically not used directly. Instead, use the graphic_eq_subsystem.m
The variables .lowerEdge and .upperEdge specify the range of frequencies, in Hz, over which the filter is effective. The variable .gain specifies the boost or cut in dB.
The design of the module is based upon the paper "Graphic Equalizer Design User Higher-Order Recursive Filters" by Holters and Zoelzer. The order of the filter, either 4, 8, or 12, is specified upon instantiation. Higher order filters provide sharper cutoffs at the expense of additional computation. As a rule of thumb, you can use 4th order filters until you have approximately 5 filter bands; 8th order filters until you have 15 filter bands; and 12th order filters for up to 31 bands. The order of the filter can only be set at instantiation time.
Internally, the filter is implemented as a cascade of second order biquad sections. These filters are smoothly updating based upon the variable .smoothingTime. Note, some low frequency filters may go unstable if the smoothingTime is too large.
typedef struct _ModuleGraphicEQBandFract32
ModuleInstanceDescriptor instance; // Common Audio Weaver module instance structure
FLOAT32 gain; // Gain in the center of the band, in dB
FLOAT32 lowerEdge; // Lower frequency edge of the band, in Hz
FLOAT32 upperEdge; // Upper frequency edge of the band, in Hz
INT32 numStages; // Number of 2nd order stages in the filter
awe_modBiquadCascadeFract32Instance *filt; // Cascade of second order Biquad filters
Description: audio input
Data type: fract32
Channel range: Unrestricted
Block size range: Unrestricted
Sample rate range: Unrestricted
Complex support: Real
Description: audio output
Data type: fract32
File Name: graphic_eq_band_fract32_module.m
Implements a single band of a cascade graphic equalizer. This modules
forms part of the overall graphic_eq_fract32_subsystem. Arguments:
NAME - name of the module.
ORDER - filter order of the stage. This must be either 4, 8, or 12.
By default, ORDER=8.