SignalCreateSignal Method (Double, Double, Double, Double, Double, Double, Double, IEnumerableObject)

Create a new signal based on the given properties. To modify a preexisting signal, use ModifySignalProperties(Double, Double, Double, Double, Double, Double, Double) or similar methods on the preexisting signal instance.

Namespace: AGI.Foundation.Communications
Assembly: AGI.Foundation.Communications (in AGI.Foundation.Communications.dll) Version: 24.3.420.0 (24.3.420.0)

Syntax

C++

Copy

public static Signal CreateSignal(
	double power,
	double frequency,
	double lowerBandwidthLimit,
	double upperBandwidthLimit,
	double noiseTemperature,
	double lowerNoiseBandwidthLimit,
	double upperNoiseBandwidthLimit,
	IEnumerable<Object> signalData
)

Public Shared Function CreateSignal ( 
	power As Double,
	frequency As Double,
	lowerBandwidthLimit As Double,
	upperBandwidthLimit As Double,
	noiseTemperature As Double,
	lowerNoiseBandwidthLimit As Double,
	upperNoiseBandwidthLimit As Double,
	signalData As IEnumerable(Of Object)
) As Signal

public:
static Signal^ CreateSignal(
	double power, 
	double frequency, 
	double lowerBandwidthLimit, 
	double upperBandwidthLimit, 
	double noiseTemperature, 
	double lowerNoiseBandwidthLimit, 
	double upperNoiseBandwidthLimit, 
	IEnumerable<Object^>^ signalData
)

static member CreateSignal : 
        power : float * 
        frequency : float * 
        lowerBandwidthLimit : float * 
        upperBandwidthLimit : float * 
        noiseTemperature : float * 
        lowerNoiseBandwidthLimit : float * 
        upperNoiseBandwidthLimit : float * 
        signalData : IEnumerable<Object> -> Signal

Parameters

power: Type: SystemDouble
Signal power, in watts.
frequency: Type: SystemDouble
Signal frequency, in hertz.
lowerBandwidthLimit: Type: SystemDouble
A value specifying the (negative) offset, in hertz, from the central frequency, to the lower limit of the signal's bandwidth.
upperBandwidthLimit: Type: SystemDouble
A value specifying the (positive) offset, in hertz, from the central frequency, to the upper limit of the signals' bandwidth.
noiseTemperature: Type: SystemDouble
The equivalent noise temperature, in kelvin, spread out over the noise bandwidth.
lowerNoiseBandwidthLimit: Type: SystemDouble
The offset to the lower limit of the noise bandwidth, in hertz.
upperNoiseBandwidthLimit: Type: SystemDouble
The offset to the upper limit of the noise bandwidth, in hertz.
signalData: Type: System.Collections.GenericIEnumerableObject
A set of metadata which describe additional properties of this signal. If , will be ignored.

Return Value

Type: Signal
The newly created signal.

Exceptions

Exception	Condition
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)

Exception

Condition

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)

Reference

Signal Class

CreateSignal Overload

AGI.Foundation.Communications Namespace