org.orekit.files.sp3

Class SP3Segment

java.lang.Object

org.orekit.files.sp3.SP3Segment

All Implemented Interfaces:

EphemerisFile.EphemerisSegment<SP3Coordinate>

public class SP3Segment
extends Object
implements EphemerisFile.EphemerisSegment<SP3Coordinate>

一个 SP3Ephemeris 的片段。

Since:

12.0

Author:

Thomas Neidhart, Evan Ward, Luc Maisonobe

Constructor Summary

Constructors

Constructor and Description
SP3Segment(double mu, Frame frame, int interpolationSamples, CartesianDerivativesFilter filter) 简单构造函数。

Method Summary

Modifier and Type	Method and Description
void	addCoordinate(SP3Coordinate coord) 添加一个新的P/V坐标。
CartesianDerivativesFilter	getAvailableDerivatives() 获取此星历片段中可用的位置导数。
List<SP3Coordinate>	getCoordinates() 获取 EphemerisFile.EphemerisSegment.getFrame() 中此星历片段的坐标。
Frame	getFrame() 获取此星历片段的参考坐标系。
int	getInterpolationSamples() 获取插值中要使用的样本数。
double	getMu() 获取卫星的标准引力参数。
BoundedPropagator	getPropagator() 将此星历片段视为一个传播器。
BoundedPropagator	getPropagator(AttitudeProvider attitudeProvider) 将此星历片段视为一个传播器。
AbsoluteDate	getStart() 获取此星历片段的开始日期。
AbsoluteDate	getStop() 获取此星历片段的结束日期。

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.orekit.files.general.EphemerisFile.EphemerisSegment

getInertialFrame

Constructor Detail

SP3Segment

public SP3Segment(double mu,
                  Frame frame,
                  int interpolationSamples,
                  CartesianDerivativesFilter filter)

简单构造函数。

参数：

mu - 用于从星历数据创建 Orbits 的标准引力参数。

frame - 参考坐标系

interpolationSamples - 用于插值的点数

filter - 可用的导数

Method Detail

getMu

public double getMu()

获取卫星的标准引力参数。

由以下指定：

getMu 在接口 EphemerisFile.EphemerisSegment<SP3Coordinate>

返回：

在 EphemerisFile.EphemerisSegment.getPropagator(AttitudeProvider) 中使用的引力参数，单位为m³/s²。

getStart

public AbsoluteDate getStart()

获取此星历片段的开始日期。

此方法返回的日期等同于 getPropagator().getMinDate()。

由以下指定：

getStart 在接口 EphemerisFile.EphemerisSegment<SP3Coordinate>

返回：

星历片段的开始日期。

getStop

public AbsoluteDate getStop()

获取此星历片段的结束日期。

此方法返回的日期等同于 getPropagator().getMaxDate()。

由以下指定：

getStop 在接口 EphemerisFile.EphemerisSegment<SP3Coordinate>

返回：

星历片段的结束日期。

getFrame

public Frame getFrame()

获取此星历片段的参考坐标系。定义 EphemerisFile.EphemerisSegment.getCoordinates() 的坐标系。

由以下指定：

getFrame 在接口 EphemerisFile.EphemerisSegment<SP3Coordinate>

返回：

此片段的参考坐标系。永不为 null。

getInterpolationSamples

public int getInterpolationSamples()

获取插值中要使用的样本数。

由以下指定：

getInterpolationSamples 在接口 EphemerisFile.EphemerisSegment<SP3Coordinate>

返回：

用于插值的点数。

getAvailableDerivatives

public CartesianDerivativesFilter getAvailableDerivatives()

获取此星历片段中可用的位置导数。

虽然 EphemerisFile.EphemerisSegment.getCoordinates() 总是返回位置、速度和加速度，但此方法的返回值指示星历文件中包含哪些导数，并且实际上是有效的。

由以下指定：

getAvailableDerivatives 在接口 EphemerisFile.EphemerisSegment<SP3Coordinate>

返回：

一个值，指示文件是否包含速度和/或加速度数据。

getCoordinates

public List<SP3Coordinate> getCoordinates()

获取 EphemerisFile.EphemerisSegment.getFrame() 中此星历片段的坐标。

由以下指定：

getCoordinates 在接口 EphemerisFile.EphemerisSegment<SP3Coordinate>

返回：

按时间顺序排列的状态向量列表。这些坐标的时间间隔不一定是均匀的。 EphemerisFile.EphemerisSegment.getAvailableDerivatives() 的值指示文件中是否指定了速度或加速度。在返回值中，任何未在星历文件中指定的位置、速度或加速度坐标都为零。

addCoordinate

public void addCoordinate(SP3Coordinate coord)

添加一个新的P/V坐标。

参数：

coord - 卫星的P/V坐标

getPropagator

public BoundedPropagator getPropagator()

将此星历片段视为一个传播器。

要将此卫星的星历视为 Propagator，必须满足几个条件。必须能够从星历文件中的坐标系规范构造一个 Orekit Frame。当 EphemerisFile.EphemerisSegment.getFrame() 正常返回时，满足此条件。此外，EphemerisFile.EphemerisSegment.getMu() 必须返回一个有效值。如果不满足这些条件，此方法或返回的 Propagator 的方法可能会抛出一个 OrekitException。

使用的 attitude provider 是与 惯性坐标系 对齐的 FrameAlignedProvider

每次调用此方法都会创建一个新的传播器。

由以下指定：

getPropagator 在接口 EphemerisFile.EphemerisSegment<SP3Coordinate>

返回：

此星历片段的传播器。

getPropagator

public BoundedPropagator getPropagator(AttitudeProvider attitudeProvider)

将此星历段视为一个传播器。

为了将此卫星的星历视为一个传播器，必须满足几个条件。Orekit必须能够从星历文件中的参考系规范构造一个参考系。当EphemerisFile.EphemerisSegment.getFrame()正常返回时，满足此条件。此外，EphemerisFile.EphemerisSegment.getMu()必须返回一个有效值。如果这些条件不满足，此方法或返回的传播器的方法之一可能会抛出一个OrekitException。

每次调用此方法都会创建一个新的传播器。

指定者：

getPropagator 在接口 EphemerisFile.EphemerisSegment<SP3Coordinate>

参数：

attitudeProvider - 姿态计算提供者

返回：

此星历段的传播器。