Package org.orekit.models.earth.troposphere

Class SaastamoinenModel

java.lang.Object

org.orekit.models.earth.troposphere.ModifiedSaastamoinenModel

org.orekit.models.earth.troposphere.SaastamoinenModel

All Implemented Interfaces:

DiscreteTroposphericModel, TroposphericModel, ParameterDriversProvider

@Deprecated
public class SaastamoinenModel
extends ModifiedSaastamoinenModel

Deprecated.

as of 12.1, replaced by ModifiedSaastamoinenModel

The modified Saastamoinen model.

Author:

Luc Maisonobe

Field Summary

Fields

Modifier and Type	Field	Description
static double	DEFAULT_LOW_ELEVATION_THRESHOLD	Deprecated. Default lowest acceptable elevation angle [rad].
static String	DELTA_R_FILE_NAME	Deprecated. Default file name for δR correction term table.

Fields inherited from class org.orekit.models.earth.troposphere.ModifiedSaastamoinenModel

WATER

Constructor Summary

Constructors

Constructor	Description
SaastamoinenModel(double t0, double p0, double r0)	Deprecated. Create a new Saastamoinen model for the troposphere using the given environmental conditions and table from the reference book.
SaastamoinenModel(double t0, double p0, double r0, String deltaRFileName)	Deprecated. Create a new Saastamoinen model for the troposphere using the given environmental conditions.
SaastamoinenModel(double t0, double p0, double r0, String deltaRFileName, DataProvidersManager dataProvidersManager)	Deprecated. Create a new Saastamoinen model for the troposphere using the given environmental conditions.

Method Summary

Modifier and Type	Method	Description
static SaastamoinenModel	getStandardModel()	Deprecated. Create a new Saastamoinen model using a standard atmosphere model.
double	pathDelay(double elevation, GeodeticPoint point, double[] parameters, AbsoluteDate date)	Deprecated.
<T extends CalculusFieldElement<T>> T	pathDelay(T elevation, FieldGeodeticPoint<T> point, T[] parameters, FieldAbsoluteDate<T> date)	Deprecated.

Methods inherited from class org.orekit.models.earth.troposphere.ModifiedSaastamoinenModel

getLowElevationThreshold, getParametersDrivers, getPth0Provider, pathDelay, pathDelay, setLowElevationThreshold

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.orekit.utils.ParameterDriversProvider

getNbParametersDriversValue, getParameterDriver, getParameters, getParameters, getParameters, getParameters, getParametersAllValues, getParametersAllValues, isSupported

Field Detail

DELTA_R_FILE_NAME

public static final String DELTA_R_FILE_NAME

Deprecated.

Default file name for δR correction term table.

See Also:

Constant Field Values

DEFAULT_LOW_ELEVATION_THRESHOLD

public static final double DEFAULT_LOW_ELEVATION_THRESHOLD

Deprecated.

Default lowest acceptable elevation angle [rad].

See Also:

Constant Field Values

Constructor Detail

SaastamoinenModel

@DefaultDataContext
public SaastamoinenModel(double t0,
                         double p0,
                         double r0)

Deprecated.

Create a new Saastamoinen model for the troposphere using the given environmental conditions and table from the reference book.

Parameters:

t0 - the temperature at the station [K]

p0 - the atmospheric pressure at the station [mbar]

r0 - the humidity at the station [fraction] (50% → 0.5)

Since:

10.1

See Also:

ModifiedSaastamoinenModel(PressureTemperatureHumidityProvider, String, DataProvidersManager)

SaastamoinenModel

@DefaultDataContext
public SaastamoinenModel(double t0,
                         double p0,
                         double r0,
                         String deltaRFileName)

Deprecated.

Create a new Saastamoinen model for the troposphere using the given environmental conditions. This constructor uses the default data context if deltaRFileName != null.

Parameters:

t0 - the temperature at the station [K]

p0 - the atmospheric pressure at the station [mbar]

r0 - the humidity at the station [fraction] (50% → 0.5)

deltaRFileName - regular expression for filename containing δR correction term table (typically DELTA_R_FILE_NAME), if null default values from the reference book are used

Since:

7.1

See Also:

ModifiedSaastamoinenModel(PressureTemperatureHumidityProvider, String, DataProvidersManager)

SaastamoinenModel

public SaastamoinenModel(double t0,
                         double p0,
                         double r0,
                         String deltaRFileName,
                         DataProvidersManager dataProvidersManager)

Deprecated.

Create a new Saastamoinen model for the troposphere using the given environmental conditions. This constructor allows the user to specify the source of of the δR file.

Parameters:

t0 - the temperature at the station [K]

p0 - the atmospheric pressure at the station [mbar]

r0 - the humidity at the station [fraction] (50% → 0.5)

deltaRFileName - regular expression for filename containing δR correction term table (typically DELTA_R_FILE_NAME), if null default values from the reference book are used

dataProvidersManager - provides access to auxiliary data.

Since:

10.1

Method Detail

getStandardModel

@DefaultDataContext
public static SaastamoinenModel getStandardModel()

Deprecated.

Create a new Saastamoinen model using a standard atmosphere model.

• altitude: 0m
• temperature: 18 degree Celsius
• pressure: 1013.25 mbar
• humidity: 50%

Returns:

a Saastamoinen model with standard environmental values

pathDelay

@Deprecated
public double pathDelay(double elevation,
                        GeodeticPoint point,
                        double[] parameters,
                        AbsoluteDate date)

Deprecated.

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

The Saastamoinen model is not defined for altitudes below 0.0. for continuity reasons, we use the value for h = 0 when altitude is negative.

There are also numerical issues for elevation angles close to zero. For continuity reasons, elevations lower than a threshold will use the value obtained for the threshold itself.

Specified by:

pathDelay in interface DiscreteTroposphericModel

Overrides:

pathDelay in class ModifiedSaastamoinenModel

Parameters:

elevation - the elevation of the satellite, in radians

point - station location

parameters - tropospheric model parameters

date - current date

Returns:

the path delay due to the troposphere in m

See Also:

ModifiedSaastamoinenModel.getLowElevationThreshold(), ModifiedSaastamoinenModel.setLowElevationThreshold(double)

pathDelay

@Deprecated
public <T extends CalculusFieldElement<T>> T pathDelay(T elevation,
                                                       FieldGeodeticPoint<T> point,
                                                       T[] parameters,
                                                       FieldAbsoluteDate<T> date)

Deprecated.

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

The Saastamoinen model is not defined for altitudes below 0.0. for continuity reasons, we use the value for h = 0 when altitude is negative.

There are also numerical issues for elevation angles close to zero. For continuity reasons, elevations lower than a threshold will use the value obtained for the threshold itself.

Specified by:

pathDelay in interface DiscreteTroposphericModel

Overrides:

pathDelay in class ModifiedSaastamoinenModel

Type Parameters:

T - type of the elements

Parameters:

elevation - the elevation of the satellite, in radians

point - station location

parameters - tropospheric model parameters at current date

date - current date

Returns:

the path delay due to the troposphere in m

See Also:

ModifiedSaastamoinenModel.getLowElevationThreshold(), ModifiedSaastamoinenModel.setLowElevationThreshold(double)