org.orekit.propagation.events

Class ElevationDetector

java.lang.Object

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

org.orekit.propagation.events.ElevationDetector

All Implemented Interfaces:

EventDetector

public class ElevationDetector
extends AbstractDetector<ElevationDetector>

卫星升降事件查找器，允许设置方位角和/或高度角限制或地面方位角/高度角掩模输入。每个计算都可以配置为使用大气折射。

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

Since:

6.1

Author:

Hank Grabowski

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	ElevationDetector(AdaptableInterval maxCheck, double threshold, int maxIter, EventHandler handler, double minElevation, ElevationMask mask, AtmosphericRefractionModel refractionModel, TopocentricFrame topo) 具有完整参数的受保护构造函数。
	ElevationDetector(double maxCheck, double threshold, TopocentricFrame topo) 基于传入的地心框架和默认最大检查间隔和收敛阈值值的重写创建高度检测器的实例。
	ElevationDetector(TopocentricFrame topo) 基于传入的地心框架和最小高度角创建高度检测器的实例。

Method Summary

Modifier and Type	Method and Description
protected ElevationDetector	create(AdaptableInterval newMaxCheck, double newThreshold, int newMaxIter, EventHandler newHandler) 构建一个新实例。
double	g(SpacecraftState s) 计算切换函数的值。
ElevationMask	getElevationMask() 返回当前配置的高度掩模。
double	getMinElevation() 返回当前配置的最小有效高度值。
AtmosphericRefractionModel	getRefractionModel() 返回当前配置的折射模型。
TopocentricFrame	getTopocentricFrame() 返回当前配置的地心框架定义。
ElevationDetector	withConstantElevation(double newMinElevation) 设置检测的最小高度。
ElevationDetector	withElevationMask(ElevationMask newElevationMask) 使用传入的掩模对象设置检测的高度掩模。
ElevationDetector	withRefraction(AtmosphericRefractionModel newRefractionModel) 设置高度检测器在计算中使用大气折射模型。

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

ElevationDetector

public ElevationDetector(TopocentricFrame topo)

基于传入的地心框架和最小高度角创建高度检测器的实例。

使用默认值进行最大检查间隔(AbstractDetector.DEFAULT_MAXCHECK)和收敛阈值(AbstractDetector.DEFAULT_THRESHOLD)。

参数：

topo - 地心模型的引用

另请参阅：

withConstantElevation(double), withElevationMask(ElevationMask), withRefraction(AtmosphericRefractionModel)

ElevationDetector

public ElevationDetector(double maxCheck,
                         double threshold,
                         TopocentricFrame topo)

基于传入的地心框架和默认最大检查间隔和收敛阈值值的重写创建高度检测器的实例。

参数：

maxCheck - 最大检查间隔(s)

threshold - 收敛阈值(s)

topo - 地心模型的引用

另请参阅：

withConstantElevation(double), withElevationMask(ElevationMask), withRefraction(AtmosphericRefractionModel)

ElevationDetector

protected ElevationDetector(AdaptableInterval maxCheck,
                            double threshold,
                            int maxIter,
                            EventHandler handler,
                            double minElevation,
                            ElevationMask mask,
                            AtmosphericRefractionModel refractionModel,
                            TopocentricFrame topo)

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

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

参数：

maxCheck - 最大检查间隔

threshold - 收敛阈值(s)

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

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

minElevation - 以弧度(rad)表示的最小高度

mask - 高度掩模的引用

refractionModel - 折射模型的引用

topo - 地心模型的引用

Method Detail

create

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

构建一个新实例。

由：

create 在类 AbstractDetector<ElevationDetector>

参数：

newMaxCheck - 最大检查间隔(s)

newThreshold - 收敛阈值(s)

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

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

返回：

适当子类型的新实例

getElevationMask

public ElevationMask getElevationMask()

返回当前配置的高度掩模。

返回：

高度掩模（如果实例已配置为使用withConstantElevation(double)，则为null）

另请参阅：

withElevationMask(ElevationMask)

getMinElevation

public double getMinElevation()

返回当前配置的最小有效高度值。

返回：

最小高度值（如果实例已配置为使用withElevationMask(ElevationMask)，则为Double.NaN）

另请参阅：

withConstantElevation(double)

getRefractionModel

public AtmosphericRefractionModel getRefractionModel()

返回当前配置的折射模型。

返回：

折射模型

另请参阅：

withRefraction(AtmosphericRefractionModel)

getTopocentricFrame

public TopocentricFrame getTopocentricFrame()

返回当前配置的地心框架定义。

返回：

地心框架定义

g

public double g(SpacecraftState s)

计算切换函数的值。此函数测量当前高度（如果需要还包括方位角）与参考掩模或最小值之间的差异。

由：

g 在接口 EventDetector

由：

g 在类 AbstractDetector<ElevationDetector>

参数：

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

返回：

切换函数的值

withConstantElevation

public ElevationDetector withConstantElevation(double newMinElevation)

设置检测的最小高度。

如果之前已配置高度掩模，则将覆盖高度掩模。

参数：

newMinElevation - 可见性的最小高度，以弧度(rad)表示

返回：

具有更新配置的新检测器（实例未更改）

自：

6.1

另请参阅：

getMinElevation()

withElevationMask

public ElevationDetector withElevationMask(ElevationMask newElevationMask)

使用传入的掩模对象设置检测的高度掩模。

参数：

newElevationMask - 用于计算的高度掩模

返回：

具有更新配置的新检测器（实例未更改）

自：

6.1

另请参阅：

getElevationMask()

withRefraction

public ElevationDetector withRefraction(AtmosphericRefractionModel newRefractionModel)

设置高度检测器在计算中使用大气折射模型。

要在复制现有高度检测器时禁用折射，请调用此方法并使用null参数。

参数:

newRefractionModel - 用于计算的折射模型

返回:

具有更新配置的新探测器（实例未更改）

自版本:

6.1

另请参阅:

getRefractionModel()