Documentation |
Fall time of negative-going bilevel waveform transitions
F = falltime(X)
F = falltime(X,FS)
F = falltime(X,T)
[F,LT,UT]
= falltime(...)
[F,LT,UT,LL,UL]
= falltime(...)
[...] = falltime(...,Name,Value)
falltime(...)
F = falltime(X) returns a vector, F, containing the time each transition of the bilevel waveform, X, takes to cross from the 90% to 10% reference levels. See Percent Reference Levels. To determine the transitions, falltime estimates the state levels of the input waveform by a histogram method. falltime identifies all regions, which cross the lower-state boundary of the high state and the upper-state boundary of the low 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. Because falltime uses interpolation, F may contain values that do not correspond to sampling instants of the bilevel waveform, X.
F = falltime(X,FS) specifies the sampling frequency in hertz. The sampling frequency determines the sample instants corresponding to the elements in X. The first sample instant in X corresponds to t=0. Because falltime uses interpolation, F may contain values that do not correspond to sampling instants of the bilevel waveform, X.
F = falltime(X,T) specifies the sample instants, T, as a vector with the same number of elements as X.
[F,LT,UT] = falltime(...) returns vectors, LT and UT, whose elements correspond to the time instants where X crosses the lower and upper percent reference levels.
[F,LT,UT,LL,UL] = falltime(...) returns the levels, LL and UL, corresponding to the lower- and upper-percent reference levels.
[...] = falltime(...,Name,Value) returns the fall times with additional options specified by one or more Name,Value pair arguments.
falltime(...) plots the signal and darkens the regions of each transition where fall time is computed. The plot marks the lower and upper crossings and the associated reference levels. The state levels and the associated lower- and upper-state boundaries are also displayed.
X |
Bilevel waveform. X is a real-valued row or column vector. |
FS |
Sample rate in hertz. |
T |
Vector of sample instants. The length of T must equal the length of the bilevel waveform, X. |
'PercentReferenceLevels' |
Reference levels as a percentage of the waveform amplitude. The low-state level is defined to be 0 percent. The high-state level is defined to be 100 percent. See Percent Reference Levels. 'PercentReferenceLevels' is a 2-element real row vector whose elements correspond to the lower- and upper-percent reference levels. Default: [10 90] |
'StateLevels' |
Low and high-state levels. Specifies the levels to use for the low- and high-state levels as a 2-element real-valued row vector whose first and second elements correspond to the low- and high-state levels. |
'Tolerance' |
Tolerance levels (lower- and upper-state boundaries) expressed as a percentage. See State-Level Tolerances. Default: 2 |
F |
Fall times. F is a vector containing the duration of each negative-going transition. If you specify the sampling rate, FS, or the sampling instants, T, fall times are in seconds. If you do not specify a sampling rate, or sampling instants, fall times are in samples. |
LT |
Instants when negative-going transition crosses the lower-reference level. By default, the lower-reference level is the 10% reference level. You can change the default reference levels by specifying the 'PercentReferenceLevels' name-value pair. |
UT |
Instants when negative-going transition crosses the upper-reference level. By default, the upper reference level is the 90% reference level. You can change the default reference levels by specifying the 'PercentReferenceLevels' name-value pair. |
LL |
Lower-reference level in waveform amplitude units. LL is a vector containing the waveform values corresponding to the lower-reference level in each negative-going transition. By default, the lower-reference level is the 10% reference level. You can change the default reference levels by specifying the 'PercentReferenceLevels' name-value pair. |
UL |
Upper-reference level in waveform amplitude units. LL is a vector containing the waveform values corresponding to the upper-reference level in each negative-going transition. By default, the upper-reference level is the 90% reference level. You can change the default reference levels by specifying the 'PercentReferenceLevels' name-value pair. |
[1] IEEE^{®} Standard on Transitions, Pulses, and Related Waveforms, IEEE Standard 181, 2003, pp. 15–17.