AbstractPropagator (OREKIT 12.0.1 API)

java.lang.Object
- org.orekit.propagation.AbstractPropagator

All Implemented Interfaces:

Propagator, PVCoordinatesProvider

Direct Known Subclasses:

AbstractAnalyticalPropagator, AbstractIntegratedPropagator
```
public abstract class AbstractPropagator
extends Object
implements Propagator
```
用于解析器的通用处理Propagator方法。
这个抽象类允许轻松地提供完整的一组Propagator方法，包括对任何简单传播方法的所有传播模式支持和离散事件支持。

Author:

Luc Maisonobe

Field Summary
- Fields inherited from interface org.orekit.propagation.Propagator
  DEFAULT_MASS

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`AbstractPropagator()` 构建一个新实例。

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addAdditionalStateProvider(AdditionalStateProvider provider)` 添加一组用户指定的状态参数，以便与轨道传播一起计算。
`protected AbstractMatricesHarvester`	`createHarvester(String stmName, org.hipparchus.linear.RealMatrix initialStm, DoubleArrayDictionary initialJacobianColumns)` 创建适用于解算器的收割机。
`List<AdditionalStateProvider>`	`getAdditionalStateProviders()` 获取用于附加状态的不可修改的提供程序列表。
`AttitudeProvider`	`getAttitudeProvider()` 获取姿态提供程序。
`Frame`	`getFrame()` 获取在其中传播轨道的参考系。
`protected AbstractMatricesHarvester`	`getHarvester()` 获取收割机。
`SpacecraftState`	`getInitialState()` 获取传播器的初始状态。
`String[]`	`getManagedAdditionalStates()` 获取所有受管状态的名称。
`StepHandlerMultiplexer`	`getMultiplexer()` 获取持有所有步骤处理程序的复用器。
`TimeStampedPVCoordinates`	`getPVCoordinates(AbsoluteDate date, Frame frame)` 获取所选参考系中的物体的`PVCoordinates`。
`protected AbsoluteDate`	`getStartDate()` 获取开始日期。
`protected void`	`initializeAdditionalStates(AbsoluteDate target)` 在传播开始时初始化附加状态提供程序。
`protected void`	`initializePropagation()` 初始化传播。
`boolean`	`isAdditionalStateManaged(String name)` 检查是否管理附加状态。
`SpacecraftState`	`propagate(AbsoluteDate target)` 朝着目标日期传播。
`void`	`resetInitialState(SpacecraftState state)` 重置传播器的初始状态。
`void`	`setAttitudeProvider(AttitudeProvider attitudeProvider)` 设置姿态提供程序。
`protected void`	`setStartDate(AbsoluteDate startDate)` 设置开始日期。
`MatricesHarvester`	`setupMatricesComputation(String stmName, org.hipparchus.linear.RealMatrix initialStm, DoubleArrayDictionary initialJacobianColumns)` 设置计算状态转移矩阵和关于参数的雅可比矩阵。
`protected void`	`stateChanged(SpacecraftState state)` 通知状态变化。
`protected SpacecraftState`	`updateAdditionalStates(SpacecraftState original)` 通过添加所有附加状态更新状态。
`protected SpacecraftState`	`updateUnmanagedStates(SpacecraftState original)` 通过添加未受管状态更新状态。

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
addEventDetector, clearEventsDetectors, clearStepHandlers, getDefaultLaw, getEphemerisGenerator, getEventsDetectors, propagate, setStepHandler, setStepHandler

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

- Constructor Detail
  - AbstractPropagator
```
protected AbstractPropagator()
```
    构建一个新实例。
- Method Detail
  - setStartDate
```
protected void setStartDate(AbsoluteDate startDate)
```
    设置开始日期。
    
    参数：
    
    startDate - 开始日期
  - getStartDate
```
protected AbsoluteDate getStartDate()
```
    获取开始日期。
    
    返回：
    
    开始日期
  - getAttitudeProvider
```
public AttitudeProvider getAttitudeProvider()
```
    获取姿态提供程序。
    
    指定者：
    
    getAttitudeProvider 在接口 Propagator
    
    返回：
    
    姿态提供程序
  - setAttitudeProvider
```
public void setAttitudeProvider(AttitudeProvider attitudeProvider)
```
    设置姿态提供程序。
    
    指定者：
    
    setAttitudeProvider 在接口 Propagator
    
    参数：
    
    attitudeProvider - 姿态提供程序
  - getInitialState
```
public SpacecraftState getInitialState()
```
    获取传播器的初始状态。
    
    指定者：
    
    getInitialState 在接口 Propagator
    
    返回：
    
    初始状态
  - getFrame
```
public Frame getFrame()
```
    获取在其中传播轨道的参考系。
    传播参考系是初始状态的定义参考系，因此应在设置此状态后调用此方法，否则可能返回null。
    
    指定者：
    
    getFrame 在接口 Propagator
    
    返回：
    
    传播轨道的参考系
    
    另请参阅：
    
    Propagator.resetInitialState(SpacecraftState)
  - resetInitialState
```
public void resetInitialState(SpacecraftState state)
```
    重置传播器的初始状态。
    
    指定者：
    
    resetInitialState 在接口 Propagator
    
    参数：
    
    state - 要考虑的新初始状态
  - getMultiplexer
```
public StepHandlerMultiplexer getMultiplexer()
```
    获取持有所有步骤处理程序的复用器。
    
    指定者：
    
    getMultiplexer 在接口 Propagator
    
    返回：
    
    持有所有步骤处理程序的复用器
  - addAdditionalStateProvider
```
public void addAdditionalStateProvider(AdditionalStateProvider provider)
```
    添加一组用户指定的状态参数，以便与轨道传播一起计算。
    
    指定者：
    
    addAdditionalStateProvider 在接口 Propagator
    
    参数：
    
    provider - 附加状态的提供程序
  - getAdditionalStateProviders
```
public List<AdditionalStateProvider> getAdditionalStateProviders()
```
    获取用于附加状态的不可修改的提供程序列表。
    
    指定者：
    
    getAdditionalStateProviders 在接口 Propagator
    
    返回：
    
    附加状态的提供程序
  - setupMatricesComputation
```
public MatricesHarvester setupMatricesComputation(String stmName,
                                                  org.hipparchus.linear.RealMatrix initialStm,
                                                  DoubleArrayDictionary initialJacobianColumns)
