Documentation |
Settling time for bilevel waveform
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(...)
S = settlingtime(X,D) returns the time, S, from the mid-reference 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 mid-reference 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 upper-state boundary of the low state and the lower-state boundary of the high state. The low-state and high-state boundaries are expressed as the state level plus or minus a multiple of the difference between the state levels. See State-Level Tolerances.
S = settlingtime(X,FS,D) specifies the sampling rate for the bilevel waveform, X in hertz. The first sample instant in X is equal to t=0. Because settlingtime uses interpolation to determine the mid-reference level instant, S may contain values that do not correspond to sampling instants.
S = settlingtime(X,T,D) specifies the sample instants, T, as a vector with the same number of elements as X.
[S,SLEV,SINST] = settlingtime(...) returns vectors, SLEV, and SINST, whose elements correspond to the levels and sample instants of the settling points for each transition.
[S,SLEV,SINST] = settlingtime(...,Name,Value) returns the settling times, levels, and corresponding sample instants with additional options specified by one or more 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 mid-crossings, and the associated reference levels. The plot also displays the state levels with the corresponding lower and upper tolerance boundaries.
X |
Bilevel waveform. X is a real-valued row or column vector. |
D |
Settle-seek duration. D is a positive scalar, which defines the duration after the mid-reference level instant that settlingtime looks for a settling time. If no settling time occurs in D seconds after the mid-reference level instant, settlingtime returns a NaN. See Settling Time and Settle Seek Duration. |
FS |
Sample rate in hertz. |
T |
Vector of sample instants. The length of T must equal the length of the bilevel waveform, X. |
'MidPercentReferenceLevel' |
Mid-reference level as a percentage of the waveform amplitude. See Mid-Reference Level. Default: 50 |
'StateLevels' |
Low and high-state levels. StateLevels is a 1-by-2 real-valued vector. The first element is the low-state level. The second element is the high-state level. If you do not specify low and high-state levels, settlingtime estimates the state levels from the input waveform using the histogram method. |
'Tolerance' |
Tolerance levels (lower and upper state boundaries) expressed as a percentage. See State-Level Tolerances. Default: 2 |
S |
The time from the mid-reference level instant to the time instant each transition enters and remains within a 2% tolerance region of the final state over duration, D. |
SLEV |
Waveform values at the settling points. |
SINST |
Time instants of the settling points. |
[1] IEEE^{®} Standard on Transitions, Pulses, and Related Waveforms, IEEE Standard 181, 2003, pp. 23–24.