This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.

cumsec

Cumulative second-order section of BiquadFilter System object

Syntax

sect = cumsec(biquad)
sect = cumsec(biquad,indices)
sect = cumsec(biquad,indices,secondary)
cumsec(biquad,...)
sect = cumsec(biquad,'Arithmetic',arithType)

Description

example

sect = cumsec(biquad) returns a cell array, sect, which contains cumulative sections of the dsp.BiquadFilter filter System object™, biquad. Each element in sect is a filter with the structure of the original filter. The first element is the first filter section of biquad. The second element of sect is a filter that represents the combination of the first and second sections of biquad. The third element of sect is a filter which combines sections 1, 2, and 3 of biquad. This pattern continues until the final element of sect contains all the sections of biquad and should be identical to biquad.

sect = cumsec(biquad,indices) returns the cumulative sections of the dsp.BiquadFilter filter System object biquad whose indices in the original filter are in the vector indices.

sect = cumsec(biquad,indices,secondary) uses the secondary scaling points secondary in the sections to determine where the sections should be split when secondary is true. secondary is false by default. This option only applies for dsp.BiquadFilter objects with 'Direct form II' and 'Direct form I transposed' structures. For these structures, the secondary scaling points refer to the location between the recursive and the nonrecursive part, that is the 'middle' of the section.

cumsec(biquad,...) plots the magnitude response of the cumulative sections using fvtool.

sect = cumsec(biquad,'Arithmetic',arithType) returns the cumulative sections of the filter System object biquad with the arithmetic specified in arithType.

Examples

collapse all

This example plots the relative responses of the sections of a sixth-order filter with three sections. Each curve adds one more section to form the filter response.

Lowpass = fdesign.lowpass('n,fc',6,.4); ButterLowpass = butter(Lowpass,'SystemObject',true); 
CumSections = cumsec(ButterLowpass); hfvt = fvtool(CumSections{1},CumSections{2},CumSections{3}); 
legend(hfvt,'First Section','First Two Sections','Overall  Filter');

Input Arguments

collapse all

The dsp.BiquadFilter System object with one of the following filter structures:

StructureDescription
df1sosDirect-form I filter object with second-order sections.
df1tsosDirect-Form I transposed filter with second-order sections.
df2sosDirect-form II filter object with second-order sections.
df2tsosDirect-Form II transposed filter with second-order sections.

Filter indices. Use indices to specify the filter sections cumsec uses to compute the cumulative responses.

This option applies only when biquad has the df2sos and df1tsos structures. For these second-order section structures, the secondary scaling points refer to the scaling locations between the recursive and the nonrecursive parts of the section (the "middle" of the section). Argument secondary accepts either true or false. By default, secondary is false.

Specify the arithmetic used during analysis. When the arithmetic input is not specified and the filter System object is unlocked, the analysis tool assumes a double-precision filter. The 'Arithmetic' property set to 'Fixed' applies only to filter System objects with fixed-point properties.

Introduced in R2011a