Click or drag to resize

SignalModifySignalProperties Method

Create a new signal by modifying the properties of this signal.

Namespace:  AGI.Foundation.Communications
Assembly:  AGI.Foundation.Communications (in AGI.Foundation.Communications.dll) Version: 24.2.419.0 (24.2.419.0)
Syntax
Copy
public Signal ModifySignalProperties(
	double power,
	double frequency,
	double lowerBandwidthLimit,
	double upperBandwidthLimit,
	double noiseTemperature,
	double lowerNoiseBandwidthLimit,
	double upperNoiseBandwidthLimit
)

Parameters

power
Type: SystemDouble
The new total power, in watts.
frequency
Type: SystemDouble
The new center frequency, in hertz.
lowerBandwidthLimit
Type: SystemDouble
The new offset from the center frequency to the lowest frequency, in hertz. (usually negative)
upperBandwidthLimit
Type: SystemDouble
The new offset from the center frequency to the highest frequency, in hertz.
noiseTemperature
Type: SystemDouble
The new noise temperature, in kelvin.
lowerNoiseBandwidthLimit
Type: SystemDouble
The new offset from the center frequency to the lowest frequency at which there is significant noise, in hertz.
upperNoiseBandwidthLimit
Type: SystemDouble
The new offset from the center frequency to the highest frequency at which there is significant noise, in hertz.

Return Value

Type: Signal
The modified signal.
Exceptions
ExceptionCondition
ArgumentOutOfRangeException

Thrown when:

  • frequency, power, or noiseTemperature is negative
  • the computed LowerBandwidthFrequency (frequency + lowerBandwidthLimit) is negative
  • the frequency Bandwidth (upperBandwidthLimit - lowerBandwidthLimit) is zero
  • lowerNoiseBandwidthLimit causes the lowest frequency of the noise to be negative (frequency + lowerNoiseBandwidthLimit must be positive)
  • lowerNoiseBandwidthLimit is greater than upperNoiseBandwidthLimit (note that lowerNoiseBandwidthLimit is usually negative)
Remarks
The modified Signal retains any additional Data on the original signal.
See Also