Wind_BSF
Advanced Analysis Library Only
AnalysisLibErrType Wind_BSF (double samplingFrequency, double lowerCutoffFreq, double upperCutoffFreq, int numberOfCoef, double coefficientArray[], int windowType);
Purpose
 |
Note This function has been superseded by WindFIR_Filter. |
Designs a digital bandstop FIR linear phase filter using a windowing technique. Five windows are available. Wind_BSF generates only the filter coefficients; it does not actually perform data filtering.
The attenuation value determines the approximate peak value of the sidelobes. Transition bandwidth determines a frequency range over which the filter response changes from the pass band to the stop band or from the stop band to the pass band. For more information, refer to Discrete-Time Signal Processing by Oppenheim and Schafer, cited in the Bibliography.
Example Code
/* Design a 55-point bandstop FIR linear phase filter that can achieve at least a 44 dB attenuation and filter the incoming signal with the designed filter. */
double x[256], coef[55], y[310], fs, fl, fh;
n, m, windType;
fs = 1000.0; /* sampling frequency */
fl = 200.0; /* desired lower cutoff frequency */
fh = 300.0; /* desired higher cutoff frequency */
/* stop band is from 200.0 to 300.0 */
n = 55; /* filter length */
windType = 3; /* using Hanning window */
m = 256;
Wind_BSF (fs, fl, fh, n, coef, windType);
Convolve (coef, n, x, m, y); /* Convolve the filter with the signal. */
Parameters
| Input | ||||||||||||||||||||||||||
| Name | Type | Description | ||||||||||||||||||||||||
| samplingFrequency | double | Sampling frequency in Hertz. | ||||||||||||||||||||||||
| lowerCutoffFreq | double | Lower cutoff frequency in Hertz. | ||||||||||||||||||||||||
| upperCutoffFreq | double | Upper cutoff frequency in Hertz. | ||||||||||||||||||||||||
| numberOfCoef | int | Length of the window FIR filter. numberOfCoef must be odd for this filter. |
||||||||||||||||||||||||
| windowType | int | Window type. windowType selects one of the five windows as shown in the following table.
|
||||||||||||||||||||||||
| Output | ||||||||||||||||||||||||||
| Name | Type | Description | ||||||||||||||||||||||||
| coefficientArray | double [] | Calculated output window FIR filter coefficients. | ||||||||||||||||||||||||
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. |
Additional Information
Library: Advanced Analysis Library
Include file: analysis.h
LabWindows/CVI compatibility: LabWindows/CVI 3.1 and later