Admin Production ni-theme
Current Publication

Configure Trace Type

IVI Compliance Package

IviSpecAn Configure Trace Type

IviSpecAnBase Capability Group

This VI configures the type of trace to acquire.

instrument handle The instrument handle that you obtain from the IviSpecAn Initialize or IviSpecAn Initialize With Options VIs.
trace name Pass the name of the trace you are configuring.

This control accepts either a virtual repeated capability name or an instrument-specific trace name.

Virtual repeated capability names are aliases for instrument-specific trace strings. The instrument-specific trace strings can differ from one instrument to another. Virtual repeated capability names allow you to use and swap instruments without having to change the trace names in your source code. You specify virtual repeated capability names in MAX.


Default Value: ""
trace type The type of trace to acquire. The driver sets the
IviSpecAn>>Basic Operation>>Trace Type property to this value.

Valid Values:
IVISPECAN_VAL_TRACE_TYPE_CLEAR_WRITE
- Sets the spectrum analyzer to clear previous sweep data
off the display before performing a sweep. Subsequent
sweeps may or may not clear the display first, but the
data array at the end of the sweep is entirely new.

IVISPECAN_VAL_TRACE_TYPE_MAX_HOLD
- Sets the spectrum analyzer to keep the data from either
the previous data or the new sweep data, which ever is
higher.

IVISPECAN_VAL_TRACE_TYPE_MIN_HOLD
- Sets the spectrum analyzer to keep the data from either
the previous data or the new sweep data, which ever is
lower.

IVISPECAN_VAL_TRACE_TYPE_VIDEO_AVERAGE
- Sets the spectrum analyzer to maintain a running average
of the swept data.

IVISPECAN_VAL_TRACE_TYPE_VIEW
- Disables acquisition into this trace but displays the
existing trace data.

IVISPECAN_VAL_TRACE_TYPE_STORE
- Disables acquisition and disables the display of the
existing trace data.

Default Value: IVISPECAN_VAL_TRACE_TYPE_CLEAR_WRITE
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 IviSpecAn Initialize or IviSpecAn 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.