Digital IIR Filter

Filters signals in either single or multiple waveforms. If you are filtering multiple waveforms, the VI maintains separate filter states for each waveform. You can use this polymorphic VI to filter signals in single or multiple waveforms, or to filter signals in multiple waveforms with multiple specifications. The data type you wire to the signal in input determines the polymorphic instance to use.

Note  Do not use the single-channel instance of this VI for continuous multiple-channel processing.

Details

IIR Filter for 1 Chan

reset filter forces the filter coefficients to be redesigned and the internal filter states to be reset to zero when it is TRUE.
signal in is the waveform data you want to filter for channel 1.
error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurs before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a non-zero error code. If status is FALSE, code is 0 or a warning code.
source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
IIR filter specifications is the cluster containing design parameters for an IIR filter.
Topology determines the design type of the filter.

0Off
1Butterworth
2Chebyshev
3Inverse Chebyshev
4Elliptic
5Bessel
Type specifies the passband of the filter according to the following values.

0Lowpass
1Highpass
2Bandpass
3Bandstop
Lower Fc is the low cutoff frequency and must observe the Nyquist criterion. The Nyquist criterion is 0< fl< 0.5fs, where fl is the cutoff frequency, and fs is the sampling frequency. If Lower cutoff frequency is less than zero or greater than half the sampling frequency, the VI sets the signal out waveform to be empty and returns an error. The default is 100.
PB Ripple must be greater than zero, and you must express it in decibels. If passband ripple is less than or equal to zero, the VI sets the Signal Out waveform to be empty and returns an error. The default is 1.0.
Order is the filter order. If Order <= 0 then the filter uses the Optional IIR Filter Specifications to compute the order.
Upper Fc is the high cutoff frequency. This parameter is ignored when Filter type is 0 (lowpass) or 1 (highpass).
SB Attenuation must be greater than zero, and you must express it in decibels. If stopband attenuation is less than or equal to zero, the VI sets the Signal Out waveform to be empty array and returns an error. stopband attenuation defaults to 60.0.
optional IIR filter specification is a cluster containing information necessary to compute the order of an IIR filter.
Lower PB is the lowest of the two passband frequencies. The default is 100Hz.
Upper PB is the highest of the two passband frequencies. The default is 0.
PB Gain is the gain at the passband frequencies. Gain may be specified in linear terms or dB. The default is -3dB.
Lower SB is the lowest of the two stopband frequencies. The default is 200Hz.
Upper SB is the highest of the two stopband frequencies. The default is 0.
SB Gain is the gain at the stopband frequencies. Gain may be specified in linear terms or dB. The default is -60dB.
Scale determines how the Passband and Stopband gain parameters are interpreted.
signal out is the generated waveform.
filter information contains the magnitude and phase responses of the filter in a cluster that is ready to be graphed and also the order of the filter.
order is the order of the IIR filter and must be greater than zero. The default is 2.0. If order is less than or equal to zero, the VI sets IIR Filter Cluster to an empty array and returns an error.
magnitude H(w) is the magnitude response of the filter. You can wire this cluster to a graph.
f0 is the start frequency of the magnitude response.
df is the spacing between elements of the magnitude response in Hertz.
Mag H(w) is an array of values containing the magnitude response of the filter.
phase H(w) is the phase response of the filter.
f0 is the start frequency of the phase response.
df is the spacing between elements of the magnitude response in Hertz.
Phase H(w) is an array of values containing the phase response of the filter.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a non-zero error code. If status is FALSE, code is 0 or a warning code.
source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

IIR Filter for N Chan

reset filter forces the filter coefficients to be redesigned and the internal filter states to be reset to zero when it is TRUE.
signal(s) in is an array of waveforms containing the signals to be filtered.
error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurs before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a non-zero error code. If status is FALSE, code is 0 or a warning code.
source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
IIR filter specifications is the cluster containing design parameters for an IIR filter.
Topology determines the design type of the filter.

0Off
1Butterworth
2Chebyshev
3Inverse Chebyshev
4Elliptic
5Bessel
Type specifies the passband of the filter according to the following values.

