Propagator (OREKIT 12.0.1 API)

All Superinterfaces:

PVCoordinatesProvider

All Known Subinterfaces:

BoundedPropagator

All Known Implementing Classes:

AbstractAnalyticalPropagator, AbstractIntegratedPropagator, AbstractPropagator, AdapterPropagator, AggregateBoundedPropagator, BrouwerLyddanePropagator, DeepSDP4, DSSTPropagator, EcksteinHechlerPropagator, Ephemeris, GLONASSAnalyticalPropagator, GLONASSNumericalPropagator, GNSSPropagator, IntegratedEphemeris, KeplerianPropagator, NumericalPropagator, SBASPropagator, SGP4, TLEPropagator
```
public interface Propagator
extends PVCoordinatesProvider
```
此接口提供了在任何时间传播轨道的方法。
此接口是轨道传播的顶层抽象。它只允许传播到预定义日期。它由没有时间限制的解析模型实现，基于外部数据文件的轨道读取器，使用丰富力模型的数值积分器以及在数值积分完成并收集到密集输出数据后构建的连续模型实现。

请注意，一个单独的传播器不能从多个线程调用。它的配置可以更改，因为至少有一个resetInitialState(SpacecraftState)方法，即使不支持重置状态的传播器（例如TLEPropagator）在计算过程中也会缓存一些内部数据。但是，只要它们配置了独立的构建模块（主要是事件处理器和步长处理器，可能会保留一些内部状态），并且只从一个线程调用它们，它们就可以在多线程应用程序中使用。还可以使用PropagatorsParallelizer来同步运行多个传播器以并行运行。

Author:

Luc Maisonobe, Véronique Pommier-Maurussane

Field Summary

Fields
Modifier and Type	Field and Description
`static double`	`DEFAULT_MASS` 默认质量。

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`void`	`addAdditionalStateProvider(AdditionalStateProvider additionalStateProvider)` 添加一组用户指定的状态参数，以便与轨道传播一起计算。
`<T extends EventDetector> void`	`addEventDetector(T detector)` 添加事件探测器。
`void`	`clearEventsDetectors()` 移除所有事件探测器。
`default void`	`clearStepHandlers()` 移除所有步长处理器。
`List<AdditionalStateProvider>`	`getAdditionalStateProviders()` 获取用于附加状态的提供程序的不可修改列表。
`AttitudeProvider`	`getAttitudeProvider()` 获取姿态提供程序。
`static AttitudeProvider`	`getDefaultLaw(Frames frames)` 使用给定的参考系获取默认定律。
`EphemerisGenerator`	`getEphemerisGenerator()` 设置一个星历生成器，它将监视传播以从中构建星历。
`Collection<EventDetector>`	`getEventsDetectors()` 获取已添加的所有事件探测器。
`Frame`	`getFrame()` 获取传播轨道的参考系。
`SpacecraftState`	`getInitialState()` 获取传播器的初始状态。
`String[]`	`getManagedAdditionalStates()` 获取所有管理状态的名称。
`StepHandlerMultiplexer`	`getMultiplexer()` 获取保存所有步长处理器的复用器。
`boolean`	`isAdditionalStateManaged(String name)` 检查是否管理了附加状态。
`SpacecraftState`	`propagate(AbsoluteDate target)` 朝向目标日期传播。
`SpacecraftState`	`propagate(AbsoluteDate start, AbsoluteDate target)` 从起始日期朝向目标日期传播。
`void`	`resetInitialState(SpacecraftState state)` 重置传播器的初始状态。
`void`	`setAttitudeProvider(AttitudeProvider attitudeProvider)` 设置姿态提供程序。
`default void`	`setStepHandler(double h, OrekitFixedStepHandler handler)` 设置固定步长的单个处理器。
`default void`	`setStepHandler(OrekitStepHandler handler)` 设置可变步长的单个处理器。
`default MatricesHarvester`	`setupMatricesComputation(String stmName, org.hipparchus.linear.RealMatrix initialStm, DoubleArrayDictionary initialJacobianColumns)` 设置计算状态转移矩阵和相对于参数的雅可比矩阵。

Methods inherited from interface org.orekit.utils.PVCoordinatesProvider
getPosition, getPVCoordinates

- Field Detail
  - DEFAULT_MASS
```
static final double DEFAULT_MASS
```
    默认质量。
    
    另请参阅:
    
    常量字段值
- Method Detail
  - getDefaultLaw
