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

The input signal.

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

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

Default: low pulse

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

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

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

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

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

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

Error conditions that occur before this node runs.

The node responds to this input according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error	error in contains an error
If no error occurred before the node runs, the node begins execution normally. If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.	If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

Default: No error

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

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

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

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.

reserved

Value reserved for future use.

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.

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.

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.

Error information.

The node produces this output according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error	error in contains an error
If no error occurred before the node runs, the node begins execution normally. If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.	If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

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.

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=\frac{t_f-t_r}{2}$

where t_c is the pulse center time, t_f is the time instant of the falling mid ref level crossing, and t_r is the time instant of the preceding rising mid ref level crossing.

ref levels

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

high ref level

The high reference level.

mid ref level

The middle reference level.

low ref level

The low reference level.

ref units

Units of the reference levels.

ref units is always absolute in measurement info.