Table Of Contents

Pulse Time and Transition Measurements (Pulse) (G Dataflow)

Version:
    Last Modified: January 9, 2017

    Returns various measurements of a specific pulse in a periodic waveform or an array of periodic waveforms, such as the period, pulse duration, and duty cycle.

    connector_pane_image
    datatype_icon

    signal

    The input signal.

    This input can be a waveform or an array of waveforms.

    datatype_icon

    polarity

    Value that specifies whether this node measures high or low pulses.

    Name Value Description
    low pulse 0 Measures low pulses.
    high pulse 1 Measures high pulses.

    Default: low pulse

    datatype_icon

    pulse number

    Number of the pulse that this node measures. For example, if pulse number is 1 and polarity is low pulse, the node returns the pulse duration of the first low pulse. The node measures the period and duty cycle of the period that begins with the (2n - 1)th mid reference level crossing, where n is pulse number.

    Default: 1

    datatype_icon

    reference levels settings

    High, middle, and low reference levels of a waveform.

    datatype_icon

    high ref level

    High reference level of the waveform.

    After the signal crosses the mid ref level in the rising direction, it must cross the high ref level before the next falling mid ref level crossing can be counted.

    Default: 90

    datatype_icon

    mid ref level

    Middle reference level of the waveform.

    The interval between consecutive rising mid ref level crossings defines one cycle, or period, of the waveform. At least one high or low reference level crossing must separate each mid ref level crossing.

    Default: 50

    datatype_icon

    low ref level

    Low reference level of the waveform.

    After the signal crosses the mid ref level in the falling direction, it must cross the low ref level before the next rising mid ref level crossing can be counted.

    Default: 10

    datatype_icon

    ref units

    Units of the high, middle, and low reference levels.

    Name Value Description
    absolute 0 Interprets the reference levels as absolute levels.
    percent 1 Interprets the reference levels as a percentage of the full range of the waveform.

    Default: percent

    datatype_icon

    error in

    Error conditions that occur before this node runs. The node responds to this input according to standard error behavior.

    Default: No error

    datatype_icon

    state levels settings

    Settings that determine the high and low state levels of a waveform.

    datatype_icon

    method

    Method this node uses to compute the high and low state levels of the waveform.

    Name Description
    histogram Returns the levels of the histogram bins with the maximum number of hits in the upper and lower regions of the waveform. The upper and lower regions of the waveform include the upper and lower 40%, respectively, of the peak-to-peak range of the waveform.
    peak Searches the entire waveform for its maximum and minimum levels.
    auto select Determines whether the histogram bins that correspond to the high and low state levels each have over 5% of the total hits. If so, this node returns those results. Otherwise, this node uses the peak method. This ensures a reasonable answer for either a square wave (ignoring the overshoot and undershoot) or a triangle wave (where a histogram fails).

    Default: auto select

    datatype_icon

    histogram size

    Number of bins in the histogram this node uses to determine the high and low state levels of the waveform.

    If you select the peak method, this node ignores this input.

    Default: 256

    datatype_icon

    histogram method

    Method this node uses to compute the histogram. Currently, mode is the only available histogram method.

    Name Description
    mode Uses the mode method.
    datatype_icon

    reserved

    Value reserved for future use.

    datatype_icon

    period

    Time between adjacent middle reference level crossings in the same direction in seconds.

    The reciprocal of this value is the signal frequency. The measurement interval includes the pulse you specify in pulse number.

    This output returns a double-precision, floating-point number or an array of double-precision, floating-point numbers.

    datatype_icon

    pulse duration

    Time difference, in seconds, between the first two middle reference level crossings of the specified pulse number.

    pulse duration is also known as pulse width.

    This output returns a double-precision, floating-point number or an array of double-precision, floating-point numbers.

    datatype_icon

    duty cycle

    Fraction of a period.

    duty cycle is also known as duty factor.

    This output returns a double-precision, floating-point number or an array of double-precision, floating-point numbers.

    Equation for Calculating duty cycle

    This node uses the following equation to calculate duty cycle:

    d u t y c y c l e = 100 × ( p u l s e d u r a t i o n p e r i o d )

    In this equation, pulse duration can refer to the high or low portion of the period, depending on whether polarity is high pulse or low pulse.

    datatype_icon

    error out

    Error information. The node produces this output according to standard error behavior.

    datatype_icon

    measurement info

    Pulse-center time of the selected pulse and the absolute reference levels this node uses to define the measurement cycle.

    This output can be a cluster or an array of clusters.

    datatype_icon

    pulse center

    Time instant of the midpoint of the specified pulse number.

    Algorithm Definition

    pulse center for a polarity of high pulse is given by the following equation.

    t c = t f t r 2

    where tc is the pulse center time, tf is the time instant of the falling mid ref level crossing, and tr is the time instant of the preceding rising mid ref level crossing.

    datatype_icon

    ref levels

    Three user-defined reference levels of the waveform in absolute units.

    datatype_icon

    high ref level

    The high reference level.

    datatype_icon

    mid ref level

    The middle reference level.

    datatype_icon

    low ref level

    The low reference level.

    datatype_icon

    ref units

    Units of the reference levels.

    ref units is always absolute in measurement info.

    Where This Node Can Run:

    Desktop OS: Windows

    FPGA: Not supported


    Recently Viewed Topics