GravityFieldFactory (OREKIT 12.0.1 API)

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

```
public class GravityFieldFactory
extends Object
```
用于读取多种支持格式的重力场文件的工厂。

Author:

Fabien Maussion, Pascal Parraud, Luc Maisonobe

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`EGM_FILENAME` EGM文件的默认正则表达式。
`static String`	`FES_CHAT_EPSILON_FILENAME` FES C hat和epsilon潮汐文件的默认正则表达式。
`static String`	`FES_CNM_SNM_FILENAME` FES Cnm，Snm潮汐文件的默认正则表达式。
`static String`	`FES_HF_FILENAME` FES Hf潮汐文件的默认正则表达式。
`static String`	`GRGS_FILENAME` GRGS文件的默认正则表达式。
`static String`	`ICGEM_FILENAME` ICGEM文件的默认正则表达式。
`static String`	`SHM_FILENAME` SHM文件的默认正则表达式。

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static void`	`addDefaultOceanTidesReaders()` 添加用于海洋潮汐的默认读取器。
`static void`	`addDefaultPotentialCoefficientsReaders()` 添加用于重力场的默认读取器。
`static void`	`addOceanTidesReader(OceanTidesReader reader)` 添加一个用于海洋潮汐的读取器。
`static void`	`addPotentialCoefficientsReader(PotentialCoefficientsReader reader)` 添加一个用于重力场的读取器。
`static void`	`clearOceanTidesReaders()` 清除海洋潮汐读取器。
`static void`	`clearPotentialCoefficientsReaders()` 清除重力场读取器。
`static void`	`configureOceanLoadDeformationCoefficients(OceanLoadDeformationCoefficients oldc)` 配置海洋载荷变形系数。
`static NormalizedSphericalHarmonicsProvider`	`getConstantNormalizedProvider(int degree, int order, AbsoluteDate freezingDate)` 从第一个支持的文件中获取恒定重力场系数提供程序。
`static UnnormalizedSphericalHarmonicsProvider`	`getConstantUnnormalizedProvider(int degree, int order, AbsoluteDate freezingDate)` 从第一个支持的文件中获取恒定重力场系数提供程序。
`static LazyLoadedGravityFields`	`getGravityFields()` 获取由此类的静态方法调用的`GravityFields`的实例。
`static NormalizedSphericalHarmonicsProvider`	`getNormalizedProvider(double ae, double mu, TideSystem tideSystem, double[][] normalizedC, double[][] normalizedS)` 从规范系数创建一个与时间无关的`NormalizedSphericalHarmonicsProvider`。
`static NormalizedSphericalHarmonicsProvider`	`getNormalizedProvider(int degree, int order)` 从第一个支持的文件中获取重力场系数提供程序。
`static NormalizedSphericalHarmonicsProvider`	`getNormalizedProvider(UnnormalizedSphericalHarmonicsProvider unnormalized)` 从`UnnormalizedSphericalHarmonicsProvider`创建一个`NormalizedSphericalHarmonicsProvider`。
`static OceanLoadDeformationCoefficients`	`getOceanLoadDeformationCoefficients()` 获取配置的海洋载荷变形系数。
`static List<OceanTidesWave>`	`getOceanTidesWaves(int degree, int order)` 从第一个支持的文件中获取海洋潮汐波。
`static double[][]`	`getUnnormalizationFactors(int degree, int order)` 获取非归一化因子数组。
`static UnnormalizedSphericalHarmonicsProvider`	`getUnnormalizedProvider(double ae, double mu, TideSystem tideSystem, double[][] unnormalizedC, double[][] unnormalizedS)` 从规范系数创建一个与时间无关的`UnnormalizedSphericalHarmonicsProvider`。
`static UnnormalizedSphericalHarmonicsProvider`	`getUnnormalizedProvider(int degree, int order)` 从第一个支持的文件中获取重力场系数提供程序。
`static UnnormalizedSphericalHarmonicsProvider`	`getUnnormalizedProvider(NormalizedSphericalHarmonicsProvider normalized)` 从`NormalizedSphericalHarmonicsProvider`创建一个`UnnormalizedSphericalHarmonicsProvider`。
`static PotentialCoefficientsReader`	`readGravityField(int maxParseDegree, int maxParseOrder)` 从第一个支持的文件中读取重力场系数提供程序。

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
```
    ICGEM文件的默认正则表达式。
    
    另请参阅:
    
    常量字段值
  - SHM_FILENAME
```
public static final String SHM_FILENAME
```
    SHM文件的默认正则表达式。
    
    另请参阅:
    
    常量字段值
  - EGM_FILENAME
