Package: TuningGoal
Maximum loop gain constraint for control system tuning
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.
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
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
.

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 

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: 
This tuning goal imposes an implicit stability constraint on
the closedloop sensitivity function measured at Location
,
evaluated with loops opened at the points identified in Openings
.
The dynamics affected by this implicit constraint are the stabilized
dynamics for this tuning goal. The MinDecay
and MaxRadius
options
of systuneOptions
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,
use systuneOptions
to change
these defaults.
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.
TuningGoal.Gain
 TuningGoal.LoopShape
 TuningGoal.Margins
 TuningGoal.MinLoopGain
 evalGoal
 looptune
 looptune
(for slTuner)
 sigma
 slTuner
 systune
 systune (for slTuner)
 viewGoal