# :MEASure:RESults?

Results Panel List Commands

- :MEASure:LIST:CLEar
- :MEASure:LIST:ITEM{N}:COUNt?
- :MEASure:LIST:ITEM{N}:COUNt:STATus?
- :MEASure:LIST:ITEM{N}:COUNt:STATus:REASon?
- :MEASure:LIST:ITEM{N}:CURRent?
- :MEASure:LIST:ITEM{N}:MAXimum?
- :MEASure:LIST:ITEM{N}:MAXimum:STATus?
- :MEASure:LIST:ITEM{N}:MAXimum:STATus:REASon?
- :MEASure:LIST:ITEM{N}:MEAN?
- :MEASure:LIST:ITEM{N}:MEAN:STATus?
- :MEASure:LIST:ITEM{N}:MEAN:STATus:REASon?
- :MEASure:LIST:ITEM{N}:MINimum?
- :MEASure:LIST:ITEM{N}:MINimum:STATus?
- :MEASure:LIST:ITEM{N}:MINimum:STATus:REASon?
- :MEASure:LIST:ITEM{N}:NAME?
- :MEASure:LIST:ITEM{N}:OCCurrences
- :MEASure:LIST:ITEM{N}:REGion
- :MEASure:LIST:ITEM{N}:SDEViation?
- :MEASure:LIST:ITEM{N}:SDEViation:STATus?
- :MEASure:LIST:ITEM{N}:SDEViation:STATus:REASon?
- :MEASure:LIST:ITEM{N}:SOURce
- :MEASure:LIST:ITEM{N}:STATus?
- :MEASure:LIST:ITEM{N}:STATus:DETails?
- :MEASure:LIST:ITEM{N}:STATus:REASon?
- :MEASure:LIST:MOVE
- :MEASure:LIST:REMove
- :MEASure:LIST:SELect
- :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.

Be aware that the returned string is not meant to be an exact representation of the Results table. For example,

- Table fields that are not numerical values are often returned as a number. For example if the measurements source waveform is off, the table shows the "Current" value as "Source Off" but returns the value "Current=9.91E+37".
- Any questionable measurement results are also returned as the value "9.91E+37".
- Units of measurement are not returned. For example, "9.440E-11" is returned for a displayed value of "94.40 ps".
- Because results are returned in a comma-separated string, any measurement names that include commas in the Results table will not show commas in the returned string. However, the `:MEASure:LIST:ITEM{N}:NAME?` query will return measurement names that include commas.

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()