org.orekit.propagation.events

Class FieldAltitudeDetector<T extends org.hipparchus.CalculusFieldElement<T>>

java.lang.Object

org.orekit.propagation.events.FieldAbstractDetector<FieldAltitudeDetector<T>,T>

org.orekit.propagation.events.FieldAltitudeDetector<T>

Type Parameters:

T - type of the field elements

All Implemented Interfaces:

FieldEventDetector<T>

public class FieldAltitudeDetector<T extends org.hipparchus.CalculusFieldElement<T>>
extends FieldAbstractDetector<FieldAltitudeDetector<T>,T>

卫星高度交叉事件查找器。

此类查找高度事件（即卫星穿越地面上预定义高度水平线）。

默认实现行为是在升高时继续传播，在下降时停止传播。可以在构造后调用FieldAbstractDetector.withHandler(FieldEventHandler)来更改此行为。

Since:

9.0

Author:

Luc Maisonobe

See Also:

FieldPropagator.addEventDetector(FieldEventDetector)

Field Summary

Fields inherited from class org.orekit.propagation.events.FieldAbstractDetector

DEFAULT_MAX_ITER, DEFAULT_MAXCHECK, DEFAULT_THRESHOLD

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	FieldAltitudeDetector(FieldAdaptableInterval<T> maxCheck, T threshold, int maxIter, FieldEventHandler<T> handler, T altitude, BodyShape bodyShape) 具有完整参数的受保护构造函数。
	FieldAltitudeDetector(T altitude, BodyShape bodyShape) 构建一个新的高度检测器。
	FieldAltitudeDetector(T maxCheck, T altitude, BodyShape bodyShape) 构建一个新的高度检测器。
	FieldAltitudeDetector(T maxCheck, T threshold, T altitude, BodyShape bodyShape) 构建一个新的高度检测器。

Method Summary

Modifier and Type	Method and Description
protected FieldAltitudeDetector<T>	create(FieldAdaptableInterval<T> newMaxCheck, T newThreshold, int newMaxIter, FieldEventHandler<T> newHandler) 构建一个新实例。
T	g(FieldSpacecraftState<T> s) 计算切换函数的值。
T	getAltitude() 获取阈值高度值。
BodyShape	getBodyShape() 获取天体形状。

Methods inherited from class org.orekit.propagation.events.FieldAbstractDetector

getHandler, getMaxCheckInterval, getMaxIterationCount, getThreshold, init, isForward, withHandler, withMaxCheck, withMaxCheck, withMaxIter, withThreshold

Methods inherited from class java.lang.Object

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

Constructor Detail

FieldAltitudeDetector

public FieldAltitudeDetector(T altitude,
                             BodyShape bodyShape)

构建一个新的高度检测器。

此简单构造函数采用最大检查间隔的默认值（FieldAbstractDetector.DEFAULT_MAXCHECK）和收敛阈值的默认值（FieldAbstractDetector.DEFAULT_THRESHOLD）。

参数：

altitude - 阈值高度值

bodyShape - 用于评估高度的天体形状

FieldAltitudeDetector

public FieldAltitudeDetector(T maxCheck,
                             T altitude,
                             BodyShape bodyShape)

构建一个新的高度检测器。

此简单构造函数采用收敛阈值的默认值（FieldAbstractDetector.DEFAULT_THRESHOLD）。

高度检查之间的最大间隔应小于要处理的最小通行时间的一半，否则可能会错过一些短通行。

参数：

maxCheck - 最大检查间隔（秒）

altitude - 阈值高度值（米）

bodyShape - 用于评估高度的天体形状

FieldAltitudeDetector

public FieldAltitudeDetector(T maxCheck,
                             T threshold,
                             T altitude,
                             BodyShape bodyShape)

构建一个新的高度检测器。

高度检查之间的最大间隔应小于要处理的最小通行时间的一半，否则可能会错过一些短通行。

高度检查之间的最大间隔应小于要处理的最小通行时间的一半，否则可能会错过一些短通行。

参数：

maxCheck - 最大检查间隔（秒）

threshold - 收敛阈值（秒）

altitude - 阈值高度值（米）

bodyShape - 用于评估高度的天体形状

FieldAltitudeDetector

protected FieldAltitudeDetector(FieldAdaptableInterval<T> maxCheck,
                                T threshold,
                                int maxIter,
                                FieldEventHandler<T> handler,
                                T altitude,
                                BodyShape bodyShape)

具有完整参数的受保护构造函数。

此构造函数不是公共的，因为预期用户将使用建造者API和各种withXxx()方法来设置实例，以便以可读的方式设置实例，而不使用大量参数。

参数：

maxCheck - 最大检查间隔

threshold - 收敛阈值（秒）

maxIter - 事件时间搜索中的最大迭代次数

handler - 事件发生时要调用的事件处理程序

altitude - 阈值高度值（米）

bodyShape - 用于评估高度的天体形状

自版本：

6.1

Method Detail

create

protected FieldAltitudeDetector<T> create(FieldAdaptableInterval<T> newMaxCheck,
                                          T newThreshold,
                                          int newMaxIter,
                                          FieldEventHandler<T> newHandler)

构建一个新实例。

指定者：

create 在类中 FieldAbstractDetector<FieldAltitudeDetector<T extends org.hipparchus.CalculusFieldElement<T>>,T extends org.hipparchus.CalculusFieldElement<T>>

参数：

newMaxCheck - 最大检查间隔

newThreshold - 收敛阈值（秒）

newMaxIter - 事件时间搜索中的最大迭代次数

newHandler - 事件发生时要调用的事件处理程序

返回：

适当子类型的新实例

getAltitude

public T getAltitude()

获取阈值高度值。

返回：

阈值高度值（米）

getBodyShape

public BodyShape getBodyShape()

获取天体形状。

返回：

天体形状

g

public T g(FieldSpacecraftState<T> s)

计算切换函数的值。此函数衡量当前高度与阈值高度之间的差异。

指定者：

g 在接口中 FieldEventDetector<T extends org.hipparchus.CalculusFieldElement<T>>

指定者：

g 在类中 FieldAbstractDetector<FieldAltitudeDetector<T extends org.hipparchus.CalculusFieldElement<T>>,T extends org.hipparchus.CalculusFieldElement<T>>

参数：

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

返回：

切换函数的值