Admin Production ni-theme
Current Publication

Configure Offset

IVI Compliance Package

IviPwrMeter Configure Offset

IviPwrMeterBase Capability Group

This VI specifies the offset to be added to the measured value in units of dB.

instrument handle The instrument handle that you obtain from the IviPwrMeter Initialize or IviPwrMeter Initialize With Options VIs.
channel name The name of the channel for which to set the Offset.

Pass the virtual channel name that you assign to the instrument in the Configuration Utility.

Virtual channel names are aliases for instrument-specific channel strings. The instrument-specific channel strings can differ from one instrument to another. Virtual channel names allow you to use and swap instruments without having to change the channel names in your source code. You assign a virtual channel name to an instrument-specific channel through the Configuration Utility. This control accepts virtual channel names you have assigned to the specific instrument you are using. It also accepts the instrument-specific channel names.

Default Value: ""
offset Specifies an offset to be added to the measured value. The units of this property are dB. This property can be used to compensate for system losses or gains between the unit under test and the sensor of the power meter. The driver sets the IviPwrMeter>>Basic Operation>>Offset property to this value.

For example, a cable loss of 2 dB could be compensated for by setting this property to 2. Similarly, a gain stage of 10 dB could be accounted for by setting the value of this property to -10. In both cases, the reading from the power meter will indicate the power at the unit under test rather than power at the power meter's sensor.

Unit: dB

Default Value: 0.0 dB
error in (no error) The error in cluster can accept error information wired from VIs previously called. Use this information to decide if any functionality should be bypassed in the event of errors from other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.

instrument handle out The instrument handle that you obtain from the IviPwrMeter Initialize or IviPwrMeter Initialize With Options VIs.
error out The error out cluster passes error or warning information out of a VI to be used by other VIs.

The pop-up option Explain Error (or Explain Warning) gives more information about the error displayed.