Gets or sets the gain of a switch or cable, in dB, connected before the RF IN connector of an NI-RFSA device.

Syntax

Namespace: NationalInstruments.ModularInstruments.NIRfsa

public double ExternalGain { get; set; }

Remarks

Specifies a Double representing the gain of a switch or cable, in dB, connected before the RF IN connector of an NI-RFSA device.

The default value is 0. Valid Values are -INF to +INF

When you set this property, along with the RFAttenuation and IFAttenuation properties, NI-RFSA calculates appropriate attenuator settings based on the value of this property and the value of the ReferenceLevel property. In this case, NI-RFSA interprets the reference level as the maximum expected power level of the signal at the input of the external gain device.

With this property set, NI-RFSA reads the Level property value as the power level at the input of the external gain device at which the NI-RFSA device should trigger.

Negative values indicate attenuation.

For more information about attenuation, refer to the Attenuation and Signal Levels topic for your device in the NI RF Vector Signal Analyzers Help.

Exceptions

TypeDescription
System.ObjectDisposedException

The ExternalGain property was accessed after the associated NIRfsa object was disposed.