LazyLoadedGravityFields (OREKIT 12.0.1 API)

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

All Implemented Interfaces:

GravityFields
```
public class LazyLoadedGravityFields
extends Object
implements GravityFields
```
当首次请求时加载重力场，并在此之前可以进行配置。旨在与Orekit 10.0中的GravityFieldFactory的行为相匹配。

Since:

10.1

Author:

Evan Ward, Fabien Maussion, Pascal Parraud, Luc Maisonobe

See Also:

GravityFieldFactory

Constructor Summary

Constructors
Constructor and Description
`LazyLoadedGravityFields(DataProvidersManager dataProvidersManager, TimeScale timeScale)` 创建一个重力场工厂，使用给定的数据管理器加载重力场文件。

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addDefaultOceanTidesReaders()` 添加默认的海洋潮汐读取器。
`void`	`addDefaultPotentialCoefficientsReaders()` 添加默认的重力场读取器。
`void`	`addOceanTidesReader(OceanTidesReader reader)` 添加一个海洋潮汐读取器。
`void`	`addPotentialCoefficientsReader(PotentialCoefficientsReader reader)` 添加一个重力场读取器。
`void`	`clearOceanTidesReaders()` 清除海洋潮汐读取器。
`void`	`clearPotentialCoefficientsReaders()` 清除重力场读取器。
`void`	`configureOceanLoadDeformationCoefficients(OceanLoadDeformationCoefficients oldc)` 配置海洋载荷变形系数。
`NormalizedSphericalHarmonicsProvider`	`getConstantNormalizedProvider(int degree, int order, AbsoluteDate freezingDate)` 获取在给定历元冻结的恒定重力场归一化系数提供程序。
`UnnormalizedSphericalHarmonicsProvider`	`getConstantUnnormalizedProvider(int degree, int order, AbsoluteDate freezingDate)` 获取在给定历元冻结的恒定重力场非归一化系数提供程序。
`NormalizedSphericalHarmonicsProvider`	`getNormalizedProvider(int degree, int order)` 获取重力场归一化系数提供程序。
`OceanLoadDeformationCoefficients`	`getOceanLoadDeformationCoefficients()` 获取配置的海洋载荷变形系数。
`List<OceanTidesWave>`	`getOceanTidesWaves(int degree, int order)` 获取海洋潮汐波。
`UnnormalizedSphericalHarmonicsProvider`	`getUnnormalizedProvider(int degree, int order)` 获取重力场非归一化系数提供程序。
`PotentialCoefficientsReader`	`readGravityField(int maxParseDegree, int maxParseOrder)` 从第一个支持的文件中读取重力场系数提供程序。

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

- Constructor Detail
  - LazyLoadedGravityFields
```
public LazyLoadedGravityFields(DataProvidersManager dataProvidersManager,
                               TimeScale timeScale)
```
    创建一个重力场工厂，使用给定的数据管理器加载重力场文件。
    
    参数：
    
    dataProvidersManager - 提供对辅助数据文件的访问。
    
    timeScale - 用于解析addDefaultPotentialCoefficientsReaders()中的日期。在Orekit 10.0中为TT。
- Method Detail
  - addPotentialCoefficientsReader
```
public void addPotentialCoefficientsReader(PotentialCoefficientsReader reader)
```
    添加一个重力场读取器。
    
    参数：
    
    reader - 要添加到重力场的自定义读取器
    
    另请参阅：
    
    addDefaultPotentialCoefficientsReaders(), clearPotentialCoefficientsReaders()
  - addDefaultPotentialCoefficientsReaders
```
public void addDefaultPotentialCoefficientsReaders()
```
    添加默认的重力场读取器。
    默认的读取器支持ICGEM、SHM、EGM和GRGS格式，使用默认名称GravityFieldFactory.ICGEM_FILENAME、GravityFieldFactory.SHM_FILENAME、GravityFieldFactory.EGM_FILENAME、GravityFieldFactory.GRGS_FILENAME，并且不允许缺失系数。
    
    另请参阅：
    
    addPotentialCoefficientsReader(PotentialCoefficientsReader), clearPotentialCoefficientsReaders()
  - clearPotentialCoefficientsReaders
```
public void clearPotentialCoefficientsReaders()
```
    清除重力场读取器。
    
    另请参阅：
    
    addPotentialCoefficientsReader(PotentialCoefficientsReader), addDefaultPotentialCoefficientsReaders()
  - addOceanTidesReader
```
public void addOceanTidesReader(OceanTidesReader reader)
```
    添加一个海洋潮汐读取器。
    
    参数：
    
    reader - 要添加到重力场的自定义读取器
    
    另请参阅：
    
    addDefaultPotentialCoefficientsReaders(), clearPotentialCoefficientsReaders()
  - configureOceanLoadDeformationCoefficients
```
public void configureOceanLoadDeformationCoefficients(OceanLoadDeformationCoefficients oldc)
```
    配置海洋载荷变形系数。
    
    参数：
    
    oldc - 海洋载荷变形系数
    
    另请参阅：
    
    getOceanLoadDeformationCoefficients()
  - getOceanLoadDeformationCoefficients
```
public OceanLoadDeformationCoefficients getOceanLoadDeformationCoefficients()
```
    获取配置的海洋载荷变形系数。
    如果从未调用过configureOceanLoadDeformationCoefficients，默认值将是IERS 2010系数。
    
    返回：
    
    海洋载荷变形系数
    
    另请参阅：
    
    configureOceanLoadDeformationCoefficients(OceanLoadDeformationCoefficients)
  - addDefaultOceanTidesReaders
```
public 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
```
public void clearOceanTidesReaders()
```
    清除海洋潮汐读取器。
    
    另请参阅：
    
    addPotentialCoefficientsReader(PotentialCoefficientsReader), addDefaultPotentialCoefficientsReaders()
  - readGravityField
