fr.cnes.sirius.patrius.groundstation

Class RFStationAntenna

java.lang.Object

fr.cnes.sirius.patrius.groundstation.RFStationAntenna

All Implemented Interfaces:

PVCoordinatesProvider, Serializable

public class RFStationAntenna
extends Object
implements PVCoordinatesProvider

This class represents an RF antenna model for a ground station. It is used when calculating the RF link budget.

Since:

1.2

Version:

$Id$

Author:

Tiziana Sabatini

See Also:

RFLinkBudgetModel, Serialized Form

Concurrency :

not thread-safe

Concurrency comment :

link to the tree of frames

Constructor Summary

Constructors

Constructor and Description
RFStationAntenna(TopocentricFrame inTopoFrame, double inMeritFactor, double inGroundLoss, double inEllipticityFactor, double[][] inAtmosphericLoss, double[][] inPointingLoss, double inCombinerLoss) Constructor of the station antenna model.

Method Summary

Modifier and Type	Method and Description
double	getAtmosphericLoss(double elevation) Gets the atmospheric loss using a spline interpolation.
double	getCombinerLoss() Returns loss due to the combiner of the antenna [dB].
double	getEllipticityFactor()
Frame	getFrame() Returns ground station topocentric frame.
double	getGroundLoss()
double	getMeritFactor()
Frame	getNativeFrame(AbsoluteDate date) Get the native frame, i.e. the raw frame in which PVCoordinates are expressed before transformation to user output frame.
double	getPointingLoss(double elevation) Gets the pointing loss using a spline interpolation.
PVCoordinates	getPVCoordinates(AbsoluteDate date, Frame frame) Get the PVCoordinates of the body in the selected frame.

Methods inherited from class java.lang.Object

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

Constructor Detail

RFStationAntenna

public RFStationAntenna(TopocentricFrame inTopoFrame,
                        double inMeritFactor,
                        double inGroundLoss,
                        double inEllipticityFactor,
                        double[][] inAtmosphericLoss,
                        double[][] inPointingLoss,
                        double inCombinerLoss)

Constructor of the station antenna model.

Parameters:

inTopoFrame - topocentric frame of the ground station.

inMeritFactor - factor of merit of the ground antenna.

inGroundLoss - technological losses by the ground antenna.

inEllipticityFactor - factor of ellipticity.

inAtmosphericLoss - matrix of atmospheric loss as function of elevation.

inPointingLoss - matrix of pointing loss as function of elevation.

inCombinerLoss - loss due to the combiner of the antenna.

Method Detail

getMeritFactor

public final double getMeritFactor()

Returns:

the factor of merit of the ground antenna (gain / noise temperature) [dB / K].

getGroundLoss

public final double getGroundLoss()

Returns:

the technological losses by the ground antenna [dB].

getEllipticityFactor

public final double getEllipticityFactor()

Returns:

the factor of ellipticity, used to calculate the polarisation losses of the antenna [dB].

getAtmosphericLoss

public final double getAtmosphericLoss(double elevation)

Gets the atmospheric loss using a spline interpolation.
The atmospheric loss is a function of the ground station elevation.

Parameters:

elevation - ground station elevation [rad], in the range [-PI/2; PI/2].

Returns:

the atmospheric loss (iono+tropo+rain) for a given elevation [rad * dB].

getPointingLoss

public final double getPointingLoss(double elevation)

Gets the pointing loss using a spline interpolation.
The pointing loss is a function of the ground station elevation.

Parameters:

elevation - ground station elevation [rad], in the range [-PI/2; PI/2].

Returns:

the pointing loss for a given elevation [rad * dB].

getFrame

public Frame getFrame()

Returns ground station topocentric frame.

Returns:

ground station topocentric frame.

getCombinerLoss

public final double getCombinerLoss()

Returns loss due to the combiner of the antenna [dB].

Returns:

the loss due to the combiner of the antenna [dB].

getPVCoordinates

public PVCoordinates getPVCoordinates(AbsoluteDate date,
                                      Frame frame)
                               throws PatriusException

Get the PVCoordinates of the body in the selected frame.

Specified by:

getPVCoordinates in interface PVCoordinatesProvider

Parameters:

date - current date

frame - the frame where to define the position

Returns:

position/velocity of the body (m and m/s)

Throws:

PatriusException - if position cannot be computed in given frame

getNativeFrame

public Frame getNativeFrame(AbsoluteDate date)
                     throws PatriusException

Get the native frame, i.e. the raw frame in which PVCoordinates are expressed before transformation to user output frame.

Specified by:

getNativeFrame in interface PVCoordinatesProvider

Parameters:

date - a date

Returns:

the native frame

Throws:

PatriusException - thrown if native frame is undefined or unknown