VTI Instruments EX1629, User Manual

Page: 284 / 346

VTI Instruments Corp.
284 EX1629 Command Set
vtex1629_set_strain_units
F
UNCTION
P
ROTOTYPE
ViStatus vtex1629_set_strain_units (ViSession vi , ViInt32 _VI_FAR channels[] ,ViInt32 numberOfChannels ,
ViBoolean microStrain );
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.
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.
D
ATA
I
TEM
R
ESET
V
ALUE
microStrain = VI_FALSE(0) (strain)
D
ESCRIPTION
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.
E
XAMPLE
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);