0Lowpass
1Highpass
2Bandpass
3Bandstop
Lower Fc is the low cutoff frequency and must observe the Nyquist criterion. The Nyquist criterion is 0< fl< 0.5fs, where fl is the cutoff frequency, and fs is the sampling frequency. If Lower cutoff frequency is less than zero or greater than half the sampling frequency, the VI sets the signal out waveform to be empty and returns an error. The default is 100.
PB Ripple must be greater than zero, and you must express it in decibels. If passband ripple is less than or equal to zero, the VI sets the Signal Out waveform to be empty and returns an error. The default is 1.0.
Order is the filter order. If Order <= 0 then the filter uses the Optional IIR Filter Specifications to compute the order.
Upper Fc is the high cutoff frequency. This parameter is ignored when Filter type is 0 (lowpass) or 1 (highpass).
SB Attenuation must be greater than zero, and you must express it in decibels. If stopband attenuation is less than or equal to zero, the VI sets the Signal Out waveform to be empty array and returns an error. stopband attenuation defaults to 60.0.
optional IIR filter specification is a cluster containing information necessary to compute the order of an IIR filter.
Lower PB is the lowest of the two passband frequencies. The default is 100Hz.
Upper PB is the highest of the two passband frequencies. The default is 0.
PB Gain is the gain at the passband frequencies. Gain may be specified in linear terms or dB. The default is -3dB.
Lower SB is the lowest of the two stopband frequencies. The default is 200Hz.
Upper SB is the highest of the two stopband frequencies. The default is 0.
SB Gain is the gain at the stopband frequencies. Gain may be specified in linear terms or dB. The default is -60dB.
Scale determines how the Passband and Stopband gain parameters are interpreted.
signal(s) out is an array of signals that have been filtered according to the filter specifications controls.
filter information contains the magnitude and phase responses of the filter in a cluster that is ready to be graphed and also the order of the filter.
order is the order of the IIR filter and must be greater than zero. The default is 2.0. If order is less than or equal to zero, the VI sets IIR Filter Cluster to an empty array and returns an error.
magnitude H(w) is the magnitude response of the filter. You can wire this cluster to a graph.
f0 is the start frequency of the magnitude response.
df is the spacing between elements of the magnitude response in Hertz.
Mag H(w) is an array of values containing the magnitude response of the filter.
phase H(w) is the phase response of the filter.
f0 is the start frequency of the phase response.
df is the spacing between elements of the magnitude response in Hertz.
Phase H(w) is an array of values containing the phase response of the filter.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a non-zero error code. If status is FALSE, code is 0 or a warning code.
source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

IIR Filter by N Specs for N Chan

reset filter forces the filter coefficients to be redesigned and the internal filter states to be reset to zero when it is TRUE.
signal(s) in is an array of waveforms containing the signals to be filtered.
error in describes error conditions that occur before this VI or function runs. The default is no error. If an error occurred before this VI or function runs, the VI or function passes the error in value to error out. This VI or function runs normally only if no error occurs before this VI or function runs. If an error occurs while this VI or function runs, it runs normally and sets its own error status in error out. Use the Simple Error Handler or General Error Handler VIs to display the description of the error code. Use error in and error out to check errors and to specify execution order by wiring error out from one node to error in of the next node.
status is TRUE (X) if an error occurred before this VI or function ran or FALSE (checkmark) to indicate a warning or that no error occurred before this VI or function ran. The default is FALSE.
code is the error or warning code. The default is 0. If status is TRUE, code is a non-zero error code. If status is FALSE, code is 0 or a warning code.
source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning. The default is an empty string.
IIR filter specifications is an array of filter parameters. The size of this array must be the same as the number of waveforms in the signal(s) in array. The default is an empty array.
IIR filter specifications is the cluster containing design parameters for an IIR filter.
Topology determines the design type of the filter.

0Off
1Butterworth
2Chebyshev
3Inverse Chebyshev
4Elliptic
5Bessel
Type specifies the passband of the filter according to the following values.

