Querying and Modifying the Results Table

This topic explains how to return or modify the results shown in the measurement Results panel.

Querying the contents of the results panes

You can return all of the measurement results listed in the Results pane table using the :MEASure:RESults? query. This includes all of the following types of measurements:

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

You can use these queries to return individual results from a Results table measurement row identified by the ITEM{N} number:

• :MEASure:LIST:ITEM{N}:COUNt?
• :MEASure:LIST:ITEM{N}:CURRent?
• :MEASure:LIST:ITEM{N}:MAXimum?
• :MEASure:LIST:ITEM{N}:MEAN?
• :MEASure:LIST:ITEM{N}:MINimum?
• :MEASure:LIST:ITEM{N}:SDEViation?

The current result of a specific measurement can also be returned by querying the measurement. For example,

:MEASure:EYE:RTIMe?

Modifying the contents of the Results pane

You can select, clear, or remove measurement results from the results panels. First, use the measurement's :LOCation? child query to return an index value which represents the location of the result in the table. The list is indexed starting at 1, which is the top result in the table and the location of the most recent result. The first (top most) measurement in the list is identified as 1, the second measurement from the top is identified as 2, and so forth. In the above picture, Rise Time has an index of 1 and Fall Time has an index of 4. If more that one column of results is displayed, the index increases row-by-row from left to right. The following commands shows how to perform a risetime measurement, return the result's table index (in this example 4), and then remove the result from the table:

:MEASure:HORizontal:RTIMe
…
…
:MEASure:HORizontal:RTIMe:LOCation?  //  Returns the location of the rise time measurement.
:MEASure:LIST:REMove 4

Commands Used to Edit Measurements

The following list shows the various commands used to edit measurements already in the results table.

• :MEASure:LIST:ITEM{N}:OCCurrences
• :MEASure:LIST:ITEM{N}:REGion
• :MEASure:LIST:ITEM{N}:SOURce

Commands Used to Modify Results Table

These commands can be used to alter the measurement results table. Some measurement results tables cannot be modified. However, the :LOCation? child query is still used to return the measurement index.

• :MEASure:LIST:CLEar
• :MEASure:LIST:MOVE
• :MEASure:LIST:REMove
• :MEASure:LIST:SELect

See Also

Click the following links for information about querying other measurement results:

• Marker Commands
• Waveform Histogram Commands
• Mask Test Commands