IviSpecAn_ConfigureFrequencyCenterSpan

CVI/LabWindows IVI Class Driver

IviSpecAn_ConfigureFrequencyCenterSpan

IviSpecAnBase Capability Group

C Function Prototype

ViStatus IviSpecAn_ConfigureFrequencyCenterSpan (ViSession vi, ViReal64 centerFrequency, ViReal64 span);

Purpose

This function configures the frequency range of the spectrum analyzer using the center frequency and the frequency span. If span corresponds to zero Hertz, then the spectrum analyzer operates in time-domain mode. Otherwise, spectrum analyzer operates in frequency-domain mode.

This function modifies the IVISPECAN_ATTR_FREQUENCY_START and IVISPECAN_ATTR_FREQUENCY_STOP attributes as follows:

Frequency Start = Center Frequency - Span/2
Frequency Stop = Center Frequency + Span/2

Note:

In auto-coupled mode, resolution bandwidth (RBW), video bandwidth (VBW), and sweep time may be affected by this function.

Parameters

Name Type Description
vi ViSession The ViSession handle that you obtain from the IviSpecAn_init or IviSpecAn_InitWithOptions function. The handle identifies a particular instrument session.

Default Value: None

centerFrequency ViReal64 The center frequency of the frequency sweep.

Units: Hertz

Default Value: 5.0 MHz

span ViReal64 The frequency span of the frequency sweep.

Units: Hertz

Default Value: 1.0 MHz

Return Values