Documentation |
Separation between bilevel waveform pulses
S = pulsesep(X)
S = pulsesep(X,FS)
S = pulsesep(X,T)
[S,INITCROSS]
= pulsesep(...)
[S,INITCROSS,FINALCROSS]
= pulsesep(...)
[S,INITCROSS,FINALCROSS,NEXTCROSS]
= pulsesep(...)
[S,INITCROSS,FINALCROSS,NEXTCROSS,MIDLEV]
= pulsesep(...)
[S,INITCROSS,FINALCROSS,NEXTCROSS,MIDLEV]
= pulsesep(...,Name,Value)
pulsesep(...)
S = pulsesep(X) returns the differences, S, between the mid-reference level instants of the final negative-going transitions of every positive-polarity pulse and the next positive-going transition. X is a bilevel waveform. To determine the transitions that compose each pulse, pulsesep estimates the state levels of X by a histogram method. pulsesep 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. Because pulsesep uses interpolation to determine the mid-reference level instants, S may contain values that do not correspond to sampling instants of the bilevel waveform, X.
S = pulsesep(X,FS) specifies the sampling rate, FS, in Hz as a positive scalar. The first time instant corresponds to t=0. Because pulsesep uses interpolation to determine the mid-reference level instants, S may contain values that do not correspond to sampling instants of the bilevel waveform, X.
S = pulsesep(X,T) specifies the sampling instants, T, in a vector equal in length to X. Because pulsesep uses interpolation to determine the mid-reference level instants, S may contain values that do not correspond to sampling instants of the bilevel waveform, X.
[S,INITCROSS] = pulsesep(...) returns the mid-reference level instants, INITCROSS, of the first positive-polarity transitions.
[S,INITCROSS,FINALCROSS] = pulsesep(...) returns the mid-reference level instants, FINALCROSS, of the final transition of each pulse.
[S,INITCROSS,FINALCROSS,NEXTCROSS] = pulsesep(...) returns the mid-reference level instants, NEXTCROSS, of the next detected transition after each pulse.
[S,INITCROSS,FINALCROSS,NEXTCROSS,MIDLEV] = pulsesep(...) returns the mid-reference level, MIDLEV.
[S,INITCROSS,FINALCROSS,NEXTCROSS,MIDLEV] = pulsesep(...,Name,Value) returns the pulse separations with additional options specified by one or more Name,Value pair arguments.
pulsesep(...) plots the signal and darkens the regions between each pulse where pulse separation is computed. It marks the location of the mid crossings, and their associated reference level. The state levels and their associated lower and upper boundaries (adjustable by the Name,Value pair with name 'Tolerance') are also plotted.
X |
Bilevel waveform. If the waveform, X, does not contain at least two transitions, pulsesep outputs an empty matrix. |
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. Default: 50 |
'Polarity' |
Pulse polarity. Specify the polarity as 'positive' or 'negative'. If you specify 'positive', pulsesep looks for pulses with positive-going (positive polarity) initial transitions. If you specify 'negative', pulsesep looks for pulses with negative-going (negative polarity) initial transitions. See Pulse Polarity. Default: 'positive' |
'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, pulsesep 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 |
Pulse separations in seconds. The pulse separation is defined as the time between the mid-reference level instants of the final transition of one pulse and the initial transition of the next pulse. See Pulse Separation. |
INITCROSS |
Mid-reference level instants of initial transition. |
FINALCROSS |
Mid-reference level instants of final transition. |
NEXTCROSS |
Mid-reference level instants of the initial transition after the final transition of the preceding pulse. |
MIDLEV |
Waveform value that corresponds to the mid-reference level. |
[1] IEEE^{®} Standard on Transitions, Pulses, and Related Waveforms, IEEE Standard 181, 2003.