# :MEASure Subsystem

:MEASure Command Groups

- Configure Measurements
- Measurements
- Jitter
- Marker Commands
- Limit-Test Commands
- Limit-Lines Commands
- Waveform Histogram Commands
- Measurement Histogram Commands
- Mask Test Commands
- Returning Measurements
- Querying and Modifying the Results Table
- Measurement Errors

Use the Measure (`:MEASure`) subsystem to make parametric measurements on displayed waveforms. Once a valid waveform is displayed, select the command in this subsystem that corresponds to the measurement that you wish to make including results for histograms, marker, eye masks, and limit lines.

Measurements are made using statistics on a waveform database.

- To return reliable scalar measurements, see Returning Measurements.
- To return measurement results shown in the tables, see Querying and Modifying the Results Table.
- If a measurement cannot be made, see Measurement Errors.

## Displaying a Valid Waveform

To make a measurement, the portion of the waveform required for that measurement must be displayed on Infiniium. For example,

- For a period or frequency measurement, at least 1.5 complete cycles must be displayed.
- For a pulse width measurement, the entire pulse must be displayed.
- For a rise time measurement, the leading (positive-going) edge of the waveform must be displayed.
- For a fall time measurement, the trailing (negative-going) edge of the waveform must be displayed.

## Making Measurements

If more than one period, edge, or pulse is displayed, time measurements are made on the first, left-most portion of the displayed waveform. When any of the defined measurements are requested, Infiniium first determines the top (100%) and base (0%) voltages of the waveform. From this information, Infiniium determines the other important voltage values (10%, 90%, and 50% voltage values) for making measurements. The 10% and 90% voltage values are used in the rise-time and fall-time measurements when standard measurements are selected. The 50% voltage value is used for measuring frequency, period, pulse width, and duty cycle with standard measurements selected. You can also make measurements using user-defined parameters, instead of the standard measurement values as explained later in this topic.

When the command form of a measurement is used, the measurement result is displayed in the results panel:

    :MEASure:EYE:EWIDth

When the query form of the measurement is used, the measurement is made one time and the measurement result is returned.

    :MEASure:EYE:EWIDth?

Also,

- If the current acquisition is complete, the current acquisition is measured and the result is returned.
- If the current acquisition is incomplete and Infiniium is running, acquisitions will continue to occur until the acquisition is complete. The acquisition will then be measured and the result returned.
- If the current acquisition is incomplete and Infiniium is stopped, the measurement result will be "9.91E+37 which represents Not a Number (NaN)".

You can also return the measurement results of every measurement that is listed in all displayed measurement results panes that are displayed below the graticule. Use the `:MEASure:RESults?` query. The following is an example of three measurements returned. Line breaks have been added to make the string easier to read:

    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

All measurements are made using the entire display, except for vRMS which allows measurements on a single cycle, and eye measurements in the defined eye window. Therefore, if you want to make measurements on a particular cycle, display only that cycle on the screen.

Measurements are made on the displayed waveform specified by the measurement's child `:SOURce` command. For example, to make a rise time measurement on channel 1_2 use the following commands:

    :MEASure:HORizontal:RTIMe:SOURce CHAN1_2
    :MEASure:HORizontal:RTIMe?

Most measurements are only made on a single source. Some measurements are more complicated, such as the delta time, and can be made on one or two sources with additional waveform parameters specified.

    :CHANnel1:DISPlay ON
    :MEASure:HORizontal:DTIMe:ENUMber1 1
    :MEASure:HORizontal:DTIMe:ENUMber2 2
    :MEASure:HORizontal:DTIMe:EDIRection1 RISing
    :MEASure:HORizontal:DTIMe:ETHReshold1 MIDDle
    :MEASure:HORizontal:DTIMe:EDIRection2 RISing
    :MEASure:HORizontal:DTIMe:ETHReshold2 MIDDle
    :MEASure:HORizontal:DTIMe

### To return all results for all measurements that are displayed in a results table

- :MEASure:RESults?

### To turn on or off the display of measurement annotations on the displayed waveform

- :MEASure:ANNotations:STATe