DominantPole - MapleSim Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.

Online Help

ControlDesign

  

DominantPole

  

PID controller design for (dominant) pole placement

 

Calling Sequence

Parameters

Options

Description

Examples

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

• 

controller = PI or PID

  

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:

– 

PI:

– 

PID:

  

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:

– 

PI:

– 

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)

See Also

ControlDesign

ControlDesign[CohenCoon]

ControlDesign[GainPhaseMargin]

ControlDesign[ZNFreq]

ControlDesign[ZNTimeModified]

 


Download Help Document