IviACPwr Fetch Measurement Array [MSR] VI
IviACPwrMeasurement Capability Group
This VI returns the values measured by a previous call to the IviACPwr Initiate Measurement VI. The IviACPwr Fetch Measurement Array VI returns an array of measured values of 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.
 |
Measurement Buffer Size Specifies the size of the user-allocated measurement array. | ||
 |
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 (Array Current Cycle) Specifies the type of measurement to return.
Valid Values: Harmonic Group: Array Current Harmonic Phase - IVIACPWR_VAL_MEASURE_ARRAY_CURRENT_HARMONIC_PHASE (0) Current Harmonic Phase Angles are measured in degrees. Array Current Harmonic Magnitude Absolute - IVIACPWR_VAL_MEASURE_ARRAY_CURRENT_HARMONIC_ABS (1) Current Harmonic Magnitudes are measured as an absolute value in RMS Amps. Array Current Harmonic Magnitude Percent Fundamental - IVIACPWR_VAL_MEASURE_ARRAY_CURRENT_HARMONIC_PCT (2) Current Harmonic Magnitudes are measured as a Percent of fundamental. Array Voltage Harmonic Phase - IVIACPWR_VAL_MEASURE_ARRAY_VOLTAGE_HARMONIC_PHASE (3) Voltage Harmonic Phase Angles are measured in Degrees. Array Voltage Harmonic Magnitude Absolute - IVIACPWR_VAL_MEASURE_ARRAY_VOLTAGE_HARMONIC_ABS (4) Voltage Harmonic Magnitudes are measured as an absolute value in RMS Volts. Array Voltage Harmonic Magnitude Percent Fundamental - IVIACPWR_VAL_MEASURE_ARRAY_VOLTAGE_HARMONIC_PCT (5) Voltage Harmonic Magnitudes are measured as a percent of the fundamental. Waveform Group: Array Current Cycle - IVIACPWR_VAL_MEASURE_ARRAY_CURRENT_CYCLE (6) Single cycle of the current waveform in Amps. Array Voltage Cycle - IVIACPWR_VAL_MEASURE_ARRAY_VOLTAGE_CYCLE (7) Single cycle of the Voltage Waveform in Volts. Default Value: Array Current Cycle - IVIACPWR_VAL_MEASURE_ARRAY_CURRENT_CYCLE (6) |
||
 |
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 data array. | ||
 |
Measurement Actual Size Returns the number of values stored in the measurement array. | ||
 |
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. |
