fr.cnes.sirius.patrius.signalpropagation.troposphere

Class AzoulayModel

java.lang.Object

fr.cnes.sirius.patrius.signalpropagation.troposphere.AzoulayModel

All Implemented Interfaces:

IParameterizable, AngularCorrection, TroposphericCorrection, Serializable

public final class AzoulayModel
extends Object
implements TroposphericCorrection, AngularCorrection

This class is a tropospheric correction model that implements the TroposphericCorrection and AngularCorrection interfaces to correct a signal with the Azoulay model.

Since:

1.1

Version:

$Id$

Author:

Thomas Trapier

See Also:

TroposphericCorrection, Serialized Form

Concurrency :

immutable

Constructor Summary

Constructors

Constructor and Description
AzoulayModel(MeteorologicalConditionsProvider meteoConditionsProvider, double ellipsoidAltitude) Constructor using the geometric elevation in the model.
AzoulayModel(MeteorologicalConditionsProvider meteoConditionsProvider, double ellipsoidAltitude, boolean isGeometricElevation) Constructor.

Method Summary

Modifier and Type	Method and Description
double	computeElevationCorrectionFromApparentElevation(AbsoluteDate date, double apparentElevation) Compute the angular correction from the apparent elevation.
double	computeElevationCorrectionFromGeometricElevation(AbsoluteDate date, double geometricElevation) Compute the angular correction from the geometric elevation.
double	computeSignalDelay(AbsoluteDate date, double elevation) Calculates the tropospheric signal delay for the signal path from a ground station to a satellite at a given date.
double	derivativeValue(Parameter p, double elevation) Compute the signal delay derivative value with respect to the input parameter.
double	derivativeValueFromApparentElevation(Parameter p, double elevation) Compute the elevation correction derivative value with respect to the input parameter.
double	derivativeValueFromGeometricElevation(Parameter p, double geometricElevation) Compute the elevation correction derivative value with respect to the input parameter.
double[]	getCorrectionsFromApparentElevation(AbsoluteDate date, double apparentElevation) Computes the corrections due to the troposphere from the apparent value of the elevation at a given date.
double[]	getCorrectionsFromGeometricElevation(AbsoluteDate date, double geometricElevation) Computes the corrections due to the troposphere from the geometric value of the elevation at a given date.
double	getMinimalToleratedApparentElevation() Getter for the minimal tolerated apparent elevation for this model (some models cannot compute correction for too low elevations).
ArrayList<Parameter>	getParameters() Get the supported parameters.
boolean	isDifferentiableBy(Parameter p) Tell if the function is differentiable by the given parameter.
boolean	supportsParameter(Parameter param) Check if a parameter is supported.

Methods inherited from class java.lang.Object

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

Constructor Detail

AzoulayModel

public AzoulayModel(MeteorologicalConditionsProvider meteoConditionsProvider,
                    double ellipsoidAltitude)

Constructor using the geometric elevation in the model.

Parameters:

meteoConditionsProvider - Provider for the meteorological conditions

ellipsoidAltitude - The ground point ellipsoid altitude [m]

AzoulayModel

public AzoulayModel(MeteorologicalConditionsProvider meteoConditionsProvider,
                    double ellipsoidAltitude,
                    boolean isGeometricElevation)

Constructor.

Parameters:

meteoConditionsProvider - Provider for the meteorological conditions

ellipsoidAltitude - The ground point ellipsoid altitude [m]

isGeometricElevation - true if the computed correction is used to get the apparent elevation from the geometric elevation value, false if it is used to get the geometric elevation from the apparent elevation value

Method Detail

supportsParameter

public boolean supportsParameter(Parameter param)

Check if a parameter is supported.

Specified by:

supportsParameter in interface IParameterizable

Parameters:

param - parameter to check

Returns:

true if the parameter is supported

getParameters

public ArrayList<Parameter> getParameters()

Get the supported parameters.

Specified by:

getParameters in interface IParameterizable

Returns:

list of supported parameters

derivativeValue

public double derivativeValue(Parameter p,
                              double elevation)

