dsp.BiquadFilter

(To be removed) IIR filter using biquadratic structures

The dsp.BiquadFilter object will be removed in a future release. Use the dsp.SOSFilter object instead. For more information on updating your code, see Version History.

Description

The dsp.BiquadFilter object implements a cascade of biquadratic sections, where the coefficients for each section are supplied by a separate row of an N-by-6 second-order sections (SOS) matrix. Each row of the SOS matrix contains the numerator and denominator coefficients of the corresponding section of the filter. The resulting filter can be applied to a vector or matrix input, where each column represents a channel of data that is processed independently.

To implement an IIR filter structure using biquadratic or SOS:

1. Create the dsp.BiquadFilter object and set its properties.

2. Call the object with arguments, as if it were a function.

To learn more about how System objects work, see What Are System Objects?

Creation

Syntax

biquad = dsp.BiquadFilter

biquad = dsp.BiquadFilter(sosmatrix,scalevalues)

biquad = dsp.BiquadFilter(Name,Value)

Description

biquad = dsp.BiquadFilter returns a biquadratic IIR (SOS) filter System object™, biquad, which independently filters each channel (column) of the input over time using the SOS section [1 0.3 0.4 1 0.1 0.2] with a direct-form II transposed structure.

biquad = dsp.BiquadFilter(sosmatrix,scalevalues) returns a biquadratic filter object, with the SOSMatrix property set to sosmatrix and the ScaleValues property set to scalevalues.

biquad = dsp.BiquadFilter(Name,Value) returns a biquadratic filter object, biquad, with each property set to the specified value.

Properties

Unless otherwise indicated, properties are nontunable, which means you cannot change their values after calling the object. Objects lock when you call them, and the release function unlocks them.

If a property is tunable, you can change its value at any time.

For more information on changing property values, see System Design in MATLAB Using System Objects.

Structure — Filter structure

'Direct form II transposed' (default) | 'Direct form I' | 'Direct form I transposed' | 'Direct form II'

Specify the filter structure as 'Direct form I', 'Direct form I transposed', 'Direct form II', 'Direct form II transposed'.

SOSMatrixSource — SOS matrix source

'Property' (default) | 'Input port'

Specify the source of the SOS matrix as 'Property' or 'Input port'.

SOSMatrix — SOS matrix

[1 0.3 0.4 1 0.1 0.2] (default) | N-by-6 matrix

Specify the second-order section (SOS) matrix as an N-by-6 matrix, where N is the number of sections in the filter. Each row of the SOS matrix contains the numerator and denominator coefficients of the corresponding section of the filter. The system function, H(z), of a biquad filter is:

$$H(z)=\frac{{\displaystyle \sum _{k=0}^2{b}_k}{z}^{-k}}{1-{\displaystyle \sum _{l=1}^2{a}_l}{z}^{-l}}$$

The coefficients are ordered in the rows of the SOS matrix as (b₀, b_1,b_2,1, –a₁, –a₂). You can use coefficients of real or complex values. This property applies only when you set the SOSMatrixSource property to Property. The leading denominator coefficient of the biquad filter, a₀, equals 1 for each filter section, regardless of the specified value.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fi

ScaleValues — Scale values for each biquad section

1 (default) | scalar | vector

Specify the scale values to apply before and after each section of a biquad filter. ScaleValues must be either a scalar or a vector of length N+1, where N is the number of sections. If you set this property to a scalar, the scalar value is used as the gain value only before the first filter section. The remaining gain values are set to 1. If you set this property to a vector of N+1values, each value is used for a separate section of the filter.

Dependencies

This property applies only when you set the SOSMatrixSource property to Property.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

InitialConditions — Initial conditions for direct form II structures

0 (default) | scalar | vector | matrix

Specify the initial conditions of the filter states when the Structure property is one of | Direct form II | Direct form II transposed |. The number of states or delay elements (zeros and poles) in a direct-form II biquad filter equals twice the number of filter sections. You can specify the initial conditions as a scalar, vector, or matrix.

When you specify a scalar value, the biquad filter initializes all delay elements in the filter to that value. When you specify a vector of length equal to the number of delay elements in the filter, each vector element specifies a unique initial condition for the corresponding delay element.

