Click or drag to resize

SphericalTabularGainData Constructor (Double, Double, Double, Boolean)

Initializes an instance given an array of theta values, an array of phi values, and a multidimensional array of gain values. Phi is defined as the azimuth angle from the positive x-axis to the orthogonal projection of the point in the x-y plane. Theta is defined as the zenith angle from the positive z-axis to the point. The gain values array must be arranged such that the rows of the array represent phi cuts through the antenna pattern and the columns represent theta cuts. Therefore, the first dimension of the gain values array must be the same size as the phi values array and the second dimension of the gain values array must be the same size as the theta values array. If duplicate phi/theta points are found, the first one that is found will be kept and subsequent phi/theta points are ignored. For example, if the phi array contains a value of 0 degrees and a value of 360 degrees (same cut through the sphere) all of the theta values at phi equal to 360 degrees will be ignored.

Namespace:  AGI.Foundation.Communications.Antennas
Assembly:  AGI.Foundation.Communications (in AGI.Foundation.Communications.dll) Version: 24.1.418.0 (24.1.418.0)
Syntax
public SphericalTabularGainData(
	double[] phiValues,
	double[] thetaValues,
	double[,] gainValues,
	bool gainValuesAreDecibel
)

Parameters

phiValues
Type: SystemDouble
An array of phi values. Phi is defined as the azimuth angle from the positive x-axis to the orthogonal projection of the point in the x-y plane.
thetaValues
Type: SystemDouble
An array of theta values. Theta is defined as the zenith angle from the positive z-axis to the point.
gainValues
Type: SystemDouble
A multidimensional array of gain values.
gainValuesAreDecibel
Type: SystemBoolean
True if the values in the gainValues array are in decibels. False if the values in the gainValues array are in linear units.
Exceptions
ExceptionCondition
ArgumentNullException Thrown when phiValues, thetaValues or gainValues is .
Remarks
This type represents an exception in the library which otherwise uses linear units. The gain values are stored in decibels because the interpolation scheme interpolates in decibels rather than linear units. The gain produced by the evaluate method is still in linear units.
See Also