IviACPwr Fetch Measurement [MSR] VI
IviACPwrMeasurement Capability Group
This VI returns the value measured by a previous call to the IviACPwr Initiate Measurement VI. The IviACPwr Fetch Measurement VI returns a single measured value for the requested measurement type. Call this VI multiple times to retrieve the available measurement types and output phases. The available measurement types are divided into measurement groups. Use the IviACPwr Initiate Measurement VI to measure fresh values for that group.
 |
instrument handle The instrument handle that you obtain from the IviACPwr Initialize or IviACPwr Initialize With Options VIs. The handle identifies a particular instrument session.
Default Value: None |
||
 |
Phase Name ("") Specifies the name of the output phase to return the measurement.
Pass the virtual output phase name that you assign to the instrument in the IVI Configuration utility. Virtual output phase names are aliases for instrument-specific output phase strings, which can differ from one instrument to another. With virtual output phase names, you can use and swap instruments without having to change the output phase names in your source code. Assign a virtual output phase name to an instrument-specific output phase through the IVI Configuration utility. This control accepts virtual output phase names you have assigned to the specific instrument you are using and also accepts the instrument-specific output phase names. Default Value: ""
|
||
 |
Measurement Type (Frequency) Specifies the type of measurement to return.
Valid Values: Base Group: Voltage RMS L-N - IVIACPWR_VAL_MEASURE_VOLTAGE_RMS_LN (0) Voltage RMS line to neutral is measured. Current RMS - IVIACPWR_VAL_MEASURE_CURRENT_RMS (1) Current RMS is measured. Frequency - IVIACPWR_VAL_MEASURE_FREQUENCY (2) Frequency is measured. Voltage DC - IVIACPWR_VAL_MEASURE_VOLTAGE_DC (3) Voltage level is measured when in DC Only Mode. Current DC - IVIACPWR_VAL_MEASURE_CURRENT_DC (4) Current level is measured when in DC Only Mode. Power Factor - IVIACPWR_VAL_MEASURE_POWER_FACTOR (5) Power Factor is measured. Crest Factor - IVIACPWR_VAL_MEASURE_CREST_FACTOR (6) Crest Factor is measured. Current Peak - IVIACPWR_VAL_MEASURE_CURRENT_PEAK (7) Peak Current is measured. Power VA - IVIACPWR_VAL_MEASURE_POWER_VA (8) Power is measured in Volts-Amps. Real Power - IVIACPWR_VAL_MEASURE_POWER_REAL (9) Real Power is measured in Watts. Power DC - IVIACPWR_VAL_MEASURE_POWER_DC (10) Power is measured in Watts when in DC Only Mode. Phase Angle - IVIACPWR_VAL_MEASURE_PHASE_ANGLE (11) Phase Angle is measured in Degrees. Voltage RMS L-L - IVIACPWR_VAL_MEASURE_VOLTAGE_RMS_LL (12) Voltage RMS (line-to-line) is measured. Distortion Group: Current OHD - IVIACPWR_VAL_MEASURE_CURRENT_OHD (13) Current Odd Harmonics Distortion is measured. Current EHD - IVIACPWR_VAL_MEASURE_CURRENT_EHD (14) Current Even Harmonics Distortion is measured. Current THD - IVIACPWR_VAL_MEASURE_CURRENT_THD (15) Current Total (Odd+Even) Harmonic Distortion is measured. Voltage OHD - IVIACPWR_VAL_MEASURE_VOLTAGE_OHD (16) Voltage Odd Harmonics Distortion is measured. Voltage EHD - IVIACPWR_VAL_MEASURE_VOLTAGE_EHD (17) Voltage Even Harmonics Distortion is measured. Voltage THD - IVIACPWR_VAL_MEASURE_VOLTAGE_THD (18) Voltage Total (Odd+Even) Harmonic Distortion is measured. Default Value: Frequency - IVIACPWR_VAL_MEASURE_FREQUENCY (2) |
||
 |
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 IviACPwr Initialize or IviACPwr Initialize With Options VIs. | ||
 |
Measurement Returns the measured value. | ||
 |
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. |
