Section 11: TSP command reference
Series 3700A System Switch/Multimeter Reference Manual
11-216
3700AS-901-01 Rev. D/June 2018
dmm.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
Function
Yes
Usage
relativeValue
= dmm.rel.acquire()
relativeValue
The internal measurement acquired for the relative offset level value
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()
Acquires a relative offset level value for
temperature.
Also see
(on page 11-179)
(on page 11-218)