org.orekit.propagation.events

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

java.lang.Object

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

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

Type Parameters:

T - type of the field element

All Implemented Interfaces:

FieldEventDetector<T>

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

针对地面点的高程极值探测器。

该探测器标识了当飞船达到相对于地面点的高程极值时。

由于在大多数情况下只需要高程的最大值，而最小值通常是无关紧要的，因此这个探测器通常被包装在一个配置了事件斜率过滤器中，该过滤器配置了FilterType.TRIGGER_ONLY_DECREASING_EVENTS（即当高程导数从正值减少到负值时，对应于最大值）。设置这个过滤器可以节省一些计算时间，因为甚至不需要查看高程的最小值出现。然而，通常仍然需要进行额外的过滤。

Since:

12.0

Author:

Luc Maisonobe

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
	FieldElevationExtremumDetector(org.hipparchus.Field<T> field, TopocentricFrame topo) 构建一个新的探测器。
protected	FieldElevationExtremumDetector(FieldAdaptableInterval<T> maxCheck, T threshold, int maxIter, FieldEventHandler<T> handler, TopocentricFrame topo) 具有完整参数的受保护构造函数。
	FieldElevationExtremumDetector(T maxCheck, T threshold, TopocentricFrame topo) 构建一个探测器。

Method Summary

Modifier and Type	Method and Description
protected FieldElevationExtremumDetector<T>	create(FieldAdaptableInterval<T> newMaxCheck, T newThreshold, int newMaxIter, FieldEventHandler<T> newHandler) 构建一个新实例。
T	g(FieldSpacecraftState<T> s) 计算检测函数的值。
T	getElevation(FieldSpacecraftState<T> s) 获取高程值。
TopocentricFrame	getTopocentricFrame() 返回以地面点为中心的地心坐标系。

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

FieldElevationExtremumDetector

public FieldElevationExtremumDetector(org.hipparchus.Field<T> field,
                                      TopocentricFrame topo)

构建一个新的探测器。

新实例使用最大检查间隔（FieldAbstractDetector.DEFAULT_MAXCHECK）和收敛阈值（FieldAbstractDetector.DEFAULT_THRESHOLD）的默认值。

参数：

field - 元素所属的域

topo - 以地面点为中心的地心坐标系

FieldElevationExtremumDetector

public FieldElevationExtremumDetector(T maxCheck,
                                      T threshold,
                                      TopocentricFrame topo)

构建一个探测器。

参数：

maxCheck - 最大检查间隔（秒）

threshold - 收敛阈值（秒）

topo - 以地面点为中心的地心坐标系

FieldElevationExtremumDetector

protected FieldElevationExtremumDetector(FieldAdaptableInterval<T> maxCheck,
                                         T threshold,
                                         int maxIter,
                                         FieldEventHandler<T> handler,
                                         TopocentricFrame topo)

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

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

参数：

maxCheck - 最大检查间隔

threshold - 收敛阈值（秒）

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

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

topo - 以地面点为中心的地心坐标系

Method Detail

create

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

构建一个新实例。

由以下指定：

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

参数：

newMaxCheck - 最大检查间隔

newThreshold - 收敛阈值（秒）

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

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

返回：

适当子类型的新实例

getTopocentricFrame

public TopocentricFrame getTopocentricFrame()

返回以地面点为中心的地心坐标系。

返回：

以地面点为中心的地心坐标系

getElevation

public T getElevation(FieldSpacecraftState<T> s)

获取高程值。

参数：

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

返回：

飞船高程

g

public T g(FieldSpacecraftState<T> s)

计算检测函数的值。

该值是飞船高程的一阶导数。

由以下指定：

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

由以下指定：

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

参数：

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

返回：

飞船高程的一阶导数