Channel Object

See SourcePowerCalData Interface for putting and getting typed source power calibration data.

Description

The channel object is like the engine that produces data. Channel settings consist of stimulus values like frequency, power, IF bandwidth, and number of points.

Accessing the Channel object

You can get a handle to a channel in a number of ways. But first you have to make sure that the channel exists. When you first startup the analyzer, there is one S11 measurement on channel 1. Thus there is only one channel in existence. You can do the following:

Dim app As AgilentPNA835x.Application
Set app = CreateObject("AgilentPNA835x.Application", <analyzerName>)

Dim chan As IChannel
Set chan = app.ActiveChannel

Set chan = app.Channels(2)

The first method returns the channel object that is driving the active measurement. If there is no measurement, there may not be a channel. Once a channel is created, it does not go away. So if there once was a measurement (hence a channel), the channel will still be available.

If there is no channel you can create one in a couple ways. You can do the following:

Pna.CreateMeasurement( ch1, "S11", port1, window2)

Pna.Channels.Add(2)

The latter will have no visible effect on the analyzer. It will simply create channel 2 if it does not already exist.

See Also:

(Bold Methods or Properties provide access to a child object)

Methods	Interface See History	Description
Abort	IChannel	Aborts the current measurement sweep on the channel.
ApplySourcePowerCorrectionTo	IChannel11	Copies an existing Source Power Calibration to another channel.
AveragingRestart	IChannel	Clears and restarts averaging of the measurement data.
Continuous	IChannel	The channel continuously responds to trigger signals.
CopyToChannel	IChannel2	Sets up another channel as a copy of this objects channel.
FrequencySpanFull	IChannel25	Sets the frequency span to the entire frequency range of the analyzer.
GetConverter	IChannel17	Returns a handle to a Converter object.
GetErrorCorrection	IChannel8	Returns the channel error correction state.
GetNumberOfGroups	IChannel4	Returns the number of groups a channel has yet to acquire.
GetPortNumber	IChannel13	Returns the port number for the specified string port name.
GetRxLevelingConfiguration	IChannel17	Returns a handle to a RxLevelingConfiguration object
getSourcePowerCalData	IChannel	Superseded with Get SourcePowerCalDataEx
getSourcePowerCalDataEx	IChannel4	Returns requested source power calibration data, if it exists.
GetSupportedALCModes	IChannel10	Returns a list of supported ALC modes
GetXAxisValues	IChannel	Returns the channel's X-axis values into a dimensioned Variant array.
GetXAxisValues2	IChannel	Returns the channel's X-axis values into a dimensioned NON-Variant array.
Hold	IChannel	Puts the Channel in Hold - not sweeping.
Next_IFBandwidth	IChannel	A function that returns the Next higher IF Bandwidth value.
NumberOfGroups	IChannel	Sets the Number of trigger signals the channel will receive.
Preset	IChannel	Resets the channel to factory defined settings.
PreviousIFBandwidth	IChannel	Returns the previous IF Bandwidth value.
putSourcePowerCalData	IChannel	Superseded with Put SourcePowerCalDataEx Method
putSourcePowerCalDataEx	IChannel4	Inputs source power calibration data to this channel for a specific source port.
SelectCalSet	IChannel	Specifies the Cal Set to use for the Channel
Single	IChannel	Channel responds to one trigger signal from any source (internal, external, or manual). Then channel switches to Hold.
UnselectCalset	IChannel24	Unselects a Cal Set from the specified channel.
Properties	Interface	Description
ALCLevelingMode	IChannel10	Set or return the ALC leveling mode.
AlternateSweep	IChannel	Sets sweeps to either alternate or chopped.
Attenuator	IChannel	Sets or returns the value of the attenuator control for the specified port number.
AttenuatorMode	IChannel	Sets or returns the mode of operation of the attenuator control for the specified port number.
AuxiliaryTrigger	IChannel10	Provides access to Auxiliary Triggering
Averaging	IChannel	Turns trace averaging ON or OFF for all measurements on the channel.
AveragingCount	IChannel	Returns the number of sweeps that have been averaged into the measurements.
AveragingFactor	IChannel	Specifies the number of measurement sweeps to combine for an average.
AverageMode	IChannel16	Sets Point or Sweep averaging.
BalancedTopology	IChannel6	Provides access to the topology of a balanced DUT.
Calibrator	IChannel4	Provides access to Unguided calibration.
CalSet	IChannel7	Provides access to the contents of a Cal Set
centerFrequency	IChannel	Sets or returns the center frequency of the channel. Shared with the Segment Object
CenterFrequencyStepSize	IChannel25	Sets and reads the center frequency step size of the analyzer.
CenterFrequencyStepSizeMode	IChannel25	Sets and reads how the center frequency step size is determined.
channelNumber	IChannel	Returns the Channel number. Shared with the Measurement Object
Converter	IChannel21	Provides access to a mixer/converter object.
CorrectionMethods	IChannel21	Provides access to channel correction properties.
CoupleChannelParams	IChannel5	Turns ON and OFF Time Domain Trace Coupling.
CouplePorts	IChannel	Turns ON and OFF port power coupling.
CustomChannelConfiguration	IChannel12	Provides access to custom application objects.
CWFrequency	IChannel	Set the Continuous Wave (CW) frequency.
DCStimulus	IChannel23	Provides access to the DCStimulus object.
DefinedRoles	IChannel22	Returns the roles for which sources can be used for the channel.
DwellTime	IChannel	Sets or returns the dwell time for the channel. Shared with the Segment Object
ErrorCorrection	IChannel7	Attempts to sets error correction ON or OFF for all of the measurements on the channel.
ExternalTriggerDelay	IChannel6	Sets or returns the external trigger delay value for the channel.
FastCWPointCount	IChannel16	Enables Fast CW sweep and sets the number of data points for the channel.
Fixturing	IChannel6	Provides access to Port Ext, Embedding, and De-embedding functions.
FOM Collection	IChannel9	Provides access to Frequency Offset Measurements
FrequencyOffsetDivisor	IChannel2
FrequencyOffsetFrequency	IChannel2
FrequencyOffsetMultiplier	IChannel2	Superseded with FOM and FOMRange
FrequencyOffsetCWOverride	IChannel2
FrequencyOffsetState	IChannel2
FrequencySpan	IChannel	Sets or returns the frequency span of the channel. Shared with the Segment Object.
FrequencyStep	IChannel24	Sets the frequency step size across the selected frequency range.
IFBandwidth	IChannel	Sets or returns the IF Bandwidth of the channel. Shared with the Segment Object.
IFConfiguration	IChannel4	Provides access to the IF gain and source path settings for the H11 Option.
IsBlocked	IChannel19	Returns whether or not a channel is blocked from sweeping.
IsContinuous	IChannel4	Returns whether or not a channel is in continuous mode.
IsHold	IChannel4	Returns whether or not a channel is in hold mode.
LowFrequencyExtension	IChannel26	Enables low frequency extension (LFE).
MeasurementClass	IChannel15	Returns the measurement class name.
MultiDimensionalSweep	IChannel27	Provides access to the MultiDimensionalSweep Object.
NumberOfPoints	IChannel	Sets or returns the Number of Points of the channel. Shared with the Segment Object.
Parent	IChannel	Returns a handle to the parent object of the channel.
PathConfiguration	IChannel10	Provides access to path configuration switches and setting.
PathConfigurationManager	IChannel10	Provides access to path configuration file management.
PhaseControl	IChannel21	Provides access to the PhaseControl object.
PointSweepState	IChannel16	Turns point sweep ON or OFF for all measurements on the channel.
PowerSlope	IChannel	Sets or returns the Power Slope value.
PowerSlopeState	IChannel18	Turns power slope ON or OFF
PulseGenerator	IChannel10	Provides access to pulse generator configuration.
PulseGeneratorID	IChannel23	Returns the ID for the specified Pulse Generator name.
PulseGeneratorNames	IChannel23	Returns a list of configured Pulse Generator names.
PulseMeasControl	IChannel20	Provides access to pulse measurement settings.
R1InputPath	IChannel2	Throws internal reference switch.
ReceiverAttenuator	IChannel	Sets or returns the value of the specified receiver attenuator control.
ReduceIFBandwidth	IChannel5	Sets or returns the state of the Reduced IF Bandwidth at Low Frequencies setting.
RoleDevice	IChannel22	Sets and returns the source to be used in the specified role.
RXLevelingConfiguration	IChannel21	Provides access to the ReceiverLeveling Object
Segments	IChannel	Provides access to the Collection for iterating through the sweep segments of a channel.
SignalProcessingModuleFour	IChannel10	Provides access to the SignalProcessingModuleFour object.
SourcePortCount	IChannel13	Returns the number of source ports.
SourcePortFixedFrequency	IChannel27	Set and read the fixed frequency value for a specific port.
SourcePortMode	IChannel9	Sets the state of the VNA sources. (AUTO \| ON \| OFF)
SourcePortNames	IChannel13	Returns the string names of source ports.
SourcePortStartFrequency	IChannel27	Set and read the start frequency value for a specific port.
SourcePortStopFrequency	IChannel27	Set and read the stop frequency value for a specific port.
SourcePowerCalPowerOffset	IChannel4	Sets or returns a power level offset from the VNA test port power.
SourcePowerCorrection	IChannel	Turns source power correction ON or OFF for a specific source port.
StartFrequency	IChannel	Sets or returns the start frequency of the channel. Shared with the Segment Object
StartPower	IChannel	Sets the start power of the analyzer when sweep type is set to Power Sweep.
StartPowerEx	IChannel13	Sets and reads the power sweep start power value for a specific port.
StopFrequency	IChannel	Sets or returns the stop frequency of the channel. Shared with the Segment Object
StopPower	IChannel	Sets the Stop Power of the analyzer when sweep type is set to Power Sweep.
StopPowerEx	IChannel13	Sets and reads the power sweep stop power value for a specific port.
SweepDelay	IChannel19	Sets the time to wait just before acquisition begins for each sweep.
SweepGenerationMode	IChannel	Sets the method used to generate a sweep: continuous ramp (analog) or discrete steps (stepped).
SweepSpeedMode	IChannel14	Set or returns the sweep speed mode.
SweepTime	IChannel	Sets the Sweep time of the analyzer.
SweepType	IChannel	Sets the type of X-axis sweep that is performed on a channel.
TestPortPower	IChannel	Sets or returns the RF power level for the channel. Shared with the Segment Object
TriggerMode	IChannel	Determines the measurement that occurs when a trigger signal is sent to the channel.
UserRangeMax	IChannel	Superseded - Use meas.UserRangeMax Sets the stimulus stop value for the specified User Range.
UserRangeMin	IChannel	Superseded - Use meas.UserRangeMin Sets the stimulus start value for the specified User Range.
XAxisPointSpacing	IChannel	Sets X-Axis point spacing for the active channel.

