sdo.requirements.PZDampingRatio class

Package: sdo.requirements

Damping ratio bound

Description

Specify bounds on the damping ratio of the poles of a linear system. You can then optimize the model response to meet these bounds using sdo.optimize. You can also use this object to specify overshoot bound.

You must have Simulink® Control Design™ software to specify damping ratio requirements.

Construction

damp_req = sdo.requirements.PZDampingRatio creates a sdo.requirements.PZDampingRatio object and assigns default values to its properties.

gainphase_req = sdo.requirements.PZDampingRatio(Name,Value) uses additional options specified by one or more 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.

Input Arguments

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside single quotes (' '). You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

'DampingRatio'

Damping ratio bound. Must be a finite scalar between 0 and 1.

Default: 0.7071

'Description'

Requirement description. Must be a string.

Default: ''

'Name'

Requirement name. Must be a string.

Default: ''

'Type'

Damping ratio bound type. Must be one of the following strings:

  • '<=' — Upper bound

  • '>=' — Lower bound

  • '==' — Equality bound

  • 'max' — Maximization objective

Default: '>='

Properties

DampingRatio

Damping ratio bound. Must be a finite scalar between 0 and 1.

Default: 0.7071

Description

Requirement description. Must be a string.

Default: ''

Name

Requirement name. Must be a string.

Default: ''

Type

Damping ratio bound type. Must be one of the following strings:

  • '<=' — Upper bound

  • '>=' — Lower bound

  • '==' — Equality bound

  • 'max' — Maximization objective

Default: '>='

Methods

evalRequirementEvaluate damping ratio bound on linear system
getOvershootConvert damping ratio to equivalent overshoot value
setOvershootSet overshoot to an equivalent damping ratio

Copy Semantics

Handle. To learn how handle classes affect copy operations, see Copying Objects in the MATLAB® documentation.

Examples

Construct a damping ratio object and specify the damping ratio.

       r = sdo.requirements.PZDampingRatio;
       r.DampingRatio = 0.1;

Alternatively, you can specify the damping ratio during construction.

       r = sdo.requirements.PZDampingRatio('DampingRatio',0.1);

Alternatives

Use getbounds to get the bounds specified in a Check Pole-Zero Characteristics block.

Was this topic helpful?