org.orekit.propagation.events

Class NodeDetector

java.lang.Object

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

org.orekit.propagation.events.NodeDetector

All Implemented Interfaces:

EventDetector

public class NodeDetector
extends AbstractDetector<NodeDetector>

节点交叉事件查找器。

此类查找赤道交叉事件（即升降交点）。

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

请注意，对于几乎赤道轨道，节点检测将失败。例如，如果节点检测器用于触发一个ImpulseManeuver，并且机动将轨道平面转向赤道，则检测器可能在执行机动后完全失败！这是一个在验证过程中遇到的真实案例...

Author:

Luc Maisonobe

See Also:

Propagator.addEventDetector(EventDetector)

Field Summary

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

DEFAULT_MAX_ITER, DEFAULT_MAXCHECK

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	NodeDetector(AdaptableInterval maxCheck, double threshold, int maxIter, EventHandler handler, Frame frame) 具有完整参数的受保护构造函数。
	NodeDetector(double threshold, Orbit orbit, Frame frame) 构建一个新实例。
	NodeDetector(Frame frame) 构建一个新实例。
	NodeDetector(Orbit orbit, Frame frame) 构建一个新实例。

Method Summary

Modifier and Type	Method and Description
protected NodeDetector	create(AdaptableInterval newMaxCheck, double newThreshold, int newMaxIter, EventHandler newHandler) 构建一个新实例。
double	g(SpacecraftState s) 计算切换函数的值。
Frame	getFrame() 获取定义赤道的参考系。

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

NodeDetector

public NodeDetector(Frame frame)

构建一个新实例。

默认的最大检查间隔设置为1800秒，可以使用流畅API中的AbstractDetector.withMaxCheck(double)进行更改。默认的收敛阈值设置为1.0e-3秒，可以使用流畅API中的AbstractDetector.withThreshold(double)进行更改。

参数：

frame - 定义赤道的参考系（典型值为EME2000或ITRF）

自版本：

10.3

NodeDetector

public NodeDetector(Orbit orbit,
                    Frame frame)

构建一个新实例。

轨道仅用于将最大检查间隔的上限设置为与节点分离相关的值（由开普勒模型计算），并根据轨道大小设置收敛阈值。

参数：

orbit - 初始轨道

frame - 定义赤道的参考系（典型值为EME2000或ITRF）

NodeDetector

public NodeDetector(double threshold,
                    Orbit orbit,
                    Frame frame)

构建一个新实例。

轨道仅用于将最大检查间隔的上限设置为与节点分离相关的值（由开普勒模型计算）。

参数：

threshold - 收敛阈值（秒）

orbit - 初始轨道

frame - 定义赤道的参考系（典型值为EME2000或ITRF）

NodeDetector

protected NodeDetector(AdaptableInterval maxCheck,
                       double threshold,
                       int maxIter,
                       EventHandler handler,
                       Frame frame)

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

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

参数：

maxCheck - 最大检查间隔

threshold - 收敛阈值（秒）

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

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

frame - 定义赤道的参考系（典型值为EME2000或ITRF）

自版本：

6.1

Method Detail

create

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

构建一个新实例。

由以下接口指定：

create 在类 AbstractDetector<NodeDetector>

参数：

newMaxCheck - 最大检查间隔（秒）

newThreshold - 收敛阈值（秒）

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

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

返回：

适当子类型的新实例

getFrame

public Frame getFrame()

获取定义赤道的参考系。

返回：

定义赤道的参考系

g

public double g(SpacecraftState s)

计算切换函数的值。此函数计算在定义的参考系中的Z位置。

由以下接口指定：

g 在接口 EventDetector

由以下类指定：

g 在类 AbstractDetector<NodeDetector>

参数：

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

返回：

切换函数的值