IChannel History

Interface	Introduced with VNA Rev:
IChannel	1.0
IChannel2	3.0
IChannel3	4.0
IChannel4	4.0
IChannel5	4.2
IChannel6	5.0
IChannel7	5.2
IChannel8	6.0
IChannel9	7.0
IChannel10	7.2
IChannel11	7.5
IChannel12	8.0
IChannel13	8.2
IChannel14	8.33
IChannel15	8.33
IChannel16	8.35
IChannel17	8.55
IChannel19	9.20
IChannel20	9.20
IChannel21	9.30
IChannel22	9.42
IChannel23	9.50
IChannel24	10.40
IChannel25	10.45
IChannel26	12.80
IChannel27	13.25

ISourcePowerCalData Interface

Description

Contains methods for putting source power calibration data in and getting source power calibration data out of the analyzer using typed data. The methods in this interface transfer data more efficiently than methods that use variant data. However, this interfaces is only usable from VB6, C, & C++. All other programming languages must use the methods on the Channel Object.

Note: Interface ISourcePowerCalData is abbreviated as ISPCD in the following table.

Methods	Interface See History	Description
getSourcePowerCalDataScalar	ISPCD	Superseded - use PutSourcePowerCalDataScalarEx Method
getSourcePowerCalDataScalarEx	ISPCD2	Returns requested source power calibration data, if it exists.
putSourcePowerCalDataScalar	ISPCD	Superseded - use PutSourcePowerCalDataEx Method
putSourcePowerCalDataScalarEx	ISPCD2	Inputs source power calibration data to a channel, for a specific source port.
Properties		Description
None

ISourcePowerCalData History

Interface	Introduced with VNA Rev:
ISourcePowerCalData	2.0
ISourcePowerCalData2	4.0