TimeSpanParametricAcceleration (OREKIT 12.0.1 API)

java.lang.Object
- org.orekit.forces.empirical.TimeSpanParametricAcceleration

All Implemented Interfaces:

ForceModel, EventDetectorsProvider, ParameterDriversProvider
```
public class TimeSpanParametricAcceleration
extends Object
implements ForceModel
```
时间跨度参数化加速度模型。
这个类与 ParametricAcceleration 类密切相关。
不同之处在于它具有一个 TimeSpanMap，其中包含多个 AccelerationModel 对象，而不是单个 AccelerationModel 对象。
这个模型背后的想法是允许用户设计一个参数化加速度模型，该模型的物理参数可以随时间变化，时间由用户选择。

这是精确轨道确定中可以寻求的行为。
实际上，对于这种类型的应用，经验参数必须在每个新轨道上重新评估。
用法:
- 构造：构造函数接受一个加速度方向、一个姿态模式（或一个惯性标志）和一个加速度模型。
  这个最后一个模型将是您的初始加速度模型，并且最初将对整个时间线有效。
  随着添加其他加速度模型，这个第一个条目的实际有效性将被截断。
- 时间跨度：使用方法 addAccelerationModelValidAfter(AccelerationModel, AbsoluteDate) 或 addAccelerationModelValidBefore(AccelerationModel, AbsoluteDate) 添加加速度模型。
  推荐与 TimeSpanMap 中的推荐相同，即：
  - 添加一个条目会截断已经存在于地图中的相邻条目的有效性；
  - 过渡日期应该只输入一次。重复过渡日期将导致意外结果，不受支持；
  - 建议在添加时按时间顺序排列您的加速度模型，以避免混淆。
- 命名参数驱动器：强烈建议为添加到对象中的每个加速度模型的 ParameterDriver 自定义名称。这将允许您跟踪模型的演变。
  不同的名称是必需的，以区分不同的驱动器。
  由于加速度模型参数没有默认名称，您必须处理驱动器名称，以考虑在添加新加速度模型时使用不同的名称。
Since:

10.3

Author:

Bryan Cazabonne

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`DATE_AFTER` 参数驱动器名称后的日期前缀。
`static String`	`DATE_BEFORE` 参数驱动器名称后的日期前缀。

Fields inherited from interface org.orekit.propagation.events.EventDetectorsProvider
DATATION_ACCURACY

Constructor Summary

Constructors
Constructor and Description
`TimeSpanParametricAcceleration(org.hipparchus.geometry.euclidean.threed.Vector3D direction, AttitudeProvider attitudeOverride, AccelerationModel accelerationModel)` 简单构造函数。
`TimeSpanParametricAcceleration(org.hipparchus.geometry.euclidean.threed.Vector3D direction, boolean isInertial, AccelerationModel accelerationModel)` 简单构造函数。

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`<T extends org.hipparchus.CalculusFieldElement<T>> org.hipparchus.geometry.euclidean.threed.FieldVector3D<T>`	`acceleration(FieldSpacecraftState<T> state, T[] parameters)` 计算加速度。
`org.hipparchus.geometry.euclidean.threed.Vector3D`	`acceleration(SpacecraftState state, double[] parameters)` 计算加速度。
`void`	`addAccelerationModelValidAfter(AccelerationModel accelerationModel, AbsoluteDate earliestValidityDate)` 在限制日期后添加一个加速度模型条目。
`void`	`addAccelerationModelValidBefore(AccelerationModel accelerationModel, AbsoluteDate latestValidityDate)` 在限制日期前添加一个加速度模型条目。
`boolean`	`dependsOnPositionOnly()` 检查力模型是否仅依赖于位置。
`TimeSpanMap<AccelerationModel>`	`extractAccelerationModelRange(AbsoluteDate start, AbsoluteDate end)` 提取加速度模型时间跨度映射的范围。
`double[]`	`extractParameters(double[] parameters, AbsoluteDate date)` 从输入的数组中提取 `acceleration` 方法的正确参数驱动器值。
`<T extends org.hipparchus.CalculusFieldElement<T>> T[]`	`extractParameters(T[] parameters, FieldAbsoluteDate<T> date)` 从输入的数组中提取 `acceleration` 方法的正确参数驱动器值。
`AccelerationModel`	`getAccelerationModel(AbsoluteDate date)` 获取在特定日期有效的 `AccelerationModel` 模型。
`TimeSpanMap.Span<AccelerationModel>`	`getAccelerationModelSpan(AbsoluteDate date)` 获取包含指定日期的 `AccelerationModel` `TimeSpanMap.Span` 的时间跨度映射。
`Stream<EventDetector>`	`getEventDetectors()` 获取与模型相关的离散事件。
`<T extends org.hipparchus.CalculusFieldElement<T>> Stream<FieldEventDetector<T>>`	`getFieldEventDetectors(org.hipparchus.Field<T> field)` 获取与模型相关的离散事件。
`TimeSpanMap.Span<AccelerationModel>`	`getFirstSpan()` 获取加速度模型时间跨度映射的第一个 `time span`。
`List<ParameterDriver>`	`getParametersDrivers()` 获取参数的驱动器。
`void`	`init(SpacecraftState initialState, AbsoluteDate target)` 在传播开始时初始化力模型。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.orekit.forces.ForceModel
addContribution, addContribution, init

