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

Online Help

All Products    Maple    MapleSim


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 (K=Kp, Ti=KpKi, Td=KdKp). False means return the controller gains (Kp, Ki, Kd). 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 Kp,Ki for a PI controller or Kp,Ki,Kd for a PID controller, where Kp is the proportional gain, Ki is the integral gain, and Kd is the derivative gain. The controller transfer function is then obtained as:

– 

PI: Cs=Kp+Kis

– 

PID: Cs=Kp+Kis+Kds

  

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 Ki,Ti for a PI controller or K,Ti,Td for a PID controller, where K is the proportional gain, Ti is the integral time, and Td is the derivative time. The controller transfer function is then obtained as:

– 

PI: Cs=K1+1Tis

– 

PID: Cs=K1+1Tis+Tds 

  

The factored parameters can be calculated only if Ki is nonzero for a PI controller and both Kp and Ki 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

withControlDesign:

withDynamicSystems:

Example: Numeric system

sys1NewSystems+1s3+s2+13s+12:

p13+2I,32I,10:

DominantPolesys1,p1,controller=PID

144524,474536,115372,−10,7372,−32I,−3+2I

(1)

DominantPolesys1,p1,controller=PID,factored=true

144524,8671898,11534335,−10,7372,−32I,−3+2I

(2)

pidDominantPolesys1,p1,controller=PID,returntype=record

pidRecordpackedKp=144524,Ki=474536,Kd=115372,closedPoles=−10,7372,−32I,−3+2I

(3)

pidDominantPolesys1,p1,controller=PID,factored=true,returntype=record

pidRecordpackedK=144524,Ti=8671898,Td=11534335,closedPoles=−10,7372,−32I,−3+2I

(4)

pidsysDominantPolesys1,p1,controller=PID,returntype=system:

PrintSystempidsys

Transfer Functioncontinuous1 output(s); 1 input(s)inputvariable=u1soutputvariable=y1stf1,1=1153s2+4335s+949072s

(5)
• 

Get the closed-loop poles

zpksysPIDClosedLoopsys1,pidsys,outputtype=zpk:

PrintSystemzpksys

Zero Pole Gaincontinuous1 output(s); 1 input(s)inputvariable=y1_refsoutputvariable=y1sz1,1=43352306I249756552306,43352306+I249756552306,−1p1,1=−10,−32I,−3+2I,7372k1,1=115372

(6)

p13+2I,32I:

DominantPolesys1,p1,controller=Π

2878,6118,521944,52+1944,−32I,−3+2I

(7)

PIparsDominantPolesys1,p1,controller=Π,returntype=record

PIparsRecordpackedKp=2878,Ki=6118,closedPoles=521944,52+1944,−32I,−3+2I

(8)

PIsysDominantPolesys1,p1,controller=Π,returntype=system:

PrintSystemPIsys

Transfer Functioncontinuous1 output(s); 1 input(s)inputvariable=u1soutputvariable=y1stf1,1=287s6118s

(9)
• 

Get the closed-loop poles

zpksysPIDClosedLoopsys1,PIsys,outputtype=zpk:

PrintSystemzpksys

Zero Pole Gaincontinuous1 output(s); 1 input(s)inputvariable=y1_refsoutputvariable=y1sz1,1=611287,−1p1,1=−32I,−3+2I,521944,52+1944k1,1=2878

(10)

Symbolic systems

sys2NewSystems+as4+5s3+s2+bs+12:

p23+bI,3bI,7:

• 

Get a sequence of two lists with the PID controller gains and closed-loop poles

DominantPolesys2,p2

b453b2+2238a2+6b4b3+17b251b14289a+7b2+9b2+b+3457+aa2+b26a+9,7b2+9b254a2+b2+b+345a56b25167+aa2+b26a+9,14b2b+357a2+b4+53b22238a7b4+315b2+34027+aa2+b26a+9,−7,3+Ib,3Ib,4a3+4ab252a228b2+a6b2+a4b412a5b26a3b438a6+a5b40a4b2+a3b347a2b4+631a513a4b+799a3b27a2b3+168ab43419a4+51a3b1306a2b2+784b4+4473a363a2b6300ab2+19773a2+14112b270308a+63504+204a252a3+ab213a27b2+51a63,4a34ab2+52a2+28b2+a6b2+a4b412a5b26a3b438a6+a5b40a4b2+a3b347a2b4+631a513a4b+799a3b27a2b3+168ab43419a4+51a3b1306a2b2+784b4+4473a363a2b6300ab2+19773a2+14112b270308a+63504204a+252a3+ab213a27b2+51a63

(11)

sys3NewSystems+as3+s2+bs+c:

p32+I,2I:

• 

Get a record with the PI controller gains and closed-loop poles

PIrecDominantPolesys3,p3,controller=Π,returntype=record

PIrecRecordpackedKp=4bc+13a5b35a24a+5,Ki=5b+35a5c75a24a+5,closedPoles=−2+I,−2I,3a212a+15+4a4b19a4+16a3b+4a3c+100a320a2b16a2c146a2+20ac60a+2252a24a+5,3a2+4a4b19a4+16a3b+4a3c+100a320a2b16a2c146a2+20ac60a+225+12a152a24a+5

(12)
• 

Get the PI controller transfer function

PIsysDominantPolesys3,p3,controller=Π,returntype=system:

PrintSystemPIsys

Transfer Functioncontinuous1 output(s); 1 input(s)inputvariable=u1soutputvariable=y1stf1,1=4abac+13a5b35s+5ab+35a5c75a24a+5s

(13)
• 

Get the closed-loop poles

zpksysPIDClosedLoopsys3,PIsys,outputtype=zpk:

PrintSystemzpksys

Zero Pole Gaincontinuous1 output(s); 1 input(s)inputvariable=y1_refsoutputvariable=y1sz1,1=5ab+7ac154abac+13a5b35,ap1,1={[−2+I, −2I, 3a212a+15+4a4b19a4+16a3b+4a3c+100a320a2b16a2c146a2+20ac60a+2252a24a+5, 3a2+4a4b19a4+16a3b+4a3c+100a320a2b16a2c146a2+20ac60a+225+12a152a24a+5]k1,1=4ab14ac+134a54b354a24a+5

(14)

See Also

ControlDesign

ControlDesign[CohenCoon]

ControlDesign[GainPhaseMargin]

ControlDesign[ZNFreq]

ControlDesign[ZNTimeModified]