The biquad filter applies the same vector of initial conditions to each channel of the input signal. When you specify a vector of length equal to the product of the number of input channels and the number of delay elements in the filter, each element specifies a unique initial condition for the corresponding delay element in the corresponding channel. When you specify a matrix with the same number of rows as the number of delay elements in the filter, and one column for each channel of the input signal, each element specifies a unique initial condition for the corresponding delay element in the corresponding channel.

Dependencies

This property applies only when you set the Structure property to one of Direct form II or Direct form II transposed.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

NumeratorInitialConditions — Initial conditions on zeros side

0 (default) | scalar | vector | matrix

Specify the initial conditions of the filter states on the side of the filter structure with the zeros. The number of states or delay elements in the numerator of a direct-form I biquad filter equals twice the number of filter sections. You can specify the initial conditions as a scalar, vector, or matrix. When you specify a scalar, the biquad filter initializes all delay elements on the zeros side in the filter to that value. When you specify a vector of length equal to the number of delay elements on the zeros side in the filter, each vector element specifies a unique initial condition for the corresponding delay element on the zeros side.

The biquad filter applies the same vector of initial conditions to each channel of the input signal. When you specify a vector of length equal to the product of the number of input channels and the number of delay elements on the zeros side in the filter, each element specifies a unique initial condition for the corresponding delay element on the zeros side in the corresponding channel. When you specify a matrix with the same number of rows as the number of delay elements on the zeros side in the filter, and one column for each channel of the input signal, each element specifies a unique initial condition for the corresponding delay element on the zeros side in the corresponding channel.

Dependencies

This property applies only when you set the Structure property to one of Direct form I or Direct form I transposed.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

DenominatorInitialConditions — Initial conditions on poles side

0 (default) | scalar | vector | matrix

Specify the initial conditions of the filter states on the side of the filter structure with the poles. The number of denominator states, or delay elements, in a direct-form I (noncanonic) biquad filter equals twice the number of filter sections. You can specify the initial conditions as a scalar, vector, or matrix. When you specify a scalar, the biquad filter initializes all delay elements on the poles side of the filter to that value. When you specify a vector of length equal to the number of delay elements on the poles side in the filter, each vector element specifies a unique initial condition for the corresponding delay element on the poles side.

The object applies the same vector of initial conditions to each channel of the input signal. When you specify a vector of length equal to the product of the number of input channels and the number of delay elements on the poles side in the filter, each element specifies a unique initial condition for the corresponding delay element on the poles side in the corresponding channel. When you specify a matrix with the same number of rows as the number of delay elements on the poles side in the filter, and one column for each channel of the input signal, each element specifies a unique initial condition for the corresponding delay element on the poles side in the corresponding channel.

Dependencies

This property only applies when you set the Structure property to one of Direct form I or Direct form I transposed.

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

OptimizeUnityScaleValues — Optimize unity scale values

true (default) | false

When this Boolean property is set to true, the biquad filter removes all unity scale gain computations. This reduces the number of computations and increases the fixed-point accuracy.

Dependencies

This property applies only when you set the SOSMatrixSource property to Property.

ScaleValuesInputPort — How to specify scale values

true (default) | false

Select how to specify scale values. By default, this property is true, and the scale values are specified via the input port. When this property is false, all scale values are 1.

Dependencies

This property applies only when the SOSMatrixSource property is Input port.

Fixed-Point Properties

RoundingMethod — Rounding method for fixed-point operations

Floor (default) | Ceiling | Convergent | Nearest | Round | Simplest | Zero

Specify the rounding method.

OverflowAction — Overflow action for fixed-point operations

Wrap (default) | Saturate

Specify the overflow action as one of Wrap or Saturate.

MultiplicandDataType — Multiplicand word and fraction lengths

Same as output (default) | Custom

Specify the multiplicand fixed-point data type as one of Same as output or Custom.

Dependencies

This property applies only when you set the Structure property to Direct form I transposed.

CustomMultiplicandDataType — Custom multiplicand word and fraction lengths

numerictype([],32,30) (default) | numerictype

Specify the multiplicand fixed-point type as a scaled numerictype (Fixed-Point Designer) object with a Signedness of Auto.

Dependencies

This property applies only when you set the MultiplicandDataType property to Custom.

SectionInputDataType — Section input word and fraction lengths

