DynamicSystems
StepProperties
compute properties of a step response
Calling Sequence
Parameters
Options
Description
Examples
StepProperties( sys, opts )
sys
-
System; a system object
opts
(optional) equation(s) of the form option = value; specify options for the StepProperties command
parameters = set(name = complexcons) or list(name = complexcons)
Specifies numeric values for parameters in sys. These values override those specified by the parameters field of the system object, which in turn override the settings in in SystemOptions(parameters). The numeric value on the right-hand side of each equation is substituted for the name on the left-hand side in the expressions that define the model. No checking is done during the substitution to determine whether the substituted value is valid. For example, a complex value can be substituted for the coefficient of a polynomial. If the complex value had been originally assigned to the model at creation, a warning would be generated.
duration = numeric
Specifies the time duration in which to search. If not specified, a suitable value is computed.
no_evalf = truefalse
True means do not use evalf when substituting symbolic parameters in the system. This may be useful when the values are exact (integers or fractions). The default is false.
ret_record = truefalse
True means return a record of values, rather than a list. The default is false.
The StepProperties command calculates the unit-step response properties of a system object, sys, where this object must be linear and stable. Both continuous and discrete objects are accepted.
It returns an expression sequence: (final-value, 10%-point, 33%-point, 67%-point, 90%-point, peak-point, settling-point).
The first element in the sequence (final-value) is a single value. Each of the remaining elements is a list of two values, the time or index of the point and the associated value of the step response.
If the step-size is zero, a warning is raised and the percentage points will be undefined.
Returned Properties
This list describes each of the properties returned.
Final-value: the steady-state value of the step response.
10%-point: where response first reaches 1/10 to the final value.
33%-point: where response first reaches 1/3 to the final value.
67%-point: where response first reaches 2/3 to the final value.
90%-point: where response first reaches 9/10 to the final value.
peak-point: where response first reaches the peak value If the peak does not occur, [undefined, undefined] is returned. If the step is negative, the peak is in the negative direction. If the step-size is zero, the peak is at the greatest excursion from the initial value, regardless the direction.
settling-point: the settling point of the step response. If the settling time is not found within the given interval, [undefined, undefined] is returned.
with⁡DynamicSystems:
Sampling frequency
Ts≔0.05
Duration of simulation
dur≔10
Number of samples
Ns≔round⁡durTs
Ns≔200
Continuous System
sys≔TransferFunction⁡1s2+s+10
sys≔Transfer Functioncontinuous1 output(s); 1 input(s)inputvariable=u1⁡soutputvariable=y1⁡s
prop≔StepProperties⁡sys
prop≔0.100000000000000,0.146150201098349,0.0100000000000000,0.278988775168172,0.0333333333333333,0.419998798778775,0.0666666666666667,0.512928287463024,0.0900000000000000,1.00611486305525,0.160467906604390,7.31709090935268,0.102000000000000
Final value
prop1
0.100000000000000
10% to the final value
prop2
0.146150201098349,0.0100000000000000
33% to the final value
prop3
0.278988775168172,0.0333333333333333
67% to the final value
prop4
0.419998798778775,0.0666666666666667
90% to the final value
prop5
0.512928287463024,0.0900000000000000
peak value
prop6
1.00611486305525,0.160467906604390
settling value
prop7
7.31709090935268,0.102000000000000
plotsdisplay⁡plot⁡prop2..7,style=point,symbol=cross,color=black,symbolsize=30,plot⁡0,prop1,dur,prop1,color=gray,ResponsePlot⁡sys,Step⁡,duration=dur,numpoints=200
Discrete System
sysz≔ToDiscrete⁡sys,Ts
sysz≔Transfer Functiondiscrete; sampletime = .5e-11 output(s); 1 input(s)inputvariable=u1⁡zoutputvariable=y1⁡z
propz≔StepProperties⁡sysz
propz≔0.0999999989357504,3,0.00760283829914389,6,0.0324850042198717,9,0.0677171304079913,11,0.0926758273948584,21,0.160324379799413,148,0.101735627624127
propz1
0.0999999989357504
propz2
3,0.00760283829914389
propz3
6,0.0324850042198717
propz4
9,0.0677171304079913
propz5
11,0.0926758273948584
propz6
21,0.160324379799413
propz7
148,0.101735627624127
tfs≔subs⁡Ts_=Ts,x↦x1−1⋅Ts_,x2
tfs≔x↦0.05⋅x1−0.05,x2
plotsdisplay⁡plot⁡map⁡tfs,propz2..7,style=point,symbol=cross,color=black,symbolsize=30,plot⁡0,propz1,dur,propz1,color=gray,ResponsePlot⁡sysz,Step⁡sampletime=Ts,samplecount=Ns,discrete=true
See Also
DynamicSystems[Step]
Download Help Document