BatchLSEstimator (OREKIT 12.0.1 API)

java.lang.Object
- org.orekit.estimation.leastsquares.BatchLSEstimator

Direct Known Subclasses:

SequentialBatchLSEstimator
```
public class BatchLSEstimator
extends Object
```
轨道确定的最小二乘估计器。
最小二乘估计器可以与Orekit中的不同轨道传播器一起使用。当前传播器列表包括可用的传播器：numerical、DSST、Brouwer-Lyddane、Eckstein-Hechler、SGP4、Keplerian和ephemeris-based。

Since:

8.0

Author:

Luc Maisonobe

Constructor Summary

Constructors
Constructor and Description
`BatchLSEstimator(org.hipparchus.optim.nonlinear.vector.leastsquares.LeastSquaresOptimizer optimizer, PropagatorBuilder... propagatorBuilder)` 简单构造函数。

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addMeasurement(ObservedMeasurement<?> measurement)` 添加一个测量。
`Propagator[]`	`estimate()` 估计轨道、传播和测量参数。
`int`	`getEvaluationsCount()` 获取上次估计中使用的评估次数。
`int`	`getIterationsCount()` 获取上次估计中使用的迭代次数。
`Map<ObservedMeasurement<?>,EstimatedMeasurement<?>>`	`getLastEstimations()` 获取执行的最后一次估计。
`ParameterDriversList`	`getMeasurementsParametersDrivers(boolean estimatedOnly)` 获取此估计器支持的测量参数（包括测量和修饰器）。
`org.hipparchus.optim.nonlinear.vector.leastsquares.LeastSquaresOptimizer.Optimum`	`getOptimum()` 获取找到的最佳值。
`ParameterDriversList`	`getOrbitalParametersDrivers(boolean estimatedOnly)` 获取此估计器支持的轨道参数。
`org.hipparchus.linear.RealMatrix`	`getPhysicalCovariances(double threshold)` 获取空间飞行动力学中的协方差矩阵。
`ParameterDriversList`	`getPropagatorParametersDrivers(boolean estimatedOnly)` 获取此估计器支持的传播器参数。
`void`	`setConvergenceChecker(org.hipparchus.optim.ConvergenceChecker<org.hipparchus.optim.nonlinear.vector.leastsquares.LeastSquaresProblem.Evaluation> convergenceChecker)` 设置自定义收敛检查器。
`void`	`setMaxEvaluations(int maxEvaluations)` 设置模型评估的最大次数。
`void`	`setMaxIterations(int maxIterations)` 设置最大迭代次数。
`void`	`setObserver(BatchLSObserver observer)` 设置迭代的观察者。
`void`	`setParametersConvergenceThreshold(double parametersConvergenceThreshold)` 设置收敛阈值。

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

- Constructor Detail
  - BatchLSEstimator
```
public BatchLSEstimator(org.hipparchus.optim.nonlinear.vector.leastsquares.LeastSquaresOptimizer optimizer,
                        PropagatorBuilder... propagatorBuilder)
