org.orekit.propagation.semianalytical.dsst.forces

Class DSSTThirdBody

java.lang.Object

org.orekit.propagation.semianalytical.dsst.forces.DSSTThirdBody

All Implemented Interfaces:

EventDetectorsProvider, DSSTForceModel, ParameterDriversProvider

public class DSSTThirdBody
extends Object
implements DSSTForceModel

DSSTPropagator的第三体引力摄动。

Author:

Romain Di Costanzo, Pascal Parraud, Bryan Cazabonne (field translation)

Field Summary

Fields

Modifier and Type	Field and Description
static String	ATTRACTION_COEFFICIENT 该模型的单个参数名称：引力系数。
static double	BIG_TRUNCATION_TOLERANCE 大偏心轨道的截断容差。
static int	MAX_POWER 求和的最大幂次。
static String	SHORT_PERIOD_PREFIX 短周期系数键的前缀名称。
static double	SMALL_TRUNCATION_TOLERANCE 小轨道的截断容差。

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

DATATION_ACCURACY

Constructor Summary

Constructors

Constructor and Description
DSSTThirdBody(CelestialBody body, double mu) 完整构造函数。

Method Summary

Modifier and Type	Method and Description
CelestialBody	getBody() 获取第三体。
<T extends org.hipparchus.CalculusFieldElement<T>> T[]	getMeanElementRate(FieldSpacecraftState<T> currentState, FieldAuxiliaryElements<T> auxiliaryElements, T[] parameters) 计算平均赤道元素速率dai / dt。
double[]	getMeanElementRate(SpacecraftState currentState, AuxiliaryElements auxiliaryElements, double[] parameters) 计算平均赤道元素速率dai / dt。
List<ParameterDriver>	getParametersDrivers() 获取参数的驱动器。
List<ShortPeriodTerms>	initializeShortPeriodTerms(AuxiliaryElements auxiliaryElements, PropagationType type, double[] parameters) 计算偏心率的最高幂次和截断分析幂级数展开中a/R3的最高幂次。
<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 class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.orekit.propagation.semianalytical.dsst.forces.DSSTForceModel

extractParameters, extractParameters, getEventDetectors, getFieldEventDetectors, init, 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

SHORT_PERIOD_PREFIX

public static final String SHORT_PERIOD_PREFIX

短周期系数键的前缀名称。

另请参阅：

常量字段值

ATTRACTION_COEFFICIENT

public static final String ATTRACTION_COEFFICIENT

该模型的单个参数名称：引力系数。

另请参阅：

常量字段值

MAX_POWER

public static final int MAX_POWER

求和的最大幂次。

另请参阅：

常量字段值

BIG_TRUNCATION_TOLERANCE

public static final double BIG_TRUNCATION_TOLERANCE

大偏心轨道的截断容差。

另请参阅：

常量字段值

SMALL_TRUNCATION_TOLERANCE

public static final double SMALL_TRUNCATION_TOLERANCE

小轨道的截断容差。

另请参阅：

常量字段值

Constructor Detail

DSSTThirdBody

public DSSTThirdBody(CelestialBody body,
                     double mu)

完整构造函数。

参数：

body - 要考虑的第三体

mu - 中心引力系数（即，中心天体的引力系数，而不是第三体的引力系数）

另请参阅：

CelestialBodies

Method Detail

getBody

public CelestialBody getBody()

获取第三体。

返回：

第三体

initializeShortPeriodTerms

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

计算偏心率的最高幂次和截断分析幂级数展开中a/R3的最高幂次。

该方法计算第三体势能的上限值，并确定产生大于定义容差的势能项的偏心率和a/R3的最大幂次。

指定者：

initializeShortPeriodTerms 在接口 DSSTForceModel

参数：

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

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

parameters - 状态日期的力模型参数值（每个参数的1个值）

返回：

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

initializeShortPeriodTerms

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

在当前力模型的传播之前执行初始化。

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

指定者：

initializeShortPeriodTerms 在接口 DSSTForceModel

类型参数：

T - 元素的类型

参数：

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

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

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

返回：

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

getMeanElementRate

public double[] getMeanElementRate(SpacecraftState currentState,
                                   AuxiliaryElements auxiliaryElements,
                                   double[] parameters)

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

指定者：

getMeanElementRate 在接口 DSSTForceModel

参数：

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

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

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

返回：

平均元素速率dai/dt

getMeanElementRate

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

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

指定者：

getMeanElementRate 在接口 DSSTForceModel

类型参数：

T - 元素的类型

参数：

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

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

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

返回：

平均元素速率dai/dt

updateShortPeriodTerms

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

更新短周期项。

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

指定者：

updateShortPeriodTerms 在接口 DSSTForceModel中

参数：

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

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

updateShortPeriodTerms

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

更新短周期项。

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

指定者：

updateShortPeriodTerms 在接口 DSSTForceModel中

类型参数：

T - 元素的类型

参数：

parameters - 力模型参数的值（每个参数的所有跨度值），例如通过在力模型上调用ParameterDriversProvider.getParametersAllValues(Field)或在梯度转换器上调用AbstractGradientConverter.getParameters(FieldSpacecraftState, ParameterDriversProvider)获得。在该方法中调用提取参数方法DSSTForceModel.extractParameters(CalculusFieldElement[], FieldAbsoluteDate)以选择正确的参数。

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

registerAttitudeProvider

public void registerAttitudeProvider(AttitudeProvider provider)

注册姿态提供者。

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

指定者：

registerAttitudeProvider 在接口 DSSTForceModel中

参数：

provider - AttitudeProvider

getParametersDrivers

public List<ParameterDriver> getParametersDrivers()

获取参数的驱动程序。

指定者：

getParametersDrivers 在接口 ParameterDriversProvider中

返回：

参数的驱动程序