Main Content

sdo.requirements.StepResponseEnvelope

Step response bound on signal

expand all in page

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.

Specified step response characteristics on a plot

Creation

Syntax

step_req = sdo.requirements.StepResponseEnvelope
step_req = sdo.requirements.StepResponseEnvelope(Name=Value)

Description

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

example

step_req = sdo.requirements.StepResponseEnvelope(Name=Value) specifies one or more properties using name-value arguments. For example, step_req = sdo.requirements.StepResponseEnvelope(PercentOvershoot=20) creates an sdo.requirements.StepResponseEnvelope object and specifies the overshoot as 20%.

example

Before R2021a, use commas to separate each name and value, and enclose Name in quotes. For example, step_req = sdo.requirements.StepResponseEnvelope("PercentOvershoot",20) creates an sdo.requirements.StepResponseEnvelope object and specifies the overshoot as 20%.

Properties

expand all

Requirement description, specified as a character vector.

Example: 'Requirement on signal 1'

Final value of the step response, specified as a finite real scalar not equal to the InitialValue property.

Value of the signal level before the step response starts, specified as a finite real scalar not equal to the FinalValue property.

Requirement name, specified as a character vector.

Amount by which the signal can exceed the final value before settling defined as a percentage of the step range and specified as a scalar in the range [0 100] and greater than PercentSettling.

Use set to set the PercentSettling, PercentOvershoot, and PercentRise properties simultaneously.

Rise time range, defined as a percentage of the step range and specified as a scalar in the range [0 100]. The value must be less than (100–PercentSettling). Use this value along with RiseTime to define the overall rise time characteristics.

Use set to set the PercentSettling, PercentOvershoot, and PercentRise properties simultaneously.

Settling range, defined as a percentage of the step range and specified as a scalar in the range [0 100]. The value must be less than (100 – PercentRise) and less than PercentOvershoot.

Use set to set the PercentSettling, PercentOvershoot, and PercentRise properties simultaneously.

Amount by which the signal can undershoot the initial value, defined as a percentage of the step range and specified as a scalar in the range [0 100].

Time taken, in seconds, for the signal to reach the percentage of the step range value specified in PercentRise, specified as a positive real scalar less than SettlingTime.

Use set to set the RiseTime, StepTime, and SettlingTime properties simultaneously.

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

Use set to set the RiseTime, StepTime, and SettlingTime properties simultaneously.

Time, in seconds, when the step response starts, specified as a nonnegative real scalar less than RiseTime

Use set to set the RiseTime, StepTime, and SettlingTime properties simultaneously.

Time units of the requirement, specified as one of the following values. The sdo.requirements.StepResponseEnvelope object stores the value as a character vector.

  • "nanoseconds"

  • "microseconds"

  • "milliseconds"

  • "seconds"

  • "minutes"

  • "hours"

  • "days"

  • "weeks"

  • "months"

  • "years"

This property is read-only.

Step response bound type, returned as '<='.

Object Functions

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

Examples

collapse all

Open Live Script

Create a step response envelope requirements object and specify percent overshoot.

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

Alternatively, you can specify the percent overshoot when you create the object.

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

Alternatives

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

Version History

Introduced in R2010b

See Also

Topics