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 |