org.orekit.propagation.semianalytical.dsst.forces

Interface DSSTForceModel

All Superinterfaces:

EventDetectorsProvider, ParameterDriversProvider

All Known Implementing Classes:

AbstractGaussianContribution, DSSTAtmosphericDrag, DSSTJ2SquaredClosedForm, DSSTNewtonianAttraction, DSSTSolarRadiationPressure, DSSTTesseral, DSSTThirdBody, DSSTZonal

public interface DSSTForceModel
extends ParameterDriversProvider, EventDetectorsProvider

这个接口表示一个用于DSSTPropagator的力量，用于修改航天器运动。

实现这个接口的对象应该在开始传播之前添加到一个DSST propagator中。

传播器将在传播的最开始调用initializeShortPeriodTerms(AuxiliaryElements, PropagationType, double[])方法，允许进行预处理计算，例如截断等。

然后传播器将在每一步调用：

1. getMeanElementRate(SpacecraftState, AuxiliaryElements, double[])方法。力量模型实例将提取计算对平均状态导数有贡献的平均元素速率所需的所有状态数据。
2. updateShortPeriodTerms(double[], SpacecraftState...)方法，如果需要瞬时参数，对上一步内的一些点进行采样。

Author:

Romain Di Constanzo, Pascal Parraud

Field Summary

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

DATATION_ACCURACY

Method Summary

Modifier and Type	Method and Description
default double[]	extractParameters(double[] parameters, AbsoluteDate date) 从updateShortPeriodTerms方法的输入数组中提取正确的参数驱动器值。
default <T extends org.hipparchus.CalculusFieldElement<T>> T[]	extractParameters(T[] parameters, FieldAbsoluteDate<T> date) 从updateShortPeriodTerms方法的输入数组中提取正确的参数驱动器值。
default Stream<EventDetector>	getEventDetectors() 获取与模型相关的离散事件。
default <T extends org.hipparchus.CalculusFieldElement<T>> Stream<FieldEventDetector<T>>	getFieldEventDetectors(org.hipparchus.Field<T> field) 获取与模型相关的离散事件。
<T extends org.hipparchus.CalculusFieldElement<T>> T[]	getMeanElementRate(FieldSpacecraftState<T> state, FieldAuxiliaryElements<T> auxiliaryElements, T[] parameters) 计算平均赤道元素速率 dai / dt。
double[]	getMeanElementRate(SpacecraftState state, AuxiliaryElements auxiliaryElements, double[] parameters) 计算平均赤道元素速率 dai / dt。
default <T extends org.hipparchus.CalculusFieldElement<T>> void	init(FieldSpacecraftState<T> initialState, FieldAbsoluteDate<T> target) 在传播开始时初始化力量模型。
default void	init(SpacecraftState initialState, AbsoluteDate target) 在传播开始时初始化力量模型。
List<ShortPeriodTerms>	initializeShortPeriodTerms(AuxiliaryElements auxiliaryElements, PropagationType type, double[] parameters) 对当前力量模型进行传播前的初始化。
<T extends org.hipparchus.CalculusFieldElement<T>> List<FieldShortPeriodTerms<T>>	initializeShortPeriodTerms(FieldAuxiliaryElements<T> auxiliaryElements, PropagationType type, T[] parameters) 对当前力量模型进行传播前的初始化。
void	registerAttitudeProvider(AttitudeProvider provider) 注册一个姿态提供者。
void	updateShortPeriodTerms(double[] parameters, SpacecraftState... meanStates) 更新短周期项。
<T extends org.hipparchus.CalculusFieldElement<T>> void	updateShortPeriodTerms(T[] parameters, FieldSpacecraftState<T>... meanStates) 更新短周期项。

Methods inherited from interface org.orekit.utils.ParameterDriversProvider

getNbParametersDriversValue, getParameterDriver, getParameters, getParameters, getParameters, getParameters, getParametersAllValues, getParametersAllValues, getParametersDrivers, isSupported

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

getEventDetectors, getFieldEventDetectors

Method Detail

init

default void init(SpacecraftState initialState,
                  AbsoluteDate target)

在传播开始时初始化力量模型。

此方法的默认实现不执行任何操作。

参数：

initialState - 传播开始时的航天器状态。

target - 传播的日期。不等于initialState.getDate()。

自版本：

11.0

init

default <T extends org.hipparchus.CalculusFieldElement<T>> void init(FieldSpacecraftState<T> initialState,
                                                                     FieldAbsoluteDate<T> target)

在传播开始时初始化力量模型。

此方法的默认实现不执行任何操作。

类型参数：

T - 元素的类型

参数：

initialState - 传播开始时的航天器状态。

target - 传播的日期。不等于initialState.getDate()。

自版本：

11.1

getEventDetectors

default Stream<EventDetector> getEventDetectors()

获取与模型相关的离散事件。

此方法不应该被多次调用，只能由传播器调用一次，因为每次调用都会重建事件探测器。

由以下指定：

getEventDetectors 在接口 EventDetectorsProvider

返回：

事件探测器流

getFieldEventDetectors

default <T extends org.hipparchus.CalculusFieldElement<T>> Stream<FieldEventDetector<T>> getFieldEventDetectors(org.hipparchus.Field<T> field)

获取与模型相关的离散事件。

此方法不应该被多次调用，只能由传播器调用一次，因为每次调用都会重建事件探测器。

由以下指定：

getFieldEventDetectors 在接口 EventDetectorsProvider

类型参数：

T - 扩展CalculusFieldElement<T>

参数：

field - 状态所属的域

返回：

事件探测器流

