AbstractIntegratedPropagator (OREKIT 12.0.1 API)

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

All Implemented Interfaces:

Propagator, PVCoordinatesProvider

Direct Known Subclasses:

DSSTPropagator, GLONASSNumericalPropagator, NumericalPropagator
```
public abstract class AbstractIntegratedPropagator
extends AbstractPropagator
```
用于数值和半解析传播器的Propagator方法的常见处理。

Author:

Luc Maisonobe

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`AbstractIntegratedPropagator.MainStateEquations` 主状态（轨道、姿态和质量）的微分方程。

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

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`AbstractIntegratedPropagator(org.hipparchus.ode.ODEIntegrator integrator, PropagationType propagationType)` 构建一个新实例。

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addAdditionalDerivativesProvider(AdditionalDerivativesProvider provider)` 添加一个提供者，用于沿轨道传播时集成用户指定的状态导数。
`void`	`addEventDetector(EventDetector detector)` 添加一个事件探测器。
`protected void`	`afterIntegration()` 在集成后调用的方法。
`protected void`	`beforeIntegration(SpacecraftState initialState, AbsoluteDate tEnd)` 在集成前调用的方法。
`void`	`clearEventsDetectors()` 移除所有事件探测器。
`protected abstract StateMapper`	`createMapper(AbsoluteDate referenceDate, double mu, OrbitType orbitType, PositionAngleType positionAngleType, AttitudeProvider attitudeProvider, Frame frame)` 创建原始双精度分量和航天器状态之间的映射器。
`List<AdditionalDerivativesProvider>`	`getAdditionalDerivativesProviders()` 获取附加导数提供者的不可修改列表。
`int`	`getBasicDimension()` 获取没有额外参数的状态向量维度。
`int`	`getCalls()` 获取微分方程计算方法的调用次数。
`EphemerisGenerator`	`getEphemerisGenerator()` 设置一个星历生成器，用于监视传播并在完成后从中构建星历。
`Collection<EventDetector>`	`getEventsDetectors()` 获取所有已添加的事件探测器。
`protected SpacecraftState`	`getInitialIntegrationState()` 获取集成的初始状态。
`protected org.hipparchus.ode.ODEIntegrator`	`getIntegrator()` 获取传播器使用的数值积分器。
`String`	`getIntegratorName()` 获取数值积分器的名称。
`protected abstract AbstractIntegratedPropagator.MainStateEquations`	`getMainStateEquations(org.hipparchus.ode.ODEIntegrator integ)` 获取要集成的微分方程（仅适用于主状态）。
`String[]`	`getManagedAdditionalStates()` 获取所有受管状态的名称。
`double`	`getMu()` 获取中心引力系数 μ。
`protected OrbitType`	`getOrbitType()` 获取传播参数类型。
`protected PositionAngleType`	`getPositionAngleType()` 获取传播参数类型。
`PropagationType`	`getPropagationType()` 获取传播类型。
`boolean`	`getResetAtEnd()` 关于初始状态重置标志的获取器。
`protected void`	`initMapper()` 初始化映射器。
`boolean`	`isAdditionalStateManaged(String name)` 检查是否管理了额外状态。
`SpacecraftState`	`propagate(AbsoluteDate target)` 朝着目标日期传播。
`SpacecraftState`	`propagate(AbsoluteDate tStart, AbsoluteDate tEnd)` 从起始日期朝向目标日期传播。
`void`	`setAttitudeProvider(AttitudeProvider attitudeProvider)` 设置姿态提供者。
`void`	`setMu(double mu)` 设置中心引力系数 μ。
`protected void`	`setOrbitType(OrbitType orbitType)` 设置传播轨道类型。
`protected void`	`setPositionAngleType(PositionAngleType positionAngleType)` 设置位置角类型。
`void`	`setResetAtEnd(boolean resetAtEnd)` 允许/禁止在传播结束时重置初始状态。
`protected void`	`setUpEventDetector(org.hipparchus.ode.ODEIntegrator integ, EventDetector detector)` 包装一个Orekit事件探测器并将其注册到积分器。
`protected void`	`setUpStmAndJacobianGenerators()` 设置状态转移矩阵和雅可比矩阵处理。
`protected void`	`setUpUserEventDetectors()` 设置所有用户定义的事件探测器。

Methods inherited from class org.orekit.propagation.AbstractPropagator
addAdditionalStateProvider, createHarvester, getAdditionalStateProviders, getAttitudeProvider, getFrame, getHarvester, getInitialState, getMultiplexer, getPVCoordinates, getStartDate, initializeAdditionalStates, initializePropagation, resetInitialState, 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
  - AbstractIntegratedPropagator
```
protected AbstractIntegratedPropagator(org.hipparchus.ode.ODEIntegrator integrator,
                                       PropagationType propagationType)
