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