```
    设置计算状态转移矩阵和关于参数的雅可比矩阵。
    如果调用此方法，将自动计算传播开始时将选择的状态转移矩阵和关于力模型参数的雅可比矩阵，并且收割机将允许检索它们。
    
    初始矩阵的参数必须与传播器将使用的轨道类型和位置角兼容。
    
    默认实现会抛出异常，因为不是所有传播器都支持该方法。
    
    指定者：
    
    setupMatricesComputation 在接口 Propagator
    
    参数：
    
    stmName - 状态转移矩阵状态名称
    
    initialStm - 初始状态转移矩阵 ∂Y/∂Y₀，如果为null（这是最常见的情况），则假定为6x6单位矩阵
    
    initialJacobianColumns - 关于参数的雅可比矩阵的初始列，如果为null或如果字典中缺少一些选择的参数，则假定相应的初始列为0
    
    返回：
    
    收割机，在传播期间和之后检索计算的矩阵
  - createHarvester
```
protected AbstractMatricesHarvester createHarvester(String stmName,
                                                    org.hipparchus.linear.RealMatrix initialStm,
                                                    DoubleArrayDictionary initialJacobianColumns)
```
    创建适用于解算器的收割机。
    
    参数：
    
    stmName - 状态转移矩阵状态名称
    
    initialStm - 初始状态转移矩阵 ∂Y/∂Y₀，如果为null（这是最常见的情况），则假定为6x6单位矩阵
    
    initialJacobianColumns - 关于参数的雅可比矩阵的初始列，如果为null或如果字典中缺少一些选择的参数，则假定相应的初始列为0
    
    返回：
    
    收割机，在传播期间和之后检索计算的矩阵
    
    自版本：
    
    11.1
  - getHarvester
```
protected AbstractMatricesHarvester getHarvester()
```
    获取收割机。
    
    返回：
    
    收割机，如果未创建则为null
    
    自版本：
    
    11.1
  - updateUnmanagedStates
```
protected SpacecraftState updateUnmanagedStates(SpacecraftState original)
```
    通过添加未受管状态更新状态。
    
    参数：
    
    original - 原始状态
    
    返回：
    
    更新的状态，包括未受管状态
    
    另请参阅：
    
    updateAdditionalStates(SpacecraftState)
  - updateAdditionalStates
```
protected SpacecraftState updateAdditionalStates(SpacecraftState original)
```
    通过添加所有附加状态更新状态。
    
    参数:
    
    original - 原始状态
    
    返回:
    
    更新后的状态，包括所有附加状态（包括未管理状态）
    
    另请参阅:
    
    addAdditionalStateProvider(AdditionalStateProvider), updateUnmanagedStates(SpacecraftState)
  - initializeAdditionalStates
```
protected void initializeAdditionalStates(AbsoluteDate target)
```
    在传播开始时初始化附加状态提供程序。
    
    参数:
    
    target - 传播的日期。不等于initialState.getDate()。
    
    自从:
    
    11.2
  - isAdditionalStateManaged
```
public boolean isAdditionalStateManaged(String name)
```
    检查附加状态是否已管理。
    已管理的状态是传播器知道如何计算其演变的状态。它们对应于通过调用addAdditionalStateProvider方法注册了一个提供程序的附加状态。
    
    在初始状态中存在但未注册演变方法的附加状态不被视为已管理状态。这些未管理的附加状态在传播过程中不会丢失。它们的值在状态重置之间是分段恒定的，如果某个事件处理程序resetState方法在事件发生时被调用并且恰好更改了未管理的附加状态，则它们可能会发生变化。
    
    由以下指定:
    
    isAdditionalStateManaged 在接口 Propagator
    
    参数:
    
    name - 附加状态的名称
    
    返回:
    
    如果附加状态已管理，则返回true
  - getManagedAdditionalStates
```
public String[] getManagedAdditionalStates()
```
    获取所有已管理状态的名称。
    
    由以下指定:
    
    getManagedAdditionalStates 在接口 Propagator
    
    返回:
    
    所有已管理状态的名称
  - propagate
```
public SpacecraftState propagate(AbsoluteDate target)
```
    朝着目标日期传播。
    简单的传播器仅使用目标日期作为计算传播状态的规范。功能更丰富的传播器可以考虑其他信息并提供不同的操作模式或G-stop功能以在特定事件发生时停止。在这些情况下，目标日期仅是一个提示，而不是强制性目标。
    
    由以下指定:
    
    propagate 在接口 Propagator
    
    参数:
    
    target - 应传播轨道状态的目标日期
    
    返回:
    
    传播后的状态
  - getPVCoordinates
```
public TimeStampedPVCoordinates getPVCoordinates(AbsoluteDate date,
                                                 Frame frame)
