org.orekit.propagation.analytical

Class FieldAbstractAnalyticalPropagator<T extends org.hipparchus.CalculusFieldElement<T>>

java.lang.Object

org.orekit.propagation.FieldAbstractPropagator<T>

org.orekit.propagation.analytical.FieldAbstractAnalyticalPropagator<T>

Type Parameters:

T - type of the field elements

All Implemented Interfaces:

FieldPropagator<T>, FieldPVCoordinatesProvider<T>, ParameterDriversProvider

Direct Known Subclasses:

FieldBrouwerLyddanePropagator, FieldEcksteinHechlerPropagator, FieldIntegratedEphemeris, FieldKeplerianPropagator, FieldTLEPropagator

public abstract class FieldAbstractAnalyticalPropagator<T extends org.hipparchus.CalculusFieldElement<T>>
extends FieldAbstractPropagator<T>
implements ParameterDriversProvider

用于解析器的FieldPropagator方法的常见处理。

这个抽象类允许轻松提供完整的FieldPropagator方法集，包括所有传播模式支持和任何简单传播方法的离散事件支持。派生类只需实现两个方法：propagateOrbit(FieldAbsoluteDate, CalculusFieldElement[])和getMass(FieldAbsoluteDate)。第一个方法应该从某个内部存储的初始状态开始直接传播，直到指定的目标日期。

Author:

Luc Maisonobe

Field Summary

Fields inherited from interface org.orekit.propagation.FieldPropagator

DEFAULT_MASS

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	FieldAbstractAnalyticalPropagator(org.hipparchus.Field<T> field, AttitudeProvider attitudeProvider) 构建一个新实例。

Method Summary

Modifier and Type	Method and Description
protected FieldSpacecraftState<T>	acceptStep(org.orekit.propagation.analytical.FieldAbstractAnalyticalPropagator.FieldBasicStepInterpolator interpolator, FieldAbsoluteDate<T> target) 接受一个步长，触发事件和步长处理程序。
<D extends FieldEventDetector<T>> void	addEventDetector(D detector) 添加一个事件探测器。
protected FieldSpacecraftState<T>	basicPropagate(FieldAbsoluteDate<T> date) 在没有任何花哨功能的情况下传播轨道。
void	clearEventsDetectors() 移除所有事件探测器。
FieldEphemerisGenerator<T>	getEphemerisGenerator() 设置一个星历生成器，它将监视传播过程，一旦完成就从中构建星历。
Collection<FieldEventDetector<T>>	getEventsDetectors() 获取已添加的所有事件探测器。
protected abstract T	getMass(FieldAbsoluteDate<T> date) 获取质量。
FieldPVCoordinatesProvider<T>	getPvProvider() 获取PV坐标提供程序。
FieldSpacecraftState<T>	propagate(FieldAbsoluteDate<T> start, FieldAbsoluteDate<T> target) 从开始日期向目标日期传播。
protected abstract FieldOrbit<T>	propagateOrbit(FieldAbsoluteDate<T> date, T[] parameters) 将轨道推算到特定的目标日期。
protected abstract void	resetIntermediateState(FieldSpacecraftState<T> state, boolean forward) 重置中间状态。

Methods inherited from class org.orekit.propagation.FieldAbstractPropagator

addAdditionalStateProvider, getAdditionalStateProviders, getAttitudeProvider, getField, getFrame, getInitialState, getManagedAdditionalStates, getMultiplexer, getPVCoordinates, getStartDate, initializeAdditionalStates, initializePropagation, isAdditionalStateManaged, propagate, resetInitialState, setAttitudeProvider, setStartDate, 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.utils.ParameterDriversProvider

getNbParametersDriversValue, getParameterDriver, getParameters, getParameters, getParameters, getParameters, getParametersAllValues, getParametersAllValues, getParametersDrivers, isSupported

Methods inherited from interface org.orekit.propagation.FieldPropagator

clearStepHandlers, setStepHandler, setStepHandler

Methods inherited from interface org.orekit.utils.FieldPVCoordinatesProvider

getPosition

Constructor Detail

FieldAbstractAnalyticalPropagator

protected FieldAbstractAnalyticalPropagator(org.hipparchus.Field<T> field,
                                            AttitudeProvider attitudeProvider)

构建一个新实例。

参数：

attitudeProvider - 姿态计算提供程序

field - 默认使用的字段

Method Detail

getEphemerisGenerator

public FieldEphemerisGenerator<T> getEphemerisGenerator()

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

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

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

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

   FieldEphemerisGenerator<T> generator = propagator.getEphemerisGenerator();
   propagator.propagate(target);
   FieldBoundedPropagator<T> ephemeris = generator.getGeneratedEphemeris();
 

指定者：

getEphemerisGenerator 在接口 FieldPropagator<T extends org.hipparchus.CalculusFieldElement<T>>

返回：

星历生成器

addEventDetector

public <D extends FieldEventDetector<T>> void addEventDetector(D detector)

添加一个事件探测器。

指定者：

addEventDetector 在接口 FieldPropagator<T extends org.hipparchus.CalculusFieldElement<T>>

类型参数：

D - 通用版本的类类型

参数：

detector - 要添加的事件探测器

另请参阅：

FieldPropagator.clearEventsDetectors(), FieldPropagator.getEventsDetectors()

getEventsDetectors

public Collection<FieldEventDetector<T>> getEventsDetectors()

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

指定者：

getEventsDetectors 在接口 FieldPropagator<T extends org.hipparchus.CalculusFieldElement<T>>

返回：

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

另请参阅：

FieldPropagator.addEventDetector(FieldEventDetector), FieldPropagator.clearEventsDetectors()

clearEventsDetectors

public void clearEventsDetectors()

移除所有事件探测器。

指定者：

clearEventsDetectors 在接口 FieldPropagator<T extends org.hipparchus.CalculusFieldElement<T>>

另请参阅：

FieldPropagator.addEventDetector(FieldEventDetector), FieldPropagator.getEventsDetectors()

propagate

public FieldSpacecraftState<T> propagate(FieldAbsoluteDate<T> start,
                                         FieldAbsoluteDate<T> target)

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

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

指定者：

propagate 在接口 FieldPropagator<T extends org.hipparchus.CalculusFieldElement<T>>

参数：

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

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

返回：

传播状态

acceptStep

protected FieldSpacecraftState<T> acceptStep(org.orekit.propagation.analytical.FieldAbstractAnalyticalPropagator.FieldBasicStepInterpolator interpolator,
                                             FieldAbsoluteDate<T> target)
                                      throws org.hipparchus.exception.MathRuntimeException

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

参数：

interpolator - 当前步长的插值器

target - 最终传播时间

返回：

步长结束时的状态

抛出：

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

getMass

protected abstract T getMass(FieldAbsoluteDate<T> date)

获取质量。

参数：

date - 轨道的目标日期

返回：

质量

getPvProvider

public FieldPVCoordinatesProvider<T> getPvProvider()

获取PV坐标提供程序。

返回：

PV坐标提供程序

resetIntermediateState

protected abstract void resetIntermediateState(FieldSpacecraftState<T> state,
                                               boolean forward)

重置中间状态。

参数：

state - 要考虑的新中间状态

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

propagateOrbit

protected abstract FieldOrbit<T> propagateOrbit(FieldAbsoluteDate<T> date,
                                                T[] parameters)

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

参数:

date - 轨道的目标日期

parameters - 模型参数

返回:

外推参数

basicPropagate

protected FieldSpacecraftState<T> basicPropagate(FieldAbsoluteDate<T> date)

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

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

参数:

date - 传播的目标日期

返回:

指定日期的状态