Same as input (default) | Custom

Specify the section input fixed-point data type as either Same as input or Custom.

CustomSectionInputDataType — Custom section input word and fraction lengths

numerictype([],16,15) (default) | numerictype

Specify the section input fixed-point type as a scaled numerictype (Fixed-Point Designer) object with a Signedness of Auto.

Dependencies

This property applies only when you set the SectionInputDataType property to Custom.

SectionOutputDataType — Section output word and fraction lengths

Same as section input (default) | Custom

Specify the section output fixed-point data type as either Same as section input or Custom.

CustomSectionOutputDataType — Custom section output word and fraction lengths

numerictype([],16,15) (default) | numerictype

Specify the section output fixed-point type as a signed, scaled numerictype (Fixed-Point Designer) object with a Signedness of Auto.

Dependencies

This property applies only when you set the SectionOutputDataType property to Custom.

NumeratorCoefficientsDataType — Numerator coefficients word and fraction lengths

Same word length as input (default) | Custom

Specify the numerator coefficients fixed-point data type as Same word length as input or Custom. Setting this property also sets the DenominatorCoefficientsDataType and ScaleValuesDataType properties to the same value.

Dependencies

This property applies only when you set the SOSMatrixSource property to Property.

CustomNumeratorCoefficientsDataType — Custom numerator coefficients word and fraction lengths

numerictype([],16,15) (default) | numerictype

Specify the numerator coefficients fixed-point type as a numerictype (Fixed-Point Designer) object with a Signedness of Auto. The word length of the CustomNumeratorCoefficientsDataType, CustomDenominatorCoefficientsDataType, and CustomScaleValuesDataType properties must be the same.

Dependencies

This property applies only when you set the SOSMatrixSource property to Property and the NumeratorCoefficientsDataType property to Custom.

DenominatorCoefficientsDataType — Denominator coefficients word and fraction lengths

Same word length as input (default) | Custom

Specify the denominator coefficients fixed-point data type as Same word length as input or Custom. Setting this property also sets the NumeratorCoefficientsDataType and ScaleValuesDataType properties to the same value.

Dependencies

This property applies only when you set the SOSMatrixSource property to Property.

CustomDenominatorCoefficientsDataType — Custom denominator coefficients word and fraction lengths

numerictype([],16,15) (default) | numerictype

Specify the denominator coefficients fixed-point type as a numerictype (Fixed-Point Designer) object with a Signedness of Auto. The CustomNumeratorCoefficientsDataType, CustomDenominatorCoefficientsDataType, and CustomScaleValuesDataType properties must have the same word lengths.

Dependencies

This property applies only when you set the SOSMatrixSource property to Property and the DenominatorCoefficientsDataType property to Custom.

ScaleValuesDataType — Scale values word and fraction lengths

Same word length as input (default) | Custom

Specify the scale values fixed-point data type as Same word length as input or Custom. Setting this property also sets the NumeratorCoefficientsDataType and DenominatorCoefficientsDataType properties to the same value.

Dependencies

This property applies only when you set the SOSMatrixSource property to Property.

CustomScaleValuesDataType — Custom scale values word and fraction lengths

numerictype([],16,15) (default) | numerictype

Specify the scale values fixed-point type as a numerictype (Fixed-Point Designer) object with a Signedness of Auto. The CustomNumeratorCoefficientsDataType, CustomDenominatorCoefficientsDataType, and CustomScaleValuesDataType properties must have the same word lengths.

Dependencies

This property applies only when you set the SOSMatrixSource property to Property and the ScaleValuesDataType property to Custom.

NumeratorProductDataType — Numerator product word and fraction lengths

Same as input (default) | Custom | Full precision

Specify the mode to determine the numerator product fixed-point data type as:

• Same as input (default) — The numerator product word and fraction lengths are same as that of the input.

• Custom — Enables the CustomNumeratorProductDataType property, which you can use to specify the custom numerator product data type. Specify the data type as a numerictype object.

• Full precision — Use full-precision rules to specify the data type. These rules provide the most accurate fixed-point numerics. The rules prevent quantization from occurring within the object. Bits are added, as needed, so that no roundoff or overflow occurs. For more information, see Full Precision for Fixed-Point System Objects.

