settlingtime
Settling time for bilevel waveform
Syntax
S = settlingtime(X,D)
S = settlingtime(X,FS,D)
S = settlingtime(X,T,D)
[S,SLEV,SINST]
= settlingtime(...)
[S,SLEV,SINST]
= settlingtime(...,Name,Value)
settlingtime(...)
Description
returns
the time, S
= settlingtime(X
,D
)S
, from the midreference level instant
to the time instant each transition enters and remains within a 2%
tolerance region of the final state over the duration, D
. D
is
a positive scalar. Because settlingtime
uses
interpolation to determine the midreference level instant, S
may
contain values that do not correspond to sampling instants. The length
of S
is equal to the number of detected transitions
in the input signal, X
. If for any transition,
the level of the waveform does not remain within the lower and upper
tolerance boundaries, the requested duration is not present, or an
intervening transition is detected, settlingtime
marks
the corresponding element in S
as NaN
.
See Settle Seek Duration for cases
in which settlingtime
returns a NaN
.
To determine the transitions, settlingtime
estimates
the state levels of the input waveform by a histogram method. settlingtime
identifies
all regions that cross the upperstate boundary of the low state and
the lowerstate boundary of the high state. The lowstate and highstate
boundaries are expressed as the state level plus or minus a multiple
of the difference between the state levels. See StateLevel Tolerances.
specifies the sample rate for the bilevel waveform, S
= settlingtime(X
,FS
,D
)X
in hertz. The
first sample instant in X
is equal to t = 0. Because settlingtime
uses interpolation to
determine the midreference level instant, S
may contain values
that do not correspond to sampling instants.
specifies
the sample instants, S
= settlingtime(X
,T
,D
)T
, as a vector with the
same number of elements as X
.
[
returns vectors, S
,SLEV
,SINST
]
= settlingtime(...)SLEV
,
and SINST
, whose elements correspond to the
levels and sample instants of the settling points for each transition.
[
returns
the settling times, levels, and corresponding sample instants with
additional options specified by one or more S
,SLEV
,SINST
]
= settlingtime(...,Name,Value
)Name,Value
pair
arguments.
settlingtime(...)
plots the signal and
darkens the regions of each transition where settling time is computed.
The plot marks the location of the settling time of each transition,
the midcrossings, and the associated reference levels. The plot also
displays the state levels with the corresponding lower and upper tolerance
boundaries.
Input Arguments

Bilevel waveform. 

Settleseek duration. 

Sample rate in hertz. 

Vector of sample instants. The length of 
NameValue Arguments

Midreference level as a percentage of the waveform amplitude. See MidReference Level. Default: 

Low and highstate levels. 

Tolerance levels (lower and upper state boundaries) expressed as a percentage. See StateLevel Tolerances. Default: 
Output Arguments

The time from the midreference level instant to the time instant
each transition enters and remains within a 2% tolerance region of
the final state over duration, 

Waveform values at the settling points. 

Time instants of the settling points. 
Examples
More About
References
[1] IEEE^{®} Standard on Transitions, Pulses, and Related Waveforms, IEEE Standard 181, 2003, pp. 23–24.
See Also
falltime
 midcross
 pulsewidth
 risetime
 statelevels