Elp_CascadeCoef

Advanced Analysis Library Only

AnalysisLibErrType Elp_CascadeCoef (double samplingFreq, double lowerCutoffFreq, double upperCutoffFreq, double ripple, double stopBandAtten, IIRFilterPtr filterInformation);

Purpose

Generates the set of cascade form filter coefficients to implement an IIR filter as specified by the elliptic (or Cauer) filter model.

filterInformation is the pointer to the filter structure that contains the filter coefficients and the internal filter information. You must allocate this structure by calling AllocIIRFilterPtr before calling this cascade IIR filter design function.

To redesign another filter, you should first call FreeIIRFilterPtr to free the present filter structure and then call AllocIIRFilterPtr with the new type and order parameters before you call Elp_CascadeCoef.

If the type and order remain the same, you can call Elp_CascadeCoef without calling FreeIIRFilterPtr and AllocIIRFilterPtr. In this case, you must properly reset the filtering operation for that structure by calling ResetIIRFilter before the first call to IIRCascadeFiltering.

Example

/* Design a cascade lowpass elliptic IIR filter. */
double fs, fl, fh, ripple, atten, x[256], y[256];
int type, order, n;
IIRFilterPtr filterInfo;
n = 256;
fs = 1000.0;
fl = 200.0;
ripple = 0.5;
atten = 40.0;
order = 5;
type = 0; /* lowpass */
Uniform(n, 17, x);
filterInfo = AllocIIRFilterPtr(type, order);
if(filterInfo!=0) {

Elp_CascadeCoef(fs, fl, fh, ripple, atten, filterInfo);
IIRCascadeFiltering(x, n, filterInfo, y);
FreeIIRFilterPtr(filterInfo);

}

Parameters

Input
Name Type Description
samplingFreq double-precision The sampling frequency in Hertz.
lowerCutoffFreq double-precision The lower cutoff frequency of the filter in Hertz.
upperCutoffFreq double-precision The cutoff frequency of the filter in Hertz
ripple double-precision The amplitude of the stop band ripple in decibels.

Default Value: 0.1 db.
stopBandAtten double-precision The stop band attenuation, in decibels, of the IIR filter to design.

Default Value: 60.0.
filterInformation IIRFilterPtr Pointer to the filter structure that contains the filter coefficients and the internal filter information.

You must allocate this structure by calling AllocIIRFilterPtr before calling this cascade IIR filter design function.

Return Value

Name Type Description
status AnalysisLibErrType A value that specifies the type of error that occurred. Refer to analysis.h for definitions of these constants.