Company Events Academic Community Support Solutions Products & Services Contact NI MyNI

tf_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] = tf_to_sos(b, a)

[sos, g] = tf_to_sos(b, a, dir)

[sos, g] = tf_to_sos(b, a, dir, s)

sos = tf_to_sos(b, a)

sos = tf_to_sos(b, a, dir)

sos = tf_to_sos(b, a, dir, s)

Legacy Name: tf2sos

Description

Converts a transfer function to a second-order section.

Examples

Inputs

Name Description
b Specifies the forward filter coefficients. b is a vector.
a Specifies the backward filter coefficients. a is a vector.
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 specify g, LabVIEW embeds the gain in the first section.

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

[sos, g] = tf_to_sos([1 2 3 4], [7 6 5 4])

Related Topics

sos_to_tf
tf_to_zpk_eqlen


 

Your Feedback! poor Poor  |  Excellent excellent   Yes No
 Document Quality? 
 Answered Your Question? 
Add Comments 1 2 3 4 5 submit