Keithley 3730 Reference Manual

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
dmm.func (on page 11-179)
dmm.rel.level (on page 11-218)

Keithley 3730 Specifications

General

Brand	Keithley
Model	3730
Category	Multimeter
Language	English