ss_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

Syntax

[sos, g] = ss_to_sos(a, b, c, d)

[sos, g] = ss_to_sos(a, b, c, d, dir)

[sos, g] = ss_to_sos(a, b, c, d, dir, s)

sos = ss_to_sos(a, b, c, d)

sos = ss_to_sos(a, b, c, d, dir)

sos = ss_to_sos(a, b, c, d, dir, s)

Legacy Name: ss2sos

Description

Converts a state-space to a second-order section system.

Examples

Inputs

Name Description
a, b, c, d Specify the state-space of the system.
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.

Outputs

Name Description
sos Returns a 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 request g, LabVIEW embeds the gain in the first section of the system.

Details

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

Examples

[a, b, c, d] = tf_to_ss([1 2 3 4], [7 6 5 4]);
[sos, g] = ss_to_sos(a, b, c, d)