org.orekit.models.earth.troposphere

Class GlobalMappingFunctionModel

java.lang.Object

org.orekit.models.earth.troposphere.GlobalMappingFunctionModel

All Implemented Interfaces:

MappingFunction

public class GlobalMappingFunctionModel
extends Object
implements MappingFunction

The Global Mapping Function model for radio techniques. This model is an empirical mapping function. It only needs the values of the station latitude, longitude, height and the date for the computations.

The Global Mapping Function is based on spherical harmonics up to degree and order of 9. It was developed to be consistent with the Vienna1 mapping function model.

Author:

Bryan Cazabonne

See Also:

"Boehm, J., A.E. Niell, P. Tregoning, H. Schuh (2006), Global Mapping Functions (GMF): A new empirical mapping function based on numerical weather model data, Geoph. Res. Letters, Vol. 33, L07304, doi:10.1029/2005GL025545.", "Petit, G. and Luzum, B. (eds.), IERS Conventions (2010), IERS Technical Note No. 36, BKG (2010)"

Constructor Summary

Constructors

Constructor and Description
GlobalMappingFunctionModel(double latitude, double longitude) Build a new instance.
GlobalMappingFunctionModel(double latitude, double longitude, TimeScale utc) Build a new instance.

Method Summary

Modifier and Type	Method and Description
List<ParameterDriver>	getParametersDrivers() Get the drivers for tropospheric model parameters.
double[]	mappingFactors(double elevation, double height, double[] parameters, AbsoluteDate date) This method allows the computation of the hydrostatic and wet mapping functions.
<T extends RealFieldElement<T>> T[]	mappingFactors(T elevation, T height, T[] parameters, FieldAbsoluteDate<T> date) This method allows the computation of the hydrostatic and wet mapping functions.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.orekit.models.earth.troposphere.MappingFunction

getParameters, getParameters

Constructor Detail

GlobalMappingFunctionModel

@DefaultDataContext
public GlobalMappingFunctionModel(double latitude,
                                                      double longitude)

Build a new instance.

This constructor uses the default data context.

Parameters:

latitude - geodetic latitude of the station, in radians

longitude - geodetic latitude of the station, in radians

See Also:

GlobalMappingFunctionModel(double, double, TimeScale)

GlobalMappingFunctionModel

public GlobalMappingFunctionModel(double latitude,
                                  double longitude,
                                  TimeScale utc)

Build a new instance.

Parameters:

latitude - geodetic latitude of the station, in radians

longitude - geodetic latitude of the station, in radians

utc - UTC time scale.

Since:

10.1

Method Detail

mappingFactors

public double[] mappingFactors(double elevation,
                               double height,
                               double[] parameters,
                               AbsoluteDate date)

This method allows the computation of the hydrostatic and wet mapping functions. The resulting element is an array having the following form:

• double[0] = m_h(e) → hydrostatic mapping function
• double[1] = m_w(e) → wet mapping function

Specified by:

mappingFactors in interface MappingFunction

Parameters:

elevation - the elevation of the satellite, in radians.

height - the height of the station in m above sea level.

parameters - tropospheric model parameters.

date - current date

Returns:

a two components array containing the hydrostatic and wet mapping functions.

mappingFactors

public <T extends RealFieldElement<T>> T[] mappingFactors(T elevation,
                                                          T height,
                                                          T[] parameters,
                                                          FieldAbsoluteDate<T> date)

This method allows the computation of the hydrostatic and wet mapping functions. The resulting element is an array having the following form:

• T[0] = m_h(e) → hydrostatic mapping function
• T[1] = m_w(e) → wet mapping function

Specified by:

mappingFactors in interface MappingFunction

Type Parameters:

T - type of the elements

Parameters:

elevation - the elevation of the satellite, in radians.

height - the height of the station in m above sea level.

parameters - tropospheric model parameters.

date - current date

Returns:

a two components array containing the hydrostatic and wet mapping functions.

getParametersDrivers

public List<ParameterDriver> getParametersDrivers()

Get the drivers for tropospheric model parameters.

Specified by:

getParametersDrivers in interface MappingFunction

Returns:

drivers for tropospheric model parameters