org.orekit.propagation.analytical

Class AbstractAnalyticalMatricesHarvester

java.lang.Object

org.orekit.propagation.AbstractMatricesHarvester

org.orekit.propagation.analytical.AbstractAnalyticalMatricesHarvester

All Implemented Interfaces:

AdditionalStateProvider, MatricesHarvester

public abstract class AbstractAnalyticalMatricesHarvester
extends AbstractMatricesHarvester
implements AdditionalStateProvider

两维雅可比矩阵和解析轨道传播器之间的基类收割机。

Since:

11.1

Author:

Thomas Paulet, Bryan Cazabonne

Field Summary

Fields inherited from class org.orekit.propagation.AbstractMatricesHarvester

STATE_DIMENSION

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractAnalyticalMatricesHarvester(AbstractAnalyticalPropagator propagator, String stmName, org.hipparchus.linear.RealMatrix initialStm, DoubleArrayDictionary initialJacobianColumns) 简单构造函数。

Method Summary

Modifier and Type	Method and Description
void	freezeColumnsNames() 冻结雅可比列的名称。
double[]	getAdditionalState(SpacecraftState state) 获取额外状态。
abstract AbstractAnalyticalGradientConverter	getGradientConverter() 获取与解析轨道传播器相关的梯度转换器。
List<String>	getJacobiansColumnsNames() 获取由MatricesHarvester.getParametersJacobian(org.orekit.propagation.SpacecraftState)返回的矩阵中参数的名称。
String	getName() 获取额外状态的名称。
OrbitType	getOrbitType() 获取用于矩阵计算的轨道类型。
org.hipparchus.linear.RealMatrix	getParametersJacobian(SpacecraftState state) 获取相对于传播参数的雅可比矩阵。
PositionAngleType	getPositionAngleType() 获取用于矩阵计算的位置角。
org.hipparchus.linear.RealMatrix	getStateTransitionMatrix(SpacecraftState state) 从状态中提取状态转移矩阵。
void	setReferenceState(SpacecraftState reference) 设置参考状态。

Methods inherited from class org.orekit.propagation.AbstractMatricesHarvester

getConversionJacobian, getInitialJacobianColumn, getInitialStateTransitionMatrix, getStmName

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.AdditionalStateProvider

init, yields

Constructor Detail

AbstractAnalyticalMatricesHarvester

protected AbstractAnalyticalMatricesHarvester(AbstractAnalyticalPropagator propagator,
                                              String stmName,
                                              org.hipparchus.linear.RealMatrix initialStm,
                                              DoubleArrayDictionary initialJacobianColumns)

简单构造函数。

初始矩阵的参数必须与传播器将使用的轨道类型和位置角兼容

参数：

propagator - 与此收割机绑定的传播器

stmName - 状态转移矩阵状态名称

initialStm - 初始状态转移矩阵 ∂Y/∂Y₀，如果为null（这是最常见的情况），则假定为6x6单位矩阵

initialJacobianColumns - 相对于参数的雅可比矩阵的初始列，如果为null或字典中缺少某些选定的参数，则假定相应的初始列为0

Method Detail

getJacobiansColumnsNames

public List<String> getJacobiansColumnsNames()

获取由MatricesHarvester.getParametersJacobian(org.orekit.propagation.SpacecraftState)返回的矩阵中参数的名称。

请注意，只有在设置了所有力模型并正确选择了参数后，参数的名称才完全知晓。首先检索矩阵收割机并在开始传播之前选择力模型参数的应用程序必须注意等到参数设置好之后再调用此方法。过早调用该方法会返回错误的结果。

名称按照雅可比矩阵列的顺序返回

由以下指定：

getJacobiansColumnsNames 在接口 MatricesHarvester

返回：

雅可比矩阵参数（即列）的名称

freezeColumnsNames

public void freezeColumnsNames()

冻结雅可比列的名称。

此方法在传播开始时调用，即在配置完成时

由以下指定：

freezeColumnsNames 在类 AbstractMatricesHarvester

getName

public String getName()

获取额外状态的名称。

由以下指定：

getName 在接口 AdditionalStateProvider

返回：

额外状态的名称（包含任何大小写的“orekit”名称均保留供库内部使用）

getAdditionalState

public double[] getAdditionalState(SpacecraftState state)

获取额外状态。

由以下指定：

getAdditionalState 在接口 AdditionalStateProvider

参数：

state - 应对应于额外状态的航天器状态

返回：

与航天器状态对应的额外状态

getStateTransitionMatrix

public org.hipparchus.linear.RealMatrix getStateTransitionMatrix(SpacecraftState state)

从状态中提取状态转移矩阵。

由以下指定：

getStateTransitionMatrix 在接口 MatricesHarvester

覆盖：

getStateTransitionMatrix 在类 AbstractMatricesHarvester

参数：

state - 航天器状态

返回：

状态转移矩阵，其语义与传播一致，如果没有状态转移矩阵可用，则返回null 轨道类型。

getParametersJacobian

public org.hipparchus.linear.RealMatrix getParametersJacobian(SpacecraftState state)

获取相对于传播参数的雅可比矩阵。

由以下指定：

getParametersJacobian 在接口 MatricesHarvester

覆盖：

getParametersJacobian 在类 AbstractMatricesHarvester

参数：

state - 航天器状态

返回：

相对于传播参数的雅可比矩阵，如果没有参数，则返回null

setReferenceState

public void setReferenceState(SpacecraftState reference)

设置参考状态。

每当全局传播参考状态更改时，将调用此方法。这对应于批量最小二乘轨道确定中的传播开始，或者在卡尔曼滤波中每个测量的预测步骤。其目标是允许收割机计算一些内部数据。像TLE这样的解析模型用它来计算解析导数，DSST这样的半解析模型用它来计算短周期项，数值模型根本不使用它。

由以下指定：

setReferenceState 在接口 MatricesHarvester

覆盖：

setReferenceState 在类 AbstractMatricesHarvester

参数：

reference - 要设置的参考状态

getOrbitType

public OrbitType getOrbitType()

获取用于矩阵计算的轨道类型。

由以下指定：

getOrbitType 在接口 MatricesHarvester

返回：

用于矩阵计算的轨道类型

getPositionAngleType

public PositionAngleType getPositionAngleType()

获取用于矩阵计算的位置角。

如果MatricesHarvester.getOrbitType()返回OrbitType.CARTESIAN，则无关紧要。

由以下指定：

getPositionAngleType 在接口 MatricesHarvester

返回：

用于矩阵计算的位置角

getGradientConverter

public abstract AbstractAnalyticalGradientConverter getGradientConverter()

获取与解析轨道传播器相关的梯度转换器。

返回：

梯度转换器