poleplace (MathScript RT Module Function)
- Updated2023-03-14
- 2 minute(s) read
poleplace (MathScript RT Module Function)
Owning Class: ssdesign
Requires: Control Design and Simulation Module and MathScript RT Module
Syntax
[K, q] = poleplace(A, B, p)
[K, q] = poleplace(A, B, p, 'K')
[K, q] = poleplace(SysInSS, p)
[K, q] = poleplace(SysInSS, p, 'K')
[L, q] = poleplace(A, C, p, 'L')
[L, q] = poleplace(SysInSS, p, 'L')
[Ltrans, q] = poleplace(A', C', p)
Legacy Name: place
Description
Calculates the gain that places the closed-loop poles at specified locations in a system model with full state feedback. You can use this function with multiple-input multiple-output (MIMO) models. Use the ackermann function for single-input single-output (SISO) models.
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. |
| p | Specifies where you want to place the closed-loop poles. p is a complex vector. |
| 'K' | Specifies that you want this function to design a controller gain vector. 'K' is a string constant and is the default value of this argument. You also can enter 'c' or 'controller'. |
| SysInSS | Specifies a linear time-invariant (LTI) model in state-space form. |
| 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. |
| 'L' | Specifies that you want this function to design an estimator gain vector. 'L' is a string constant. You also can enter 'o' or 'observer'. |
Outputs
| Name | Description |
|---|---|
| K | Returns the feedback controller gain vector that produces a closed-loop model such that the locations of the poles are equal to the values you specified in the p vector. K is a real vector. |
| q | Returns the eigenvalues of the matrix (A - BK). These eigenvalues are the closed-loop pole locations. q is a complex vector. |
| L | Returns the feedback estimator gain vector that produces a closed-loop model such that the locations of the poles are equal to the values you specified in the p vector. L is a real vector. |
| Ltrans | Returns the transpose of L. You then can use the transpose function to transpose Ltrans to obtain L. Ltrans is a real vector. |
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
A = [-1, 2; 0, -3]
B = [0, 1; 1, 0]
p = [-4 + i; -4 - i]
K = poleplace(A, B, p)