Methods inherited from interface org.orekit.utils.ParameterDriversProvider
getNbParametersDriversValue, getParameterDriver, getParameters, getParameters, getParameters, getParameters, getParametersAllValues, getParametersAllValues, isSupported

Methods inherited from interface org.orekit.propagation.events.EventDetectorsProvider
getEventDetectors, getFieldEventDetectors

- Field Detail
  - DATE_BEFORE
```
public static final String DATE_BEFORE
```
    参数驱动器名称前的日期前缀。
    
    另请参阅:
    
    常量字段值
  - DATE_AFTER
```
public static final String DATE_AFTER
```
    参数驱动器名称后的日期前缀。
    
    另请参阅:
    
    常量字段值
- Constructor Detail
  - TimeSpanParametricAcceleration
```
public TimeSpanParametricAcceleration(org.hipparchus.geometry.euclidean.threed.Vector3D direction,
                                      boolean isInertial,
                                      AccelerationModel accelerationModel)
```
    简单构造函数。
    
    参数:
    
    direction - 覆盖的航天器框架中的加速度方向
    
    isInertial - 如果为true，则方向在用于传播的相同惯性框架中定义（即 SpacecraftState.getFrame()），否则方向在航天器框架中定义（即使用传播 姿态法则）
    
    accelerationModel - 用于计算经验加速度贡献的加速度模型
  - TimeSpanParametricAcceleration
```
public TimeSpanParametricAcceleration(org.hipparchus.geometry.euclidean.threed.Vector3D direction,
                                      AttitudeProvider attitudeOverride,
                                      AccelerationModel accelerationModel)
```
    简单构造函数。
    
    参数:
    
    direction - 覆盖的航天器框架中的加速度方向
    
    isInertial - 如果为true，则方向在用于传播的相同惯性框架中定义（即 SpacecraftState.getFrame()），否则方向在航天器框架中定义（即使用传播 姿态法则）
    
    attitudeOverride - 用于计算加速度的姿态提供程序
    
    accelerationModel - 用于计算经验加速度贡献的加速度模型
- Method Detail
  - init
```
public void init(SpacecraftState initialState,
                 AbsoluteDate target)
```
    在传播开始时初始化力模型。在调用 ForceModel.addContribution(SpacecraftState, TimeDerivativesEquations)、ForceModel.addContribution(FieldSpacecraftState, FieldTimeDerivativesEquations)、ForceModel.acceleration(SpacecraftState, double[]) 或 ForceModel.acceleration(FieldSpacecraftState, CalculusFieldElement[]) 之前将调用此方法。
    此方法的默认实现不执行任何操作。
    
    由以下接口指定:
    
    init 在接口 ForceModel
    
    参数:
    
    initialState - 传播开始时的航天器状态
    
    target - 传播日期。不等于 initialState.getDate()。
  - addAccelerationModelValidBefore
