:MEASure:RESults?

Query Syntax

:MEASure:RESults? {STANdard | EXTended} 

Description

This command returns a comma-separated string that includes the results for all measurements that are displayed in the Results table. The returned string can be modified using the following command parameters:

STANdard

This is the default argument, and it is identical to sending the command without an argument. The returned string includes each measurement listed in the table. Standard measurement values are included such as current, minimum, and maximum values. Additional fields may be included such as measurement status. For example, sending :MEASure:RESults? STANdard returns this string for three measurements:

Name=Eye Height[Data],Source=E1,Current=5.036E-1,Status=Correct,Mean=5.03616E-1,StdDev=0,Min=5.036E-1,Max=5.036E-1,Count=1691,
Name=Fall Time,Source=1,Current=2.8879E-10,Status=Correct,Mean=2.889562E-10,StdDev=3.8600E-12,Min=2.7733E-10,Max=2.9966E-10,Count=1488,
Name=Jitter[rms s],Source=E1,Current=4.48E-12,Status=Correct,Mean=4.477E-12,StdDev=0,Min=4.48E-12,Max=4.48E-12,Count=195

Line returns have been added to the example above to make the results easier to read, but are not included in the returned string.

EXTended

This parameter returns all the same fields that are returned using the STANdard parameter plus additional fields that are included when you copy the table data to the Windows clipboard. This includes measurement fields such as resolution, mean, and standard deviation. For example, sending :MEASure:RESults? EXTended returns this string for three measurements. The conditions for the following returned string were the same as are used for the STANdard parameter above:

Name=Eye Height[Data],Source=E1,Current=5.036E-1,Status=Correct,Resolution=8E-5,Mean=5.03616E-1,StdDev=0,Min=5.036E-1,Max=5.036E-1,Count=1691,
Name=Fall Time,Source=1,Current=2.8879E-10,Status=Correct,Resolution=1E-14,Mean=2.889562E-10,StdDev=3.8600E-12,Min=2.7733E-10,Max=2.9966E-10,Count=1488,
Name=Jitter[rms s],Source=E1,Current=4.48E-12,Status=Correct,Resolution=2E-14,Mean=4.477E-12,StdDev=0,Min=4.48E-12,Max=4.48E-12,Count=195

Line returns have been added to the example above to make the results easier to read, but are not included in the returned string.

As you can see in the above examples for each parameter, the returned string includes each result as a label=value pair. For example, "Name=Eye Height[Ampl]". Since each value is labeled, the table column heads are not included in the returned string. The measurement results data is ordered by row from top to bottom, which each row starting with the "Name=" characters. The returned string can include the following measurements:

• In Time, Amplitude, PAM, and User toolbar measurements.
• In Advanced Eye, PAM, and User toolbar measurements.

If a measurement limit test is on, the number of failures are also returned.

To learn how to query the following values, click on these links:

• Marker Commands
• Waveform Histogram Commands
• Mask Test Commands

Although the :MEASure:RESults? query does give you a quick way to return the Results table values, you can of course query the measurement results individually. For example, to return the results of an Eye Width measurement use the following Python 3 script. Before you run the script, view an eye diagram on the display with connection 1 channel 1.

"""
Written for Python 3
"""
import pyvisa  # PyVISA package
rm = pyvisa.ResourceManager() # Create an instance of PyVISA's ResourceManager
Infiniium = rm.open_resource('TCPIP0::localhost::hislip0,4880::INSTR')
Infiniium.timeout = 20000 # Set connection timeout to 20s
Infiniium.read_termination = '\n'
Infiniium.write(':ACQuire:STOP')
Infiniium.write(':MEASure:EYE:EWIDth:SOURce ECHannel1')
Infiniium.write(':MEASure:EYE:EWIDth')
print('Eye Width values:')
print('Source waveform: ' + Infiniium.query(':MEASure:EYE:EWIDth:SOURce?'))
print('Current value: ' + Infiniium.query(':MEASure:EYE:EWIDth?'))
print('Minimum value: ' + Infiniium.query(':MEASure:EYE:EWIDth:MIN?'))
print('Maximum value: ' + Infiniium.query(':MEASure:EYE:EWIDth:MAX?'))
print('Count: ' + Infiniium.query(':MEASure:EYE:EWIDth:COUNt?'))
Infiniium.write(':SYSTem:GTLocal')
Infiniium.close()