zpk_to_sos (MathScript RT Module Function)

LabVIEW 2012 MathScript RT Module Help

Edition Date: June 2012

Part Number: 373123C-01

»View Product Info
Download Help (Windows Only)

Owning Class: linear systems

Requires: MathScript RT Module


[sos, g] = zpk_to_sos(z, p)

[sos, g] = zpk_to_sos(z, p, k)

[sos, g] = zpk_to_sos(z, p, k, dir)

[sos, g] = zpk_to_sos(z, p, k, dir, s)

sos = zpk_to_sos(z, p)

sos = zpk_to_sos(z, p, k)

sos = zpk_to_sos(z, p, k, dir)

sos = zpk_to_sos(z, p, k, dir, s)

Legacy Name: zp2sos


Converts a zero-pole-gain representation to a second-order section.



Name Description
z Specifies the zeros of the system. z is a vector.
p Specifies the poles of the system. p is a vector.
k Specifies the gain of the system. The default is 1.
dir Specifies how to arrange the second-order sections. dir accepts the following values.

'up' (default) The first row contains the poles closest to the origin.
'down' The first row contains the poles farthest from the origin.
s Specifies the desired scaling of the gain and the numerator coefficients of all second-order sections. s accepts the following values.

'none' (default) Uses no scaling.
Inf Uses infinity norm scaling. The filter must be stable to use infinity norm scaling.
2 Uses 2-norm scaling. The filter must be stable to use 2-norm scaling.


Name Description
sos Returns the second-order section system. sos is an L-by-6 matrix. Each row of s contains the coefficients of one section as [b0 b1 b2 1 a1 a2].
g Returns the gain of the system. If you do not specify g, LabVIEW embeds the gain in the first section.


The following table lists the support characteristics of this function.

Supported in the LabVIEW Run-Time Engine Yes
Supported on RT targets Yes
Suitable for bounded execution times on RT Not characterized


[z, p, k] = tf_to_zpk([1 2 3 4], [7 6 5 4]);
[sos, g] = zpk_to_sos(z, p, k)

Related Topics



Not Helpful