Digital Comparison VI

Owning Palette: Digital Waveform VIs and Functions

Requires: Base Development System

Compares a digital waveform to another digital waveform or to a specified value or compares a set of digital data to another set of digital data or to a specified value. You must manually select the polymorphic instance you want to use.

Use the pull-down menu to select an instance of this VI.

Select an instance Waveform to WaveformTable to TableWaveform to ValueTable to Value

Add to the block diagram

Find on the palette

Waveform to Waveform

	start sample B specifies where to start the comparison within digital waveform B.
	start sample A specifies where to start the comparison within digital waveform A.
	digital waveform A is the waveform for which you want to perform a digital comparison.
	digital waveform B is the waveform for which you want to perform a digital comparison.
	error in describes error conditions that occur before this node runs. With the following exception, this input provides standard error in functionality. This node runs normally even if an error occurred before this node runs.
	compare level specifies the comparison results returned by the VI. 0 Pass/Fail Only (default)—Specifies that the VI returns only passed? as an output, which improves the performance of the comparison. 1 Pass/Fail and # Errors—Specifies that the VI returns passed? and # failed samples. 2 Pass/Fail, # Errors and Diff Data—Specifies that the VI returns passed?, # failed samples, and diff data.
	# samples to compare specifies the number of samples in digital waveform A and digital waveform B to compare. The default value is –1, which specifies that the VI compares all samples.
	passed? returns TRUE if all corresponding values in digital waveform A and digital waveform B match.
	# failed samples returns the total number of corresponding samples in digital waveform A and digital waveform B that do not match.
	diff data returns the waveform representing the comparison of digital waveform A and digital waveform B. Zeros represent corresponding samples that match. Ones represent corresponding samples that differ. You can use this data to determine the exact location of all differing samples.
	error out contains error information. This output provides standard error out functionality.

Table to Table

	start position B specifies where to start the comparison within digital data B.
	start position A specifies where to start the comparison within digital data A.
	digital data A is the digital data for which you want to perform a digital comparison.
	digital data B is the digital data for which you want to perform a digital comparison.
	error in describes error conditions that occur before this node runs. With the following exception, this input provides standard error in functionality. This node runs normally even if an error occurred before this node runs.
	compare level specifies the comparison results returned by the VI. 0 Pass/Fail Only (default)—Specifies that the VI returns only passed? as an output, which improves the performance of the comparison. 1 Pass/Fail and # Errors—Specifies that the VI returns passed? and # failed samples. 2 Pass/Fail, # Errors and Diff Data—Specifies that the VI returns passed?, # failed samples, and diff data.
	# samples to compare specifies the number of samples in digital data A and digital data B to compare. The default value is -1, which specifies that the VI compares all samples.
	passed? returns TRUE if all corresponding values in digital data A and digital data B match.
	# failed samples returns the total number of corresponding samples in digital data A and digital data B that do not match.
	diff data returns the digital data representing the comparison of digital data A and digital data B. Zeros represent corresponding samples that match. Ones represent corresponding samples that differ. You can use this data to determine the exact location of all differing samples.
	error out contains error information. This output provides standard error out functionality.

Waveform to Value

	digital waveform is the input digital waveform.
	comparison specifies to what value the digital data contained in the digital input is compared. 0 Equal 0 (default)—Force Down 1 Equal 1—Force Up 2 Equal Z—Force Z 3 Equal L—Compare Low 4 Equal H—Compare High 5 Equal X—Compare Don't Care 6 Equal T—Compare Invalid 7 Equal V—Compare Valid 8 Equal 0 or L 9 Equal 1 or H 10 Not Equal 0 or 1 11 Not Equal 0, 1, L, or H
	error in describes error conditions that occur before this node runs. With the following exception, this input provides standard error in functionality. This node runs normally even if an error occurred before this node runs.
	boolean array is a Boolean-array representation of where the comparison value is found in the digital data contained in the digital input.
	passed? returns TRUE if any value in the digital data contained in the digital input matches the comparison request specified in comparison.
	error out contains error information. This output provides standard error out functionality.

Table to Value

	digital data is the set of input digital data.
	comparison specifies to what value the digital data contained in the digital input is compared. 0 Equal 0 (default)—Force Down 1 Equal 1—Force Up 2 Equal Z—Force Z 3 Equal L—Compare Low 4 Equal H—Compare High 5 Equal X—Compare Don't Care 6 Equal T—Compare Invalid 7 Equal V—Compare Valid 8 Equal 0 or L 9 Equal 1 or H 10 Not Equal 0 or 1 11 Not Equal 0, 1, L, or H
	error in describes error conditions that occur before this node runs. With the following exception, this input provides standard error in functionality. This node runs normally even if an error occurred before this node runs.
	boolean array is a Boolean-array representation of where the comparison value is found in the digital data contained in the digital input.
	Passed? returns TRUE if any value in the digital data contained in the digital input matches the comparison request specified in comparison.
	error out contains error information. This output provides standard error out functionality.