bundles / scipy latest / scipy / signal / _lti_conversion / abcd_normalize
function
scipy.signal._lti_conversion:abcd_normalize
source: build-install/usr/lib/python3.14/site-packages/scipy/signal/_lti_conversion.py:118
Signature
def abcd_normalize(A = None, B = None, C = None, D = None)Summary
Check state-space matrices compatibility and ensure they are 2d arrays.
Extended Summary
First, the input matrices are converted into two-dimensional arrays with appropriate dtype as needed. Then the dimensions n, q, p are determined by investigating the array shapes. If an input is None, or has size zero, it is set to an array of zeros of compatible shape. Finally, it is verified that all parameter shapes are compatible with each other. If that fails, a ValueError is raised. Note that the dimensions n, q, p are allowed to be zero.
Parameters
A: array_like, optionalTwo-dimensional array of shape (n, n).
B: array_like, optionalTwo-dimensional array of shape (n, p).
C: array_like, optionalTwo-dimensional array of shape (q, n).
D: array_like, optionalTwo-dimensional array of shape (q, p).
Returns
A, B, C, D: arrayState-space matrices as two-dimensional arrays with identical dtype. The result dtype is determined based on the standard dtype promotion rules except for when the inputs are all of integer dtype, in which case the returned arrays will have the default floating point dtype of
float64.
Raises
: ValueErrorIf the dimensions n, q, or p could not be determined or if the shapes are incompatible with each other.
Notes
If a matrix is not modified, the original matrix (not a copy) is returned.
The tutorial_signal_state_space_representation section of the user_guide presents the corresponding definitions of continuous-time and disrcete time state space systems.
Examples
The following example demonstrates that the passed lists are converted into two-dimensional arrays:from scipy.signal import abcd_normalize AA, BB, CC, DD = abcd_normalize(A=[[1, 2], [3, 4]], B=[[-1], [5]], C=[[4, 5]], D=2.5) AA.shape, BB.shape, CC.shape, DD.shape✓
((2, 2), (2, 1), (1, 2), (1, 1))In the following, the missing parameter C is assumed to be an array of zeros with shape (1, 2):
from scipy.signal import abcd_normalize AA, BB, CC, DD = abcd_normalize(A=[[1, 2], [3, 4]], B=[[-1], [5]], D=2.5) AA.shape, BB.shape, CC.shape, DD.shape CC✓
array([[0., 0.]])
See also
- StateSpace
Linear Time Invariant system in state-space form.
- cont2discrete
Transform a continuous to a discrete state-space system.
- dlti
Discrete-time linear time invariant system base class.
- ss2tf
State-space to transfer function.
- ss2zpk
State-space representation to zero-pole-gain representation.
- tf2ss
Transfer function to state-space representation.
Aliases
scipy.signal.abcd_normalize