```
    获取所选参考系中物体的PVCoordinates。
    
    由以下指定:
    
    getPVCoordinates 在接口 PVCoordinatesProvider
    
    参数:
    
    date - 当前日期
    
    frame - 定义位置的参考系
    
    返回:
    
    物体的时间戳位置/速度（米和米/秒）
  - initializePropagation
```
protected void initializePropagation()
```
    初始化传播。
    
    自从:
    
    10.1
  - stateChanged
```
protected void stateChanged(SpacecraftState state)
```
    通知状态更改。
    
    参数:
    
    state - 新状态

Class AbstractPropagator

Field Summary

Fields inherited from interface org.orekit.propagation.Propagator

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface org.orekit.propagation.Propagator

Methods inherited from interface org.orekit.utils.PVCoordinatesProvider

Constructor Detail

AbstractPropagator

Method Detail

setStartDate

getStartDate

getAttitudeProvider

setAttitudeProvider

getInitialState

getFrame

resetInitialState

getMultiplexer

addAdditionalStateProvider

getAdditionalStateProviders

setupMatricesComputation

createHarvester

getHarvester

updateUnmanagedStates

updateAdditionalStates

initializeAdditionalStates

isAdditionalStateManaged

getManagedAdditionalStates

propagate

getPVCoordinates

initializePropagation

stateChanged