VTI Instruments EX1629 - Vtex1629_Set_Tare

www.vtiinstruments.com
EX1629 Command Set 287
vtex1629_set_tare
FUNCTION PROTOTYPE
ViStatus vtex1629_set_tare (ViSession vi, ViInt32 _VI_FAR channels[], ViInt32 numberOfChannels, ViReal64
tareValue);
FUNCTION PARAMETERS
vi = contains a session handle to the instrument. This handle is obtained by the function and remains valid until the
session is closed.
channels = an input integer array containing a list of channel numbers for which the tare value will be set. Valid
input values: 0 to 47.
numberOfChannels = the size of the channels list. Valid input values: 1 to 48.
tareValue = a real input value indicating the tare value to set for all the indicated channels.
DATA ITEM RESET VALUE
tareValue = 0.00000
DESCRIPTION
This function sets the tare values for a list of channels. The tare value is subtracted from the output of the EU
conversion. It is used to provide a user-selectable offset value for a channel.
NOTE The tare value is not linked to the units setting. For correct results, the EU conversion and units
(ε or µε, if using a strain EU conversion) should be set first, followed by any tare value.
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 channels[] = {0};
…
status = vtex1629_set_tare (instrumentHandle, channels, 1, 0.01);