7½ Digit Graphical Sampling Multimeter Reference Manual Section 8:
DMM7510-901-01 Rev. B / May 2015 8-179
dmm.measure.rel.acquire()
This function acquires a measurement and stores it as the relative offset value.
Type TSP-Link accessible
Affected by Where saved Default value
Usage
dmm.measure.rel.acquire()
Functions
dmm.FUNC_DIGITIZE_CURRENT
dmm.FUNC_DIGITIZE_VOLTAGE
Details
This command triggers the instrument to make a new measurement for the selected function. This
measurement is then stored as the new relative offset level.
When you send this command, the instrument does not apply any math, limit test, or filter settings to
the measurement, even if they are set. It is a measurement that is made as if these settings are
disabled.
If an error event occurs during the measurement, nil is returned and the relative offset level remains
at the last valid setting.
You must change to the function for which you want to acquire a value before sending this command.
The instrument must have relative offset enabled to use the acquired relative offset value.
After executing this command, you can use the dmm.measure.rel.level attribute to see the last
relative level value that was acquired or that was set.
Example
dmm.measure.func = dmm.FUNC_DC_VOLTAGE
rel_value = dmm.measure.rel.acquire()
dmm.measure.rel.enable = dmm.ON
print(rel_value)
Acquires a relative offset level value for voltage
measurements, turns the relative offset feature
on, and outputs the value.
Also see
dmm.digitize.rel.acquire() (on page 8-111)
dmm.measure.rel.enable (on page 8-180)
dmm.measure.rel.level (on page 8-181)