```
public static final String EGM_FILENAME
```
    EGM文件的默认正则表达式。
    
    另请参阅:
    
    常量字段值
  - GRGS_FILENAME
```
public static final String GRGS_FILENAME
```
    GRGS文件的默认正则表达式。
    
    另请参阅:
    
    常量字段值
  - FES_CNM_SNM_FILENAME
```
public static final String FES_CNM_SNM_FILENAME
```
    FES Cnm，Snm潮汐文件的默认正则表达式。
    
    另请参阅:
    
    常量字段值
  - FES_CHAT_EPSILON_FILENAME
```
public static final String FES_CHAT_EPSILON_FILENAME
```
    FES C hat和epsilon潮汐文件的默认正则表达式。
    
    另请参阅:
    
    常量字段值
  - FES_HF_FILENAME
```
public static final String FES_HF_FILENAME
```
    FES Hf潮汐文件的默认正则表达式。
    
    另请参阅:
    
    常量字段值
- Method Detail
  - getGravityFields
```
@DefaultDataContext
public static LazyLoadedGravityFields getGravityFields()
```
    获取由此类的静态方法调用的GravityFields的实例。
    
    返回:
    
    此工厂使用的重力场。
    
    自版本:
    
    10.1
  - addPotentialCoefficientsReader
```
@DefaultDataContext
public static void addPotentialCoefficientsReader(PotentialCoefficientsReader reader)
```
    添加一个用于重力场的读取器。
    
    参数:
    
    reader - 要添加的自定义读取器
    
    另请参阅:
    
    addDefaultPotentialCoefficientsReaders(), clearPotentialCoefficientsReaders()
  - addDefaultPotentialCoefficientsReaders
```
@DefaultDataContext
public static void addDefaultPotentialCoefficientsReaders()
```
    添加用于重力场的默认读取器。
    默认的读取器支持ICGEM、SHM、EGM和GRGS格式，使用默认名称ICGEM_FILENAME、SHM_FILENAME、EGM_FILENAME、GRGS_FILENAME，并且不允许缺失系数。
    
    另请参阅:
    
    addPotentialCoefficientsReader(PotentialCoefficientsReader), clearPotentialCoefficientsReaders()
  - clearPotentialCoefficientsReaders
```
@DefaultDataContext
public static void clearPotentialCoefficientsReaders()
```
    清除重力场读取器。
    
    另请参阅:
    
    addPotentialCoefficientsReader(PotentialCoefficientsReader), addDefaultPotentialCoefficientsReaders()
  - addOceanTidesReader
```
@DefaultDataContext
public static void addOceanTidesReader(OceanTidesReader reader)
```
    添加一个用于海洋潮汐的读取器。
    
    参数:
    
    reader - 要添加的自定义读取器
    
    另请参阅:
    
    addDefaultPotentialCoefficientsReaders(), clearPotentialCoefficientsReaders()
  - configureOceanLoadDeformationCoefficients
```
@DefaultDataContext
public static void configureOceanLoadDeformationCoefficients(OceanLoadDeformationCoefficients oldc)
```
    配置海洋载荷变形系数。
    
    参数:
    
    oldc - 海洋载荷变形系数
    
    另请参阅:
    
    getOceanLoadDeformationCoefficients()
  - getOceanLoadDeformationCoefficients
```
@DefaultDataContext
public static OceanLoadDeformationCoefficients getOceanLoadDeformationCoefficients()
```
    获取配置的海洋载荷变形系数。
    如果从未调用过configureOceanLoadDeformationCoefficients，默认值将是IERS 2010系数。
    
    返回:
    
    海洋载荷变形系数
    
    另请参阅:
    
    configureOceanLoadDeformationCoefficients(OceanLoadDeformationCoefficients)
  - addDefaultOceanTidesReaders
```
@DefaultDataContext
public static void addDefaultOceanTidesReaders()
```
    添加海洋潮汐的默认读取器。
    默认读取器支持类似于由IERS发布的fes2004_Cnm-Snm.dat和fes2004.dat文件，使用默认的海洋载荷变形系数，这些系数默认为IERS 2010系数，限制为6阶。如果需要更高阶系数，可以在加载海洋潮汐模型之前调用configureOceanLoadDeformationCoefficients方法，使用Pascal Gégout计算的高阶系数。
    
    警告：已发布的约定中引用的文件存在一些错误。这些错误已经被纠正，更新后的文件可以在这里找到： http://tai.bipm.org/iers/convupdt/convupdt_c6.html。
    
    另请参阅：
    
    addPotentialCoefficientsReader(PotentialCoefficientsReader), clearPotentialCoefficientsReaders(), configureOceanLoadDeformationCoefficients(OceanLoadDeformationCoefficients), getOceanLoadDeformationCoefficients()
  - clearOceanTidesReaders
