CALCulate:SCALe:GAIN
CALCulate:SCALe:GAIN
CALCulate:SCALe:OFFSet
Syntax
CALCulate:SCALe:GAIN <gain>[,(@<ch_list>)]
CALCulate:SCALe:GAIN? [(@<ch_list>)]
CALCulate:SCALe:OFFSet <offset>[,(@<ch_list>)]
CALCulate:SCALe:OFFSet? [(@<ch_list>)]
Description
These commands set the gain ("M") and offset ("B") for scaled readings on the specified multiplexer channels.
Used With:
- 34901A 20 Channel Multiplexer (2/4-wire) Module
- 34902A 16 Channel Multiplexer (2/4-wire) Module
- 34908A 40 Channel Single-Ended Multiplexer Module
Parameters
Name Type Range of Values Default Value <gain> Numeric Any value between -1E15 to +1E15 This is a required parameter. The factory default is 1.
<offset> Numeric Any value between -1E+15 and +1E+15. This is a required parameter. The factory default is 0.
<ch_list> Channel List One or more channels, as shown:
(@310) - channel 10 on the module in slot 300.
(@305:310) - channels 05 through 10 on the module in slot 300.
(@202:207,209,302:308) - channels 02 through 07 and 09 on the module in slot 200 and channels 02 through 08 on the module in slot 300.
If you omit the optional <ch_list> parameter, this command applies to the currently defined scan list.
Remarks
- Scaling is applied using the following equation:
Scaled Reading = (Gain x Measurement) + Offset - After setting the gain and offset values, use the CALCulate:SCALe:STATe command to enable the scaling function.
- Readings can be acquired during a scan using the multiplexer. For scanning measurements using the multiplexer modules, an error is generated if the internal DMM is disabled (see INSTrument:DMM command) or not installed in the mainframe.
- You must configure the channel (function, transducer type, etc.) before applying any scaling values. If you change the measurement configuration, scaling is turned off on that channel and the gain and offset values are reset (M=1 and B=0). Scaling is also turned off when you change the temperature probe type, temperature units, or disable the internal DMM.
- If you change the measurement configuration (function, transducer type, etc.) on a channel or the internal DMM, scaling is turned off on those channels and the gain and offset values are cleared.
- If you plan to use scaling on a channel which will also use alarms, be sure to configure the scaling values first. If you attempt to assign the alarm limits first, the instrument will turn off alarms and clear the limit values when you enable scaling on that channel. If you specify a custom measurement label with scaling, it is automatically used when alarms are logged on that channel.
- If you redefine the scan list, no change will be made to the scaling state or the gain and offset values. If you decide to add a channel back to the scan list, the original gain and offset values are restored.
- You can use scaling to make a "null" measurement on a channel and store it as the offset ("B") for subsequent measurements. This allows you to adjust for voltage or resistive offsets through your wiring to the point of the measurement. See CALCulate:SCALe:OFFSet:NULL.
- The CONFigure and MEASure? commands automatically set the gain ("M") to 1 and offset ("B") to 0.
- A Factory Reset (*RST command) turns off scaling and clears the scaling values on all channels (gain = 1, offset = 0). An Instrument Preset (SYSTem:PRESet command) does not clear the scaling values and does not turn off scaling.
Return Format
The query returns the gain or offset value for each channel specified. Multiple responses are separated by commas.
Examples
The following command sets the gain to +1.25 on channels 03 and 13 in slot 100.
CALC:SCAL:GAIN 1.25,(@103,113)
The following query returns the gain settings on channels 03 and 13 in slot 100.
CALC:SCAL:GAIN? (@103,113)
Typical Response: +1.25000000E+00,+1.25000000E+00
The following command sets the offset to +10.125 on channels 03 and 13 in slot 100.
CALC:SCAL:OFFS 10.125,(@103,113)
The following query returns the offset values on channels 03 and 13 in slot 100.
CALC:SCAL:OFFS? (@103,113)
Typical Response: +1.01250000E+01,+1.01250000E+01