org.orekit.propagation.analytical

Class AbstractAnalyticalPropagator

java.lang.Object

org.orekit.propagation.AbstractPropagator

org.orekit.propagation.analytical.AbstractAnalyticalPropagator

All Implemented Interfaces:

Propagator, PVCoordinatesProvider

Direct Known Subclasses:

AdapterPropagator, AggregateBoundedPropagator, BrouwerLyddanePropagator, EcksteinHechlerPropagator, Ephemeris, GLONASSAnalyticalPropagator, GNSSPropagator, IntegratedEphemeris, KeplerianPropagator, SBASPropagator, TLEPropagator

public abstract class AbstractAnalyticalPropagator
extends AbstractPropagator

用于解析器的通用处理方法。这个抽象类可以轻松地提供完整的解析器方法集，包括所有传播模式支持和任何简单传播方法的离散事件支持。派生类只需实现两个方法：propagateOrbit(AbsoluteDate)和getMass(AbsoluteDate)。第一个方法应该从内部存储的初始状态开始直接传播，直到指定的目标日期。

Author:

Luc Maisonobe

Field Summary

Fields inherited from interface org.orekit.propagation.Propagator

DEFAULT_MASS

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractAnalyticalPropagator(AttitudeProvider attitudeProvider) 构建一个新实例。

Method Summary

Modifier and Type	Method and Description
protected SpacecraftState	acceptStep(OrekitStepInterpolator interpolator, AbsoluteDate target) 接受一个步长，触发事件和步长处理器。
<T extends EventDetector> void	addEventDetector(T detector) 添加一个事件探测器。
protected SpacecraftState	basicPropagate(AbsoluteDate date) 在没有任何高级功能的情况下传播轨道。
void	clearEventsDetectors() 移除所有事件探测器。
EphemerisGenerator	getEphemerisGenerator() 设置一个星历生成器，它将监视传播过程，一旦完成就会从中构建星历。
Collection<EventDetector>	getEventsDetectors() 获取所有已添加的事件探测器。
protected List<String>	getJacobiansColumnsNames() 获取由MatricesHarvester.getParametersJacobian(org.orekit.propagation.SpacecraftState)返回的矩阵中参数的名称。
protected abstract double	getMass(AbsoluteDate date) 获取质量。
PVCoordinatesProvider	getPvProvider() 获取PV坐标提供程序。
SpacecraftState	propagate(AbsoluteDate start, AbsoluteDate target) 从开始日期向目标日期传播。
protected abstract Orbit	propagateOrbit(AbsoluteDate date) 将轨道推算到特定的目标日期。
protected abstract void	resetIntermediateState(SpacecraftState state, boolean forward) 重置中间状态。

Methods inherited from class org.orekit.propagation.AbstractPropagator

addAdditionalStateProvider, createHarvester, getAdditionalStateProviders, getAttitudeProvider, getFrame, getHarvester, getInitialState, getManagedAdditionalStates, getMultiplexer, getPVCoordinates, getStartDate, initializeAdditionalStates, initializePropagation, isAdditionalStateManaged, propagate, resetInitialState, setAttitudeProvider, setStartDate, setupMatricesComputation, stateChanged, updateAdditionalStates, updateUnmanagedStates

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.orekit.propagation.Propagator

clearStepHandlers, getDefaultLaw, setStepHandler, setStepHandler

Methods inherited from interface org.orekit.utils.PVCoordinatesProvider

getPosition

Constructor Detail

AbstractAnalyticalPropagator

protected AbstractAnalyticalPropagator(AttitudeProvider attitudeProvider)

构建一个新实例。

参数：

attitudeProvider - 姿态计算提供程序

Method Detail

getEphemerisGenerator

public EphemerisGenerator getEphemerisGenerator()

设置一个星历生成器，它将监视传播过程，一旦完成就会从中构建星历。

当用户需要在初始时间和目标时间之间的任何时间快速随机访问轨道状态时，可以使用此生成器。一个典型的例子是实现搜索和迭代算法，这些算法可能在找到结果之前在传播范围内向前和向后导航，即使所使用的传播器是基于积分的，只能从一个初始时间到一个目标时间。

