canonical (MathScript RT Module Function)
- Updated2023-03-14
- 2 minute(s) read
canonical (MathScript RT Module Function)
Owning Class: ssanals
Requires: Control Design and Simulation Module and MathScript RT Module
Syntax
SysCanSS = canonical(SysInSS)
SysCanSS = canonical(SysInSS, formtype)
SysCanSS = canonical(A, B, C, D)
SysCanSS = canonical(A, B, C, D, formtype)
[SysCanSS, T] = canonical(SysInSS)
[SysCanSS, T] = canonical(SysInSS, formtype)
[SysCanSS, T] = canonical(A, B, C, D)
[SysCanSS, T] = canonical(A, B, C, D, formtype)
Legacy Name: canon
Description
Transforms a state-space system model to a canonical form using the formtype that you specify. This function also returns the transformation matrix that this function uses to transform the model.
Inputs
| Name | Description | ||||
|---|---|---|---|---|---|
| SysInSS | Specifies a linear time-invariant (LTI) system in transfer function, zero-pole-gain, or state-space form. This function converts transfer function and zero-pole-gain models to state-space form before transforming the model into canonical form. | ||||
| formtype | Specifies the canonical form this function uses to transform the SysIn model into the SysCanSS model. method is a string that can take the following values:
|
||||
| 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. |
Outputs
| Name | Description |
|---|---|
| SysCanSS | Returns an LTI model in state-space form that is the canonical realization of SysInSS. |
| T | Returns the transformation matrix this function uses to transform the SysInSS model into the SysCanSS model. T is a real matrix. |
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
SysInSS = ss([1, 1; -1, 2], [1, 2]', [2, 1], 0)
[SysCanSS, T] = canonical(SysInSS, 'modal')