Package: sdo.requirements
Nichols response bound
Specify piecewise-linear bounds on the Nichols (gain-phase)
response of a linear system. You can then optimize the model response
to meet these bounds using sdo.optimize
.
You can specify an upper or lower bound, include multiple linear
edges, and extend the bounds to +
or –inf
.
You must have Simulink® Control Design™ software to specify open-loop gain and phase requirements.
creates a olgainphase_req
= sdo.requirements.OpenLoopGainPhasesdo.requirements.OpenLoopGainPhase
object and assigns
default values to its properties.
uses additional options specified by one or more gainphase_req
=
sdo.requirements.OpenLoopGainPhase(Name,Value
)Name,Value
pair
arguments. Name
is a property name and Value
is
the corresponding value. Name
must appear inside single quotes
(''
). You can specify several name-value pair arguments in any
order as Name1,Value1,...,NameN,ValueN
.
Specify optional
comma-separated pairs of Name,Value
arguments. Name
is
the argument name and Value
is the corresponding value.
Name
must appear inside quotes. You can specify several name and value
pair arguments in any order as
Name1,Value1,...,NameN,ValueN
.
Use Name,Value
arguments to specify properties of the
requirement object during object creation. For example, requirement
= sdo.requirements.OpenLoopGainPhase('Type','>=')
creates
an sdo.requirements.OpenLoopGainPhase
object
and specifies the Type
property as a lower bound.
|
Gain values for a piecewise linear bound. Specify the start and end values in decibels for all the edges in the piecewise-linear bound.
The property must be a Use Default: |
|
Phase values for a piecewise-linear bound. Specify the start and end values in degrees for all the edges
in the piecewise-linear bound. The property must be a Use Default: |
|
Requirement description, specified as a character vector. For
example, Default: |
|
Magnitude units of the requirement. Must be:
Default: |
|
Requirement name, specified as a character vector. Default: |
|
Extend bound in a negative or positive time direction. Use to bound signals that extend beyond the coordinates specified
by the Must be a Default: |
|
Phase units of the requirement specified as one of the following values:
Default: |
|
Gain and phase requirement type, specified as one of the following values:
Default: |
evalRequirement | Evaluate gain and phase bounds on Nichols response of linear system |
Handle. To learn how handle classes affect copy operations, see Copying Objects.
Construct an open-loop gain and phase object, and specify gain and phase requirements.
r = sdo.requirements.OpenLoopGainPhase; set(r,'BoundPhases',[-120 -120; -120 -150; -150 -180],... 'BoundGains',[20 0; 0 -20; -20 -20]);
Alternatively, you can specify the gain and phase requirements during construction:
r = sdo.requirements.OpenLoopGainPhase('BoundPhases',... [-120 -120; -120 -150; -150 -180],'BoundGains',... [20 0; 0 -20; -20 -20]);
Use getbounds
to get the
bounds specified in a Check Nichols Characteristics (Simulink Control Design) block.