Elliptic Filter VI

Owning Palette: Filters VIs

Requires: Full Development System

Generates a digital elliptic filter by calling the Elliptic Coefficients VI. Wire data to the X input to determine the polymorphic instance to use or manually select the instance.

Details  Example

Use the pull-down menu to select an instance of this VI.

 Add to the block diagram  Find on the palette

Elliptic Filter (DBL)

filter type specifies the passband of the filter.

0Lowpass
1Highpass
2Bandpass
3Bandstop
passband ripple is the ripple in the passband. passband ripple must be greater than 0 and expressed in decibels. The default is 1.0. If passband ripple is less than or equal to 0, the VI sets the output filter data to an empty array and returns an error.
X is the input signal to filter.
sampling freq: fs is the frequency in Hz at which you want to sample X and must be greater than 0. The default is 1.0 Hz. If sampling freq: fs is less than or equal to 0, this VI sets Filtered X to an empty array and returns an error.
high cutoff freq: fh is the high cutoff frequency in Hz. The default is 0.45 Hz. The VI ignores this parameter when filter type is 0 (Lowpass) or 1 (Highpass). When filter type is 2 (Bandpass) or 3 (Bandstop), high cutoff freq: fh must be greater than low cutoff freq: fl and observe the Nyquist criterion.
low cutoff freq: fl is the low cutoff frequency in Hz and must observe the Nyquist criterion. The default is 0.125 Hz. If low cutoff freq: fl is less than or equal to 0 or greater than half the value of sampling freq: fs, the VI sets Filtered X to an empty array and returns an error. When filter type is 2 (Bandpass) or 3 (Bandstop), low cutoff freq: fl must be less than high cutoff freq: fh.
stopband attenuation is the attenuation in the stopband. stopband attenuation must be greater than 0 and expressed in decibels. The default is 60.0. If stopband attenuation is less than or equal to 0, the VI sets Filtered X to an empty array and returns an error.
Note  If the filter order is high, this VI uses a higher attenuation than the value of stopband attenuation to design the filter.
order is the order of the IIR filter and must be greater than 0. The default is 2.0. If order is less than or equal to 0, the VI sets Filtered X to an empty array and returns an error.
init/cont controls the initialization of the internal states. The default is FALSE. The first time this VI runs or if init/cont is FALSE, LabVIEW initializes the internal states to 0. If init/cont is TRUE, LabVIEW initializes the internal states to the final states from the previous call to this instance of this VI. To process a large data sequence that consists of smaller blocks, set this input to FALSE for the first block and to TRUE for continuous filtering of all remaining blocks.
Filtered X is the output array of filtered samples.
error returns any error or warning from the VI. You can wire error to the Error Cluster From Error Code VI to convert the error code or warning into an error cluster.

Elliptic Filter (CDB)

filter type specifies the passband of the filter.

0Lowpass
1Highpass
2Bandpass
3Bandstop
passband ripple is the ripple in the passband. passband ripple must be greater than 0 and expressed in decibels. The default is 1.0. If passband ripple is less than or equal to 0, the VI sets the output filter data to an empty array and returns an error.
X is the input signal to filter.
sampling freq: fs is the frequency in Hz at which you want to sample X and must be greater than 0. The default is 1.0 Hz. If sampling freq: fs is less than or equal to 0, this VI sets Filtered X to an empty array and returns an error.
high cutoff freq: fh is the high cutoff frequency in Hz. The default is 0.45 Hz. The VI ignores this parameter when filter type is 0 (Lowpass) or 1 (Highpass). When filter type is 2 (Bandpass) or 3 (Bandstop), high cutoff freq: fh must be greater than low cutoff freq: fl and observe the Nyquist criterion.
low cutoff freq: fl is the low cutoff frequency in Hz and must observe the Nyquist criterion. The default is 0.125 Hz. If low cutoff freq: fl is less than or equal to 0 or greater than half the value of sampling freq: fs, the VI sets Filtered X to an empty array and returns an error. When filter type is 2 (Bandpass) or 3 (Bandstop), low cutoff freq: fl must be less than high cutoff freq: fh.
stopband attenuation is the attenuation in the stopband. stopband attenuation must be greater than 0 and expressed in decibels. The default is 60.0. If stopband attenuation is less than or equal to 0, the VI sets Filtered X to an empty array and returns an error.
Note  If the filter order is high, this VI uses a higher attenuation than the value of stopband attenuation to design the filter.
order is the order of the IIR filter and must be greater than 0. The default is 2.0. If order is less than or equal to 0, the VI sets Filtered X to an empty array and returns an error.
init/cont controls the initialization of the internal states. The default is FALSE. The first time this VI runs or if init/cont is FALSE, LabVIEW initializes the internal states to 0. If init/cont is TRUE, LabVIEW initializes the internal states to the final states from the previous call to this instance of this VI. To process a large data sequence that consists of smaller blocks, set this input to FALSE for the first block and to TRUE for continuous filtering of all remaining blocks.
Filtered X is the output array of filtered samples.
error returns any error or warning from the VI. You can wire error to the Error Cluster From Error Code VI to convert the error code or warning into an error cluster.

Elliptic Filter Details

After calling the Elliptic Coefficients VI, the Elliptic Filter VI calls the IIR Cascade Filter VI to obtain an elliptic Filtered X sequence.

The values for high cutoff freq: fh and low cutoff freq: fl must observe the following relationship:

0 < f1 < f2 < 0.5fs

where f1 is low cutoff freq: fl, f2 is high cutoff freq: fh, and fs is sampling freq: fs.

Example

Refer to the IIR Filter Design VI in the labview\examples\Signal Processing\Filters directory for an example of using the Elliptic Filter VI.

 Open example  Find related examples