org.orekit.models.earth

Class GeoMagneticModelLoader

java.lang.Object

org.orekit.models.earth.GeoMagneticModelLoader

All Implemented Interfaces:

DataLoader

public class GeoMagneticModelLoader
extends Object
implements DataLoader

从给定的输入流加载地磁场模型。流可以包含多个模型，加载器按顺序读取所有可用模型。

预期模型文件的格式为：

• 由geomag软件使用的组合格式，可从IGRF模型网站获取；支持每个文件多个时期
• 由WMM模型网站使用的原始格式。

组合格式

     {模型名称} {时期} {nMax} {nMaxSec} {nMax3} {有效起始} {有效结束} {最小高度} {最大高度} {模型名称} {行号}
 {n} {m} {gnm} {hnm} {dgnm} {dhnm} {模型名称} {行号}
 

示例：

    WMM2010  2010.00 12 12  0 2010.00 2015.00   -1.0  600.0          WMM2010   0
 1  0  -29496.6       0.0      11.6       0.0                        WMM2010   1
 1  1   -1586.3    4944.4      16.5     -25.9                        WMM2010   2
 

原始WMM格式

    {时期} {模型名称} {有效起始}
 {n} {m} {gnm} {hnm} {dgnm} {dhnm}
 

示例：

    2015.0            WMM-2015        12/15/2014
  1  0  -29438.5       0.0       10.7        0.0
  1  1   -1501.1    4796.2       17.9      -26.8
 

Author:

Thomas Neidhart

Constructor Summary

Constructors

Constructor and Description
GeoMagneticModelLoader() 空构造函数。

Method Summary

Modifier and Type	Method and Description
Collection<GeoMagneticField>	getModels() 返回已成功加载的GeoMagneticField模型的Collection。
void	loadData(InputStream input, String name) 从流中加载数据。
boolean	stillAcceptsData() 检查加载器是否仍接受新数据。

Methods inherited from class java.lang.Object

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

Constructor Detail

GeoMagneticModelLoader

public GeoMagneticModelLoader()

空构造函数。

这个构造函数并非必需，但它可以防止在JDK 18及更高版本中出现虚假的javadoc警告。

自版本:

12.0

Method Detail

getModels

public Collection<GeoMagneticField> getModels()

返回已成功加载的GeoMagneticField模型的Collection。该Collection按插入顺序排列，因此可能不按模型时期顺序排序。

返回:

返回已成功加载的GeoMagneticField模型的Collection

stillAcceptsData

public boolean stillAcceptsData()

检查加载器是否仍接受新数据。

此方法用于通过尽快中断数据集的爬取来加快数据加载速度，一旦加载器找到等待的数据，就会中断。对于可以从任意数量的来源合并数据的加载器（例如JPL星历或分布在多个文件中的地球定位参数），此方法应始终返回true，以确保没有数据遗留。

由以下指定:

stillAcceptsData 在接口 DataLoader

返回:

当加载器仍接受新数据时返回true

loadData

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

从流中加载数据。

由以下指定:

loadData 在接口 DataLoader

参数:

input - 数据输入流

name - 文件名（或zip条目）

抛出:

IOException - 如果无法读取数据

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