```
public void addAccelerationModelValidBefore(AccelerationModel accelerationModel,
                                            AbsoluteDate latestValidityDate)
```
    在限制日期前添加一个加速度模型条目。
    
    使用 addAccelerationModelValidBefore(entry, t) 将使 entry 在 ]-∞, t[ 中有效（注意开放括号）。
    
    警告：由于加速度模型参数没有默认名称，用户必须自行处理驱动器名称，以考虑在添加新加速度模型时使用不同名称（即不同参数）。
    
    参数:
    
    accelerationModel - 加速度模型条目
    
    latestValidityDate - 条目有效之前的日期（必须与已用于过渡的所有日期不同）
  - addAccelerationModelValidAfter
```
public void addAccelerationModelValidAfter(AccelerationModel accelerationModel,
                                           AbsoluteDate earliestValidityDate)
```
    在限制日期后添加一个加速度模型条目。
    
    使用 addAccelerationModelValidAfter(entry, t) 将使 entry 在 [t, +∞[ 中有效（注意闭合括号）。
    
    警告：由于加速度模型参数没有默认名称，用户必须自行处理驱动器名称，以考虑在添加新加速度模型时使用不同名称（即不同参数）。
    
    参数:
    
    accelerationModel - 加速度模型条目
    
    earliestValidityDate - 条目有效之后的日期（必须与已用于过渡的所有日期不同）
  - getAccelerationModel
```
public AccelerationModel getAccelerationModel(AbsoluteDate date)
```
    获取在特定日期有效的 AccelerationModel 模型。
    
    参数:
    
    date - 有效日期
    
    返回:
    
    在日期有效的加速度模型
  - getAccelerationModelSpan
```
public TimeSpanMap.Span<AccelerationModel> getAccelerationModelSpan(AbsoluteDate date)
```
    获取包含指定日期的AccelerationModel TimeSpanMap.Span。
    
    参数:
    
    date - 属于所需时间跨度的日期
    
    返回:
    
    包含指定日期的加速度模型时间跨度
  - extractAccelerationModelRange
```
public TimeSpanMap<AccelerationModel> extractAccelerationModelRange(AbsoluteDate start,
                                                                    AbsoluteDate end)
```
    提取加速度模型映射的一段范围。
    返回的对象将是一个新的独立实例，仅包含位于指定范围内的过渡。
    有关更多信息，请参阅TimeSpanMap.extractRange方法。
    
    参数:
    
    start - 包含在范围内的最早过渡日期（可以设置为AbsoluteDate.PAST_INFINITY以保留所有早期过渡）
    
    end - 包含在范围内的最晚过渡日期（可以设置为AbsoluteDate.FUTURE_INFINITY以保留所有晚期过渡）
    
    返回:
    
    一个新的加速度模型TimeSpanMap实例，其中所有过渡都限制在指定范围内
  - getFirstSpan
```
public TimeSpanMap.Span<AccelerationModel> getFirstSpan()
```
    获取加速度模型时间跨度映射的第一个时间跨度。
    
    返回:
    
    加速度模型时间跨度映射的第一个时间跨度
    
    自版本:
    
    11.1
  - dependsOnPositionOnly
```
public boolean dependsOnPositionOnly()
```
    检查力模型是否仅依赖于位置。
    
    指定者:
    
    dependsOnPositionOnly 在接口 ForceModel
    
    返回:
    
    如果力模型仅依赖于位置，则为true，如果它依赖于速度，直接或由于对姿态的依赖，则为false
  - acceleration
```
public org.hipparchus.geometry.euclidean.threed.Vector3D acceleration(SpacecraftState state,
                                                                      double[] parameters)
```
    计算加速度。
    
    指定者:
    
    acceleration 在接口 ForceModel
    
    参数:
    
    state - 当前状态信息：日期、运动学、姿态
    
    parameters - 在状态日期处的力模型参数值，每个parameterDriver仅有1个值
    
    返回:
    
    与状态相同的加速度
  - acceleration
```
public <T extends org.hipparchus.CalculusFieldElement<T>> org.hipparchus.geometry.euclidean.threed.FieldVector3D<T> acceleration(FieldSpacecraftState<T> state,
                                                                                                                                 T[] parameters)
```
    计算加速度。
    
    指定者:
    
    acceleration 在接口 ForceModel
    
    类型参数:
    
    T - 元素的类型
    
    参数:
    
    state - 当前状态信息：日期、运动学、姿态
    
    parameters - 在状态日期处的力模型参数值，每个parameterDriver仅有1个值
    
    返回:
    
    与状态相同的加速度
  - getEventDetectors
```
public Stream<EventDetector> getEventDetectors()
```
    获取与模型相关的离散事件。
    此方法不应多次调用，只能由一个传播器调用一次，因为每次调用都会重建事件检测器。
    
    指定者:
    
    getEventDetectors 在接口 ForceModel
    
    指定者:
    
    getEventDetectors 在接口 EventDetectorsProvider
    
    返回:
    
    事件检测器流
  - getFieldEventDetectors
```
public <T extends org.hipparchus.CalculusFieldElement<T>> Stream<FieldEventDetector<T>> getFieldEventDetectors(org.hipparchus.Field<T> field)
```
    获取与模型相关的离散事件。
    此方法不应多次调用，只能由一个传播器调用一次，因为每次调用都会重建事件检测器。
    
    指定者:
    
    getFieldEventDetectors 在接口 ForceModel
    
    指定者:
    
    getFieldEventDetectors 在接口 EventDetectorsProvider
    
    类型参数:
    
    T - 扩展CalculusFieldElement<T>的类型
    
    参数:
    
    field - 状态所属的字段
    
    返回:
    
    事件检测器流
  - getParametersDrivers
```
public List<ParameterDriver> getParametersDrivers()
```
    获取参数的驱动程序。
    返回所有加速度模型的所有参数驱动程序的数组。模型按时间顺序排序。
    
    指定者:
    
    getParametersDrivers 在接口 ParameterDriversProvider
    
    返回:
    
    参数的驱动程序
  - extractParameters
```
public double[] extractParameters(double[] parameters,
                                  AbsoluteDate date)
```
    从输入数组中提取acceleration方法的正确参数驱动程序值。根据输入日期过滤参数。
    
    参数:
    
    parameters - 输入参数数组
    
    date - 日期
    
    返回:
    
    给定日期的参数
  - extractParameters
```
public <T extends org.hipparchus.CalculusFieldElement<T>> T[] extractParameters(T[] parameters,
                                                                                FieldAbsoluteDate<T> date)
```
    从输入数组中提取acceleration方法的正确参数驱动程序值。根据输入日期过滤参数。
    
    类型参数:
    
    T - 扩展CalculusFieldElement的类型
    
    参数:
    
    parameters - 输入参数数组
    
    date - 日期
    
    返回:
    
    给定日期的参数

Class TimeSpanParametricAcceleration

Field Summary

Fields inherited from interface org.orekit.propagation.events.EventDetectorsProvider

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface org.orekit.forces.ForceModel

Methods inherited from interface org.orekit.utils.ParameterDriversProvider

Methods inherited from interface org.orekit.propagation.events.EventDetectorsProvider

Field Detail

DATE_BEFORE

DATE_AFTER

Constructor Detail

TimeSpanParametricAcceleration

TimeSpanParametricAcceleration

Method Detail

init

addAccelerationModelValidBefore

addAccelerationModelValidAfter

getAccelerationModel

getAccelerationModelSpan

extractAccelerationModelRange

getFirstSpan

dependsOnPositionOnly

acceleration

acceleration

getEventDetectors

getFieldEventDetectors

getParametersDrivers

extractParameters

extractParameters