```
    构建一个新实例。
    
    参数：
    
    integrator - 用于传播的数值积分器。
    
    propagationType - 要输出的轨道类型（平均或摄动）。
- Method Detail
  - setResetAtEnd
```
public void setResetAtEnd(boolean resetAtEnd)
```
    允许/禁止在传播结束时重置初始状态。
    默认情况下，在传播结束时，传播器将初始状态重置为最终状态，从而允许从那里开始新的传播，而无需重新计算已执行的部分。调用此方法并将resetAtEnd设置为false会阻止此类重置。
    
    参数：
    
    resetAtEnd - 如果为true，则在每次传播结束时，初始状态将重置为传播的最终状态，否则将保留初始状态
    
    自版本：
    
    9.0
  - getResetAtEnd
```
public boolean getResetAtEnd()
```
    关于初始状态重置标志的获取器。
    
    返回：
    
    重置标志
    
    自版本：
    
    12.0
  - initMapper
```
protected void initMapper()
```
    初始化映射器。
  - getIntegratorName
```
public String getIntegratorName()
```
    获取数值积分器的名称。
    
    返回：
    
    底层数值积分器的名称
    
    自版本：
    
    12.0
  - setAttitudeProvider
```
public void setAttitudeProvider(AttitudeProvider attitudeProvider)
```
    设置姿态提供者。
    
    指定者：
    
    setAttitudeProvider 在接口 Propagator中
    
    覆盖：
    
    setAttitudeProvider 在类 AbstractPropagator中
    
    参数：
    
    attitudeProvider - 姿态提供者
  - setOrbitType
```
protected void setOrbitType(OrbitType orbitType)
```
    设置传播轨道类型。
    
    参数：
    
    orbitType - 用于传播的轨道类型，null表示使用AbsolutePVCoordinates而不是Orbit进行传播
  - getOrbitType
```
protected OrbitType getOrbitType()
```
    获取传播参数类型。
    
    返回：
    
    用于传播的轨道类型，null表示使用AbsolutePVCoordinates而不是Orbit进行传播
  - getPropagationType
```
public PropagationType getPropagationType()
```
    获取传播类型。
    
    返回：
    
    传播类型。
    
    自版本：
    
    11.1
  - setPositionAngleType
```
protected void setPositionAngleType(PositionAngleType positionAngleType)
```
    设置位置角类型。
    位置参数类型仅在传播轨道类型支持时才有意义。例如，在笛卡尔参数中传播时，这是没有意义的。
    
    参数：
    
    positionAngleType - 用于传播的角度类型
  - getPositionAngleType
```
protected PositionAngleType getPositionAngleType()
```
    获取传播参数类型。
    
    返回：
    
    用于传播的角度类型
  - setMu
```
public void setMu(double mu)
```
    设置中心引力系数 μ。
    
    参数：
    
    mu - 中心引力系数（m³/s²）
  - getMu
```
public double getMu()
```
    获取中心引力系数 μ。
    
    返回：
    
    μ中心引力系数（m³/s²）
    
    另请参阅：
    
    setMu(double)
  - getCalls
```
public int getCalls()
```
    获取微分方程计算方法的调用次数。
    每次调用propagate(AbsoluteDate)方法时，调用次数都会重置。
    
    返回：
    
    微分方程计算方法的调用次数
  - isAdditionalStateManaged
```
public boolean isAdditionalStateManaged(String name)
```
    检查是否管理了额外状态。
    受管状态是传播器知道如何计算其演变的状态。它们对应于通过调用addAdditionalStateProvider方法注册了一个提供者的附加状态。
    
    出现在初始状态中但没有注册演变方法的附加状态不被视为受管状态。这些未受管的附加状态在传播过程中不会丢失。它们的值在状态重置之间是分段恒定的，如果某个事件处理程序resetState方法在事件发生时被调用并且恰好更改了未受管的附加状态，则它们的值可能会发生变化。
    
    指定者：
    
    isAdditionalStateManaged 在接口 Propagator中
    
    覆盖：
    
    isAdditionalStateManaged 在类 AbstractPropagator中
    
    参数：
    
    name - 附加状态的名称
    
    返回：
    
    如果附加状态受管则返回true
  - getManagedAdditionalStates
```
public String[] getManagedAdditionalStates()
```
    获取所有受管状态的名称。
    
    指定者：
    
    getManagedAdditionalStates 在接口 Propagator中
    
    覆盖：
    
    getManagedAdditionalStates 在类 AbstractPropagator中
    
    返回：
    
    所有受管理状态的名称
  - addAdditionalDerivativesProvider
```
public void addAdditionalDerivativesProvider(AdditionalDerivativesProvider provider)
```
    添加一个用于用户指定状态导数的提供者，以便与轨道传播一起集成。
    
    参数：
    
    provider - 附加导数的提供者
    
    自版本：
    
    11.1
    
    另请参阅：
    
    AbstractPropagator.addAdditionalStateProvider(org.orekit.propagation.AdditionalStateProvider)
  - getAdditionalDerivativesProviders
```
public List<AdditionalDerivativesProvider> getAdditionalDerivativesProviders()
```
    获取附加导数的提供者的不可修改列表。
    
    返回：
    
    附加导数的提供者
    
    自版本：
    
    11.1
  - addEventDetector
```
public void addEventDetector(EventDetector detector)
```
    添加一个事件探测器。
    
    参数：
    
    detector - 要添加的事件探测器
    
    另请参阅：
    
    Propagator.clearEventsDetectors(), Propagator.getEventsDetectors()
  - getEventsDetectors
```
public Collection<EventDetector> getEventsDetectors()
```
    获取已添加的所有事件探测器。
    
    返回：
    
    已添加探测器的不可修改集合
    
    另请参阅：
    
    Propagator.addEventDetector(EventDetector), Propagator.clearEventsDetectors()
  - clearEventsDetectors
```
public void clearEventsDetectors()
```
    移除所有事件探测器。
    
    另请参阅：
    
    Propagator.addEventDetector(EventDetector), Propagator.getEventsDetectors()
  - setUpUserEventDetectors
```
protected void setUpUserEventDetectors()
```
    设置所有用户定义的事件探测器。
  - setUpEventDetector
```
protected void setUpEventDetector(org.hipparchus.ode.ODEIntegrator integ,
                                  EventDetector detector)
