VTI Instruments EX1629 - Vtex1629_Set_Strain_Units

VTI Instruments Corp.
284 EX1629 Command Set
vtex1629_set_strain_units
FUNCTION PROTOTYPE
ViStatus vtex1629_set_strain_units (ViSession vi, ViInt32 _VI_FAR channels[],ViInt32 numberOfChannels,
ViBoolean microStrain);
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 strain units will be set. Valid
input values: 0 to 47.
numberOfChannels = the size of the channels list. Valid input values: 1 to 48.
microStrain = a Boolean input value indicating whether strain measurements will be returned in units of strain (ε)
or microstrain (µε). Passing a value of VI_TRUE (1) will configure the instrument to return microstrain while
passing a value of VI_FALSE(0) will configure the instrument to return strain.
DATA ITEM RESET VALUE
microStrain = VI_FALSE(0) (strain)
DESCRIPTION
This function determines whether the EX1629 will return strain measurements in units of strain (ε) or microstrain
(µε) for a given list of channels. Each channel can be configured to return strain measurements in strain or
microstrain (1 strain (ε) = 1x10
6
microstrain (µε)). This setting has no effect for non-strain EU conversions.
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 channels[] = {0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15};
…
status = vtex1629_set_strain_units(instrumentHandle, channels, 16, VI_TRUE);