Polyphase FIR interpolator
The FIRInterpolator object upsamples an input by the integer upsampling factor, L, followed by an FIR anti-imaging filter. The filter coefficients are scaled by the interpolation factor. A polyphase interpolation structure implements the filter. The resulting discrete-time signal has a sampling rate L times the original sampling rate.
To upsample an input:
H= dsp.FIRInterpolator returns an FIR interpolator, H, which upsamples an input signal by a factor of 3 and applies an FIR filter to interpolate the output.
H = dsp.FIRInterpolator('PropertyName',PropertyValue, ...) returns an FIR interpolator, H, with each property set to the specified value.
H = dsp.FIRInterpolator(INTERP, NUM,'PropertyName',PropertyValue, ...) returns an FIR interpolation object, H, with the InterpolationFactor property set to INTERP, the Numerator property set to NUM, and other properties set to the specified values.
Specify the integer factor, L, by which to increase the sampling rate of the input signal. The polyphase implementation uses L polyphase subfilters to compute convolutions at the lower sample rate. The FIR interpolator delays and interleaves these lower-rate convolutions to obtain the higher-rate output. The property value defaults to 3.
FIR filter coefficient source
Specify the source of the numerator coefficients as one of 'Property' (default) or 'Input port'.
FIR filter coefficients
Specify the numerator coefficients of the FIR anti-imaging filter as the coefficients of a polynomial in z–1. Indexing from zero, the filter coefficients are:
To act as an effective anti-imaging filter, the coefficients must correspond to a lowpass filter with a normalized cutoff frequency no greater than the reciprocal of the InterpolationFactor. The filter coefficients are scaled by the value of the InterpolationFactor property before filtering the signal. To form the L polyphase subfilters, Numerator is appended with zeros if necessary. The default is the output of fir1(15,0.25). This property is valid only when the NumeratorSource property is 'Property'.
|clone||Create FIR interpolator object with same property values|
|fvtool||Open filter visualization tool|
|getNumInputs||Number of expected inputs to step method|
|getNumOutputs||Number of outputs of step method|
|isLocked||Locked status for input attributes and nontunable properties|
|phasez||Unwrapped phase response|
|release||Allow property value and input characteristics changes|
|reset||Reset FIR interpolator filter states|
|step||Upsample and interpolate input|
Double the sampling rate of an audio signal from 22.05 kHz to 44.1 kHz, and play the audio:
hmfr = dsp.AudioFileReader('OutputDataType',... 'single'); hap = dsp.AudioPlayer(44100); hfirint = dsp.FIRInterpolator(2, ... firpm(30, [0 0.45 0.55 1], [1 1 0 0])); while ~isDone(hmfr) frame = step(hmfr); y = step(hfirint, frame); step(hap, y); end pause(1); release(hmfr); release(hap);
This object implements the algorithm, inputs, and outputs described on the FIR Interpolation block reference page. The object properties correspond to the block parameters, except:
The FIRInterpolator object does not have a property that corresponds to the Input processing parameter of the FIR Interpolation block.
The Rate options block parameter is not supported by the FIRInterpolator object.