```
    包装一个Orekit事件探测器并将其注册到积分器中。
    
    参数：
    
    integ - 要注册事件探测器的积分器
    
    detector - 要包装的事件探测器
  - getEphemerisGenerator
```
public EphemerisGenerator getEphemerisGenerator()
```
    设置一个星历生成器，用于监视传播并从中构建星历。
    当用户需要在初始时间和目标时间之间的任何时间快速随机访问轨道状态时，可以使用此生成器。一个典型的例子是实现搜索和迭代算法，这些算法可能在找到结果之前在传播范围内向前和向后导航，即使所使用的传播器是基于积分的，只能从一个初始时间到一个目标时间。
    
    请注意，当与基于积分的传播器一起使用时，生成器将存储所有中间结果。因此，在长时间积分范围和高精度/短时间步长的情况下，它会占用大量内存。当与解析传播器一起使用时，生成器仅存储开始/停止时间和对解析传播器本身的引用，以根据需要调用它，因此它的内存占用较小。
    
    返回的星历生成器最初将为空，在随后调用propagate(target)或propagate(start, target)之一时，将填充传播数据。因此，使用此方法的正确方式是：
```
   EphemerisGenerator generator = propagator.getEphemerisGenerator();
   propagator.propagate(target);
   BoundedPropagator ephemeris = generator.getGeneratedEphemeris();
 
```
    返回：
    
    星历生成器
  - createMapper
```
protected abstract StateMapper createMapper(AbsoluteDate referenceDate,
                                            double mu,
                                            OrbitType orbitType,
                                            PositionAngleType positionAngleType,
                                            AttitudeProvider attitudeProvider,
                                            Frame frame)
