control.ss2tf

control.ss2tf(sys)

Transform a state space system to a transfer function.

The function accepts either 1 or 4 parameters:

ss2tf(sys)

Convert a linear system from state space into transfer function form. Always creates a new system.

ss2tf(A, B, C, D)

Create a transfer function system from the matrices of its state and output equations.

For details see: tf.

Parameters

sysStateSpace

A linear system.

Aarray_like or string

System matrix.

Barray_like or string

Control matrix.

Carray_like or string

Output matrix.

Darray_like or string

Feedthrough matrix.

**kwargskeyword arguments

Additional arguments passed to tf (e.g., signal names).

Returns

outTransferFunction

New linear system in transfer function form.

Other Parameters

inputs, outputsstr, or list of str, optional

List of strings that name the individual signals of the transformed system. If not given, the inputs and outputs are the same as the original system.

namestring, optional

System name. If unspecified, a generic name ‘sys[id]’ is generated with a unique integer id.

Raises

ValueError

If matrix sizes are not self-consistent, or if an invalid number of arguments is passed in.

TypeError

If sys is not a StateSpace object.

See also

tf, ss, tf2ss

Examples

>>> A = [[-1, -2], [3, -4]]
>>> B = [[5], [6]]
>>> C = [[7, 8]]
>>> D = [[9]]
>>> sys1 = ct.ss2tf(A, B, C, D)

>>> sys_ss = ct.ss(A, B, C, D)
>>> sys_tf = ct.ss2tf(sys_ss)