org.orekit.propagation.events

Class PositionAngleDetector

java.lang.Object

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

org.orekit.propagation.events.PositionAngleDetector

All Implemented Interfaces:

EventDetector

public class PositionAngleDetector
extends AbstractDetector<PositionAngleDetector>

在轨位置角度探测器。

该探测器基于Keplerian轨道的异常、圆形轨道的纬度参数，或赤道点轨道的经度参数。不支持笛卡尔轨道。角度可以是真实、平均或偏心角度。

Since:

7.1

Author:

Luc Maisonobe

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	PositionAngleDetector(AdaptableInterval maxCheck, double threshold, int maxIter, EventHandler handler, OrbitType orbitType, PositionAngleType positionAngleType, double angle) 具有完整参数的受保护构造函数。
	PositionAngleDetector(double maxCheck, double threshold, OrbitType orbitType, PositionAngleType positionAngleType, double angle) 构建探测器。
	PositionAngleDetector(OrbitType orbitType, PositionAngleType positionAngleType, double angle) 构建新的探测器。

Method Summary

Modifier and Type	Method and Description
protected PositionAngleDetector	create(AdaptableInterval newMaxCheck, double newThreshold, int newMaxIter, EventHandler newHandler) 构建新实例。
double	g(SpacecraftState s) 计算探测函数的值。
double	getAngle() 获取要穿越的固定角度（弧度）。
OrbitType	getOrbitType() 获取定义角度类型的轨道类型。
PositionAngleType	getPositionAngleType() 获取位置角度类型。
void	init(SpacecraftState s0, AbsoluteDate t) 在传播开始时初始化事件处理程序。

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

getHandler, getMaxCheckInterval, getMaxIterationCount, getThreshold, 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

PositionAngleDetector

public PositionAngleDetector(OrbitType orbitType,
                             PositionAngleType positionAngleType,
                             double angle)
                      throws OrekitIllegalArgumentException

构建新的探测器。

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

参数：

orbitType - 定义角度类型的轨道类型

positionAngleType - 位置角度类型

angle - 要穿越的固定角度

抛出：

OrekitIllegalArgumentException - 如果轨道类型是OrbitType.CARTESIAN

PositionAngleDetector

public PositionAngleDetector(double maxCheck,
                             double threshold,
                             OrbitType orbitType,
                             PositionAngleType positionAngleType,
                             double angle)
                      throws OrekitIllegalArgumentException

构建探测器。

此实例默认使用StopOnEvent处理程序

参数：

maxCheck - 最大检查间隔（秒）

threshold - 收敛阈值（秒）

orbitType - 定义角度类型的轨道类型

positionAngleType - 位置角度类型

angle - 要穿越的固定角度

抛出：

OrekitIllegalArgumentException - 如果轨道类型是OrbitType.CARTESIAN

PositionAngleDetector

protected PositionAngleDetector(AdaptableInterval maxCheck,
                                double threshold,
                                int maxIter,
                                EventHandler handler,
                                OrbitType orbitType,
                                PositionAngleType positionAngleType,
                                double angle)
                         throws OrekitIllegalArgumentException

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

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

参数：

maxCheck - 最大检查间隔

threshold - 收敛阈值（秒）

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

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

orbitType - 定义角度类型的轨道类型

positionAngleType - 位置角度类型

angle - 要穿越的固定角度

抛出：

OrekitIllegalArgumentException - 如果轨道类型是OrbitType.CARTESIAN

Method Detail

create

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

构建新实例。

由：

create 在类 AbstractDetector<PositionAngleDetector>中指定

参数：

newMaxCheck - 最大检查间隔（秒）

newThreshold - 收敛阈值（秒）

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

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

返回：

适当子类型的新实例

getOrbitType

public OrbitType getOrbitType()

获取定义角度类型的轨道类型。

返回：

定义角度类型的轨道类型

getPositionAngleType

public PositionAngleType getPositionAngleType()

获取位置角度类型。

返回：

位置角度类型

getAngle

public double getAngle()

获取要穿越的固定角度（弧度）。

返回：

要穿越的固定角度（弧度）

init

public void init(SpacecraftState s0,
                 AbsoluteDate t)

在传播开始时初始化事件处理程序。

此方法在传播开始时调用一次。如果需要，事件处理程序可以用于初始化一些内部数据。

默认实现不执行任何操作

此实现设置传播方向并初始化事件处理程序。如果子类覆盖此方法，则应调用super.init(s0, t)。

由：

init 在接口 EventDetector中指定

覆盖：

init 在类 AbstractDetector<PositionAngleDetector>中

参数：

s0 - 初始状态

t - 集成的目标时间

g

public double g(SpacecraftState s)

计算探测函数的值。

该值是飞行器与要穿越的固定角度之间的角度差异，通过一些符号调整以确保连续性。这些调整意味着事件检测中的increasing标志在这里变得无关紧要！例如，Kepler轨道中的角度始终增加，但此g函数将增加和减少，因此它将在每个轨道上交叉零值，交替轨道上的增加和减少方向。

由：

g 在接口 EventDetector中指定

由：

g 在类 AbstractDetector<PositionAngleDetector>中

参数：

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

返回：

飞行器与固定角度之间的角度差异，通过一些符号调整以确保连续性