Setting this property also sets the DenominatorProductDataType property to the same value.

CustomNumeratorProductDataType — Custom numerator product word and fraction lengths

numerictype([],32,30) (default) | numerictype

Specify the product fixed-point type as a scaled numerictype (Fixed-Point Designer) object with a Signedness of Auto. The CustomNumeratorProductDataType and CustomDenominatorProductDataType properties must have the same word lengths.

Dependencies

This property applies only when you set the NumeratorProductDataType property to Custom.

DenominatorProductDataType — Denominator product word and fraction lengths

Same as input (default) | Custom | Full precision

Specify the mode to determine the denominator product fixed-point data type as:

• Same as input (default) — The denominator product word and fraction lengths are same as that of the input.

• Custom — Enables the CustomDenominatorProductDataType property, which you can use to specify the custom denominator product data type. Specify the data type as a numerictype object.

• Full precision — Use full-precision rules to specify the data type. These rules provide the most accurate fixed-point numerics. The rules prevent quantization from occurring within the object. Bits are added, as needed, so that no roundoff or overflow occurs. For more information, see Full Precision for Fixed-Point System Objects.

Setting this property also sets the NumeratorProductDataType property to the same value.

CustomDenominatorProductDataType — Custom denominator product word and fraction lengths

numerictype([],32,30) (default) | numerictype

Specify the product fixed-point type as a scaled numerictype (Fixed-Point Designer) object with a Signedness of Auto. The CustomNumeratorProductDataType and CustomDenominatorProductDataType properties must have the same word lengths.

Dependencies

This property applies only when you set the DenominatorProductDataType to Custom.

NumeratorAccumulatorDataType — Numerator accumulator word and fraction lengths

Same as product (default) | Same as input | Custom

Specify the numerator accumulator fixed-point data type as Same as input, Same as product, or Custom. Setting this property also sets the DenominatorAccumulatorDataType property to the same value.

CustomNumeratorAccumulatorDataType — Custom numerator accumulator word and fraction lengths

numerictype([],32,30) (default) | numerictype

Specify the numerator accumulator fixed-point type as a scaled numerictype (Fixed-Point Designer) object with a Signedness of Auto. The CustomNumeratorAccumulatorDataType and CustomDenominatorAccumulatorDataType properties must have the same word lengths.

Dependencies

This property applies only when you set the NumeratorAccumulatorDataType property to Custom.

DenominatorAccumulatorDataType — Denominator accumulator word and fraction lengths

Same as product (default) | Same as input | Custom

Specify the denominator accumulator fixed-point data type as Same as input, Same as product, or Custom. Setting this property also sets the NumeratorAccumulatorDataType property to the same value.

CustomDenominatorAccumulatorDataType — Custom denominator accumulator word and fraction lengths

numerictype([],32,30) (default) | numerictype

Specify the denominator accumulator fixed-point type as a scaled numerictype (Fixed-Point Designer) object with a Signedness of Auto. The CustomNumeratorAccumulatorDataType and CustomDenominatorAccumulatorDataType properties must have the same word lengths.

Dependencies

This property applies only when you set the DenominatorAccumulatorDataType property to Custom.

StateDataType — State word and fraction lengths

Same as accumulator (default) | Same as input | Custom

Specify the state fixed-point data type as Same as input, Same as accumulator, or Custom.

Dependencies

This property applies when you set the Structure property to Direct form II or Direct form II transposed.

CustomStateDataType — Custom state word and fraction lengths

numerictype([],16,15) (default) | numerictype

Specify the state fixed-point type as a scaled numerictype (Fixed-Point Designer) object with a Signedness of Auto.

Dependencies

This property applies only when you set the StateDataType property to Custom.

NumeratorStateDataType — Numerator state word and fraction lengths

Same as accumulator (default) | Same as input | Custom

Specify the numerator state fixed-point data type as Same as input, Same as accumulator, or Custom. Setting this property also sets the DenominatorStateDataType property to the same value.

Dependencies

This property applies only when you set the Structure property to Direct form I transposed.

CustomNumeratorStateDataType — Custom numerator state word and fraction lengths

numerictype([],16,15) (default) | numerictype

