sdo.requirements.ClosedLoopPeakGain class

Package:sdo.requirements

Closed loop peak gain bound

Description

Specify lower or equality bounds on the closed loop peak gain of a linear system. The closed loop can be formed using negative, positive or no feedback. You can then optimize the model response to meet these bounds usingsdo.optimize.

You must have金宝app^®Control Design™software to specify closed-loop peak gain bounds.

Construction

pkgain_req= sdo.requirements.ClosedLoopPeakGaincreates asdo.requirements.ClosedLoopPeakGainobject and assigns default values to its properties.

pkgain_req= sdo.requirements.ClosedLoopPeakGain(Name,Value)uses additional options specified by one or moreName,Valuepair arguments.Nameis a property name andValueis the corresponding value.Namemust appear inside single quotes (''). You can specify several name-value pair arguments in any order asName1,Value1,...,NameN,ValueN.

Input Arguments

Name-Value Arguments

Specify optional pairs of arguments asName1=Value1,...,NameN=ValueN, whereNameis the argument name andValueis the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and encloseNamein quotes.

UseName,Valuearguments to specifypropertiesof the requirement object during object creation. For example,requirement = sdo.requirements.ClosedLoopPeakGain('Type','<=')creates ansdo.requirements.ClosedLoopPeakGainobject and specifies theTypeproperty as an upper bound.

Properties

`Description`	Requirement description, specified as a character vector. For example,`'Requirement on signal 1'`. Default:`''`
`FeedbackSign`	反馈回路信号来确定t的峰值增益he linear system. Must be`–1`or`1`. Use`–1`if the loop has negative feedback and`1`if the loop has positive feedback. Default:`–1`
`MagnitudeUnits`	Magnitude units of the requirement. Must be`'db'`(decibels) or`'abs'`(absolute units). Default:`'abs'`
`Name`	Requirement name, specified as a character vector. Default:`''`
`PeakGain`	Peak gain bound. Default:`2`
`Type`	Peak gain requirement type, specified as one of the following: `'<='`— Upper bound `'=='`— Equality bound `'min'`— Minimization objective Default:`'<='`

Methods

evalRequirement

Evaluate peak gain bound for linear system

Copy Semantics

Handle. To learn how handle classes affect copy operations, seeCopying Objects.

Examples

Construct a closed loop peak gain object and specify peak gain requirement.

r = sdo.requirements.ClosedLoopPeakGain; r.PeakGain = 2;

Alternatively, you can specify the peak gain during construction:

r = sdo.requirements.ClosedLoopPeakGain('PeakGain',2);

Alternatives

Usegetboundsto get the bounds specified inCheck Nichols Characteristics(Simulink Control Design)block.