```
static AttitudeProvider getDefaultLaw(Frames frames)
```
    使用给定的参考系获取默认定律。
    
    参数:
    
    frames - 要使用的参考系。
    
    返回:
    
    姿态定律。
  - getMultiplexer
```
StepHandlerMultiplexer getMultiplexer()
```
    获取保存所有步长处理器的复用器。
    
    返回:
    
    保存所有步长处理器的复用器
    
    自版本:
    
    11.0
  - clearStepHandlers
```
default void clearStepHandlers()
```
    移除所有步长处理器。
    此便利方法等同于调用getMultiplexer().clear()
    
    自版本:
    
    11.0
    
    另请参阅:
    
    getMultiplexer(), StepHandlerMultiplexer.clear()
  - setStepHandler
```
default void setStepHandler(double h,
                            OrekitFixedStepHandler handler)
```
    设置固定步长的单个处理器。
    此便利方法等同于调用getMultiplexer().clear()，然后调用getMultiplexer().add(h, handler)
    
    参数:
    
    h - 固定步长（秒）
    
    handler - 在每个完成的步骤结束时调用的处理器
    
    自版本:
    
    11.0
    
    另请参阅:
    
    getMultiplexer(), StepHandlerMultiplexer.add(double, OrekitFixedStepHandler)
  - setStepHandler
```
default void setStepHandler(OrekitStepHandler handler)
```
    设置可变步长的单个处理器。
    此便利方法等同于调用getMultiplexer().clear()，然后调用getMultiplexer().add(handler)
    
    参数:
    
    handler - 在每个完成的步骤结束时调用的处理器
    
    自版本:
    
    11.0
    
    另请参阅:
    
    getMultiplexer(), StepHandlerMultiplexer.add(OrekitStepHandler)
  - getEphemerisGenerator
```
EphemerisGenerator getEphemerisGenerator()
```
    设置一个星历生成器，它将监视传播以从中构建星历。
    当用户需要在初始时间和目标时间之间的任何时间快速随机访问轨道状态时，可以使用此生成器。一个典型的例子是实现搜索和迭代算法，这些算法可能在找到结果之前在传播范围内向前和向后导航，即使所使用的传播器是基于积分的并且只从一个初始时间到一个目标时间。
    
    请注意，当与基于积分的传播器一起使用时，生成器将存储所有中间结果。因此，在长时间积分范围和高精度/短时间步长的情况下，它会占用大量内存。当与解析传播器一起使用时，生成器仅存储开始/停止时间和对解析传播器本身的引用，以便在需要时调用它，因此它的内存占用较少。
    
    返回的星历生成器最初将为空，当随后调用propagate(target)或propagate(start, target)时，它将填充传播数据。因此，使用此方法的正确方式是：
```
   EphemerisGenerator generator = propagator.getEphemerisGenerator();
   propagator.propagate(target);
   BoundedPropagator ephemeris = generator.getGeneratedEphemeris();
 
```
    返回:
    
    星历生成器
  - getInitialState
```
SpacecraftState getInitialState()
```
    获取传播器的初始状态。
    
    返回:
    
    初始状态
  - resetInitialState
```
void resetInitialState(SpacecraftState state)
```
    重置传播器的初始状态。
    
    参数:
    
    state - 要考虑的新初始状态
  - addAdditionalStateProvider
```
void addAdditionalStateProvider(AdditionalStateProvider additionalStateProvider)
```
    添加一组用户指定的状态参数，以便与轨道传播一起计算。
    
    参数:
    
    additionalStateProvider - 附加状态的提供程序
  - getAdditionalStateProviders
```
List<AdditionalStateProvider> getAdditionalStateProviders()
```
    获取用于附加状态的提供程序的不可修改列表。
    
    返回:
    
    附加状态的提供程序
  - isAdditionalStateManaged
```
boolean isAdditionalStateManaged(String name)
```
    检查是否管理了附加状态。
    管理的状态是传播器知道如何计算其演变的状态。它们对应于通过调用addAdditionalStateProvider方法注册了一个provider的附加状态。
    
    出现在初始状态中但没有注册演变方法的附加状态不被视为管理状态。这些未管理的附加状态在传播过程中不会丢失。它们的值在状态重置时是分段恒定的，如果某个事件处理器resetState方法在事件发生时被调用并且恰好更改了未管理的附加状态，则它们的值会发生变化。
    
    参数:
    
    name - 附加状态的名称
    
    返回:
    
    如果附加状态被管理，则返回true
  - getManagedAdditionalStates
