Main Content

sdo.requirements.StepResponseEnvelope class

Package: sdo.requirements

Step response bound on signal

Description

Specify a step response envelope requirement on a time-domain signal. Step response characteristics such as rise-time and percentage overshoot define the step response envelope.

Construction

step_req = sdo.requirements.StepResponseEnvelope creates an sdo.requirements.StepResponseEnvelope object and assigns default values to its properties.

step_req = sdo.requirements.StepResponseEnvelope(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 Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is 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 enclose Name in quotes.

Use Name,Value arguments to specify properties of the requirement object during object creation. For example, requirement = sdo.requirements.StepResponseEnvelope('PercentOvershoot',20) creates an sdo.requirements.StepResponseEnvelope object and specifies the PercentOvershoot property as 20.

Properties

Description

Requirement description, specified as a character vector. For example, 'Requirement on signal 1'.

Default: ''

FinalValue

Final value of the step response. Must be a finite real scalar not equal to the InitialValue property.

Default: 1

InitialValue

Value of the signal level before the step response starts. Must be a finite real scalar not equal to the FinalValue. property.

Default: 0

Name

Requirement name, specified as a character vector.

Default: ''

PercentOvershoot

The percentage amount by which the signal can exceed the final value before settling. This amount is specified as a percentage of step range.

Must be a real finite scalar between [0 100] and greater than PercentSettling.

Use set to set this and the PercentSettling properties simultaneously.

Default: 10

PercentRise

The percentage of step range value used with the RiseTime property to define the overall rise time characteristics.

Must be a real finite scalar between [0 100] and less than (100–PercentSettling).

Use set to set this and the PercentSettling properties simultaneously.

Default: 80

PercentSettling

The percentage of the step range value that defines the settling range of settling time characteristic specified in the SettlingTime property.

Must be a real positive finite scalar between [0 100] and less than (100 – PercentRise) and less than PercentOvershoot.

Use set to set this and the PercentOvershoot and PercentRise properties simultaneously.

Default: 1

PercentUndershoot

The percentage amount by which the signal can undershoot the initial value. This amount is specified as a percentage of step range.

Must be a positive finite scalar between [0 100].

Default: 1

RiseTime

Time taken, in seconds, for the signal to reach the percentage of the step range value specified in PercentRise.

Must be a finite positive real scalar and less than the SettlingTime. Time is relative to the StepTime.

Use set to set this and the StepTime and SettlingTime properties simultaneously.

Default: 5

SettlingTime

Time taken, in seconds, for the signal to settle within a specified settling range around the final value. This settling range is defined as the final value plus or minus the settling range, specified in PercentSettling.

Must be a finite positive real scalar, greater than RiseTime. Time is relative to the StepTime.

Use set to set this and the RiseTime properties simultaneously.

Default: 7

StepTime

Time, in seconds, when the step response starts.

Must be a finite real nonnegative scalar, less than the RiseTime property.

Use set to set this and the RiseTime properties simultaneously.

Default: 0

TimeUnits

Time units of the requirement, specified as one of the following values:

  • 'nanoseconds'

  • 'microseconds'

  • 'milliseconds'

  • 'seconds'

  • 'minutes'

  • 'hours'

  • 'days'

  • 'weeks'

  • 'months'

  • 'years'

Default: 'second'

Type

Step response bound type.

This property is read-only and set to '<='.

Methods

copyCopy design requirement
getGet design requirement property values
setSet design requirement property values
evalRequirementEvaluate design requirement

Copy Semantics

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

Examples

Construct a step response bound object and specify percent overshoot.

 r = sdo.requirements.StepResponseEnvelope;
 r.PercentOvershoot = 20;

Alternatively, you can specify the percent overshoot during construction:

 r = sdo.requirements.StepResponseEnvelope('PercentOvershoot',20);

Alternatives

Use getbounds to get the bounds specified in a Check Step Response Characteristics block.