Command Groups
Measurement C
ommand Group
Use the commands in the Measurement Command Group to control the automated
measurement system.
Up to eight automated measurements can be displayed on the screen. In the
commands, these measurement readouts are named MEAS<x>, where <x> is the
measurement number.
In addition to the eight displayed measurements, the measurement commandslet
you specify an additional measurement, IMMed. The immediate measurement
has no front-panel equivalent. Immediate measurements are never displayed.
Because they are computed only when needed, immediate measurements slow the
waveform update rate less than displayed measurements.
To obtain measurement results, use the MEASUrement:MEAS<x>:VALue?
query for displayed results or the MEASUrement:IMMed:VALue? query for
immediate measurements.
Measurement commands can set and query measurement parameters. You
can assign some parameters, such as waveform sources, differently for each
measurement. Other parameters, such as reference levels, have only one value,
which applies to all measurements.
Readout values for t
he 8 displayed measurements are updated periodically. As
such, queries of these measurement values may return 9.91E+37, which represents
NaN (not a number) and a measurement warning event (e.g. 2225. “Measurement
error. No waveform to measure”) when the measurement is not yet computed.
Immediate measurement queries will return values once the measurement has
been computed.
Example of Immediate
Measurements
An example command sequence follows that illustrates immediate measurements
of Cycle Mean on channel 1:
:MEASUrement:IMMed:SOUrce1 CH1
:MEASUrement:IMMed:TYPe CMEan
:MEASUrement:IMMed:VALue? -18.5568E-3
:MEASUrement:IMMed:VALue?;VALue?;VALue?
-21.6400E-3;-23.8023E-3;-21.0064E-3
Table 2-33: Measurement Commands
Command
Description
MEASUrement?
Returns all measurement parameters
MEASUrement:CLEARSNapshot
Removes the measurement snapshot display
MEASUrement:GATing This command specifies the measurement gating
MEASUrement:IMMed?
Returns all immediate measurement setup parameters
2-36 MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual