FieldPropagator (OREKIT 12.0.1 API)

Type Parameters:

T - the type of the field elements

All Superinterfaces:

FieldPVCoordinatesProvider<T>

All Known Subinterfaces:

FieldBoundedPropagator<T>

All Known Implementing Classes:

FieldAbstractAnalyticalPropagator, FieldAbstractIntegratedPropagator, FieldAbstractPropagator, FieldBrouwerLyddanePropagator, FieldDeepSDP4, FieldDSSTPropagator, FieldEcksteinHechlerPropagator, FieldIntegratedEphemeris, FieldKeplerianPropagator, FieldNumericalPropagator, FieldSGP4, FieldTLEPropagator
```
public interface FieldPropagator<T extends org.hipparchus.CalculusFieldElement<T>>
extends FieldPVCoordinatesProvider<T>
```
该接口提供了在任意时间传播轨道的方法。
该接口是轨道传播的顶层抽象。它只允许传播到预定义日期。它由没有时间限制的解析模型实现，由基于外部数据文件的轨道读取器实现，由使用丰富力模型的数值积分器实现，以及由在数值积分完成并收集了密集输出数据后构建的连续模型实现。

Author:

Luc Maisonobe, Véronique Pommier-Maurussane

Field Summary

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

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`void`	`addAdditionalStateProvider(FieldAdditionalStateProvider<T> additionalStateProvider)` 添加一组用户指定的状态参数，以便与轨道传播一起计算。
`<D extends FieldEventDetector<T>> void`	`addEventDetector(D detector)` 添加事件探测器。
`void`	`clearEventsDetectors()` 移除所有事件探测器。
`default void`	`clearStepHandlers()` 移除所有步长处理器。
`List<FieldAdditionalStateProvider<T>>`	`getAdditionalStateProviders()` 获取用于额外状态的不可修改提供程序列表。
`AttitudeProvider`	`getAttitudeProvider()` 获取姿态提供程序。
`FieldEphemerisGenerator<T>`	`getEphemerisGenerator()` 设置一个星历生成器，它将监视传播以便在完成后从中构建星历。
`Collection<FieldEventDetector<T>>`	`getEventsDetectors()` 获取已添加的所有事件探测器。
`Frame`	`getFrame()` 获取传播轨道的参考系。
`FieldSpacecraftState<T>`	`getInitialState()` 获取传播器的初始状态。
`String[]`	`getManagedAdditionalStates()` 获取所有管理状态的名称。
`FieldStepHandlerMultiplexer<T>`	`getMultiplexer()` 获取保存所有步长处理器的复用器。
`boolean`	`isAdditionalStateManaged(String name)` 检查是否管理额外状态。
`FieldSpacecraftState<T>`	`propagate(FieldAbsoluteDate<T> target)` 朝向目标日期传播。
`FieldSpacecraftState<T>`	`propagate(FieldAbsoluteDate<T> start, FieldAbsoluteDate<T> target)` 从起始日期朝向目标日期传播。
`void`	`resetInitialState(FieldSpacecraftState<T> state)` 重置传播器的初始状态。
`void`	`setAttitudeProvider(AttitudeProvider attitudeProvider)` 设置姿态提供程序。
`default void`	`setStepHandler(FieldOrekitStepHandler<T> handler)` 设置用于可变步长的单个处理器。
`default void`	`setStepHandler(T h, FieldOrekitFixedStepHandler<T> handler)` 设置用于固定步长的单个处理器。

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

- Field Detail
  - DEFAULT_MASS
```
static final double DEFAULT_MASS
```
    默认质量。
    
    另请参阅:
    
    常量字段值
- Method Detail
  - getMultiplexer
```
FieldStepHandlerMultiplexer<T> getMultiplexer()
```
    获取保存所有步长处理器的复用器。
    
    返回:
    
    保存所有步长处理器的复用器
    
    自从:
    
    11.0
  - clearStepHandlers
```
default void clearStepHandlers()
```
    移除所有步长处理器。
    此便利方法等同于调用getMultiplexer().clear()
    
    自从:
    
    11.0
    
    另请参阅:
    
    getMultiplexer(), FieldStepHandlerMultiplexer.clear()
  - setStepHandler
```
default void setStepHandler(T h,
                            FieldOrekitFixedStepHandler<T> handler)
```
    设置用于固定步长的单个处理器。
    此便利方法等同于调用getMultiplexer().clear()，然后调用getMultiplexer().add(h, handler)
    
    参数:
    
    h - 固定步长（秒）
    
    handler - 在每个完成的步骤结束时调用的处理器
    
    自从:
    
    11.0
    
    另请参阅:
    
    getMultiplexer(), FieldStepHandlerMultiplexer.add(CalculusFieldElement, FieldOrekitFixedStepHandler)
  - setStepHandler
```
default void setStepHandler(FieldOrekitStepHandler<T> handler)
```
    设置用于可变步长的单个处理器。
    此便利方法等同于调用getMultiplexer().clear()，然后调用getMultiplexer().add(handler)
    
    参数:
    
    handler - 在每个完成的步骤结束时调用的处理器
    
    自从:
    
    11.0
    
    另请参阅:
    
    getMultiplexer(), FieldStepHandlerMultiplexer.add(FieldOrekitStepHandler)
  - getEphemerisGenerator
