:MEASure:OSCilloscope:USER

Meas. mode:
Scope
Package License:
L-RND
L-MFG
Waveform type:
NRZ
PAM4
Flex Apps:
FlexDCA
FlexRT
User Measurements (Scope) Commands

Command Syntax

:MEASure:OSCilloscope:USER{1:8}

{1:8} selects one of eight possible user measurements.

Description

Turns on the selected oscilloscope mode user-defined measurement. The query form of the command returns the measured value. If the selected user measurement has not been created using the :CFILe child command, the value NaN (9.91E+37) is returned.

Requires FlexDCA revision A.05.00 and above.

Measurement Ready?

To confirm that the measurement is ready to read, you can query the measurement's status:

if ('CORR' in Flex.query(':MEASure:OSCilloscope:USER:STATus?')):
	measurement = Flex.query(':MEASure:OSCilloscope:USER?')

If averaging is turned on (:ACQuire:AVERaging), you can also confirm if the measurement result is ready by comparing the number of specified averages (:ACQuire:ECOunt?) versus the number of measurement sweeps that have occurred (:MEASure:OSCilloscope:USER:COUNt?). The technique uses the :COUNt? common measurement query. For example,

if (Flex.query(':MEASure:OSCilloscope:USER:COUNt?') >= Flex.query(':ACQuire:ECOUNt?')):
	measurement = Flex.query(':MEASure:OSCilloscope:USER?')

You can also use an acquisition limit lest to test that a number of waveform samples, or pattern acquisitions have completed before returning a measurement. Refer to the :LTESt:ACQuire:CTYPe command.

Common Measurement Child Queries

This command supports the use of the following common measurement queries: :LOCation?, :COUNt?, :MAXimum?, :MINimum?, :MEAN?, and :SDEViation?.

Measurement Identification

Avoid subtle programming errors! To ensure that the correct measurement is installed or queried, always explicitly identify a measurement when installing a measurement or querying a measured value, status, or detail. To identify a measurement, specify the measurement's source waveform (:SOURce child command). With some measurements, you may also need to specify other identifying values. Generally, when selecting a measurement using FlexDCA's GUI, if a dialog appears prompting you to select values, you should explicitly specify these values when remotely identifying the measurement. More information.

For example, to return the status of the measurement, :MEASure:OSCilloscope:USER:

flex.write(':MEASure:OSCilloscope:USER:SOURce CHAN1A')
if flex.query(':MEASure:OSCilloscope:USER:STATus?') == 'CORR';
    measurement = flex.query(':MEASure:OSCilloscope:USER?')
else:
	details = flex.query(':MEASure:OSCilloscope:USER:STATus:DETails?')
	reason = flex.query(':MEASure:OSCilloscope:USER:STATus:REASon?')

Child commands for measurement identification:

  • :MEASure:OSCilloscope:USER:SOURce
  • :MEASure:OSCilloscope:USER:REGion