fr.cnes.sirius.patrius.assembly.properties

Class RFAntennaProperty

java.lang.Object

fr.cnes.sirius.patrius.assembly.properties.RFAntennaProperty

All Implemented Interfaces:

IPartProperty

public class RFAntennaProperty
extends Object
implements IPartProperty

This class represents an RF antenna property for a part of the assembly. This property is used when calculating the RF link budget.

Since:

1.2

Version:

$Id$

Author:

Tiziana Sabatini

See Also:

IPartProperty, RFLinkBudgetModel

Concurrency :

immutable

Constructor Summary

Constructors

Constructor and Description
RFAntennaProperty(double inOutputPower, double[] inPatternPolarAngle, double[] inPatternAzimuth, double[][] inGainPattern, double[][] inEllipticityFactor, double inTechnoLoss, double inCircuitLoss, double inBitRate, double inFrequency) Constructor of this property.

Method Summary

Modifier and Type	Method and Description
double	getBitRate()
double	getCircuitLoss()
double	getEllipticity(double polarAngle, double azimuth) Gets the factor of ellipticity using a spline interpolation.
double	getFrequency()
double	getGain(double polarAngle, double azimuth) Gets the antenna gain using a spline interpolation.
double	getOutputPower()
double	getTechnoLoss()
PropertyType	getType() Get the type of the property.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RFAntennaProperty

public RFAntennaProperty(double inOutputPower,
                         double[] inPatternPolarAngle,
                         double[] inPatternAzimuth,
                         double[][] inGainPattern,
                         double[][] inEllipticityFactor,
                         double inTechnoLoss,
                         double inCircuitLoss,
                         double inBitRate,
                         double inFrequency)

Constructor of this property.

Parameters:

inOutputPower - amplifier output power.

inPatternPolarAngle - antenna pattern values of the polar angle (1 x N); this array can't contain 2 values (but it can contain only one value) because of the spline interpolation: at least 3 values are required.
Polar angle values must be between 0 and PI.

inPatternAzimuth - antenna pattern values of the azimuthal angle (1 x M); this array can't contain 2 values (but it can contain only one value) because of the spline interpolation: at least 3 values are required.
Azimuthal angle values must be between 0 and 2PI.

inGainPattern - antenna gain diagram values: Gain = F(polar angle, azimuth) (N x M).

inEllipticityFactor - factor of ellipticity: F(polar angle, azimuth) (N x M).

inTechnoLoss - technological losses by the satellite transmitter.

inCircuitLoss - losses between TX and antenna.

inBitRate - bit rate for nominal mode.

inFrequency - emission frequency.

Method Detail

getOutputPower

public final double getOutputPower()

Returns:

the amplifier output power [dB].

getGain

public final double getGain(double polarAngle,
                            double azimuth)

Gets the antenna gain using a spline interpolation.
The antenna gain is a function of the station direction (gain = F(polarAngle, azimuth)).

Parameters:

polarAngle - the polar angle of the ground station direction in the antenna frame [0, PI].

azimuth - the azimuth of the ground station direction in the antenna frame [0, 2PI].

Returns:

the antenna gain for the specified ground station direction [dB].

getEllipticity

public final double getEllipticity(double polarAngle,
                                   double azimuth)

Gets the factor of ellipticity using a spline interpolation.
The ellipticity factor is a function of the station direction (ellipticity = F(polarAngle, azimuth)) and is used to calculate the polarisation losses of the antenna.

Parameters:

polarAngle - the polar angle of the ground station direction in the antenna frame [0, PI].

azimuth - the azimuth of the ground station direction in the antenna frame [0, 2PI].

Returns:

the ellipticity factor for the specified ground station direction [dB].

getTechnoLoss

public final double getTechnoLoss()

Returns:

the technological losses by the satellite transmitter [dB].

getCircuitLoss

public final double getCircuitLoss()

Returns:

the losses between TX and antenna [dB].

getBitRate

public final double getBitRate()

Returns:

the bit rate for nominal mode [bps].

getFrequency

public final double getFrequency()

Returns:

the emission frequency [Hz].

getType

public final PropertyType getType()

Get the type of the property.

Specified by:

getType in interface IPartProperty

Returns:

the type of the property (see PropertyType enumeration)