```
FieldEphemerisGenerator<T> getEphemerisGenerator()
```
    设置一个星历生成器，它将监视传播以便在完成后从中构建星历。
    当用户需要在初始时间和目标时间之间的任何时间快速随机访问轨道状态时，可以使用此生成器。一个典型的例子是实现可能在传播范围内向前和向后导航的搜索和迭代算法，即使所使用的传播器是基于积分的并且只从一个初始时间到一个目标时间。
    
    请注意，当与基于积分的传播器一起使用时，生成器将存储所有中间结果。因此，在长积分范围和高精度/短时间步长的情况下，它会占用大量内存。当与解析传播器一起使用时，生成器仅存储开始/停止时间和对解析传播器本身的引用，以便在需要时调用它，因此它的内存占用较低。
    
    返回的星历生成器最初将为空，当随后调用propagate(target)或propagate(start, target)中的任一方法时，它将填充传播数据。因此，使用此方法的正确方式是：
```
   FieldEphemerisGenerator<T> generator = propagator.getEphemerisGenerator();
   propagator.propagate(target);
   FieldBoundedPropagator<T> ephemeris = generator.getGeneratedEphemeris();
 
```
    返回:
    
    星历生成器
  - getInitialState
```
FieldSpacecraftState<T> getInitialState()
```
    获取传播器的初始状态。
    
    返回:
    
    初始状态
  - resetInitialState
```
void resetInitialState(FieldSpacecraftState<T> state)
```
    重置传播器的初始状态。
    
    参数:
    
    state - 要考虑的新初始状态
  - addAdditionalStateProvider
```
void addAdditionalStateProvider(FieldAdditionalStateProvider<T> additionalStateProvider)
```
    添加一组用户指定的状态参数，以便与轨道传播一起计算。
    
    参数:
    
    additionalStateProvider - 用于额外状态的提供程序
  - getAdditionalStateProviders
```
List<FieldAdditionalStateProvider<T>> getAdditionalStateProviders()
```
    获取用于额外状态的不可修改提供程序列表。
    
    返回:
    
    额外状态的提供程序
  - isAdditionalStateManaged
```
boolean isAdditionalStateManaged(String name)
```
    检查是否管理额外状态。
    
    参数:
    
    name - 额外状态的名称
    
    返回:
    
    如果额外状态已管理，则返回true
  - getManagedAdditionalStates
```
String[] getManagedAdditionalStates()
```
    获取所有管理状态的名称。
    
    返回:
    
    所有管理状态的名称
  - addEventDetector
```
<D extends FieldEventDetector<T>> void addEventDetector(D detector)
```
    添加事件探测器。
    
    类型参数:
    
    D - 通用版本的类类型
    
    参数:
    
    detector - 要添加的事件探测器
    
    另请参阅:
    
    clearEventsDetectors(), getEventsDetectors()
  - getEventsDetectors
```
Collection<FieldEventDetector<T>> getEventsDetectors()
```
    获取已添加的所有事件探测器。
    
    返回:
    
    已添加探测器的不可修改集合
    
    另请参阅:
    
    addEventDetector(FieldEventDetector), clearEventsDetectors()
  - clearEventsDetectors
```
void clearEventsDetectors()
```
    移除所有事件探测器。
    
    另请参阅:
    
    addEventDetector(FieldEventDetector), getEventsDetectors()
  - getAttitudeProvider
```
AttitudeProvider getAttitudeProvider()
```
    获取姿态提供程序。
    
    返回:
    
    姿态提供者
  - setAttitudeProvider
```
void setAttitudeProvider(AttitudeProvider attitudeProvider)
```
    设置姿态提供者。
    
    参数:
    
    attitudeProvider - 姿态提供者
  - getFrame
```
Frame getFrame()
```
    获取轨道传播的参考系。
    传播参考系是初始状态的定义参考系，因此应在设置了初始状态之后调用此方法，否则可能返回null。
    
    返回:
    
    轨道传播的参考系
    
    另请参阅:
    
    resetInitialState(FieldSpacecraftState)
  - propagate
```
FieldSpacecraftState<T> propagate(FieldAbsoluteDate<T> target)
```
    朝着目标日期传播。
    简单的传播器仅使用目标日期作为计算传播状态的规范。功能更丰富的传播器可以考虑其他信息并提供不同的操作模式或G-stop功能以在特定事件发生时停止。在这些情况下，目标日期仅是一个提示，而不是强制性目标。
    
    参数:
    
    target - 应传播轨道状态的目标日期
    
    返回:
    
    传播状态
  - propagate
```
FieldSpacecraftState<T> propagate(FieldAbsoluteDate<T> start,
                                  FieldAbsoluteDate<T> target)
```
    从开始日期朝向目标日期传播。
    这些传播器使用开始日期和目标日期来计算传播状态。对于使用事件检测机制的传播器，如果提供的开始日期与初始状态日期不同，则会执行第一次简单传播，而不处理任何事件计算。然后从开始日期到目标日期执行完整传播。
    
    参数:
    
    start - 应传播轨道状态的开始日期
    
    target - 应传播轨道状态的目标日期
    
    返回:
    
    传播状态

Interface FieldPropagator<T extends org.hipparchus.CalculusFieldElement<T>>

Field Summary

Method Summary

Methods inherited from interface org.orekit.utils.FieldPVCoordinatesProvider

Field Detail

DEFAULT_MASS

Method Detail

getMultiplexer

clearStepHandlers

setStepHandler

setStepHandler

getEphemerisGenerator

getInitialState

resetInitialState

addAdditionalStateProvider

getAdditionalStateProviders

isAdditionalStateManaged

getManagedAdditionalStates

addEventDetector

getEventsDetectors

clearEventsDetectors

getAttitudeProvider

setAttitudeProvider

getFrame

propagate

propagate