```
String[] getManagedAdditionalStates()
```
    获取所有管理状态的名称。
    
    返回:
    
    所有管理状态的名称
  - addEventDetector
```
<T extends EventDetector> void addEventDetector(T detector)
```
    添加事件探测器。
    
    类型参数:
    
    T - 通用版本的类类型
    
    参数:
    
    detector - 要添加的事件探测器
    
    另请参阅:
    
    clearEventsDetectors(), getEventsDetectors()
  - getEventsDetectors
```
Collection<EventDetector> getEventsDetectors()
```
    获取已添加的所有事件探测器。
    
    返回：
    
    已添加探测器的不可修改集合
    
    另请参阅：
    
    addEventDetector(EventDetector), clearEventsDetectors()
  - clearEventsDetectors
```
void clearEventsDetectors()
```
    移除所有事件探测器。
    
    另请参阅：
    
    addEventDetector(EventDetector), getEventsDetectors()
  - getAttitudeProvider
```
AttitudeProvider getAttitudeProvider()
```
    获取姿态提供器。
    
    返回：
    
    姿态提供器
  - setAttitudeProvider
```
void setAttitudeProvider(AttitudeProvider attitudeProvider)
```
    设置姿态提供器。
    
    参数：
    
    attitudeProvider - 姿态提供器
  - getFrame
```
Frame getFrame()
```
    获取轨道传播的参考系。
    传播参考系是初始状态的定义参考系，因此应在设置了此状态之后调用此方法，否则可能返回null。
    
    返回：
    
    轨道传播的参考系
    
    另请参阅：
    
    resetInitialState(SpacecraftState)
  - setupMatricesComputation
```
default MatricesHarvester setupMatricesComputation(String stmName,
                                                   org.hipparchus.linear.RealMatrix initialStm,
                                                   DoubleArrayDictionary initialJacobianColumns)
```
    设置状态转移矩阵和关于参数的雅可比矩阵的计算。
    如果调用了此方法，将自动计算状态转移矩阵和关于力模型参数的雅可比矩阵，这些参数将在传播开始时选择，并且收集器将允许检索它们。
    
    初始矩阵的参数必须与传播器将使用的轨道类型和位置角度相兼容。
    
    默认实现会抛出异常，因为不是所有传播器都支持此方法。
    
    参数：
    
    stmName - 状态转移矩阵状态名称
    
    initialStm - 初始状态转移矩阵 ∂Y/∂Y₀，如果为null（最常见情况），则假定为6x6单位矩阵
    
    initialJacobianColumns - 关于参数的雅可比矩阵的初始列，如果为null或者字典中缺少某些选择的参数，则相应的初始列假定为0
    
    返回：
    
    收集器，用于在传播期间和之后检索计算的矩阵
    
    自版本：
    
    11.1
  - propagate
```
SpacecraftState propagate(AbsoluteDate target)
```
    朝向目标日期传播。
    简单的传播器仅使用目标日期作为计算传播状态的规范。功能更丰富的传播器可以考虑其他信息，并提供不同的操作模式或G-stop功能以在特定事件发生时停止。在这些情况下，目标日期仅是一个提示，而不是强制性目标。
    
    参数：
    
    target - 应传播轨道状态的目标日期
    
    返回：
    
    传播状态
  - propagate
```
SpacecraftState propagate(AbsoluteDate start,
                          AbsoluteDate target)
```
    从起始日期朝向目标日期传播。
    这些传播器使用起始日期和目标日期来计算传播状态。对于使用事件检测机制的传播器，如果提供的起始日期与初始状态日期不同，则将执行第一次简单传播，而不处理任何事件计算。然后从起始日期到目标日期执行完整传播。
    
    参数：
    
    start - 应传播轨道状态的起始日期
    
    target - 应传播轨道状态的目标日期
    
    返回：
    
    传播状态

Interface Propagator

Field Summary

Method Summary

Methods inherited from interface org.orekit.utils.PVCoordinatesProvider

Field Detail

DEFAULT_MASS

Method Detail

getDefaultLaw

getMultiplexer

clearStepHandlers

setStepHandler

setStepHandler

getEphemerisGenerator

getInitialState

resetInitialState

addAdditionalStateProvider

getAdditionalStateProviders

isAdditionalStateManaged

getManagedAdditionalStates

addEventDetector

getEventsDetectors

clearEventsDetectors

getAttitudeProvider

setAttitudeProvider

getFrame

setupMatricesComputation

propagate

propagate