Query Syntax

:MEASure:RESults? {STANdard | EXTended} 

Description

In Oscilloscope, Eye/Mask, Jitter, and TDR/TDT modes, 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 in Eye mode for three measurements:

Name=Eye Height[Ampl],Source=1A,Current=4.870E-1,Status=Correct,Min=4.870E-1,Max=4.870E-1,Count=2.8E+1,
Name=Fall Time,Source=1A,Current=2.344E-11,Status=Correct,Min=2.344E-11,Max=2.344E-11,Count=2.8E+1,
Name=Jitter[rms],Source=1A,Current=1.024E-12,Status=Correct,Min=1.006E-12,Max=1.034E-12,Count=2.8E+1

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 in Eye mode for three measurements. The conditions for the following returned string were the same as are used for the STANdard parameter above:

Name=Eye Height[Ampl],Source=1A,Current=4.870E-1,Status=Correct,Resolution=2E-4,Mean=4.8706E-1,StdDev=0,Min=4.870E-1,Max=4.870E-1,Count=2.8E+1,
Name=Fall Time,Source=1A,Current=2.344E-11,Status=Correct,Resolution=2E-14,Mean=2.3435E-11,StdDev=0,Min=2.344E-11,Max=2.344E-11,Count=2.8E+1,
Name=Jitter[rms],Source=1A,Current=1.024E-12,Status=Correct,Resolution=2E-15,Mean=1.0210E-12,StdDev=5.5E-15,Min=1.006E-12,Max=1.034E-12,Count=2.8E+1

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 Scope Mode, Time, Amplitude, PAM, JSA/CRE, and User toolbar measurements.
• In Eye Mod, Eye, Advanced Eye, PAM, JSA/CRE, and User toolbar measurements.
• In Jitter/Noise Mode, Time, Amplitude, Meas, and JSA/CRE toolbar measurements. These are listed on the Jitter pane and Amplitude pane.
• In TDR/TDT Mode, Time, Amplitude, 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 pane
• Histograms pane
• Mask Test pane
• JSA Results pane

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.5 script. Before you run the script, view an eye diagram on the display with channel 1A.

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