IviPwrMeter Configure Measurement
IviPwrMeterBase Capability Group
This VI configures the instrument to take single or dual channel measurements.
For single channel measurements, this VI enables the channel specified by Operand1 and disables all other channels. The result returned by the Fetch or Read VIs is the measurement taken at the channel specified by Operand1. Although, the driver measures the power in Watts, the result is converted to the same unit as the value of the IviPwrMeter>>Basic Operation>>Units property.
For dual channel measurements, this VI enables the channels specified by Operand1 and Operand2 and disables all other channels. The result returned by the Fetch or Read VIs is the result of the specified math operation applied to the measurements on the channels specified by Operand1 and Operand2.
Although, the math operation is performed on the measured values in Watts,the result is converted to the appropriate units depending on the value of the Units property and the value of the Operator.
For Difference and Sum operations, the resulting units is the same as the Units property.
For Quotient operations, the resulting units are in dB, except when Units are set to Watts. When set to Watts, the resulting measurement is without units.
 |
instrument handle The instrument handle that you obtain from the IviPwrMeter Initialize or IviPwrMeter Initialize With Options VIs. |
 |
operator The math VI applied to the operands.
To configure the power meter to take single channel measurements, pass None as the Operator value. To configure the power meter to take simultaneous dual channel measurements, pass one of the other defined math operators as the Operator value. Valid Values: IVIPWRMETER_VAL_NONE (No Operator) - Take a single channel measurement. Return the measured value for Operand1. Operand2 is ignored. IVIPWRMETER_VAL_DIFFERENCE (Difference) - Subtract the power measured on Operand2 from the power measured on Operand1. IVIPWRMETER_VAL_SUM (Sum) - Add the power measured on Operand2 to the power measured on Operand1. IVIPWRMETER_VAL_QUOTIENT (Quotient) - Divide the power measured on Operand1 by the power measured on Operand2. Default Value: IVIPWRMETER_VAL_DIFFERENCE (Difference) |
 |
operand 1 The name of the channel from which the value for the first operand of the math operator is measured.
Default Value: "" |
|
operand 2 The name of the channel from which the value for the second operand of the math operator is measured.
Default Value: "" |
 |
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. |