GravityFieldFactory (ORbit Extrapolation KIT 9.2 API)

java.lang.Object
- org.orekit.forces.gravity.potential.GravityFieldFactory

```
public class GravityFieldFactory
extends Object
```
Factory used to read gravity field files in several supported formats.

Author:

Fabien Maussion, Pascal Parraud, Luc Maisonobe

Field Summary

Fields
Modifier and Type	Field	Description
`static String`	`EGM_FILENAME`	Default regular expression for EGM files.
`static String`	`FES_CHAT_EPSILON_FILENAME`	Default regular expression for FES C hat and epsilon tides files.
`static String`	`FES_CNM_SNM_FILENAME`	Default regular expression for FES Cnm, Snm tides files.
`static String`	`FES_HF_FILENAME`	Default regular expression for FES Hf tides files.
`static String`	`GRGS_FILENAME`	Default regular expression for GRGS files.
`static String`	`ICGEM_FILENAME`	Default regular expression for ICGEM files.
`static String`	`SHM_FILENAME`	Default regular expression for SHM files.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method	Description
`static void`	`addDefaultOceanTidesReaders()`	Add the default READERS for ocean tides.
`static void`	`addDefaultPotentialCoefficientsReaders()`	Add the default readers for gravity fields.
`static void`	`addOceanTidesReader(OceanTidesReader reader)`	Add a reader for ocean tides.
`static void`	`addPotentialCoefficientsReader(PotentialCoefficientsReader reader)`	Add a reader for gravity fields.
`static void`	`clearOceanTidesReaders()`	Clear ocean tides readers.
`static void`	`clearPotentialCoefficientsReaders()`	Clear gravity field readers.
`static void`	`configureOceanLoadDeformationCoefficients(OceanLoadDeformationCoefficients oldc)`	Configure ocean load deformation coefficients.
`static NormalizedSphericalHarmonicsProvider`	`getConstantNormalizedProvider(int degree, int order)`	Get the constant gravity field coefficients provider from the first supported file.
`static UnnormalizedSphericalHarmonicsProvider`	`getConstantUnnormalizedProvider(int degree, int order)`	Get the constant gravity field coefficients provider from the first supported file.
`static NormalizedSphericalHarmonicsProvider`	`getNormalizedProvider(double ae, double mu, TideSystem tideSystem, double[][] normalizedC, double[][] normalizedS)`	Create a time-independent `NormalizedSphericalHarmonicsProvider` from canonical coefficients.
`static NormalizedSphericalHarmonicsProvider`	`getNormalizedProvider(int degree, int order)`	Get the gravity field coefficients provider from the first supported file.
`static NormalizedSphericalHarmonicsProvider`	`getNormalizedProvider(UnnormalizedSphericalHarmonicsProvider unnormalized)`	Create a `NormalizedSphericalHarmonicsProvider` from an `UnnormalizedSphericalHarmonicsProvider`.
`static OceanLoadDeformationCoefficients`	`getOceanLoadDeformationCoefficients()`	Get the configured ocean load deformation coefficients.
`static List<OceanTidesWave>`	`getOceanTidesWaves(int degree, int order)`	Get the ocean tides waves from the first supported file.
`static double[][]`	`getUnnormalizationFactors(int degree, int order)`	Get a un-normalization factors array.
`static UnnormalizedSphericalHarmonicsProvider`	`getUnnormalizedProvider(double ae, double mu, TideSystem tideSystem, double[][] unnormalizedC, double[][] unnormalizedS)`	Create a time-independent `UnnormalizedSphericalHarmonicsProvider` from canonical coefficients.
`static UnnormalizedSphericalHarmonicsProvider`	`getUnnormalizedProvider(int degree, int order)`	Get the gravity field coefficients provider from the first supported file.
`static UnnormalizedSphericalHarmonicsProvider`	`getUnnormalizedProvider(NormalizedSphericalHarmonicsProvider normalized)`	Create an `UnnormalizedSphericalHarmonicsProvider` from a `NormalizedSphericalHarmonicsProvider`.
`static PotentialCoefficientsReader`	`readGravityField(int maxParseDegree, int maxParseOrder)`	Read a gravity field coefficients provider from the first supported file.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - ICGEM_FILENAME
```
public static final String ICGEM_FILENAME
```
    Default regular expression for ICGEM files.
    
    See Also:
    
    Constant Field Values
  - SHM_FILENAME
```
public static final String SHM_FILENAME
```
    Default regular expression for SHM files.
    
    See Also:
    
    Constant Field Values
  - EGM_FILENAME
```
public static final String EGM_FILENAME
```
    Default regular expression for EGM files.
    
    See Also:
    
    Constant Field Values
  - GRGS_FILENAME