请注意，当与基于积分的传播器一起使用时，生成器将存储所有中间结果。因此，在长积分范围和高精度/短时间步长的情况下，它会占用大量内存。当与解析器一起使用时，生成器只存储开始/停止时间和对解析器本身的引用，以便根据需要调用它，因此它的内存占用较少。

返回的星历生成器最初将是空的，在随后调用propagate(target)或propagate(start, target)之一时，它将填充传播数据。因此，使用此方法的正确方式是：

   EphemerisGenerator generator = propagator.getEphemerisGenerator();
   propagator.propagate(target);
   BoundedPropagator ephemeris = generator.getGeneratedEphemeris();
 

返回：

星历生成器

addEventDetector

public <T extends EventDetector> void addEventDetector(T detector)

添加一个事件探测器。

类型参数：

T - 通用版本的类类型

参数：

detector - 要添加的事件探测器

另请参阅：

Propagator.clearEventsDetectors(), Propagator.getEventsDetectors()

getEventsDetectors

public Collection<EventDetector> getEventsDetectors()

获取所有已添加的事件探测器。

返回：

已添加探测器的不可修改集合

另请参阅：

Propagator.addEventDetector(EventDetector), Propagator.clearEventsDetectors()

clearEventsDetectors

public void clearEventsDetectors()

移除所有事件探测器。

另请参阅：

Propagator.addEventDetector(EventDetector), Propagator.getEventsDetectors()

propagate

public SpacecraftState propagate(AbsoluteDate start,
                                 AbsoluteDate target)

从开始日期向目标日期传播。

这些传播器使用开始日期和目标日期来计算传播状态。对于使用事件检测机制的传播器，如果提供的开始日期与初始状态日期不同，则会执行第一次简单传播，而不处理任何事件计算。然后从开始日期到目标日期执行完整传播。

参数：

start - 应传播轨道状态的开始日期

target - 应传播轨道状态的目标日期

返回：

传播状态

acceptStep

protected SpacecraftState acceptStep(OrekitStepInterpolator interpolator,
                                     AbsoluteDate target)
                              throws org.hipparchus.exception.MathRuntimeException

接受一个步长，触发事件和步长处理器。

参数：

interpolator - 当前步长的插值器

target - 最终传播时间

返回：

步长结束时的状态

抛出：

org.hipparchus.exception.MathRuntimeException - 如果无法定位事件

getMass

protected abstract double getMass(AbsoluteDate date)

获取质量。

参数：

date - 轨道的目标日期

返回：

质量

getPvProvider

public PVCoordinatesProvider getPvProvider()

获取PV坐标提供程序。

返回：

PV坐标提供程序

resetIntermediateState

protected abstract void resetIntermediateState(SpacecraftState state,
                                               boolean forward)

重置中间状态。

参数：

state - 要考虑的新中间状态

forward - 如果为true，则中间状态对其后的传播是有效的

propagateOrbit

protected abstract Orbit propagateOrbit(AbsoluteDate date)

推算轨道直到特定的目标日期。

参数：

date - 轨道的目标日期

返回：

推算的参数

basicPropagate

protected SpacecraftState basicPropagate(AbsoluteDate date)

在没有任何高级功能的情况下传播轨道。

这个方法在精神上类似于propagate(org.orekit.time.AbsoluteDate, org.orekit.time.AbsoluteDate)方法，只是它在传播过程中不调用任何处理程序，也不处理任何离散事件，也不处理任何额外状态。它总是在指定的日期停止。

参数：

date - 传播的目标日期

返回：

指定日期的状态

getJacobiansColumnsNames

protected List<String> getJacobiansColumnsNames()

获取由MatricesHarvester.getParametersJacobian(org.orekit.propagation.SpacecraftState)返回的矩阵中参数的名称。

返回：

Jacobian矩阵中参数（即列）的名称

自版本：

11.1