```
    创建原始双分量与航天器状态之间的映射器。/** 简单构造函数。
    如果传播轨道类型支持它，则位置参数类型才有意义。例如，在笛卡尔参数中传播时，它是没有意义的。
    
    参数：
    
    referenceDate - 参考日期
    
    mu - 中心吸引系数（m³/s²）
    
    orbitType - 用于映射的轨道类型
    
    positionAngleType - 用于传播的角度类型
    
    attitudeProvider - 姿态提供者
    
    frame - 惯性参考系
    
    返回：
    
    新的映射器
  - getMainStateEquations
```
protected abstract AbstractIntegratedPropagator.MainStateEquations getMainStateEquations(org.hipparchus.ode.ODEIntegrator integ)
```
    获取要集成的微分方程（仅适用于主状态）。
    
    参数：
    
    integ - 用于传播的数值积分器。
    
    返回：
    
    主状态的微分方程
  - propagate
```
public SpacecraftState propagate(AbsoluteDate target)
```
    朝向目标日期传播。
    简单的传播器仅使用目标日期作为计算传播状态的规范。功能更丰富的传播器可以考虑其他信息并提供不同的操作模式或G-stop功能，以在发生特定事件时停止。在这些情况下，目标日期仅是一个提示，而不是强制性目标。
    
    指定者：
    
    propagate 在接口 Propagator中
    
    覆盖：
    
    propagate 在类 AbstractPropagator中
    
    参数：
    
    target - 应传播轨道状态的目标日期
    
    返回：
    
    传播状态
  - propagate
```
public SpacecraftState propagate(AbsoluteDate tStart,
                                 AbsoluteDate tEnd)
```
    从开始日期朝向目标日期传播。
    这些传播器使用开始日期和目标日期来计算传播状态。对于使用事件检测机制的传播器，如果提供的开始日期与初始状态日期不同，则将执行第一次简单传播，而不处理任何事件计算。然后从开始日期到目标日期执行完整传播。
    
    参数：
    
    tStart - 应从中传播轨道状态的开始日期
    
    tEnd - 应传播轨道状态的目标日期
    
    返回：
    
    传播状态
  - setUpStmAndJacobianGenerators
```
protected void setUpStmAndJacobianGenerators()
```
    设置状态转移矩阵和雅可比矩阵处理。
    
    自版本：
    
    11.1
  - getInitialIntegrationState
```
protected SpacecraftState getInitialIntegrationState()
```
    获取用于积分的初始状态。
    
    返回：
    
    用于积分的初始状态
  - beforeIntegration
```
protected void beforeIntegration(SpacecraftState initialState,
                                 AbsoluteDate tEnd)
```
    在积分之前调用的方法。
    默认实现不执行任何操作，可以在子类中进行专门化。
    
    参数：
    
    initialState - 初始状态
    
    tEnd - 应传播状态的目标日期
  - afterIntegration
```
protected void afterIntegration()
```
    在积分之后调用的方法。
    默认实现不执行任何操作，可以在子类中进行专门化。
  - getBasicDimension
```
public int getBasicDimension()
```
    获取没有附加参数的状态向量维度。
    
    返回：
    
    没有附加参数的状态向量维度。
  - getIntegrator
```
protected org.hipparchus.ode.ODEIntegrator getIntegrator()
```
    获取传播器使用的积分器。
    
    返回：
    
    积分器。

Class AbstractIntegratedPropagator

Nested Class Summary

Field Summary

Fields inherited from interface org.orekit.propagation.Propagator

Constructor Summary

Method Summary

Methods inherited from class org.orekit.propagation.AbstractPropagator

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

AbstractIntegratedPropagator

Method Detail

setResetAtEnd

getResetAtEnd

initMapper

getIntegratorName

setAttitudeProvider

setOrbitType

getOrbitType

getPropagationType

setPositionAngleType

getPositionAngleType

setMu

getMu

getCalls

isAdditionalStateManaged

getManagedAdditionalStates

addAdditionalDerivativesProvider

getAdditionalDerivativesProviders

addEventDetector

getEventsDetectors

clearEventsDetectors

setUpUserEventDetectors

setUpEventDetector

getEphemerisGenerator

createMapper

getMainStateEquations

propagate

propagate

setUpStmAndJacobianGenerators

getInitialIntegrationState

beforeIntegration

afterIntegration

getBasicDimension

getIntegrator