|
Calling Sequence
|
|
DominantPole(sys, p, opts)
|
|
Parameters
|
|
sys
|
-
|
System; system object
|
p
|
-
|
list; desired (dominant) closed-loop poles (real or complex). Complex poles, including those containing symbolic parameters, must be given in complex conjugate pairs. All symbolic parameters in the list are assumed to be real.
|
opts
|
-
|
(optional) equation(s) of the form option = value; specify options for the DominantPole command
|
|
|
|
|
Options
|
|
|
Specifies the controller type. The default value is PID.
|
•
|
factored = true or false
|
|
True means return the factored version of the controller gains (, , ). False means return the controller gains (, , ). The default is false.
|
•
|
returntype = list or record or system
|
|
Specifies the returned type. If list is specified, the command returns a sequence of two lists; the first contains the controller parameters and the second contains the closed-loop poles. If a record is specified, the command returns a record containing the controller parameters and the closed-loop poles. If system is specified, the command returns a System (DynamicSystems system object) containing the transfer function of the specified controller type (PI, PID). The default value is list.
|
|
|
Description
|
|
•
|
The DominantPole command calculates the controller parameters for the closed-loop (dominant) pole placement.
|
•
|
The system sys is a continuous-time linear system object created using the DynamicSystems package. The system object must single-input single-output (SISO) and one of the following types: TransferFunction (tf), ZeroPoleGain(zpk), Coefficients(coeff), StateSpace(ss), DiffEquations (de).
|
•
|
The DominantPole command returns a sequence of two lists. The first list contains controller parameters and the second one contains closed-loop poles when the control loop is closed with a unity negative feedback.
|
•
|
Using a PI controller, two closed-loop poles can be assigned. The (dominant) closed-loop poles (p) must be specified as a complex conjugate pair.
|
•
|
Using a PID controller, three closed-loop poles can be assigned. The (dominant) closed-loop poles (p) must be specified as a single real pole and a complex conjugate pair.
|
•
|
If the factored option is false, the controller parameters are returned as a list of the form for a PI controller or for a PID controller, where is the proportional gain, is the integral gain, and is the derivative gain. The controller transfer function is then obtained as:
|
|
The three parameters can independently vary and one or more could be zero for a specific problem. If the solution to the specified pole placement problem requires one or more negative gains, a warning is generated.
|
•
|
If the factored option is true, the controller parameters are returned as a list of the form for a PI controller or for a PID controller, where is the proportional gain, is the integral time, and is the derivative time. The controller transfer function is then obtained as:
|
–
|
PID:
|
|
The factored parameters can be calculated only if is nonzero for a PI controller and both and are nonzero for a PID controller.
|
•
|
As only two (with a PI) or three (with a PID) closed-loop poles are assignable, for higher order systems, the positions of the rest of the poles are dictated by the system dynamics and must be verified separately to ensure overall stability and performance.
|
|
|
Examples
|
|
>
|
|
>
|
|
|
Example: Numeric system
|
|
>
|
|
>
|
|
>
|
|
| (1) |
>
|
|
| (2) |
>
|
|
| (3) |
>
|
|
| (4) |
>
|
|
| (5) |
•
|
Get the closed-loop poles
|
>
|
|
| (6) |
>
|
|
>
|
|
| (7) |
>
|
|
| (8) |
>
|
|
| (9) |
•
|
Get the closed-loop poles
|
>
|
|
| (10) |
|
|
Symbolic systems
|
|
>
|
|
>
|
|
•
|
Get a sequence of two lists with the PID controller gains and closed-loop poles
|
>
|
|
| (11) |
>
|
|
>
|
|
•
|
Get a record with the PI controller gains and closed-loop poles
|
>
|
|
| (12) |
•
|
Get the PI controller transfer function
|
>
|
|
| (13) |
•
|
Get the closed-loop poles
|
>
|
|
| (14) |
|
|
|
|