Specify the numerator state fixed-point type as a scaled numerictype (Fixed-Point Designer) object with a Signedness of Auto. The CustomNumeratorProductDataType and CustomDenominatorProductDataType properties must have the same word lengths.

Dependencies

This property applies only when you set the StateDataType property to Custom.

DenominatorStateDataType — Denominator state word and fraction lengths

Same as accumulator (default) | Same as input | Custom

Specify the denominator state fixed-point data type as Same as input, Same as accumulator, or Custom. Setting this property also sets the NumeratorStateDataType property to the same value.

Dependencies

This property applies only when you set the Structure property to Direct form I transposed.

CustomDenominatorStateDataType — Custom denominator state word and fraction lengths

numerictype([],16,15) (default) | numerictype

Specify the denominator state fixed-point type as a scaled numerictype (Fixed-Point Designer) object with a Signedness of Auto. The CustomNumeratorStateDataType and CustomDenominatorStateDataType properties must have the same word lengths.

Dependencies

This property applies only when you set the StateDataType property to Custom.

OutputDataType — Output word and fraction lengths

Same as accumulator (default) | Same as input | Custom

Specify the output fixed-point data type as Same as input, Same as accumulator, or Custom.

CustomOutputDataType — Custom output word and fraction lengths

numerictype([],16,15) (default) | numerictype

Specify the output fixed-point type as a scaled numerictype (Fixed-Point Designer) object with a Signedness of Auto.

Dependencies

This property applies only when you set the OutputDataType property to Custom.

Usage

Syntax

y = biquad(x)

y = biquad(x,num,den)

y = biquad(x,num,den,g)

Description

y = biquad(x) filters the input signal x , and outputs the filtered values, y. The biquad filter object filters each channel of the input signal over successive calls to the algorithm.

y = biquad(x,num,den) filters the input using num as the numerator coefficients, and den as the denominator coefficients of the biquad filter. This configuration applies when the SOSMatrixSource property is Input port and the ScaleValuesInputPort property is false.

y = biquad(x,num,den,g) specifies the scale values, g, of the biquad filter. This configuration applies when the SOSMatrixSource property is Input Port and the ScaleValuesInputPort property is true.

Input Arguments

x — Data input

vector | matrix

Data input, specified as a vector or a matrix. This object also accepts variable-size inputs. Once the object is locked, you can change the size of each input channel, but you cannot change the number of channels.

The data type of all the inputs must be the same. If the input is fixed-point, it must be signed fixed point with power-of-two slope and zero bias.

The complexity of x, num, and den must be the same.

Data Types: single | double | int8 | int16 | int32 | int64 | fi
Complex Number Support: Yes

num — Numerator coefficients

3-by-N matrix

Numerator coefficients, specified as a 3-by-N numeric matrix, where N is the number of biquad filter sections. The complexity of x, num, and den must be the same.

The data type of all the inputs must be the same. If num is fixed point, it must be signed fixed point with power-of-two slope and zero bias.

Dependencies

This input applies only when you set SOSMatrixSource property is Input port.

Data Types: single | double | int8 | int16 | int32 | int64 | fi
Complex Number Support: Yes

den — Denominator coefficients

2-by-N matrix

Denominator coefficients, specified as a 2-by-N numeric matrix, where N is the number of biquad filter sections. The object assumes that the first denominator coefficient of each section is 1.

The data type of all the inputs must be the same. If den is fixed point, it must be signed fixed point with power-of-two slope and zero bias.

The complexity of x, num, and den must be the same.

Dependencies

This input applies only when you set SOSMatrixSource property is Input port.

Data Types: single | double | int8 | int16 | int32 | int64 | fi
Complex Number Support: Yes

g — Scale values

1-by-(N +1) vector

Scale values of the biquad filter, specified as a 1-by-(N +1) numeric vector, where N is the number of biquad filter sections.

The data type of all the inputs must be the same. If g is fixed point, it must be signed fixed point with power-of-two slope and zero bias.

Dependencies

This input applies when the SOSMatrixSource property is Input Port and the ScaleValuesInputPort property is true.

Data Types: single | double | int8 | int16 | int32 | int64 | fi

Output Arguments

y — Filtered output

vector | matrix

Filtered output, returned as a vector or a matrix. The size, data type, and complexity of the output signal matches that of the input signal.

