DSSTZonal (OREKIT 12.0.1 API)

java.lang.Object
- org.orekit.propagation.semianalytical.dsst.forces.DSSTZonal

All Implemented Interfaces:

EventDetectorsProvider, DSSTForceModel, ParameterDriversProvider
```
public class DSSTZonal
extends Object
implements DSSTForceModel
```
中心天体引力摄动的区域贡献。

Author:

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

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`SHORT_PERIOD_PREFIX` 短周期系数键的前缀名称。

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

Constructor Summary

Constructors
Constructor and Description
`DSSTZonal(UnnormalizedSphericalHarmonicsProvider provider)` 使用默认参考值的构造函数。
`DSSTZonal(UnnormalizedSphericalHarmonicsProvider provider, int maxDegreeShortPeriodics, int maxEccPowShortPeriodics, int maxFrequencyShortPeriodics)` 简单构造函数。

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`<T extends org.hipparchus.CalculusFieldElement<T>> T[]`	`getMeanElementRate(FieldSpacecraftState<T> spacecraftState, FieldAuxiliaryElements<T> auxiliaryElements, T[] parameters)` 计算平均春分点元素速率 da_i / dt。
`double[]`	`getMeanElementRate(SpacecraftState spacecraftState, AuxiliaryElements auxiliaryElements, double[] parameters)` 计算平均春分点元素速率 da_i / dt。
`List<ParameterDriver>`	`getParametersDrivers()` 获取参数的驱动程序。
`UnnormalizedSphericalHarmonicsProvider`	`getProvider()` 获取球谐函数提供者。
`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 attitudeProvider)` 注册姿态提供者。
`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
```
    短周期系数键的前缀名称。
    
    另请参阅:
    
    常量字段值
- Constructor Detail
  - DSSTZonal
```
public DSSTZonal(UnnormalizedSphericalHarmonicsProvider provider)
```
    使用默认参考值的构造函数。
    当使用此构造函数时，将使用最大允许值作为短周期系数：
    - maxDegreeShortPeriodics 设置为 provider.getMaxDegree()
    - maxEccPowShortPeriodics 设置为 min(provider.getMaxDegree() - 1, 4)。此参数不应超过4，因为更高的值将超出计算机容量
    - maxFrequencyShortPeriodics 设置为 2 * provider.getMaxDegree() + 1
    参数:
    
    provider - 球谐函数提供者
    
    自版本:
    
    10.1
  - DSSTZonal
```
public DSSTZonal(UnnormalizedSphericalHarmonicsProvider provider,
                 int maxDegreeShortPeriodics,
                 int maxEccPowShortPeriodics,
                 int maxFrequencyShortPeriodics)
```
    简单构造函数。
    
    参数:
    
    provider - 球谐函数提供者
    
    maxDegreeShortPeriodics - 要考虑的短周期区域谐波势的最大次数（必须介于2和 provider.getMaxDegree() 之间）
    
    maxEccPowShortPeriodics - 在短周期计算中要使用的偏心率的最大幂次数（必须介于0和 maxDegreeShortPeriodics - 1 之间，但通常不应超过4，因为更高的值将超出计算机容量）
    
    maxFrequencyShortPeriodics - 真经度短周期计算中的最大频率（必须介于1和 2 * maxDegreeShortPeriodics + 1 之间）
    
    自版本:
    
    7.2
- Method Detail
  - getProvider
```
public UnnormalizedSphericalHarmonicsProvider getProvider()
```
    获取球谐函数提供者。
    
    返回:
    
    球谐函数提供者
  - initializeShortPeriodTerms
```
public List<ShortPeriodTerms> initializeShortPeriodTerms(AuxiliaryElements auxiliaryElements,
                                                         PropagationType type,
                                                         double[] parameters)
```
    在当前力模型的传播之前执行初始化。
    此方法旨在在传播开始时调用。
    
    计算在截断的解析幂级数展开中出现的偏心率的最高幂次。
    
    此方法计算中心天体势能的上限值，并确定产生大于定义的容差的偏心率的势能项的最大幂次。
    
    由以下接口指定:
    
    initializeShortPeriodTerms 在接口 DSSTForceModel 中
    
    参数:
    
    auxiliaryElements - 与当前轨道相关的辅助元素
    
    type - 传播期间使用的元素类型
    
    parameters - 特定日期的力模型参数值（每个参数驱动程序仅有1个值），例如通过在力模型上调用 ParameterDriversProvider.getParameters(AbsoluteDate) 获得。
    
    返回:
    
    一个对象列表，将保存短周期项（这些对象也将被力模型保留，在传播期间将更新它们）
  - 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 spacecraftState,
                                   AuxiliaryElements auxiliaryElements,
                                   double[] parameters)
```
    计算平均春分点元素速率 da_i / dt。
    
    由以下接口指定:
    
    getMeanElementRate 在接口 DSSTForceModel 中
    
    参数:
    
    spacecraftState - 当前状态信息：日期、运动学、姿态
    
    auxiliaryElements - 与当前轨道相关的辅助元素
    
    parameters - 状态日期的力模型参数值（每个参数驱动程序仅有1个跨度），例如通过在力模型上调用 ParameterDriversProvider.getParameters(AbsoluteDate) 获得。
    
    返回:
    
    平均元素速率 dai/dt
  - getMeanElementRate
```
public <T extends org.hipparchus.CalculusFieldElement<T>> T[] getMeanElementRate(FieldSpacecraftState<T> spacecraftState,
                                                                                 FieldAuxiliaryElements<T> auxiliaryElements,
                                                                                 T[] parameters)
```
    计算平均春分点元素速率 da_i / dt。
    
    由以下接口指定:
    
    getMeanElementRate 在接口 DSSTForceModel 中
    
    类型参数:
    
    T - 元素的类型
    
    参数:
    
    spacecraftState - 当前状态信息：日期、运动学、姿态
    
    auxiliaryElements - 与当前轨道相关的辅助元素
    
    parameters - 状态日期的力模型参数值（每个参数驱动程序仅有1个跨度），例如通过在力模型上调用 ParameterDriversProvider.getParameters(Field, FieldAbsoluteDate) 获得，或者通过在梯度转换器上调用 AbstractGradientConverter.getParametersAtStateDate(FieldSpacecraftState, ParameterDriversProvider) 获得。
    
    返回:
    
    平均元素速率 dai/dt
  - registerAttitudeProvider
```
public void registerAttitudeProvider(AttitudeProvider attitudeProvider)
```
    注册姿态提供者。
    注册一个可以被力模型使用的姿态提供者。
    
    指定者为:
    
    registerAttitudeProvider 在接口 DSSTForceModel
    
    参数:
    
    attitudeProvider - AttitudeProvider
  - 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 - 平均状态信息：日期、运动学、姿态
  - getParametersDrivers
```
public List<ParameterDriver> getParametersDrivers()
```
    获取参数的驱动程序。
    
    指定者为:
    
    getParametersDrivers 在接口 ParameterDriversProvider
    
    返回:
    
    参数的驱动程序

Class DSSTZonal

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.propagation.semianalytical.dsst.forces.DSSTForceModel

Methods inherited from interface org.orekit.utils.ParameterDriversProvider

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

Field Detail

SHORT_PERIOD_PREFIX

Constructor Detail

DSSTZonal

DSSTZonal

Method Detail

getProvider

initializeShortPeriodTerms

initializeShortPeriodTerms

getMeanElementRate

getMeanElementRate

registerAttitudeProvider

updateShortPeriodTerms

updateShortPeriodTerms

getParametersDrivers