VTI Instruments EX1629 - Vtex1629_Set_Linearscaling_Configuration

www.vtiinstruments.com
EX1629 Command Set 265
vtex1629_set_linearscaling_configuration
FUNCTION PROTOTYPE
ViStatus vtex1629_set_linearscaling_configuration (ViSession vi, ViInt32 _VI_FAR channels[],ViInt32
numberOfChannels, ViReal64 m, ViReal64 b);
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 linear scaling coefficients will
be set. Valid input values: 0 to 47.
numberOfChannels = the size of the channels list. Valid input values: 1 to 48.
m = a real input value indicating the gain factor, m, in the linear equation y = mx + b.
b = a real input value indicating the offset value, b, in the linear equation: y = mx + b.
DATA ITEM RESET VALUE
m = 2.000000 b = 0.000000
DESCRIPTION
This function sets the slope (m) and intercept (b) parameters for a channel when configured for linear EU
conversion (x being in volts).
NOTE The m parameter (slope) is stored in the same location as the gage factor and the b parameter
(intercept) is stored in the same location as the unstrained voltage. Since the linear scaling EU
conversion and the strain EU conversions are mutually exclusive, this is never an issue in practice.
EXAMPLE
ViSession instrumentHandle;
ViStatus status;
ViInt32 channels[] = {24};
…
status = vtex1629_set_linearscaling_configuration(instrumentHandle,
channels,
1,
1.0,
0.0);