```
public PotentialCoefficientsReader readGravityField(int maxParseDegree,
                                                    int maxParseOrder)
```
    从第一个支持的文件中读取重力场系数提供程序。
    如果没有通过调用addPotentialCoefficientsReader添加任何PotentialCoefficientsReader，或者在之后调用clearPotentialCoefficientsReaders，则将自动调用addDefaultPotentialCoefficientsReaders方法。
    
    参数：
    
    maxParseDegree - 要解析的最大阶数
    
    maxParseOrder - 要解析的最大次数
    
    返回：
    
    包含已加载数据的读取器
    
    自版本：
    
    6.0
  - getConstantNormalizedProvider
```
public NormalizedSphericalHarmonicsProvider getConstantNormalizedProvider(int degree,
                                                                          int order,
                                                                          AbsoluteDate freezingDate)
```
    获取在给定时刻冻结的恒定重力场归一化系数提供者。
    如果没有通过调用PotentialCoefficientsReader添加过，或者之后调用了clearPotentialCoefficientsReaders，则将自动调用addDefaultPotentialCoefficientsReaders方法。
    
    指定者：
    
    getConstantNormalizedProvider 在接口 GravityFields
    
    参数：
    
    degree - 最大次数
    
    order - 最大阶数
    
    freezingDate - 冻结时刻
    
    返回：
    
    包含已加载数据的重力场系数提供者
    
    另请参阅：
    
    GravityFields.getNormalizedProvider(int, int)
  - getNormalizedProvider
```
public NormalizedSphericalHarmonicsProvider getNormalizedProvider(int degree,
                                                                  int order)
```
    获取重力场归一化系数提供者。
    如果没有通过调用PotentialCoefficientsReader添加过，或者之后调用了clearPotentialCoefficientsReaders，则将自动调用addDefaultPotentialCoefficientsReaders方法。
    
    指定者：
    
    getNormalizedProvider 在接口 GravityFields
    
    参数：
    
    degree - 最大次数
    
    order - 最大阶数
    
    返回：
    
    包含已加载数据的重力场系数提供者
    
    另请参阅：
    
    GravityFields.getConstantNormalizedProvider(int, int, AbsoluteDate)
  - getConstantUnnormalizedProvider
```
public UnnormalizedSphericalHarmonicsProvider getConstantUnnormalizedProvider(int degree,
                                                                              int order,
                                                                              AbsoluteDate freezingDate)
```
    获取在给定时刻冻结的恒定重力场非归一化系数提供者。
    如果没有通过调用PotentialCoefficientsReader添加过，或者之后调用了clearPotentialCoefficientsReaders，则将自动调用addDefaultPotentialCoefficientsReaders方法。
    
    指定者：
    
    getConstantUnnormalizedProvider 在接口 GravityFields
    
    参数：
    
    degree - 最大次数
    
    order - 最大阶数
    
    freezingDate - 冻结时刻
    
    返回：
    
    包含已加载数据的重力场系数提供者
    
    另请参阅：
    
    GravityFields.getUnnormalizedProvider(int, int)
  - getUnnormalizedProvider
```
public UnnormalizedSphericalHarmonicsProvider getUnnormalizedProvider(int degree,
                                                                      int order)
```
    获取非归一化重力场系数提供者。
    如果没有通过调用PotentialCoefficientsReader添加过，或者之后调用了clearPotentialCoefficientsReaders，则将自动调用addDefaultPotentialCoefficientsReaders方法。
    
    指定者：
    
    getUnnormalizedProvider 在接口 GravityFields
    
    参数：
    
    degree - 最大次数
    
    order - 最大阶数
    
    返回：
    
    包含已加载数据的重力场系数提供者
    
    另请参阅：
    
    GravityFields.getConstantUnnormalizedProvider(int, int, AbsoluteDate)
  - getOceanTidesWaves
```
public List<OceanTidesWave> getOceanTidesWaves(int degree,
                                               int order)
```
    获取海洋潮汐波。
    警告：截至2013-11-17，加载Sa波（Doodson数56.554）和P1波（Doodson数163.555）时存在不一致性。系数的符号不同。我们认为问题出在IERS的输入文件中，而不是转换中（对于所有其他波都有效），但无法确定。因此，海洋潮汐在此日期仍被视为实验性。
    
    如果没有通过调用OceanTidesReader添加过，或者之后调用了clearOceanTidesReaders，则将自动调用addDefaultOceanTidesReaders方法。
    
    指定者：
    
    getOceanTidesWaves 在接口 GravityFields
    
    参数：
    
    degree - 最大次数
    
    order - 最大阶数
    
    返回：
    
    包含已加载数据的潮汐波列表

Class LazyLoadedGravityFields

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

LazyLoadedGravityFields

Method Detail

addPotentialCoefficientsReader

addDefaultPotentialCoefficientsReaders

clearPotentialCoefficientsReaders

addOceanTidesReader

configureOceanLoadDeformationCoefficients

getOceanLoadDeformationCoefficients

addDefaultOceanTidesReaders

clearOceanTidesReaders

readGravityField

getConstantNormalizedProvider

getNormalizedProvider

getConstantUnnormalizedProvider

getUnnormalizedProvider

getOceanTidesWaves