Documentation |
Window-based finite impulse response filter design
b = fir1(n,Wn)
b = fir1(n,Wn,'ftype')
b = fir1(n,Wn,window)
b = fir1(n,Wn,'ftype',window)
b = fir1(...,'normalization')
fir1 implements the classical method of windowed linear-phase FIR digital filter design [1]. It designs filters in standard lowpass, highpass, bandpass, and bandstop configurations. By default the filter is normalized so that the magnitude response of the filter at the center frequency of the passband is 0 dB.
Note Use fir2 for windowed filters with arbitrary frequency response. |
b = fir1(n,Wn) returns row vector b containing the n+1 coefficients of an order n lowpass FIR filter. This is a Hamming-window based, linear-phase filter with normalized cutoff frequency Wn. The output filter coefficients, b, are ordered in descending powers of z.
$$B(z)=b(1)+b(2){z}^{-1}+\dots +b(n+1){z}^{-N}$$
Wn is a number between 0 and 1, where 1 corresponds to the Nyquist frequency.
If Wn is a two-element vector, Wn = [w1 w2], fir1 returns a bandpass filter with passband w1 < ω< w2.
If Wn is a multi-element vector, Wn = [w1 w2 w3 w4 w5 ... wn], fir1 returns an order n multiband filter with bands 0 < ω< w1, w1 < ω< w2, ..., wn < ω< 1.
By default, the filter is scaled so that the center of the first passband has a magnitude of exactly 1 after windowing.
b = fir1(n,Wn,'ftype') specifies a filter type, where 'ftype' is:
'high' for a highpass filter with cutoff frequency Wn.
'stop' for a bandstop filter, if Wn = [w1 w2]. The stopband frequency range is specified by this interval.
'DC-1' to make the first band of a multiband filter a passband.
'DC-0' to make the first band of a multiband filter a stopband.
fir1 always uses an even filter order for the highpass and bandstop configurations. This is because for odd orders, the frequency response at the Nyquist frequency is 0, which is inappropriate for highpass and bandstop filters. If you specify an odd-valued n, fir1 increments it by 1.
b = fir1(n,Wn,window) uses the window specified in column vector window for the design. The vector window must be n+1 elements long. If no window is specified, fir1 uses a Hamming window (see hamming) of length n+1.
b = fir1(n,Wn,'ftype',window) accepts both 'ftype' and window parameters.
b = fir1(...,'normalization') specifies whether or not the filter magnitude is normalized. The string 'normalization' can be the following:
'scale' (default): Normalize the filter so that the magnitude response of the filter at the center frequency of the passband is 0 dB.
'noscale': Do not normalize the filter.
The group delay of the FIR filter designed by fir1 is n/2.