The CoupledAllpassFilter
object implements
a coupled allpass filter structure composed of two allpass filters
connected in parallel. Each allpass branch can contain multiple sections.
The overall filter output is computed by adding the output of the
two respective branches. An optional second output can also be returned,
which is power complementary to the to the first. For example, from
the frequency domain perspective, if the first output implements a
lowpass filter, the second output implements the power complementary
highpass filter. For real signals, the power complementary output
is computed by subtracting the output of the second branch from the
first. CoupledAllpassFilter
supports double and
singleprecision floating point and allows you to choose between different
realization structures. This System object™ also supports complex
coefficients, multichannel variable length input, and tunable filter
coefficient values.
To filter each channel of the input:
Define and set up your Coupled Allpass Filter. See Construction.
Call step
to filter each channel
of the input according to the properties of dsp.CoupledAllpassFilter
.
The behavior of step
is specific to each object in
the toolbox.
Note:
Starting in R2016b, instead of using the 
caf = dsp.CoupledAllpassFilter
returns
a coupled allpass filter System object, caf
,
that filters each channel of the input signal independently. The coupled
allpass filter uses the default inner structures and coefficients.
caf = dsp.CoupledAllpassFilter('
returns a Coupled allpass filter System object, PropertyName
',PropertyValue
,
...)caf
,
with each property set to the specified value.
caf = CoupledAllpassFilter(AllpassCoefficients1,AllpassCoefficients2)
returns
a coupled allpass filter System object, caf
,
with Structure
set to 'Minimum multiplier'
.
The allpass coefficients for each of the two branches are set to their
two corresponding specified values.
returns
a coupled allpass filter System object, caf
= CoupledAllpassFilter(Structure,AllpassCoefficients1,AllpassCoefficients2)caf
,
with Structure
set to a specified value. This value
can be 'Minimum multiplier'
 'Wave Digital
Filter'
 'Lattice'
. The coefficients
relevant to the specified structure are set to the values provided.

Internal structure of allpass branches Specify the internal structure of allpass branches as one of 

Allpass polynomial coefficients of branch 1 Specify the polynomial filter coefficients for the first allpass
branch. This property is applicable only if you set the 

Wave Digital Filter coefficients of branch 1 Specify the Wave Digital Filter coefficients for the first allpass
branch. This property is applicable only if you set the 

Lattice coefficients of branch 1 Specify the allpass lattice coefficients for the first allpass
branch. This property is applicable only if you set the 

length in samples for branch 1


Independent Branch 1 Phase Gain


Allpass polynomial coefficients of branch 2 Specify the polynomial filter coefficients for the second allpass
branch. This property is applicable only if you set the 

Wave Digital Filter coefficients of branch 2 This property is applicable only if you set the 

Lattice coefficients of branch 2 Specify the allpass lattice coefficients for the second allpass
branch. This property is applicable only if you set the 

Independent Branch 2 Phase Gain Specify the value of the independent phase gain applied to branch
2. This property can accept only values equal to 

Coupled phase gain Specify the value of the phasor gain in complex conjugate form,
in each of the two branches, and in complex coefficient configuration.
This property is applicable only when the selected 

Replace allpass filter in first branch with pure delay If you set 

Allow inferring coefficients of second allpass branch as complex conjugate of first When the input signal is real, this property triggers the use of an optimized structural realization. This property is only enabled if the currently selected structure supports complex coefficients. Use it only if the filter coefficients are actually complex. 
getBranches  Return internal allpass branches 
reset  Reset internal states of Coupled Allpass filter 
step  Filter input with CoupledAllpas filter object 
Common to All System Objects  

clone  Create System object with same property values 
getNumInputs  Expected number of inputs to a System object 
getNumOutputs  Expected number of outputs of a System object 
isLocked  Check locked states of a System object (logical) 
release  Allow System object property value changes 
The following three figures summarize the main structures supported
by dsp.CoupledAllpassFilter
.
Minimum Multiplier and WDF
Lattice
Lattice with Complex Conjugate Coefficients
[1] Regalia, Philip A., Mitra, Sanjit K., and P.P Vaidyanathan " The Digital AllPass Filter: A Versatile Signal Processing Building Block." Proceedings of the IEEE 1988, Vol. 76, No. 1, pp. 19–37.
[2] Mitra, Sanjit K., and James F. Kaiser, "Handbook for Digital Signal Processing" New York: John Wiley & Sons, 1993.