```
@DefaultDataContext
public static void clearOceanTidesReaders()
```
    清除海洋潮汐读取器。
    
    另请参阅：
    
    addPotentialCoefficientsReader(PotentialCoefficientsReader), addDefaultPotentialCoefficientsReaders()
  - getConstantNormalizedProvider
```
@DefaultDataContext
public static NormalizedSphericalHarmonicsProvider getConstantNormalizedProvider(int degree,
                                                                                                     int order,
                                                                                                     AbsoluteDate freezingDate)
```
    从第一个支持的文件中获取恒定重力场系数提供者。
    如果没有通过调用addPotentialCoefficientsReader添加任何PotentialCoefficientsReader，或者之后调用了clearPotentialCoefficientsReaders，则将自动调用addDefaultPotentialCoefficientsReaders方法。
    
    参数：
    
    degree - 最大阶数
    
    order - 最大次数
    
    freezingDate - 冻结时刻
    
    返回：
    
    包含已加载数据的重力场系数提供者
    
    自版本：
    
    12.0
    
    另请参阅：
    
    getNormalizedProvider(int, int)
  - getNormalizedProvider
```
@DefaultDataContext
public static NormalizedSphericalHarmonicsProvider getNormalizedProvider(int degree,
                                                                                             int order)
```
    从第一个支持的文件中获取重力场系数提供者。
    如果没有通过调用addPotentialCoefficientsReader添加任何PotentialCoefficientsReader，或者之后调用了clearPotentialCoefficientsReaders，则将自动调用addDefaultPotentialCoefficientsReaders方法。
    
    参数：
    
    degree - 最大阶数
    
    order - 最大次数
    
    返回：
    
    包含已加载数据的重力场系数提供者
    
    自版本：
    
    6.0
    
    另请参阅：
    
    getConstantNormalizedProvider(int, int, AbsoluteDate)
  - getConstantUnnormalizedProvider
```
@DefaultDataContext
public static UnnormalizedSphericalHarmonicsProvider getConstantUnnormalizedProvider(int degree,
                                                                                                         int order,
                                                                                                         AbsoluteDate freezingDate)
```
    从第一个支持的文件中获取恒定重力场系数提供者。
    如果没有通过调用addPotentialCoefficientsReader添加任何PotentialCoefficientsReader，或者之后调用了clearPotentialCoefficientsReaders，则将自动调用addDefaultPotentialCoefficientsReaders方法。
    
    参数：
    
    degree - 最大阶数
    
    order - 最大次数
    
    freezingDate - 冻结时刻
    
    返回：
    
    包含已加载数据的重力场系数提供者
    
    自版本：
    
    6.0
    
    另请参阅：
    
    getUnnormalizedProvider(int, int)
  - getUnnormalizedProvider
```
@DefaultDataContext
public static UnnormalizedSphericalHarmonicsProvider getUnnormalizedProvider(int degree,
                                                                                                 int order)
```
    从第一个支持的文件中获取重力场系数提供者。
    如果没有通过调用addPotentialCoefficientsReader添加任何PotentialCoefficientsReader，或者之后调用了clearPotentialCoefficientsReaders，则将自动调用addDefaultPotentialCoefficientsReaders方法。
    
    参数：
    
    degree - 最大阶数
    
    order - 最大次数
    
    返回：
    
    包含已加载数据的重力场系数提供者
    
    自版本：
    
    6.0
    
    另请参阅：
    
    getConstantUnnormalizedProvider(int, int, AbsoluteDate)
  - readGravityField
```
@DefaultDataContext
public static PotentialCoefficientsReader readGravityField(int maxParseDegree,
                                                                               int maxParseOrder)
```
    从第一个支持的文件中读取重力场系数提供者。
    如果没有通过调用addPotentialCoefficientsReader添加任何PotentialCoefficientsReader，或者之后调用了clearPotentialCoefficientsReaders，则将自动调用addDefaultPotentialCoefficientsReaders方法。
    
    参数：
    
    maxParseDegree - 要解析的最大阶数
    
    maxParseOrder - 要解析的最大次数
    
    返回：
    
    包含已加载数据的读取器
    
    自版本：
    
    6.0
  - getOceanTidesWaves