Compute the signal delay derivative value with respect to the input parameter.

Specified by:

derivativeValue in interface TroposphericCorrection

Parameters:

p - parameter

elevation - the elevation of the satellite [rad]

Returns:

the derivative value

derivativeValueFromApparentElevation

public double derivativeValueFromApparentElevation(Parameter p,
                                                   double elevation)

Compute the elevation correction derivative value with respect to the input parameter.

Specified by:

derivativeValueFromApparentElevation in interface AngularCorrection

Parameters:

p - Parameter

elevation - The apparent elevation (with atmosphere) of the satellite [rad]

Returns:

the elevation derivative value

derivativeValueFromGeometricElevation

public double derivativeValueFromGeometricElevation(Parameter p,
                                                    double geometricElevation)

Compute the elevation correction derivative value with respect to the input parameter.

Specified by:

derivativeValueFromGeometricElevation in interface AngularCorrection

Parameters:

p - Parameter

geometricElevation - The geometric elevation (without atmosphere) of the satellite [rad]

Returns:

the elevation derivative value

isDifferentiableBy

public boolean isDifferentiableBy(Parameter p)

Tell if the function is differentiable by the given parameter.

Specified by:

isDifferentiableBy in interface AngularCorrection

Specified by:

isDifferentiableBy in interface TroposphericCorrection

Parameters:

p - function parameter

Returns:

true if the function is differentiable by the given parameter.

getCorrectionsFromGeometricElevation

public double[] getCorrectionsFromGeometricElevation(AbsoluteDate date,
                                                     double geometricElevation)

Computes the corrections due to the troposphere from the geometric value of the elevation at a given date.

Parameters:

date - Date of meteorological conditions

geometricElevation - The geometric elevation [rad]

Returns:

an array that contains both corrections : (apparent elevation - geometric elevation), (apparent distance - geometric distance)

getCorrectionsFromApparentElevation

public double[] getCorrectionsFromApparentElevation(AbsoluteDate date,
                                                    double apparentElevation)

Computes the corrections due to the troposphere from the apparent value of the elevation at a given date.

Parameters:

date - Date of meteorological conditions

apparentElevation - The apparent elevation (rad)

Returns:

an array that contains both corrections : (apparent elevation - geometric elevation), (apparent distance - geometric distance)

computeSignalDelay

public double computeSignalDelay(AbsoluteDate date,
                                 double elevation)

Calculates the tropospheric signal delay for the signal path from a ground station to a satellite at a given date.

Specified by:

computeSignalDelay in interface TroposphericCorrection

Parameters:

date - date of meteo conditions

elevation - the elevation of the satellite [rad]

Returns:

the signal delay due to the troposphere [s]

computeElevationCorrectionFromApparentElevation

public double computeElevationCorrectionFromApparentElevation(AbsoluteDate date,
                                                              double apparentElevation)

Compute the angular correction from the apparent elevation.

Specified by:

computeElevationCorrectionFromApparentElevation in interface AngularCorrection

Parameters:

date - The date at which we want to compute the angular correction

apparentElevation - The apparent elevation (with atmosphere) [rad]

Returns:

the elevation correction [rad] so that apparent_elevation = geometric_elevation + elevation_correction

computeElevationCorrectionFromGeometricElevation

public double computeElevationCorrectionFromGeometricElevation(AbsoluteDate date,
                                                               double geometricElevation)

Compute the angular correction from the geometric elevation.

Specified by:

computeElevationCorrectionFromGeometricElevation in interface AngularCorrection

Parameters:

date - The date at which we want to compute the angular correction

geometricElevation - The geometric elevation (without atmosphere) [rad]

Returns:

the elevation correction [rad] so that apparent_elevation = geometric_elevation + elevation_correction

getMinimalToleratedApparentElevation

public double getMinimalToleratedApparentElevation()

Getter for the minimal tolerated apparent elevation for this model (some models cannot compute correction for too low elevations).

Specified by:

getMinimalToleratedApparentElevation in interface AngularCorrection

Returns:

the minimal tolerated apparent elevation [rad]