Data Types: single | double | int8 | int16 | int32 | int64 | fi
Complex Number Support: Yes

Object Functions

To use an object function, specify the System object as the first input argument. For example, to release system resources of a System object named obj, use this syntax:

release(obj)

Specific to dsp.BiquadFilter

sos2ctf	Convert digital filter second-order section parameters to cascaded transfer function form
freqz	Frequency response of discrete-time filter System object
impz	Impulse response of discrete-time filter System object
info	Information about filter System object
coeffs	Returns the filter System object coefficients in a structure
cost	Estimate cost of implementing filter System object
scale	Scale second-order sections
scaleopts	Create an options object for second-order section scaling
scalecheck	Check scaling of biquadratic filter
cumsec	Cumulative second-order section of the biquadratic filter
generatehdl	Generate HDL code for quantized DSP filter (requires Filter Design HDL Coder) (To be removed)
tf	Convert discrete-time filter System object to transfer function
reorder	Reorder second-order sections of biquadratic filter System object
outputDelay	Determine output delay of single-rate or multirate filter

Common to All System Objects

step	Run System object algorithm
release	Release resources and allow changes to System object property values and input characteristics
reset	Reset internal states of System object

Examples

Filter a Signal Using Biquadratic Filter

Use a fourth order, lowpass biquadratic filter object with a normalized cutoff frequency of 0.4 to filter high frequencies from an input signal. Display the result as a power spectrum using the Spectrum Analyzer.

t = (0:1000)'/8e3;
% Input is 0.3 & 
% 3kHz sinusoids
xin = sin(2*pi*0.3e3*t)+sin(2*pi*3e3*t); 
                                       
src = dsp.SignalSource(xin, 100);
sink = dsp.SignalSink;
% Set up the filter
[z,p,k] = ellip(4,1,60,.4);   
[sosMatrix,scaleValues] = zp2sos(z,p,k);
biquad = dsp.BiquadFilter(sosMatrix,...
scaleValues,Structure="Direct form I"); 
 
sa = spectrumAnalyzer(SampleRate=8e3,...
    Method="welch",...
    PlotAsTwoSidedSpectrum=false,...
    OverlapPercent=80,SpectrumUnits="dBW",...
    YLimits=[-160 -10]);

while ~isDone(src)
     input = src();
     filteredOutput = biquad(input);
     sink(filteredOutput);
     sa(filteredOutput)
end

filteredResult = sink.Buffer;
fvtool(biquad,Fs=8000)

Linf-norm Scaling of a Biquadratic SOS Filter

Demonstrate the Linf-norm scaling of a biquadratic SOS filter using the scale function.

Fs = 8000; 
Fcutoff = 2000;
[z,p,k] = butter(10,Fcutoff/(Fs/2)); 
[sosMatrix,scaleValues] = zp2sos(z,p,k);
sosFilt = dsp.SOSFilter(Structure='Direct form I', ...
    Numerator=sosMatrix(:,1:3),Denominator=sosMatrix(:,4:6), ...
    HasScaleValues=true,ScaleValues=scaleValues)

sosFilt = 
  dsp.SOSFilter with properties:

            Structure: 'Direct form I'
    CoefficientSource: 'Property'
            Numerator: [5x3 double]
          Denominator: [5x3 double]
       HasScaleValues: true
          ScaleValues: [0.0029 1 1 1 1 1]

  Use get to show all properties

scale(sosFilt,'linf',scalevalueconstraint='none',maxscalevalue=2)

More About

Fixed Point

The following diagrams show the data types used in the dsp.BiquadFilter object when the input is fixed-point. For each filter structure the object supports, the data types shown in the diagrams can be set through the respective fixed-point properties of the object.

Direct Form I

The following diagram shows the data types for one section of the filter for fixed-point signals.

The following diagrams show the fixed-point data types between filter sections.

When the data is not optimized:

When you specify OptimizeUnityScaleValues to true, and scale values to 1:

Direct Form I Transposed

The following diagram shows the data types for one section of the filter for fixed-point signals.

The dashed casts are omitted when you specify OptimizeUnityScaleValues to true, and scale values to 1.

The following diagrams show the fixed-point data types between filter sections.

When the data is not optimized:

When you specify OptimizeUnityScaleValues to true, and scale values to 1:

Direct Form II