```
public static final String GRGS_FILENAME
```
    Default regular expression for GRGS files.
    
    See Also:
    
    Constant Field Values
  - FES_CNM_SNM_FILENAME
```
public static final String FES_CNM_SNM_FILENAME
```
    Default regular expression for FES Cnm, Snm tides files.
    
    See Also:
    
    Constant Field Values
  - FES_CHAT_EPSILON_FILENAME
```
public static final String FES_CHAT_EPSILON_FILENAME
```
    Default regular expression for FES C hat and epsilon tides files.
    
    See Also:
    
    Constant Field Values
  - FES_HF_FILENAME
```
public static final String FES_HF_FILENAME
```
    Default regular expression for FES Hf tides files.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - addPotentialCoefficientsReader
```
public static void addPotentialCoefficientsReader(PotentialCoefficientsReader reader)
```
    Add a reader for gravity fields.
    
    Parameters:
    
    reader - custom reader to add for the gravity field
    
    See Also:
    
    addDefaultPotentialCoefficientsReaders(), clearPotentialCoefficientsReaders()
  - addDefaultPotentialCoefficientsReaders
```
public static void addDefaultPotentialCoefficientsReaders()
```
    Add the default readers for gravity fields.
    The default READERS supports ICGEM, SHM, EGM and GRGS formats with the default names ICGEM_FILENAME, SHM_FILENAME, EGM_FILENAME, GRGS_FILENAME and don't allow missing coefficients.
    
    See Also:
    
    addPotentialCoefficientsReader(PotentialCoefficientsReader), clearPotentialCoefficientsReaders()
  - clearPotentialCoefficientsReaders
```
public static void clearPotentialCoefficientsReaders()
```
    Clear gravity field readers.
    
    See Also:
    
    addPotentialCoefficientsReader(PotentialCoefficientsReader), addDefaultPotentialCoefficientsReaders()
  - addOceanTidesReader
```
public static void addOceanTidesReader(OceanTidesReader reader)
```
    Add a reader for ocean tides.
    
    Parameters:
    
    reader - custom reader to add for the gravity field
    
    See Also:
    
    addDefaultPotentialCoefficientsReaders(), clearPotentialCoefficientsReaders()
  - configureOceanLoadDeformationCoefficients
```
public static void configureOceanLoadDeformationCoefficients(OceanLoadDeformationCoefficients oldc)
```
    Configure ocean load deformation coefficients.
    
    Parameters:
    
    oldc - ocean load deformation coefficients
    
    See Also:
    
    getOceanLoadDeformationCoefficients()
  - getOceanLoadDeformationCoefficients
```
public static OceanLoadDeformationCoefficients getOceanLoadDeformationCoefficients()
```
    Get the configured ocean load deformation coefficients.
    If configureOceanLoadDeformationCoefficients has never been called, the default value will be the IERS 2010 coefficients.
    
    Returns:
    
    ocean load deformation coefficients
    
    See Also:
    
    configureOceanLoadDeformationCoefficients(OceanLoadDeformationCoefficients)
  - addDefaultOceanTidesReaders
```
public static void addDefaultOceanTidesReaders()
                                        throws OrekitException
```
    Add the default READERS for ocean tides.
    The default READERS supports files similar to the fes2004_Cnm-Snm.dat and fes2004.dat as published by IERS, using the configured ocean load deformation coefficients, which by default are the IERS 2010 coefficients, which are limited to degree 6. If higher degree coefficients are needed, the configureOceanLoadDeformationCoefficients method can be called prior to loading the ocean tides model with the high degree coefficients computed by Pascal Gégout.
    
    WARNING: the files referenced in the published conventions have some errors. These errors have been corrected and the updated files can be found here: http://tai.bipm.org/iers/convupdt/convupdt_c6.html.
    
    Throws:
    
    OrekitException - if astronomical amplitudes cannot be read
    
    See Also:
    
    addPotentialCoefficientsReader(PotentialCoefficientsReader), clearPotentialCoefficientsReaders(), configureOceanLoadDeformationCoefficients(OceanLoadDeformationCoefficients), getOceanLoadDeformationCoefficients()
  - clearOceanTidesReaders
```
public static void clearOceanTidesReaders()
```
    Clear ocean tides readers.
    
    See Also:
    
    addPotentialCoefficientsReader(PotentialCoefficientsReader), addDefaultPotentialCoefficientsReaders()
  - getConstantNormalizedProvider
