Package: sdo.requirements
Gain and phase margin bounds
Specify lower or equality bounds on the gain and phase margin
of a linear system. You can then optimize the model response to meet
the bounds using sdo.optimize
.
You must have Simulink® Control Design™ software to specify gain and phase margin requirements.
creates a gainphase_req
= sdo.requirements.GainPhaseMarginsdo.requirements.GainPhaseMargin
object and
assigns default values to its properties.
uses additional options specified by one or more
gainphase_req
=
sdo.requirements.GainPhaseMargin(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.GainPhaseMargin('Type','>=')
creates
an sdo.requirements.GainPhaseMargin
object
and specifies the Type
property as a lower bound.
|
Requirement description, specified as a character vector. For
example, Default: |
|
Feedback loop sign to determine the gain and phase margins of the linear system. Must be Default: |
|
Gain margin bound. Use Default: |
|
Magnitude units of the requirement. Must be:
Default: |
|
Requirement name, specified as a character vector. Default: |
|
Phase margin bound. Must be in degrees and a positive finite
scalar. Set to Default: |
|
Phase units of the requirement specified as one of the following values:
Default: |
|
Gain and phase margin requirement type, specified as one of the following values:
Default: |
evalRequirement | Evaluate gain and phase margin bounds for linear system |
Handle. To learn how handle classes affect copy operations, see Copying Objects.
Construct a gain and phase margin object and specify gain and phase margin requirement.
r = sdo.requirements.GainPhaseMargin; r.GainMargin = 5; r.PhaseMargin = 55;
Alternatively, you can specify the gain and phase margins during construction.
r = sdo.requirements.GainPhaseMargin(... 'GainMargin',5, ... 'PhaseMargin', 55);
Use getbounds
to get the
bounds specified in a Check Gain and Phase
Margins (Simulink Control Design) and Check Nichols Characteristics (Simulink Control Design) block.