Dmm.rel.acquire() - Keithley 3700A Series Reference Manual

Section 11: TSP command reference

dmm.rel.acquire()

This function acquires a measurement and stores it as the relative offset value.
Type TSP-Link accessible
Function Yes
Usage
relativeValue = dmm.rel.acquire()
relativeValue
Details
This attribute is not applicable for "continuity" and "nofunction".
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, use the dmm.rel.level attribute to see the last relative level value
that was acquired or set by the user.
If error occurs during the reading, nil is returned.
An error is generated if:
•
dmm.func is set to "continuity" or "nofunction".
•
The DMM is unable to take the measurement.
When an error occurs, the relative offset level setting maintains the last valid setting.
Example
dmm.func = "temperature"
rel_value = dmm.rel.acquire()
Also see
dmm.func (on page 11-179)
dmm.rel.level
11-216
Affected by
The internal measurement acquired for the relative offset level value
(on page 11-218)
Series 3700A System Switch/Multimeter Reference Manual
Where saved Default value
Acquires a relative offset level value for
temperature.
3700AS-901-01 Rev. D/June 2018