control.rss

control.rss(states=1, outputs=1, inputs=1, strictly_proper=False, **kwargs)

Create a stable random state space object.

Parameters

states, outputs, inputsint, list of str, or None

Description of the system states, outputs, and inputs. This can be given as an integer count or as a list of strings that name the individual signals. If an integer count is specified, the names of the signal will be of the form ‘s[i]’ (where ‘s’ is one of ‘x’, ‘y’, or ‘u’).

strictly_properbool, optional

If set to True, returns a proper system (no direct term).

dtNone, True or float, optional

System timebase. 0 (default) indicates continuous time, True indicates discrete time with unspecified sampling time, positive number is discrete time with specified sampling time, None indicates unspecified timebase (either continuous or discrete time).

namestring, optional

System name (used for specifying signals). If unspecified, a generic name ‘sys[id]’ is generated with a unique integer id.

Returns

sysStateSpace

The randomly created linear system.

Raises

ValueError

If any input is not a positive integer.

Notes

If the number of states, inputs, or outputs is not specified, then the missing numbers are assumed to be 1. If dt is not specified or is given as 0 or None, the poles of the returned system will always have a negative real part. If dt is True or a positive float, the poles of the returned system will have magnitude less than 1.