StateCovarianceMatrixProvider (OREKIT 12.0.1 API)

java.lang.Object
- org.orekit.propagation.StateCovarianceMatrixProvider

All Implemented Interfaces:

AdditionalStateProvider
```
public class StateCovarianceMatrixProvider
extends Object
implements AdditionalStateProvider
```
状态协方差矩阵的额外状态提供者。
此额外状态提供者允许基于用户定义的输入状态协方差矩阵计算传播的协方差矩阵。传播的协方差矩阵的计算使用传播的航天器状态和初始状态之间的状态转移矩阵。因此，用户必须定义提供者的名称用于状态转移矩阵的名称。

由于状态转移矩阵和输入状态协方差矩阵可以用不同的轨道类型表示，因此在构建协方差提供者时，用户必须指定两种轨道类型。此外，还必须指定两个矩阵中使用的位置角。

为了将此额外状态提供者添加到轨道传播器中，用户必须使用Propagator.addAdditionalStateProvider(AdditionalStateProvider)方法。

对于给定的传播的航天器state，通过方法getStateCovariance(SpacecraftState)可以访问传播的状态协方差矩阵。

Since:

11.3

Author:

Bryan Cazabonne, Vincent Cucchietti

Constructor Summary

Constructors
Constructor and Description
`StateCovarianceMatrixProvider(String additionalName, String stmName, MatricesHarvester harvester, StateCovariance covInit)` 构造函数。

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`double[]`	`getAdditionalState(SpacecraftState state)` 获取额外状态。
`OrbitType`	`getCovarianceOrbitType()` 获取协方差矩阵所表示的轨道类型。
`String`	`getName()` 获取额外状态的名称。
`StateCovariance`	`getStateCovariance(SpacecraftState state)` 获取与初始协方差相同的帧/局部轨道帧、轨道类型和位置角中的状态协方差。
`StateCovariance`	`getStateCovariance(SpacecraftState state, Frame frame)` 获取在给定帧中表示的状态协方差。
`StateCovariance`	`getStateCovariance(SpacecraftState state, OrbitType orbitType, PositionAngleType angleType)` 获取在给定轨道类型中表示的状态协方差。
`void`	`init(SpacecraftState initialState, AbsoluteDate target)` 在传播开始时初始化额外状态提供者。
`boolean`	`yields(SpacecraftState state)` 检查此提供者是否应该放弃，以便另一个提供者有机会添加缺失的部分。

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

- Constructor Detail
  - StateCovarianceMatrixProvider
```
public StateCovarianceMatrixProvider(String additionalName,
                                     String stmName,
                                     MatricesHarvester harvester,
                                     StateCovariance covInit)
```
    构造函数。
    
    参数：
    
    additionalName - 额外状态的名称
    
    stmName - 状态转移矩阵的名称
    
    harvester - 由propagator.setupMatricesComputation(stmName, null, null)返回的矩阵收集器
    
    covInit - 初始状态协方差
- Method Detail
  - getName
```
public String getName()
```
    获取额外状态的名称。
    
    由以下指定：
    
    getName 在接口 AdditionalStateProvider
    
    返回：
    
    额外状态的名称（包含"orekit"的名称，不区分大小写，保留供库内部使用）
  - init
```
public void init(SpacecraftState initialState,
                 AbsoluteDate target)
```
    在传播开始时初始化额外状态提供者。
    
    由以下指定：
    
    init 在接口 AdditionalStateProvider
    
    参数：
    
    initialState - 传播开始时的初始状态信息
    
    target - 传播的日期
  - yields
```
public boolean yields(SpacecraftState state)
```
    检查此提供者是否应该放弃，以便另一个提供者有机会添加缺失的部分。
    放弃的决定通常基于提供的state中是否已经有额外状态（但从理论上讲，也可能取决于额外状态导数是否已经可用，或任何其他标准）。例如，如果提供者需要状态转移矩阵，则可以将此方法实现为：
```
 public boolean yields(final SpacecraftState state) {
     return !state.getAdditionalStates().containsKey("STM");
 }
 
```
    默认实现返回false，这意味着状态数据可以立即生成。
    
    只有在状态转移矩阵状态可用时才能计算协方差矩阵。
    由以下指定：
    
    yields 在接口 AdditionalStateProvider
    
    参数：
    
    state - 要处理的状态
    
    返回：
    
    如果此提供者应该放弃，以便另一个提供者有机会添加缺失的部分，因为状态是逐步构建的，则返回true
  - getAdditionalState
```
public double[] getAdditionalState(SpacecraftState state)
```
    获取额外状态。
    
    由以下指定：
    
    getAdditionalState 在接口 AdditionalStateProvider
    
    参数：
    
    state - 需要对应额外状态的航天器状态
    
    返回：
    
    与航天器状态对应的额外状态
  - getCovarianceOrbitType
```
public OrbitType getCovarianceOrbitType()
```
    获取协方差矩阵所表示的轨道类型。
    
    返回：
    
    轨道类型
  - getStateCovariance
```
public StateCovariance getStateCovariance(SpacecraftState state)
```
    获取与初始协方差相同的帧/局部轨道帧、轨道类型和位置角中的状态协方差。
    
    参数：
    
    state - 需要对应协方差矩阵的航天器状态
    
    返回：
    
    状态协方差
    
    另请参阅：
    
    getStateCovariance(SpacecraftState, Frame)，getStateCovariance(SpacecraftState, OrbitType, PositionAngleType)
  - getStateCovariance
```
public StateCovariance getStateCovariance(SpacecraftState state,
                                          Frame frame)
```
    获取在给定帧中表示的状态协方差。
    输出的协方差矩阵以与getCovarianceOrbitType()相同的轨道类型表示。
    
    参数：
    
    state - 需要对应协方差矩阵的航天器状态
    
    frame - 输出帧，输出协方差矩阵必须表示在该帧中（必须是惯性的）
    
    返回：
    
    在frame中表示的状态协方差
    
    另请参阅：
    
    getStateCovariance(SpacecraftState)，getStateCovariance(SpacecraftState, OrbitType, PositionAngleType)
  - getStateCovariance
```
public StateCovariance getStateCovariance(SpacecraftState state,
                                          OrbitType orbitType,
                                          PositionAngleType angleType)
```
    获取在给定轨道类型中表示的状态协方差。
    
    参数：
    
    state - 需要对应协方差矩阵的航天器状态
    
    orbitType - 输出轨道类型
    
    angleType - 输出位置角（如果轨道类型等于CARTESIAN则不使用）
    
    返回：
    
    在orbitType和angleType中的状态协方差
    
    另请参阅：
    
    getStateCovariance(SpacecraftState)，getStateCovariance(SpacecraftState, Frame)

Class StateCovarianceMatrixProvider

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

StateCovarianceMatrixProvider

Method Detail

getName

init

yields

getAdditionalState

getCovarianceOrbitType

getStateCovariance

getStateCovariance

getStateCovariance