```
public static NormalizedSphericalHarmonicsProvider getConstantNormalizedProvider(int degree,
                                                                                 int order)
                                                                          throws OrekitException
```
    Get the constant gravity field coefficients provider from the first supported file.
    If no PotentialCoefficientsReader has been added by calling addPotentialCoefficientsReader or if clearPotentialCoefficientsReaders has been called afterwards, the addDefaultPotentialCoefficientsReaders method will be called automatically.
    
    Parameters:
    
    degree - maximal degree
    
    order - maximal order
    
    Returns:
    
    a gravity field coefficients provider containing already loaded data
    
    Throws:
    
    OrekitException - if some data can't be read (missing or read error) or if some loader specific error occurs
    
    Since:
    
    6.0
    
    See Also:
    
    getNormalizedProvider(int, int)
  - getNormalizedProvider
```
public static NormalizedSphericalHarmonicsProvider getNormalizedProvider(int degree,
                                                                         int order)
                                                                  throws OrekitException
```
    Get the gravity field coefficients provider from the first supported file.
    If no PotentialCoefficientsReader has been added by calling addPotentialCoefficientsReader or if clearPotentialCoefficientsReaders has been called afterwards, the addDefaultPotentialCoefficientsReaders method will be called automatically.
    
    Parameters:
    
    degree - maximal degree
    
    order - maximal order
    
    Returns:
    
    a gravity field coefficients provider containing already loaded data
    
    Throws:
    
    OrekitException - if some data can't be read (missing or read error) or if some loader specific error occurs
    
    Since:
    
    6.0
    
    See Also:
    
    getConstantNormalizedProvider(int, int)
  - getNormalizedProvider
```
public static NormalizedSphericalHarmonicsProvider getNormalizedProvider(double ae,
                                                                         double mu,
                                                                         TideSystem tideSystem,
                                                                         double[][] normalizedC,
                                                                         double[][] normalizedS)
```
    Create a time-independent NormalizedSphericalHarmonicsProvider from canonical coefficients.
    Note that contrary to the other factory method, this one does not read any data, it simply uses the provided data
    
    Parameters:
    
    ae - central body reference radius
    
    mu - central body attraction coefficient
    
    tideSystem - tide system
    
    normalizedC - normalized tesseral-sectorial coefficients (cosine part)
    
    normalizedS - normalized tesseral-sectorial coefficients (sine part)
    
    Returns:
    
    provider for normalized coefficients
    
    Since:
    
    6.0
  - getNormalizedProvider
```
public static NormalizedSphericalHarmonicsProvider getNormalizedProvider(UnnormalizedSphericalHarmonicsProvider unnormalized)
                                                                  throws OrekitException
```
    Create a NormalizedSphericalHarmonicsProvider from an UnnormalizedSphericalHarmonicsProvider.
    Note that contrary to the other factory method, this one does not read any data, it simply uses the provided data.
    
    Parameters:
    
    unnormalized - provider to normalize
    
    Returns:
    
    provider for normalized coefficients
    
    Throws:
    
    OrekitException - if degree and order are too large and the normalization coefficients underflow
    
    Since:
    
    6.0
  - getConstantUnnormalizedProvider
```
public static UnnormalizedSphericalHarmonicsProvider getConstantUnnormalizedProvider(int degree,
                                                                                     int order)
                                                                              throws OrekitException
```
    Get the constant gravity field coefficients provider from the first supported file.
    If no PotentialCoefficientsReader has been added by calling addPotentialCoefficientsReader or if clearPotentialCoefficientsReaders has been called afterwards, the addDefaultPotentialCoefficientsReaders method will be called automatically.
    
    Parameters:
    
    degree - maximal degree
    
    order - maximal order
    
    Returns:
    
    a gravity field coefficients provider containing already loaded data
    
    Throws:
    
    OrekitException - if some data can't be read (missing or read error) or if some loader specific error occurs
    
    Since:
    
    6.0
    
    See Also:
    
    getUnnormalizedProvider(int, int)
  - getUnnormalizedProvider
```
public static UnnormalizedSphericalHarmonicsProvider getUnnormalizedProvider(int degree,
                                                                             int order)
                                                                      throws OrekitException
```
    Get the gravity field coefficients provider from the first supported file.
    If no PotentialCoefficientsReader has been added by calling addPotentialCoefficientsReader or if clearPotentialCoefficientsReaders has been called afterwards, the addDefaultPotentialCoefficientsReaders method will be called automatically.
    
    Parameters:
    
    degree - maximal degree
    
    order - maximal order
    
    Returns:
    
    a gravity field coefficients provider containing already loaded data
    
    Throws:
    
    OrekitException - if some data can't be read (missing or read error) or if some loader specific error occurs
    
    Since:
    
    6.0
    
    See Also:
    
    getConstantUnnormalizedProvider(int, int)
  - getUnnormalizedProvider
