zpk_to_sos (MathScript RT Module Function)

LabVIEW 2010 Help

Edition Date: June 2010

Part Number: 371361G-01

»View Product Info

Owning Class: linear systems

Requires: MathScript RT Module

Syntax

[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)

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

Name

Description

Specifies the zeros of the system. z is a vector.

Specifies the poles of the system. p is a vector.

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.

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.

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