org.orekit.files.sp3

Class SP3

java.lang.Object

org.orekit.files.sp3.SP3

All Implemented Interfaces:

EphemerisFile<SP3Coordinate,SP3Segment>

public class SP3
extends Object
implements EphemerisFile<SP3Coordinate,SP3Segment>

表示已解析的SP3轨道文件。

Author:

Thomas Neidhart, Evan Ward

Nested Class Summary

Nested classes/interfaces inherited from interface org.orekit.files.general.EphemerisFile

EphemerisFile.EphemerisSegment<C extends TimeStampedPVCoordinates>, EphemerisFile.SatelliteEphemeris<C extends TimeStampedPVCoordinates,S extends EphemerisFile.EphemerisSegment<C>>

Constructor Summary

Constructors

Constructor and Description
SP3(double mu, int interpolationSamples, Frame frame) 创建一个新的SP3文件对象。

Method Summary

Modifier and Type	Method and Description
void	addSatellite(String satId) 将具有给定标识符的新卫星添加到存储卫星列表中。
boolean	containsSatellite(String satId) 测试具有给定id的卫星是否包含在此轨道文件中。
SP3Ephemeris	getEphemeris(int index) 获取星历。
SP3Ephemeris	getEphemeris(String satId) 获取星历。
SP3Header	getHeader() 获取头部信息。
int	getSatelliteCount() 获取此轨道文件中包含的卫星数量。
Map<String,SP3Ephemeris>	getSatellites() 获取文件中每颗卫星的加载星历。
static SP3	splice(Collection<SP3> sp3) 将几个SP3文件拼接在一起。
void	validate(boolean parsing, String fileName) 检查文件是否有效。

Methods inherited from class java.lang.Object

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

Constructor Detail

SP3

public SP3(double mu,
           int interpolationSamples,
           Frame frame)

创建一个新的SP3文件对象。

参数：

mu - 单位为m³/s²的标准引力参数。

interpolationSamples - 插值中使用的样本数。

frame - 参考坐标系

Method Detail

validate

public void validate(boolean parsing,
                     String fileName)
              throws OrekitException

检查文件是否有效。

参数：

parsing - 如果为true，则表示正在解析现有文件，并且更宽松以接受一些常见错误（例如在SP3a、SP3b或SP3c文件中有86到99颗卫星之间的情况）

fileName - 生成错误消息的文件名

抛出：

OrekitException - 如果文件无效

getHeader

public SP3Header getHeader()

获取头部信息。

返回：

头部信息

自版本：

12.0

splice

public static SP3 splice(Collection<SP3> sp3)

将几个SP3文件拼接在一起。

拼接SP3文件用于在需要覆盖多个文件的连续计算时使用。这些文件应该具有完全相同的元数据：类型、时间系统、坐标系，除了卫星精度可能在不同文件之间有所不同，某些文件中可能缺少一些卫星... 一旦排序（在内部完成），如果两个文件段之间的间隙最多为时代间隔，则将这些段合并为一个段，否则保持段分开。

拼接文件仅包含所有文件中都存在的卫星。在某些文件中存在但在其他文件中不存在的卫星将被静默丢弃。

根据生产者的不同，连续的SP3文件之间可能在一个文件的最后条目和下一个文件的第一个条目之间存在间隙（例如，具有5分钟时代间隔的文件可能在23:55结束，下一个文件在00:00开始），或者两个文件在拼接日期正好有一个点（即前一个文件的最后一个点被丢弃，后一个文件的第一个点优先），因此拼接文件中仅保留一个点；这种设计选择是为了强制连续和正则插值。

参数：

sp3 - 要合并的SP3文件

返回：

合并后的SP3

自版本：

12.0

addSatellite

public void addSatellite(String satId)

将具有给定标识符的新卫星添加到存储卫星列表中。

参数：

satId - 卫星标识符

getSatellites

public Map<String,SP3Ephemeris> getSatellites()

从接口中复制的描述： EphemerisFile

获取文件中每颗卫星的加载星历。

指定者：

getSatellites 在接口 EphemerisFile<SP3Coordinate,SP3Segment>

返回：

从卫星的ID到文件中包含的有关该卫星的信息的映射。

getEphemeris

public SP3Ephemeris getEphemeris(int index)

获取星历。

参数：

index - 卫星的索引

返回：

卫星星历

自版本：

12.0

getEphemeris

public SP3Ephemeris getEphemeris(String satId)

获取星历。

参数：

satId - 卫星标识符

返回：

卫星星历，如果未找到则返回null

自版本：

12.0

getSatelliteCount

public int getSatelliteCount()

获取此轨道文件中包含的卫星数量。

返回：

卫星数量

containsSatellite

public boolean containsSatellite(String satId)

测试具有给定id的卫星是否包含在此轨道文件中。

参数：

satId - 卫星id

返回：

如果卫星包含在文件中，则返回true，否则返回false