The following diagram shows the data types for one section of the filter for fixed-point signals.

The dashed casts are omitted when you specify OptimizeUnityScaleValues to true, and scale values to 1.

The following diagrams show the fixed-point data types between filter sections.

When the data is not optimized:

When you specify OptimizeUnityScaleValues to true, and scale values to 1:

Direct Form II Transposed

The following diagram shows the data types for one section of the filter for fixed-point signals.

The following diagrams show the fixed-point data types between filter sections.

When the data is not optimized:

When you specify OptimizeUnityScaleValues to true, and scale values to 1:

Algorithms

This object implements the algorithm, inputs, and outputs described on the Biquad Filter block reference page. The object properties correspond to the block parameters, except:

• Coefficient source

• Action when the a0 values of the SOS matrix are not one – the biquad filter object assumes the zero-th-order denominator coefficient equals 1 regardless of the specified value. The biquad filter object does not support the Error or Warn options found in the corresponding block.

Both this object and its corresponding block support variable-size input. When you call the object, it can handle an input argument which is changing in size.

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

See System Objects in MATLAB Code Generation (MATLAB Coder).

HDL Code Generation

Generate VHDL, Verilog and SystemVerilog code for FPGA and ASIC designs using HDL Coder™.

This object supports HDL code generation with the HDL Coder™ or Filter Design HDL Coder™ products. For HDL Coder workflows and limitations, see HDL Code Generation for System Objects (HDL Coder). For Filter Design HDL Coder workflows and limitations, see Generate HDL Code for Filter System Objects (Filter Design HDL Coder).

Version History

Introduced in R2012a

R2024b: dsp.BiquadFilter object warns

The dsp.BiquadFilter object issues a warning and it will be removed in a future release. Use the dsp.SOSFilter object instead.

Update Code

This table shows how to replace the dsp.BiquadFilter object with the dsp.SOSFilter object in a typical workflow.

Discouraged Usage	Recommended Replacement
[z,p,k] = ellip(4,1,60,0.4); [sosMatrix,scaleValues] = zp2sos(z,p,k); biquad = dsp.BiquadFilter(... SOSMatrix = sosMatrix,... ScaleValues = scaleValues,... Structure = "Direct form I");	[z,p,k] = ellip(4,1,60,0.4); [sosMatrix,scaleValues] = zp2sos(z,p,k); [num,den] = sos2ctf(sosMatrix); sosFilter = dsp.SOSFilter(num,den,... ScaleValues=scaleValues,... Structure="Direct form I");
[num,den] = designLowpassIIR(FilterOrder=20); x = randn(1000,1); biquad = dsp.BiquadFilter(... SOSMatrixSource="Input port",... Structure = "Direct form I",... ScaleValuesInputPort = false); Transpose the numerator coefficients array designed by the designLowpassIIR function before passing it to the dsp.BiquadFilter object. num_biquad = num.'; Remove the first column in the denominator coefficients array and transpose the remaining elements before passing the array to the dsp.BiquadFilter object. den_biquad = den(:,2:end).'; y = biquad(x,num_biquad,den_biquad);	[num,den] = designLowpassIIR(FilterOrder=20); x = randn(1000,1); sosFilter = dsp.SOSFilter(... CoefficientSource="Input port",... Structure = "Direct form I"); y = sosFilter(x,num,den);

HDL Code Generation Support

For a replacement IIR filter that supports HDL code generation, use the dsphdl.BiquadFilter (DSP HDL Toolbox) object and generate code using HDL Coder tools.

Instead of specifying the SOS matrix, specify filter coefficients as Numerator and Denominator matrices. The object provides these hardware-optimized architecture options:

• 'Direct form II' and 'Direct form II transposed' architectures are pipelined and quantized to fit well into FPGA DSP blocks.

• 'Pipelined feedback form' implements a pipelined architecture that uses more multipliers than either direct form II structure, but achieves higher clock rates after synthesis.

• 'Direct form I fully serial' implements a fully serial architecture that uses only one multiplier.

For an example, see Generate HDL Code for IIR Filter (DSP HDL Toolbox).

R2023b: dsp.BiquadFilter object will be removed

The dsp.BiquadFilter object will be removed in a future release. Use the dsp.SOSFilter object instead.