evalRequirement
Class: sdo.requirements.StepResponseEnvelope
Package: sdo.requirements
Evaluate satisfaction of step response requirement
Syntax
evaluation =
evalRequirement(requirement,signal)
Description
evaluates whether evaluation
=
evalRequirement(requirement
,signal
)signal
satisfies requirement
,
the step response requirement.
Input Arguments
requirement
— Step response requirement
sdo.requirements.StepResponseEnvelope
object
Step response requirement, specified as an sdo.requirements.StepResponseEnvelope
object.
signal
— Signal to be evaluated
timeseries
object | matrix | numeric or generalized LTI model
Signal to be evaluated, specified as one of the following:
timeseries
objectMatrix of size
nxm
— Wheren
is the number of time points in the signal andm
is the number of channels in the signal. The first column is time and subsequent columns are signal values.Numeric or generalized linear time invariant (LTI) model — Available with Control System Toolbox™ software.
Output Arguments
evaluation
— Evaluation of the step response requirement
column vector
Evaluation of the step response requirement, returned as a column
vector. Negative values indicate that the requirement is satisfied,
and positive values indicate that the requirement is violated. evaluation
consists
of the maximum distances between signal
and step
response bounds. The last entry in evaluation
is
a stability measure.
The maximum signal distances from upper bounds are returned before lower bounds. The step bounds are considered in the following order:
Upper bound for the overshoot — Signal between
StepTime
(time, t = 0) andSettlingTime
of therequirement
is used.Upper bound for the settling time — Signal between
SettlingTime
and 1.5*SettlingTime
is used.Additional upper bound for the settling time — If
signal
extends beyond 1.5*SettlingTime
, there is an additional upper bound for the settling time. Maximum signal distance from this upper bound is also returned. The signal between 1.5*SettlingTime
and end of signal is used.Lower bound for the undershoot — Signal between
StepTime
andRiseTime
is used.Lower bound for the % rise — Signal between
RiseTime
andSettlingTime
is used.Lower bound for the settling time — Signal between
SettlingTime
and 1.5*SettlingTime
is used.Additional lower bound for the settling time — If
signal
extends beyond 1.5*SettlingTime
, there is an additional lower bound for the settling time. Maximum signal distance from this lower bound is also returned. The signal between 1.5*SettlingTime
and end of signal is used.
The last value in evaluation
is a measure
of stability from the end of signal
to infinity.
Negative values indicate that the projected signal is not deviating
from the step response after end of signal
. A
positive value indicates that the projected signal is deviating.
Examples
Evaluate Step Response Requirement
Create a step response requirement.
requirement = sdo.requirements.StepResponseEnvelope;
A requirement is created with the default settling time of 7 seconds.
Specify the signal to be evaluated.
signal = timeseries(1-exp(-(0:10)'));
The signal data extends to 10 seconds.
Evaluate the step response requirement.
evaluation = evalRequirement(requirement,signal)
evaluation = 6×1
-0.0917
-0.0099
-1.0000
-0.2416
-0.0092
-0.0299
The maximum distance of the signal from the step response bounds is returned in evaluation(1:5)
, followed by the stability value. Negative values indicate that the requirement is satisfied.
The maximum distance from the bounds are returned in the following order:
Distance from upper bound for the overshoot
Distance from upper bound for the settling time
Distance from lower bound for the undershoot
Distance from lower bound for the % rise
Distance from lower bound for the settling time
evaluation
does not include the distance of the signal from bounds beyond 1.5*settling time because the signal data does not extend beyond 1.5*settling time.
Open Example
You have a modified version of this example. Do you want to open this example with your edits?
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)