VTI Instruments Corp.
190
EX1629 Command Set
vtex1629_get_tare
F
UNCTION
P
ROTOTYPE
ViStatus vtex1629_get_tare (ViSession
vi
, ViInt32
channel
, ViPReal64
tareValue
);
F
UNCTION
P
ARAMETERS
vi
= contains a session handle to the instrument. This handle is obtained by the function and remains valid until the
session is closed.
channel
= an integer input value that specifies the channel for which the tare value will be returned. Valid input
values: 0 to 47.
tareValue
= a real return value that indicates the currently configured tare value for the given channel.
D
ATA
I
TEM
R
ESET
V
ALUE
Not applicable to this function.
D
ESCRIPTION
This function reads the currently configured tare value for a specific channel. The tare value is subtracted from the
output of the EU conversion for the channel. It should be specified in the proper units for the EU conversion (e.g.,
strain, volts, etc.) For strain measurements, it is also important to take into account whether a strain measurement is
being output in strain (ε) or microstrain (µε) and configure the tare value appropriately.
E
XAMPLE
ViSession instrumentHandle;
ViStatus status;
ViReal64 tare_value;
…
…
status = vtex1629_get_tare(instrumentHandle, 16, &tare_value);
