org.orekit.propagation.events

Class AltitudeDetector

java.lang.Object

org.orekit.propagation.events.AbstractDetector<AltitudeDetector>

org.orekit.propagation.events.AltitudeDetector

All Implemented Interfaces:

EventDetector

public class AltitudeDetector
extends AbstractDetector<AltitudeDetector>

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

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

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

Author:

Luc Maisonobe

See Also:

Propagator.addEventDetector(EventDetector)

Field Summary

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

DEFAULT_MAX_ITER, DEFAULT_MAXCHECK, DEFAULT_THRESHOLD

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AltitudeDetector(AdaptableInterval maxCheck, double threshold, int maxIter, EventHandler handler, double altitude, BodyShape bodyShape) 全参数保护构造函数。
	AltitudeDetector(double altitude, BodyShape bodyShape) 构建一个新的高度检测器。
	AltitudeDetector(double maxCheck, double altitude, BodyShape bodyShape) 构建一个新的高度检测器。
	AltitudeDetector(double maxCheck, double threshold, double altitude, BodyShape bodyShape) 构建一个新的高度检测器。

Method Summary

Modifier and Type	Method and Description
protected AltitudeDetector	create(AdaptableInterval newMaxCheck, double newThreshold, int newMaxIter, EventHandler newHandler) 构建一个新实例。
double	g(SpacecraftState s) 计算切换函数的值。
double	getAltitude() 获取阈值高度值。
BodyShape	getBodyShape() 获取天体形状。

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

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

AltitudeDetector

public AltitudeDetector(double altitude,
                        BodyShape bodyShape)

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

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

参数：

altitude - 阈值高度值

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

AltitudeDetector

public AltitudeDetector(double maxCheck,
                        double altitude,
                        BodyShape bodyShape)

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

这个简单构造函数采用了收敛阈值的默认值（AbstractDetector.DEFAULT_THRESHOLD）。

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

参数：

maxCheck - 最大检查间隔（秒）

altitude - 阈值高度值（米）

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

AltitudeDetector

public AltitudeDetector(double maxCheck,
                        double threshold,
                        double altitude,
                        BodyShape bodyShape)

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

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

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

参数：

maxCheck - 最大检查间隔（秒）

threshold - 收敛阈值（秒）

altitude - 阈值高度值（米）

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

AltitudeDetector

protected AltitudeDetector(AdaptableInterval maxCheck,
                           double threshold,
                           int maxIter,
                           EventHandler handler,
                           double altitude,
                           BodyShape bodyShape)

全参数保护构造函数。

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

参数：

maxCheck - 最大检查间隔

threshold - 收敛阈值（秒）

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

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

altitude - 阈值高度值（米）

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

自版本：

6.1

Method Detail

create

protected AltitudeDetector create(AdaptableInterval newMaxCheck,
                                  double newThreshold,
                                  int newMaxIter,
                                  EventHandler newHandler)

构建一个新实例。

由以下指定：

create 在类 AbstractDetector<AltitudeDetector>

参数：

newMaxCheck - 最大检查间隔（秒）

newThreshold - 收敛阈值（秒）

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

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

返回：

适当子类型的新实例

getAltitude

public double getAltitude()

获取阈值高度值。

返回：

阈值高度值（米）

getBodyShape

public BodyShape getBodyShape()

获取天体形状。

返回：

天体形状

g

public double g(SpacecraftState s)

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

由以下指定：

g 在接口 EventDetector

由以下指定：

g 在类 AbstractDetector<AltitudeDetector>

参数：

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

返回：

切换函数的值