Chapter 5 257
Language Reference
MEASure Group of Commands
Fetch Commands
:FETCh:<measurement>[n]?
This command puts selected data from the most recent measurement
into the output buffer. Use FETCh if you have already made a good
measurement and you want to return several types of data (different [n]
values, e.g. both scalars and trace data) from a single measurement.
FETCh saves you the time of re-making the measurement. You can only
FETCh results from the measurement that is currently active, it will
not change to a different measurement.
If you need to get new measurement data, use the READ command,
which is equivalent to an INITiate followed by a FETCh.
The scalar measurement results will be returned if the optional [n]
value is not included, or is set to 1. If the [n] value is set to a value other
than 1, the selected trace data results will be returned. See each
command for details of what types of scalar results or trace data results
are available. The binary data formats should be used for handling
large blocks of data since they are smaller and transfer faster then the
ASCII format. (FORMat:DATA)
FETCh may be used to return results other than those specified with
the original READ or MEASure command that you sent.
Read Commands
:READ:<measurement>[n]?
• Does not preset the measurement to the factory default settings. For
example, if you have previously initiated the ACP measurement and
you send READ:ACP? it will initiate a new measurement using the
same instrument settings.
• Initiates the measurement and puts valid data into the output
buffer. If a measurement other than the current one is specified, the
instrument will switch to that measurement before it initiates the
measurement and returns results.
For example, suppose you have previously initiated the ACP
measurement, but now you are running the channel power
measurement. Then you send READ:ACP? It will change from
channel power back to ACP and, using the previous ACP settings,
will initiate the measurement and return results.
• Blocks other SCPI communication, waiting until the measurement is
complete before returning the results.
If the optional [n] value is not included, or is set to 1, the scalar
measurement results will be returned. If the [n] value is set to a
value other than 1, the selected trace data results will be returned.