CoefficientBiquad

The CoefficientBiquad audio object accepts biquad filter coefficients via its tuning interface and then filters signals accordingly. This audio object also adjusts the input audio buffers based on the bi-quadratic filter coefficients provided into it via tuning and stores the resulting audio in the output buffers.

Use Case: This object can be deployed whenever a user wants to filter a signal based on user specified coefficients.

CoefficientBiquad Properties

Below table describes about the CoefficientBiquad audio object properties and functionality.

A screenshot of a computer Description automatically generated

Properties Description
# of Channels The object has a configurable number of channels. The number of audio inputs is always equal to the number of audio outputs.

  • The maximum allowed number of channels is 64.
  • By default, the number of channels is set to 1.
Number of biquads The number of elements generally describes the number of filters requested by the user. This value is configurable between 1 and a 100 and is by default set to 1.
Display Name Display the name of the Adder audio object in signal flow design. It can be changed based on the intended usage of the object.

Mode

There are no mode available for CoefficientBiquad audio object.

Additional Parameters

Parameters Description
Biquad Topology Allows to choose the filter topology at design time.

  • Direct Form I (DFI)
  • Direct Form II (DFII)
  • Transposed Direct Form II (TDFII)

By default, it is configured for DFII.

A screenshot of a computer Description automatically generated
Coefficient Type Allows to configurable object variable that indicates whether the filter coefficients are shared across all channels or not.

  • 0 = Coefficient (each channel has its own set of filter coefficients)

In this layout, the filter coefficients are unique per channel. The number of filters selected above would apply per channel in this layout. If the number of filters above is selected to be two, then two unique biquad sets of coefficients will be applied across each channel.

  • 1 = Coefficient one (all channels use same set of filter/filter coefficients)

This layout will share a set of filter coefficients across all channels. If the number of filters above is selected to be two, then the same two biquad sets of coefficients will be applied across all channels.

By default, it is configured for Coefficient.

A screenshot of a computer Description automatically generated

Tuning Parameters

This object does not support state and control interfaces; it only supports a tuning interface.
The five values below represent filter coefficients per biquad. Coefficient Layout exposes five values per biquad per channel, whereas Coefficient One Layout exposes one set of coefficients per biquad, and these are shared across all channels.

Parameter Description Type Unit Range Default Value Memory Offset
 b0 Biquad coefficient float None 1 f * 5 * 4 + 0
b1 Biquad coefficient float None 0 f * 5 * 4 + 4
b2 Biquad coefficient float None 0 f * 5 * 4 + 8
 – a2 Biquad coefficient float None 0 f * 5 * 4 + 12
– a2 Biquad coefficient float None 0 f * 5 * 4 + 16

b are numerator coefficients and a is denominator. The coefficients are expected to be normalized (*1/a0). And a1 and a2 are expected to be negated before being passed in.

A math equation with numbers and symbols Description automatically generated with medium confidence

Control Interface

There are no control parameters available for CoefficientBiquad audio object.