initializeShortPeriodTerms

List<ShortPeriodTerms> initializeShortPeriodTerms(AuxiliaryElements auxiliaryElements,
                                                  PropagationType type,
                                                  double[] parameters)

对当前力量模型进行传播前的初始化。

此方法旨在在传播的最开始调用。

参数：

auxiliaryElements - 与当前轨道相关的辅助元素

type - 传播期间使用的元素类型

parameters - 特定日期的力量模型参数值（每个参数驱动器仅有1个值），例如通过在力量模型上调用ParameterDriversProvider.getParameters(AbsoluteDate)获得。

返回：

一个对象列表，将保存短周期项（这些对象也会被力量模型保留，在传播期间将更新它们）

initializeShortPeriodTerms

<T extends org.hipparchus.CalculusFieldElement<T>> List<FieldShortPeriodTerms<T>> initializeShortPeriodTerms(FieldAuxiliaryElements<T> auxiliaryElements,
                                                                                                             PropagationType type,
                                                                                                             T[] parameters)

对当前力量模型进行传播前的初始化。

此方法旨在在传播的最开始调用。

类型参数：

T - 元素的类型

参数：

auxiliaryElements - 与当前轨道相关的辅助元素

type - 传播期间使用的元素类型

parameters - 特定日期的力量模型参数值（每个参数驱动器仅有1个值），例如通过在力量模型上调用ParameterDriversProvider.getParameters(AbsoluteDate)或在梯度转换器上调用AbstractGradientConverter.getParametersAtStateDate(FieldSpacecraftState, ParameterDriversProvider)获得。

返回：

一个对象列表，将保存短周期项（这些对象也会被力量模型保留，在传播期间将更新它们）

extractParameters

default double[] extractParameters(double[] parameters,
                                   AbsoluteDate date)

从updateShortPeriodTerms方法的输入数组中提取正确的参数驱动器值。根据输入日期过滤参数。

参数：

parameters - 包含所有驱动器的所有跨度值的输入参数数组，从中提取日期日期的参数值

date - 日期

返回：

给定日期的参数

extractParameters

default <T extends org.hipparchus.CalculusFieldElement<T>> T[] extractParameters(T[] parameters,
                                                                                 FieldAbsoluteDate<T> date)

从updateShortPeriodTerms方法的输入数组中提取正确的参数驱动器值。根据输入日期过滤参数。

类型参数：

T - 扩展CalculusFieldElement

参数：

parameters - 包含所有驱动器的所有跨度值的输入参数数组，从中提取日期日期的参数值

date - 日期

返回：

给定日期的参数

getMeanElementRate

double[] getMeanElementRate(SpacecraftState state,
                            AuxiliaryElements auxiliaryElements,
                            double[] parameters)

计算平均赤道元素速率 da_i / dt。

参数：

state - 当前状态信息：日期、运动学、姿态

auxiliaryElements - 与当前轨道相关的辅助元素

parameters - 状态日期的力量模型参数值（每个参数驱动器仅有1个跨度），例如通过在力量模型上调用ParameterDriversProvider.getParameters(AbsoluteDate)获得。

返回：

平均元素速率 dai/dt

getMeanElementRate

<T extends org.hipparchus.CalculusFieldElement<T>> T[] getMeanElementRate(FieldSpacecraftState<T> state,
                                                                          FieldAuxiliaryElements<T> auxiliaryElements,
                                                                          T[] parameters)

计算平均赤道元素速率 da_i / dt。

类型参数:

T - 元素的类型

参数:

state - 当前状态信息：日期、运动学、姿态

auxiliaryElements - 与当前轨道相关的辅助元素

parameters - 在状态日期处的力模型参数值（每个参数驱动器仅有一个跨度），例如通过调用 ParameterDriversProvider.getParameters(Field, FieldAbsoluteDate) 或 AbstractGradientConverter.getParametersAtStateDate(FieldSpacecraftState, ParameterDriversProvider) 来获取。

返回:

平均元素速率 dai/dt

registerAttitudeProvider

void registerAttitudeProvider(AttitudeProvider provider)

注册姿态提供者。

注册一个可以被力模型使用的姿态提供者。

参数:

provider - AttitudeProvider

updateShortPeriodTerms

void updateShortPeriodTerms(double[] parameters,
                            SpacecraftState... meanStates)

更新短周期项。

将更新的 短周期项 是在调用 initializeShortPeriodTerms(AuxiliaryElements, PropagationType, double[]) 时返回的那些。

参数:

parameters - 力模型参数的值（每个参数的所有跨度值），例如通过调用 ParameterDriversProvider.getParametersAllValues() 来获取。在方法中调用提取参数方法 extractParameters(double[], AbsoluteDate) 来选择与平均状态日期对应的正确参数。

meanStates - 平均状态信息：日期、运动学、姿态

updateShortPeriodTerms

<T extends org.hipparchus.CalculusFieldElement<T>> void updateShortPeriodTerms(T[] parameters,
                                                                               FieldSpacecraftState<T>... meanStates)

更新短周期项。

将更新的 短周期项 是在调用 initializeShortPeriodTerms(AuxiliaryElements, PropagationType, double[]) 时返回的那些。

类型参数:

T - 元素的类型

参数:

parameters - 力模型参数的值（每个参数的所有跨度值），例如通过调用 ParameterDriversProvider.getParametersAllValues(Field) 来获取。在方法中调用提取参数方法 extractParameters(CalculusFieldElement[], FieldAbsoluteDate) 来选择正确的参数。

meanStates - 平均状态信息：日期、运动学、姿态