```
@DefaultDataContext
public static List<OceanTidesWave> getOceanTidesWaves(int degree,
                                                                          int order)
```
    从第一个支持的文件中获取海洋潮汐波。
    如果没有通过调用 OceanTidesReader 添加过潮汐阅读器，或者之后调用了 clearOceanTidesReaders，则会自动调用 addDefaultOceanTidesReaders 方法。
    
    警告：截至2013-11-17，加载其中一个文件时存在不一致性，对于Sa波（Doodson数56.554）和P1波（Doodson数163.555）。系数的符号是不同的。我们认为问题出在IERS的输入文件中，而不是转换中（对于所有其他波浪都有效），但无法确定。因此，海洋潮汐在此日期仍被视为实验性质。
    
    参数：
    
    degree - 最大度数
    
    order - 最大阶数
    
    返回：
    
    包含已加载数据的潮汐波列表
    
    自版本：
    
    6.1
  - getNormalizedProvider
```
public static NormalizedSphericalHarmonicsProvider getNormalizedProvider(double ae,
                                                                         double mu,
                                                                         TideSystem tideSystem,
                                                                         double[][] normalizedC,
                                                                         double[][] normalizedS)
```
    从规范系数创建一个与时间无关的 NormalizedSphericalHarmonicsProvider。
    请注意，与其他工厂方法相反，此方法不会读取任何数据，而只是使用提供的数据。
    
    参数：
    
    ae - 中心天体参考半径
    
    mu - 中心天体引力系数
    
    tideSystem - 潮汐系统
    
    normalizedC - 规范化的球谐系数（余弦部分）
    
    normalizedS - 规范化的球谐系数（正弦部分）
    
    返回：
    
    规范化系数的提供者
    
    自版本：
    
    6.0
  - getNormalizedProvider
```
public static NormalizedSphericalHarmonicsProvider getNormalizedProvider(UnnormalizedSphericalHarmonicsProvider unnormalized)
```
    从一个 UnnormalizedSphericalHarmonicsProvider 创建一个 NormalizedSphericalHarmonicsProvider。
    请注意，与其他工厂方法相反，此方法不会读取任何数据，而只是使用提供的数据。
    
    参数：
    
    unnormalized - 要规范化的提供者
    
    返回：
    
    规范化系数的提供者
    
    自版本：
    
    6.0
  - getUnnormalizedProvider
```
public static UnnormalizedSphericalHarmonicsProvider getUnnormalizedProvider(double ae,
                                                                             double mu,
                                                                             TideSystem tideSystem,
                                                                             double[][] unnormalizedC,
                                                                             double[][] unnormalizedS)
```
    从规范系数创建一个与时间无关的 UnnormalizedSphericalHarmonicsProvider。
    请注意，与其他工厂方法相反，此方法不会读取任何数据，而只是使用提供的数据。
    
    参数：
    
    ae - 中心天体参考半径
    
    mu - 中心天体引力系数
    
    tideSystem - 潮汐系统
    
    unnormalizedC - 未规范化的球谐系数（余弦部分）
    
    unnormalizedS - 未规范化的球谐系数（正弦部分）
    
    返回：
    
    未规范化系数的提供者
    
    自版本：
    
    6.0
  - getUnnormalizedProvider
```
public static UnnormalizedSphericalHarmonicsProvider getUnnormalizedProvider(NormalizedSphericalHarmonicsProvider normalized)
```
    从一个 NormalizedSphericalHarmonicsProvider 创建一个 UnnormalizedSphericalHarmonicsProvider。
    请注意，与其他工厂方法相反，此方法不会读取任何数据，而只是使用提供的数据。
    
    参数：
    
    normalized - 要取消规范化的提供者
    
    返回：
    
    未规范化系数的提供者
    
    自版本：
    
    6.0
  - getUnnormalizationFactors
```
public static double[][] getUnnormalizationFactors(int degree,
                                                   int order)
```
    获取一个未规范化因子数组。
    未规范化系数是通过将规范化系数乘以因子数组元素获得的。
    
    参数：
    
    degree - 最大度数
    
    order - 最大阶数
    
    返回：
    
    三角形未规范化因子数组
    
    自版本：
    
    6.0

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

getGravityFields

addPotentialCoefficientsReader

addDefaultPotentialCoefficientsReaders

clearPotentialCoefficientsReaders

addOceanTidesReader

configureOceanLoadDeformationCoefficients

getOceanLoadDeformationCoefficients

addDefaultOceanTidesReaders

clearOceanTidesReaders

getConstantNormalizedProvider

getNormalizedProvider

getConstantUnnormalizedProvider

getUnnormalizedProvider

readGravityField

getOceanTidesWaves

getNormalizedProvider

getNormalizedProvider

getUnnormalizedProvider

getUnnormalizedProvider

getUnnormalizationFactors