ss (MathScript RT Module Function)
- Updated2023-03-14
- 2 minute(s) read
ss (MathScript RT Module Function)
Owning Class: construct
Requires: Control Design and Simulation Module and MathScript RT Module
Syntax
SysOutSS = ss(D)
SysOutSS = ss(A, B)
SysOutSS = ss(A, B, C)
SysOutSS = ss(A, B, C, D)
SysOutSS = ss(A, B, C, D, Ts)
SysOutSS = ss(SysIn)
Description
Constructs a continuous or discrete linear time-invariant (LTI) system model in state-space form. You also can use this function to convert transfer function and zero-pole-gain models to state-space form.
Inputs
| Name | Description |
|---|---|
| A | Specifies an n x n state matrix, where n is the number of states. The default is an empty matrix. A is a real matrix. |
| B | Specifies an n x m input matrix, where m is the number of inputs. The default is an empty matrix. B is a real matrix. |
| C | Specifies an r x n output matrix, where r is the number of outputs. The default is an empty matrix. C is a real matrix. |
| D | Specifies an r x m direct transmission matrix. The default is an empty matrix. D is a real matrix. |
| Ts | Specifies the discrete sampling time of the SysOutSS model. The default value is 0, which constructs a continuous model. Specify a non-zero value to construct a discrete model. Ts is a real scalar. |
| SysIn | Specifies an LTI transfer function or zero-pole-gain model that you want to convert to state-space form. |
Outputs
| Name | Description |
|---|---|
| SysOutSS | Returns an LTI state-space model. This model has n states, m inputs, r outputs, and a sampling time of Ts. This model is single-input single-output (SISO), single-input multiple-output (SIMO), multiple-input single-output (MISO), or multiple-input multiple-output (MIMO), depending on the dimensions of the B and C matrices. |
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
% Creates a state-space model
A = eye(2)
B = [0; 1]
C = B'
SysOutSS = ss(A, B, C)
% Converts a zero-pole-gain model to state-space form
z = 1
p = [1, -1]
k = 1
SysIn = zpk(z, p, k)
SysOutSS = ss(SysIn)