```
public static UnnormalizedSphericalHarmonicsProvider getUnnormalizedProvider(double ae,
                                                                             double mu,
                                                                             TideSystem tideSystem,
                                                                             double[][] unnormalizedC,
                                                                             double[][] unnormalizedS)
```
    Create a time-independent UnnormalizedSphericalHarmonicsProvider from canonical coefficients.
    Note that contrary to the other factory method, this one does not read any data, it simply uses the provided data
    
    Parameters:
    
    ae - central body reference radius
    
    mu - central body attraction coefficient
    
    tideSystem - tide system
    
    unnormalizedC - un-normalized tesseral-sectorial coefficients (cosine part)
    
    unnormalizedS - un-normalized tesseral-sectorial coefficients (sine part)
    
    Returns:
    
    provider for un-normalized coefficients
    
    Since:
    
    6.0
  - getUnnormalizedProvider
```
public static UnnormalizedSphericalHarmonicsProvider getUnnormalizedProvider(NormalizedSphericalHarmonicsProvider normalized)
                                                                      throws OrekitException
```
    Create an UnnormalizedSphericalHarmonicsProvider from a NormalizedSphericalHarmonicsProvider.
    Note that contrary to the other factory method, this one does not read any data, it simply uses the provided data.
    
    Parameters:
    
    normalized - provider to un-normalize
    
    Returns:
    
    provider for un-normalized coefficients
    
    Throws:
    
    OrekitException - if degree and order are too large and the un-normalization coefficients underflow
    
    Since:
    
    6.0
  - readGravityField
```
public static PotentialCoefficientsReader readGravityField(int maxParseDegree,
                                                           int maxParseOrder)
                                                    throws OrekitException
```
    Read a gravity field coefficients provider from the first supported file.
    If no PotentialCoefficientsReader has been added by calling addPotentialCoefficientsReader or if clearPotentialCoefficientsReaders has been called afterwards, the addDefaultPotentialCoefficientsReaders method will be called automatically.
    
    Parameters:
    
    maxParseDegree - maximal degree to parse
    
    maxParseOrder - maximal order to parse
    
    Returns:
    
    a reader containing already loaded data
    
    Throws:
    
    OrekitException - if some data is missing or if some loader specific error occurs
    
    Since:
    
    6.0
  - getUnnormalizationFactors
```
public static double[][] getUnnormalizationFactors(int degree,
                                                   int order)
                                            throws OrekitException
```
    Get a un-normalization factors array.
    Un-normalized coefficients are obtained by multiplying normalized coefficients by the factors array elements.
    
    Parameters:
    
    degree - maximal degree
    
    order - maximal order
    
    Returns:
    
    triangular un-normalization factors array
    
    Throws:
    
    OrekitException - if degree and order are too large and the latest coefficients underflow
    
    Since:
    
    6.0
  - getOceanTidesWaves
```
public static List<OceanTidesWave> getOceanTidesWaves(int degree,
                                                      int order)
                                               throws OrekitException
```
    Get the ocean tides waves from the first supported file.
    If no OceanTidesReader has been added by calling addOceanTidesReader or if clearOceanTidesReaders has been called afterwards, the addDefaultOceanTidesReaders method will be called automatically.
    
    WARNING: as of 2013-11-17, there seem to be an inconsistency when loading one or the other file, for wave Sa (Doodson number 56.554) and P1 (Doodson number 163.555). The sign of the coefficients are different. We think the problem lies in the input files from IERS and not in the conversion (which works for all other waves), but cannot be sure. For this reason, ocean tides are still considered experimental at this date.
    
    Parameters:
    
    degree - maximal degree
    
    order - maximal order
    
    Returns:
    
    list of tides waves containing already loaded data
    
    Throws:
    
    OrekitException - if some data can't be read (missing or read error) or if some loader specific error occurs
    
    Since:
    
    6.1

Class GravityFieldFactory

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ICGEM_FILENAME

SHM_FILENAME

EGM_FILENAME

GRGS_FILENAME

FES_CNM_SNM_FILENAME

FES_CHAT_EPSILON_FILENAME

FES_HF_FILENAME

Method Detail

addPotentialCoefficientsReader

addDefaultPotentialCoefficientsReaders

clearPotentialCoefficientsReaders

addOceanTidesReader

configureOceanLoadDeformationCoefficients

getOceanLoadDeformationCoefficients

addDefaultOceanTidesReaders

clearOceanTidesReaders

getConstantNormalizedProvider

getNormalizedProvider

getNormalizedProvider

getNormalizedProvider

getConstantUnnormalizedProvider

getUnnormalizedProvider

getUnnormalizedProvider

getUnnormalizedProvider

readGravityField

getUnnormalizationFactors

getOceanTidesWaves