ScopeChannel.DigitalGain Property
- Updated2023-09-06
- 2 minute(s) read
ScopeChannelDigitalGain Property
Gets or sets the gain on the specified channel in hardware before any onboard signal processing occurs.
Namespace: NationalInstruments.ModularInstruments.NIScope
Assembly: NationalInstruments.ModularInstruments.NIScope.Fx45 (in NationalInstruments.ModularInstruments.NIScope.Fx45.dll) Version: 2023
Syntax
public double DigitalGain { get; set; }
Public Property DigitalGain As Double Get Set
Property Value
Type: DoubleThe gain can range from -1.5 to +1.5.
Remarks
If an overflow occurs, the data is clipped and the driver returns an error.
To eliminate overflows, the digital gain should attenuate the ADC data, that is, ADC data should be set to a value less than 1.
You can also use Digital Gain to complete fine-gain adjustments on the ADC data to compensate for channel or system gain imperfections. These adjustments occur in hardware before the data is stored to memory. These adjustments save an additional processing step that normally occurs in software.
The digital gain circuit can overflow if the following condition is not met:
-1 < Unity Scaled User Data × Pre-Filter Gain < 1
To change the default error reporting caused by OSP overflows, change the OverflowErrorReportingMode attribute.
 Note |
|---|
| You can access this property only with high-speed digitizers that support onboard signal processing (OSP), such as the NI 5142. If you open a session with an instrument that does not support OSP and you attempt to access this property, a ModularInstrumentsException is thrown. |