0Lowpass
1Highpass
2Bandpass
3Bandstop
Lower Fc is the low cutoff frequency and must observe the Nyquist criterion. The Nyquist criterion is 0< fl< 0.5fs, where fl is the cutoff frequency, and fs is the sampling frequency. If Lower cutoff frequency is less than zero or greater than half the sampling frequency, the VI sets the signal out waveform to be empty and returns an error. The default is 100.
PB Ripple must be greater than zero, and you must express it in decibels. If passband ripple is less than or equal to zero, the VI sets the Signal Out waveform to be empty and returns an error. The default is 1.0.
Order is the filter order. If Order <= 0 then the filter uses the Optional IIR Filter Specifications to compute the order.
Upper Fc is the high cutoff frequency. This parameter is ignored when Filter type is 0 (lowpass) or 1 (highpass).
SB Attenuation must be greater than zero, and you must express it in decibels. If stopband attenuation is less than or equal to zero, the VI sets the Signal Out waveform to be empty array and returns an error. stopband attenuation defaults to 60.0.
optional IIR filter specifications is an array of additional filter parameters. This array must either be empty or must have the same size as the IIR filter specifications array.
optional IIR filter specification is a cluster containing information necessary to compute the order of an IIR filter.
Lower PB is the lowest of the two passband frequencies. The default is 100Hz.
Upper PB is the highest of the two passband frequencies. The default is 0.
PB Gain is the gain at the passband frequencies. Gain may be specified in linear terms or dB. The default is -3dB.
Lower SB is the lowest of the two stopband frequencies. The default is 200Hz.
Upper SB is the highest of the two stopband frequencies. The default is 0.
SB Gain is the gain at the stopband frequencies. Gain may be specified in linear terms or dB. The default is -60dB.
Scale determines how the Passband and Stopband gain parameters are interpreted.
signal(s) out is an array of signals that have been filtered according to the filter specifications controls.
filter information contains the magnitude and phase responses of the filter in a cluster that is ready to be graphed and also the order of the filter.
order is the order of the IIR filter and must be greater than zero. The default is 2.0. If order is less than or equal to zero, the VI sets IIR Filter Cluster to an empty array and returns an error.
magnitude H(w) is the magnitude response of the filter. You can wire this cluster to a graph.
f0 is the start frequency of the magnitude response.
df is the spacing between elements of the magnitude response in Hertz.
Mag H(w) is an array of values containing the magnitude response of the filter.
phase H(w) is the phase response of the filter.
f0 is the start frequency of the phase response.
df is the spacing between elements of the magnitude response in Hertz.
Phase H(w) is an array of values containing the phase response of the filter.
error out contains error information. If error in indicates that an error occurred before this VI or function ran, error out contains the same error information. Otherwise, it describes the error status that this VI or function produces. Right-click the error out indicator on the front panel and select Explain Error from the shortcut menu for more information about the error.
status is TRUE (X) if an error occurred or FALSE (checkmark) to indicate a warning or that no error occurred.
code is the error or warning code. If status is TRUE, code is a non-zero error code. If status is FALSE, code is 0 or a warning code.
source describes the origin of the error or warning and is, in most cases, the name of the VI or function that produced the error or warning.

Digital IIR Filter Details

Digital IIR Filter filters the signal(s) in a waveform array according to the IIR filter specifications and optional IIR filter specifications arrays. If you are filtering multiple waveforms, the VI applies a different filter to each of the input waveforms and maintains a separate filter state for each waveform. The VI uses optional IIR filter specifications only if Filter Order is less than or equal to zero. You do not need to wire reset filter. This VI resets itself the first time it is called.

The Digital IIR Filter VI can perform single-channel measurements in both one-shot mode (single call) and continuous mode (multiple calls with history). It can perform multichannel measurements only in one-shot mode. If you want to make multiple-channel measurements in continuous mode, either use the multi-channel instance of this VI or use one instance of this VI per channel.

The single-channel instance of this VI is primarily intended for continuous processing of a single channel. Do not generalize this behavior to the multi-channel case, typically by using this single-channel VI in a for loop to continuously process multiple channels by indexing an array of waveforms.

The single-channel instance of this VI maintains internal state information for a single channel only. Calling this VI to process another channel without clearing the history using the reset control or the restart averaging control results in an unexpected behavior of this VI because the internal state information is passed from one channel to another.