Keysight Pathwave 89600 VSA .NET API
ConfigureMultiband Method
See Also 
Keysight.SA.Vsa.AdjacentChannelPower.Interfaces Assembly > Keysight.SA.Vsa.AdjacentChannelPower Namespace > MeasurementExtension Class : ConfigureMultiband Method


mode
A value indicating which MultibandMode strategy to apply when determining the number of required spectrum channels, and how to map the spectrum channels to Offset and Carrier regions.

Glossary Item Box

Configure multiband behavior for the AdjacentChannelPower measurement.

Syntax

Visual Basic (Declaration) 
Public Overridable Sub ConfigureMultiband( _
   ByVal mode As MultibandMode _
)
C# 
public virtual void ConfigureMultiband( 
   MultibandMode mode
)
C++/CLI 
public:
virtual void ConfigureMultiband( 
   MultibandMode mode
)

Parameters

mode
A value indicating which MultibandMode strategy to apply when determining the number of required spectrum channels, and how to map the spectrum channels to Offset and Carrier regions.

Exceptions

ExceptionDescription
System.ArgumentOutOfRangeExceptionThrown if recording playback is in use and a MultibandMode is not MultibandMode.None.

Remarks

This method configures the desired number of spectrum channels, and then assigns these channels to offset and carrier regions (using SpectrumChannelIndex, Offset.LowerSpectrumChannelIndex, and Offset.UpperSpectrumChannelIndex) to configure multiband behavior. This method may attempt to adjust Agilent.SA.Vsa.Input.AcquisitionSequenceCount, and may call Agilent.SA.Vsa.Input.ChangeInputDomains to configure the desired number of spectrum channels. The recommended procedure for configuring multiband operation in MeasurementExtension is:
  1. Configure the Carrier and Offset definitions to match the desired SEM measurement.
  2. Choose desired MultibandMode and call the ConfigureMultiband method.
  3. If Agilent.SA.Vsa.AnalogChannel.Range needs to be adjusted for a Carrier or Offset, use SpectrumChannelIndex or Offset.LowerSpectrumChannelIndex or Offset.UpperSpectrumChannelIndex with Agilent.SA.Vsa.Analog.Channels to access the correct item.
  4. If a Agilent.SA.Vsa.SpectrumFrequencyChannel property needs to be adjusted for the Carrier or Offset, use SpectrumChannelIndex or Offset.LowerSpectrumChannelIndex or Offset.UpperSpectrumChannelIndex with Channels to access the correct item. Note: Many properties for Agilent.SA.Vsa.SpectrumFrequencyChannel are fixed by the Carrier settings, and cannot be adjusted.

Requirements

Target Platforms: Windows 11 Professional or Enterprise; Windows 10 Professional, Enterprise, or Education (64-bit)

Minimum Software Version Requirement: Keysight PathWave 89600 VSA Ver 27.00

See Also