Varying State Space
State-space model with varying matrix values
Control System Toolbox / Linear Parameter Varying
Use this block to implement a continuous-time state-space model with varying matrices. Feed the instantaneous values of the state matrix A, input matrix B, output matrix C, and feedforward matrix D to the corresponding input ports. The system response is given by:
where u is the system input, y is the system output, and x and dx are the state vector and state derivatives, respectively.
Use this block and the other blocks in the Linear Parameter Varying library to implement common control elements with variable parameters or coefficients. For more information, see Model Gain-Scheduled Control Systems in Simulink.
Avoid making the C and D matrices depend on the system output y. If you have such dependence, the resulting state-space equation y = C(y)x + D(y)u creates an algebraic loop, because computing the output value y requires knowing the output value. This algebraic loop is prone to instability and divergence. Instead, try expressing C and D in terms of the time t, the block input u, and the state outputs x.
For similar reasons, avoid making A and B depend on the dx output. Note that it is safe to for A and B to depend on y when y is a fixed combination of states and inputs, (in other words, when y = Cx + Du where C and D are constant matrices).
u — System input
scalar | vector
System input signal.
A — State matrix
State matrix of dimensions Nx-by-Nx, where Nx is the number of system states.
B — Input matrix
Input matrix of dimensions Nx-by-Nu, where Nu is the number of system inputs.
C — Output matrix
Output matrix Ny-by-Nx, where Ny is the number of system outputs.
D — Feedforward matrix
Feedforward matrix of dimensions Ny-by-Nu.
For a zero-feedthrough state-space model, clear the Enable feedthrough checkbox. Clearing this checkbox disables the D input port. (since R2023a)
y — System output
scalar | vector
System output signal.
x — Current state vector
Current state values.
To enable this port, select the Output states parameter.
dx — State derivatives
Current derivatives of the corresponding states in x.
To enable this port, select the Output state derivatives parameter.
Initial conditions — System initial conditions
0 (default) | scalar | vector
Initial state values, specified as a scalar or a vector whose length is the number of system states.
State names — System state names
'' (default) | character vector | cell array
To identify system states, specify state names as a:
character vector, for a one-state plant.
Cell array of character vectors, for a multistate plant.
Output states — Provide state output
on (default) | off
Select to enable the state values output port, x.
Output state derivatives — Provide state derivatives
on (default) | off
Select to enable the state derivatives output port, dx.
Enable feedthrough — Add input port for feedthrough matrix
on (default) |
Enable the D input port for a state-space model with direct feedthrough. For a zero-feedthrough model, clear this checkbox. Disabling the port for zero-feedthrough models is numerically more reliable than feeding a zero-constant into the port.
C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.
Version HistoryIntroduced in R2017b
R2023a: Enable feedthrough checkbox added
For a zero-feedthrough state-space model, clear the Enable feedthrough checkbox. Clearing this checkbox disables the D input port. Disabling the port for zero-feedthrough models is numerically more reliable than feeding a zero-constant into the port.