```
    简单构造函数。
    如果设置了多个传播器构建器，则将同时使用多个航天器的轨道。如果传播器共享某些模型或测量参数（通常是极移、本初子午线校正或地面站位置），这将非常有用。
    
    设置多个传播器构建器在使用星间测量时也很有用，即使只估计一个轨道，其他轨道也是固定的。这通常用于需要非常高精度的GNSS测量，导航公告不够准确，导航星座必须进行数值传播。
    
    参数：
    
    optimizer - 最小二乘问题的求解器
    
    propagatorBuilder - 用于传播的构建器
- Method Detail
  - setObserver
```
public void setObserver(BatchLSObserver observer)
```
    设置迭代的观察者。
    
    参数：
    
    observer - 每次迭代结束时要通知的观察者
  - addMeasurement
```
public void addMeasurement(ObservedMeasurement<?> measurement)
```
    添加一个测量。
    
    参数：
    
    measurement - 要添加的测量
  - setMaxIterations
```
public void setMaxIterations(int maxIterations)
```
    设置最大迭代次数。
    迭代次数对应于最小二乘优化器的顶层迭代。
    
    参数：
    
    maxIterations - 最大迭代次数
    
    另请参阅：
    
    setMaxEvaluations(int)、getIterationsCount()
  - setMaxEvaluations
```
public void setMaxEvaluations(int maxEvaluations)
```
    设置模型评估的最大次数。
    评估对应于使用一组估计参数执行的轨道传播和测量估计。
    
    对于Gauss-Newton优化器，每次迭代都有一个评估，因此最大次数可以设置为相同的值。对于Levenberg-Marquardt优化器，在某些迭代中可能有几次评估（通常是前几次迭代），因此最大评估次数可以设置为比最大迭代次数更高的值。
    
    参数：
    
    maxEvaluations - 模型评估的最大次数
    
    另请参阅：
    
    setMaxIterations(int)、getEvaluationsCount()
  - getOrbitalParametersDrivers
```
public ParameterDriversList getOrbitalParametersDrivers(boolean estimatedOnly)
```
    获取此估计器支持的轨道参数。
    如果有多个传播器构建器，则驱动程序的名称将附加在方括号中的索引标记后面，以区分各个轨道。因此，例如，如果一个构建器生成Kepler轨道，则名称将简单地是"a"、"e"、"i"...但如果有几个构建器，则名称将是"a[0]"、"e[0]"、"i[0]"..."a[1]"、"e[1]"、"i[1]"...
    
    参数：
    
    estimatedOnly - 如果为true，则仅返回估计参数
    
    返回：
    
    此估计器支持的轨道参数
  - getPropagatorParametersDrivers
```
public ParameterDriversList getPropagatorParametersDrivers(boolean estimatedOnly)
```
    获取此估计器支持的传播器参数。
    
    参数：
    
    estimatedOnly - 如果为true，则仅返回估计参数
    
    返回：
    
    此估计器支持的传播器参数
  - getMeasurementsParametersDrivers
```
public ParameterDriversList getMeasurementsParametersDrivers(boolean estimatedOnly)
```
    获取此估计器支持的测量参数（包括测量和修饰器）。
    
    参数：
    
    estimatedOnly - 如果为true，则仅返回估计参数
    
    返回：
    
    此估计器支持的测量参数
  - setParametersConvergenceThreshold
```
public void setParametersConvergenceThreshold(double parametersConvergenceThreshold)
```
    设置收敛阈值。
    用于估计的收敛基于估计参数的归一化值。当所有参数的前后归一化值之差小于所有参数的收敛阈值时，认为已达到收敛。由于参数是归一化的，因此对所有参数使用相同的值。
    
    归一化值计算为(current - reference)/scale，因此当对所有估计参数都满足以下条件时，即认为已达到收敛：|current[i] - previous[i]| <= threshold * scale[i]
    
    因此，在此处指定的收敛阈值可以视为应用于比例的乘法因子。由于所有参数的比例通常很小（例如，轨道位置通常约为1米），因此阈值不应太小。10⁻³的值通常相当准确。
    
    调用此方法会覆盖之前通过调用setConvergenceChecker(ConvergenceChecker)设置的任何检查器。这两种方法是互斥的。
    
    参数：
    
    parametersConvergenceThreshold - 归一化参数（无量纲，与参数比例有关）的收敛阈值
    
    另请参阅：
    
    setConvergenceChecker(ConvergenceChecker)、EvaluationRmsChecker
  - setConvergenceChecker
```
public void setConvergenceChecker(org.hipparchus.optim.ConvergenceChecker<org.hipparchus.optim.nonlinear.vector.leastsquares.LeastSquaresProblem.Evaluation> convergenceChecker)
```
    设置自定义收敛检查器。
    调用此方法会覆盖之前通过调用setParametersConvergenceThreshold(double)设置的任何检查器。这两种方法是互斥的。
    
    参数：
    
    convergenceChecker - 要设置的收敛检查器
    
    自从：
    
    10.1
    
    另请参阅：
    
    setParametersConvergenceThreshold(double)
  - estimate
```
public Propagator[] estimate()
```
    估算轨道、传播和测量参数。
    在调用此方法之前，必须使用getOrbitalParametersDrivers(boolean)、getPropagatorParametersDrivers(boolean)和getMeasurementsParametersDrivers(boolean)设置所有参数的初始猜测，然后通过设置参数的值。
    
    对于参考日期尚未在调用此方法之前设置为非空日期的参数（即ParameterDriver.getReferenceDate()返回null的参数），将自动在估算开始时将默认参考日期设置为第一个传播器构建器的初始轨道日期。对于参考日期已设置为非空日期的参数，此参考日期保持不变。
    
    此方法返回后，可以使用getOrbitalParametersDrivers(boolean)、getPropagatorParametersDrivers(boolean)和getMeasurementsParametersDrivers(boolean)然后通过获取参数的值检索估算的参数。
    
    作为便利，该方法还返回一个完全配置好且准备好使用的传播器，其中包含所有估算值。
    
    要获取更详细的信息，getOptimum()方法提供详细元素（协方差矩阵、估算参数标准差、加权雅可比、RMS、χ²、残差等）。
    
    返回：
    
    配置了估算轨道作为初始状态的传播器，以及设置了所有传播器估算参数
  - getLastEstimations
```
public Map<ObservedMeasurement<?>,EstimatedMeasurement<?>> getLastEstimations()
```
    获取执行的最后一次估算。
    
    返回：
    
    执行的最后一次估算
  - getOptimum
```
public org.hipparchus.optim.nonlinear.vector.leastsquares.LeastSquaresOptimizer.Optimum getOptimum()
```
    获取找到的最优解。
    LeastSquaresOptimizer.Optimum对象包含详细元素（协方差矩阵、估算参数标准差、加权雅可比、RMS、χ²、残差等）。
    
    请注意，返回的对象是底层数学库的原始视图。在这个原始级别上，参数具有归一化值，而航天飞行参数具有物理值及其单位。因此，在使用这些元素时需要应用缩放因子。
    
    返回：
    
    在上次调用estimate()后找到的最优解
  - getPhysicalCovariances
```
public org.hipparchus.linear.RealMatrix getPhysicalCovariances(double threshold)
```
    获取航天动力学物理单位中的协方差矩阵。
    此方法从[@link optimum中检索covariances并对其应用缩放因子，以将其从原始归一化值转换回物理值。
    
    参数：
    
    threshold - 用于识别矩阵奇异性的阈值
    
    返回：
    
    航天动力学物理单位中的协方差矩阵
    
    自版本：
    
    9.1
  - getIterationsCount
```
public int getIterationsCount()
```
    获取上次估算使用的迭代次数。
    
    返回：
    
    上次估算使用的迭代次数
    
    另请参阅：
    
    setMaxIterations(int)
  - getEvaluationsCount
```
public int getEvaluationsCount()
```
    获取上次估算使用的评估次数。
    
    返回：
    
    上次估算使用的评估次数
    
    另请参阅：
    
    setMaxEvaluations(int)

Class BatchLSEstimator

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

BatchLSEstimator

Method Detail

setObserver

addMeasurement

setMaxIterations

setMaxEvaluations

getOrbitalParametersDrivers

getPropagatorParametersDrivers

getMeasurementsParametersDrivers

setParametersConvergenceThreshold

setConvergenceChecker

estimate

getLastEstimations

getOptimum

getPhysicalCovariances

getIterationsCount

getEvaluationsCount