TuningGoal.MaxLoopGain class
Package: TuningGoal
Maximum loop gain constraint for control system tuning
Description
Use TuningGoal.MaxLoopGain
to enforce a maximum
loop gain and desired rolloff in a particular frequency band. Use
this tuning goal with control system tuning commands such as systune
or looptune
.
This tuning goal imposes a maximum gain on the openloop frequency response (L) at a specified location in your control system. You specify the maximum openloop gain as a function of frequency (a maximum gain profile). For MIMO feedback loops, the specified gain profile is interpreted as an upper bound on the largest singular value of L.
When you tune a control system, the maximum gain profile is converted to a maximum gain constraint on the complementary sensitivity function, T) = L/(I + L).
The following figure shows a typical specified maximum gain profile (dashed line) and a resulting tuned loop gain, L (blue line). The shaded region represents gain profile values that are forbidden by this tuning goal. The figure shows that when L is much smaller than 1, imposing a maximum gain on T is a good proxy for a maximum openloop gain.
TuningGoal.MaxLoopGain
and TuningGoal.MinLoopGain
specify
only highgain or lowgain constraints in certain frequency bands.
When you use these tuning goals, systune
and looptune
determine
the best loop shape near crossover. When the loop shape near crossover
is simple or well understood (such as integral action), you can use TuningGoal.LoopShape
to
specify that target loop shape.
Construction
creates
a tuning goal for limiting the gain of a SISO or MIMO feedback loop.
The tuning goal limits the openloop frequency response measured at
the specified locations to the maximum gain profile specified by Req
= TuningGoal.MaxLoopGain(location
,loopgain
)loopgain
.
You can specify the maximum gain profile as a smooth transfer function
or sketch a piecewise error profile using an frd
model
or the makeweight
(Robust Control Toolbox) command.
Only gain values smaller than 1 are enforced.
specifies
a maximum gain profile of the form Req
= TuningGoal.MaxLoopGain(location
,fmax
,gmax
)loopgain = K/s
(integral
action). The software chooses K
such that the gain
value is gmax
at the specified frequency, fmax
.
Input Arguments

Location at which the maximum openloop gain is constrained, specified as a character vector or cell array of character vectors that identify one or more locations in the control system to tune. What loopopening locations are available depends on what kind of system you are tuning:
If 

Maximum openloop gain as a function of frequency. You can specify loopgain = frd([1 1e1 1e3],[1 10 100]); bodemag(loopgain) When you use an Only gain values smaller than 1 are enforced. For multiinput,
multioutput (MIMO) feedback loops, the gain profile is interpreted
as a minimum rolloff requirement, which is an upper bound on the
largest singular value of If you are tuning in discrete time (that is, using a 

Frequency of maximum gain Use this argument to specify a maximum gain profile of the form 

Value of maximum gain occurring at Use this argument to specify a maximum gain profile of the form 
Properties

Maximum openloop gain as a function of frequency, specified
as a SISO The software automatically maps the input argument Use 

Frequency band in which tuning goal is enforced, specified as
a row vector of the form Set the Req.Focus = [1,100]; Default: 

Stability requirement on closedloop dynamics, specified as
1 ( When Default: 1 ( 

Toggle for automatically scaling loop signals, specified as In multiloop or MIMO control systems, the feedback channels
are automatically rescaled to equalize the offdiagonal terms in the
openloop transfer function (loop interaction terms). Set Default: 

Location at which minimum loop gain is constrained, specified
as a cell array of character vectors that identify one or more analysis
points in the control system to tune. For example, if The value of the 

Models to which the tuning goal applies, specified as a vector of indices. Use the Req.Models = 2:4; When Default: 

Feedback loops to open when evaluating the tuning goal, specified as a cell array of character vectors that identify loopopening locations. The tuning goal is evaluated against the openloop configuration created by opening feedback loops at the locations you identify. If you are using the tuning goal to tune a Simulink model
of a control system, then If you are using the tuning goal to tune a generalized statespace
( For example, if Default: 

Name of the tuning goal, specified as a character vector. For example, if Req.Name = 'LoopReq'; Default: 
Examples
Tips
This tuning goal imposes an implicit stability constraint on the closedloop sensitivity function measured at
Location
, evaluated with loops opened at the points identified inOpenings
. The dynamics affected by this implicit constraint are the stabilized dynamics for this tuning goal. TheMinDecay
andMaxRadius
options ofsystuneOptions
control the bounds on these implicitly constrained dynamics. If the optimization fails to meet the default bounds, or if the default bounds conflict with other requirements, usesystuneOptions
to change these defaults.
Algorithms
When you tune a control system using a TuningGoal
,
the software converts the tuning goal into a normalized scalar value f(x).
Here, x is the vector of free (tunable) parameters
in the control system. The software then adjusts the parameter values
to minimize f(x) or to drive f(x)
below 1 if the tuning goal is a hard constraint.
For TuningGoal.MaxLoopGain
, f(x)
is given by:
$$f\left(x\right)={\Vert {W}_{T}\left({D}^{1}TD\right)\Vert}_{\infty}.$$
Here, D is a diagonal scaling (for MIMO loops). T is
the complementary sensitivity function at Location
. W_{T} is
a frequencyweighting function derived from the maximum loop gain
profile, MaxGain
. The gain of this function roughly
matches 1/MaxGain
for values ranging from –60
dB to 20 dB. For numerical reasons, the weighting function levels
off outside this range, unless the specified gain profile changes
slope outside this range. This adjustment is called regularization.
Because poles of W_{T} close
to s = 0 or s = Inf
might
lead to poor numeric conditioning of the systune
optimization
problem, it is not recommended to specify gain profiles with very
lowfrequency or very highfrequency dynamics.
To obtain W_{T}, use:
WT = getWeight(Req,Ts)
where Req
is the tuning goal, and Ts
is the sample time
at which you are tuning (Ts = 0
for continuous time). For more information
about regularization and its effects, see Visualize Tuning Goals.
Although T is a closedloop transfer function, driving f(x) < 1 is equivalent to enforcing an upper bound on the openloop transfer, L, in a frequency band where the gain of L is less than one. To see why, note that T = L/(I + L). For SISO loops, when L << 1, T ≈ L. Therefore, enforcing the openloop maximum gain requirement, L < 1/W_{T}, is roughly equivalent to enforcing W_{T}T < 1. For MIMO loops, similar reasoning applies, with T ≈ σ_{max}(L), where σ_{max} is the largest singular value.
Compatibility Considerations
See Also
looptune
 systune
 looptune
(for slTuner)
(Simulink Control Design)  systune (for slTuner)
(Simulink Control Design)  viewGoal
 evalGoal
 TuningGoal.Gain
 TuningGoal.LoopShape
 TuningGoal.MinLoopGain
 TuningGoal.Margins
 slTuner
(Simulink Control Design)  sigma