Keysight Pathwave 89600 VSA .NET API
RangeInDbm Property
See Also 
Agilent.SA.Vsa.Interfaces Assembly > Agilent.SA.Vsa Namespace > Analog Class : RangeInDbm Property


Glossary Item Box

Gets or sets the input range (in dBm) of the input channel.

Syntax

Visual Basic (Declaration) 
Public Overridable Property RangeInDbm As Double
C# 
public virtual double RangeInDbm {get; set;}
C++/CLI 
public:
virtual property double RangeInDbm {
   double get();
   void set (    double value);
}

Property Value

The range of the input channel. The default is 30 dBm unless the hardware is not capable of that in which case it is coerced to the highest value possible with the current hardware. Setting the value causes the value to be set on all channels. Getting the value returns the value from the first channel. RangeInDbm = 10.0 * Log10(Range(Vpk) * Range(Vpk) * 500.0/RefImpedance(Ohms)

Remarks

Most hardware only allows a limited set of allowable values for the input range, which is dependent upon the Adc hardware, down converter, and input/calibrator module currently being used. The range specified is rounded up to the next largest available range.

The ValidValues<T>("RangeInDbm") method can be used to retrieve a list of valid ranges. When that method is used for Range on this object it will return the valid values of range for the first channel.

For multi-channel hardware, Range can be set independently for each channel or all channels can be set to the same value. To set the Range for an individual channel, use the Range property on the appropriate channel. Individual channel settings are available via the Channels collection. To set the Range for all channels to the same value, set this property and all the channels' Range values will be set to the specified Range value.

When queried, this property always returns the value for the first channel. For multi-channel hardware, the Range for an individual channel can be retrieved via the Range property on the appropriate channel. Individual channel settings are available via the Channels collection.

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 21.20

See Also