org.orekit.forces.gravity.potential

Class ICGEMFormatReader

java.lang.Object

org.orekit.forces.gravity.potential.PotentialCoefficientsReader

org.orekit.forces.gravity.potential.ICGEMFormatReader

All Implemented Interfaces:

DataLoader

public class ICGEMFormatReader
extends PotentialCoefficientsReader

ICGEM重力场格式的读取器。

该格式用于描述自2004年以来由GFZ波茨坦发布的EIGEN模型的重力场。它在Franz Barthelmes和Christoph Förste的论文中有描述：“ICGEM格式”。该论文的2006-02-28版本可以在这里找到，该论文的2011-06-07版本可以在这里找到。这些版本在时间相关系数上有所不同，2011年之前（直到eigen-5模型）仅为线性，之后（从eigen-6模型开始）还具有谐波效应。文件格式的第三个版本（截至2018-05-14尚未记录）还添加了时间相关系数的时间跨度，允许分段模型。该类支持这三个版本。

此读取器对重力常数键进行了宽松检查，因此接受以gravity_constant结尾的任何键，而不仅仅是在先前文档中指定的earth_gravity_constant。这允许读取ICGEM - 其他天体的重力场模型页面中发现的非地球重力场。

使用此类的正确方法是调用GravityFieldFactory，它将确定要使用的读取器以及所选重力场文件。

Author:

Luc Maisonobe

See Also:

GravityFields

Constructor Summary

Constructors

Constructor and Description
ICGEMFormatReader(String supportedNames, boolean missingCoefficientsAllowed) 简单构造函数。
ICGEMFormatReader(String supportedNames, boolean missingCoefficientsAllowed, TimeScale timeScale) 简单构造函数。

Method Summary

Modifier and Type	Method and Description
RawSphericalHarmonicsProvider	getProvider(boolean wantNormalized, int degree, int order) 获取用于读取球谐系数的提供程序。
void	loadData(InputStream input, String name) 从流中加载数据。

Methods inherited from class org.orekit.forces.gravity.potential.PotentialCoefficientsReader

buildFlatArray, buildRow, getAe, getBaseProvider, getMaxAvailableDegree, getMaxAvailableOrder, getMaxParseDegree, getMaxParseOrder, getMu, getSupportedNames, getTideSystem, missingCoefficientsAllowed, parseCoefficient, parseDouble, rescale, rescale, setAe, setMaxParseDegree, setMaxParseOrder, setMu, setRawCoefficients, setReadComplete, setTideSystem, stillAcceptsData, toDate, toDate

Methods inherited from class java.lang.Object

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

Constructor Detail

ICGEMFormatReader

@DefaultDataContext
public ICGEMFormatReader(String supportedNames,
                                             boolean missingCoefficientsAllowed)

简单构造函数。

此构造函数使用默认数据上下文。

参数：

supportedNames - 支持的文件名的正则表达式

missingCoefficientsAllowed - 如果为true，则允许输入数据中缺少系数

另请参见：

ICGEMFormatReader(String, boolean, TimeScale)

ICGEMFormatReader

public ICGEMFormatReader(String supportedNames,
                         boolean missingCoefficientsAllowed,
                         TimeScale timeScale)

简单构造函数。

参数：

supportedNames - 支持的文件名的正则表达式

missingCoefficientsAllowed - 如果为true，则允许输入数据中缺少系数

timeScale - 在解析日期时使用的时间标度

自：

10.1

Method Detail

loadData

public void loadData(InputStream input,
                     String name)
              throws IOException,
                     ParseException,
                     OrekitException

从流中加载数据。

由以下指定：

loadData 在接口 DataLoader

由以下指定：

loadData 在类 PotentialCoefficientsReader

参数：

input - 数据输入流

name - 文件的名称（或zip条目）

抛出：

IOException - 如果无法读取数据

ParseException - 如果无法解析数据或发生某些特定于加载程序的错误

OrekitException

getProvider

public RawSphericalHarmonicsProvider getProvider(boolean wantNormalized,
                                                 int degree,
                                                 int order)

获取用于读取球谐系数的提供程序。

由以下指定：

getProvider 在类 PotentialCoefficientsReader

参数：

wantNormalized - 如果为true，则提供程序将提供归一化系数，否则将提供未归一化系数

degree - 最大次数

order - 最大阶数

返回：

一个新的提供程序