org.orekit.propagation.events

Class BooleanDetector

java.lang.Object

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

org.orekit.propagation.events.BooleanDetector

All Implemented Interfaces:

EventDetector

public class BooleanDetector
extends AbstractDetector<BooleanDetector>

这个类为事件检测器提供了AND和OR操作。该类将g函数的正值视为真，负值视为假。

对于成像卫星的一个例子可能是仅在卫星在正上方（仰角> 0）且地面点被阳光照射（太阳仰角> 0）时检测事件。另一个稍微牵强的例子使用OR运算符将是检测对一组地面站的访问，并且仅在卫星进入或离开该组视野时报告事件，而不是地面站之间的切换。

对于BooleanDetector，重要的是底层事件检测器的g函数的符号不是任意的，而是具有语义含义，例如进入或退出，真或假。该类与检测器一起工作，这些检测器检测进入或退出区域，例如EclipseDetector，ElevationDetector，LatitudeCrossingDetector。将此检测器与不基于进入或退出区域的检测器一起使用，例如DateDetector，LongitudeCrossingDetector，可能会导致意外结果。要对后一种类型的事件检测器应用条件，通常更适合使用EventEnablingPredicateFilter。

Author:

Evan Ward

See Also:

andCombine(Collection), orCombine(Collection), notCombine(EventDetector), EventEnablingPredicateFilter, EventSlopeFilter

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	BooleanDetector(List<EventDetector> detectors, org.orekit.propagation.events.BooleanDetector.Operator operator, AdaptableInterval newMaxCheck, double newThreshold, int newMaxIter, EventHandler newHandler) 具有所有参数的私有构造函数。

Method Summary

Modifier and Type	Method and Description
static BooleanDetector	andCombine(Collection<? extends EventDetector> detectors) 创建一个新的事件检测器，它是给定事件检测器的逻辑AND。
static BooleanDetector	andCombine(EventDetector... detectors) 创建一个新的事件检测器，它是给定事件检测器的逻辑AND。
protected BooleanDetector	create(AdaptableInterval newMaxCheck, double newThreshold, int newMaxIter, EventHandler newHandler) 构建一个新实例。
double	g(SpacecraftState s) 计算切换函数的值。
List<EventDetector>	getDetectors() 获取原始检测器的列表。
void	init(SpacecraftState s0, AbsoluteDate t) 在传播开始时初始化事件处理程序。
static NegateDetector	notCombine(EventDetector detector) 创建一个新的事件检测器，它否定另一个检测器的g函数。
static BooleanDetector	orCombine(Collection<? extends EventDetector> detectors) 创建一个新的事件检测器，它是给定事件检测器的逻辑OR。
static BooleanDetector	orCombine(EventDetector... detectors) 创建一个新的事件检测器，它是给定事件检测器的逻辑OR。

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

BooleanDetector

protected BooleanDetector(List<EventDetector> detectors,
                          org.orekit.propagation.events.BooleanDetector.Operator operator,
                          AdaptableInterval newMaxCheck,
                          double newThreshold,
                          int newMaxIter,
                          EventHandler newHandler)

具有所有参数的私有构造函数。

参数：

detectors - 操作数。

operator - 应用于操作数的g函数值的约简运算符。

newMaxCheck - 最大检查间隔（秒）。

newThreshold - 收敛阈值（秒）。

newMaxIter - 最大迭代次数。

newHandler - 事件处理程序。

Method Detail

andCombine

public static BooleanDetector andCombine(EventDetector... detectors)

创建一个新的事件检测器，它是给定事件检测器的逻辑AND。

如果且仅当detectors中所有检测器的g函数都为正时，创建的事件检测器的g函数才为正。

起始间隔、阈值和迭代计数设置为所有detectors中最严格（最小）的值。不使用底层detectors的事件处理程序，而是默认处理程序为ContinueOnEvent。

参数：

detectors - 操作数。必须至少包含一个检测器。

返回：

一个新的事件检测器，它是操作数的逻辑AND。

抛出：

NoSuchElementException - 如果detectors为空。

另请参阅：

BooleanDetector，andCombine(Collection)，orCombine(EventDetector...)，notCombine(EventDetector)

andCombine

public static BooleanDetector andCombine(Collection<? extends EventDetector> detectors)

创建一个新的事件检测器，它是给定事件检测器的逻辑AND。

如果且仅当detectors中所有检测器的g函数都为正时，创建的事件检测器的g函数才为正。

起始间隔、阈值和迭代计数设置为detectors中最严格（最小）的值。不使用底层detectors的事件处理程序，而是默认处理程序为ContinueOnEvent。

参数：

detectors - 操作数。必须至少包含一个检测器。

返回：

一个新的事件检测器，它是操作数的逻辑AND。

抛出：

NoSuchElementException - 如果detectors为空。

另请参阅：

BooleanDetector，andCombine(EventDetector...)，orCombine(Collection)，notCombine(EventDetector)

orCombine

public static BooleanDetector orCombine(EventDetector... detectors)

创建一个新的事件检测器，它是给定事件检测器的逻辑OR。

如果且仅当detectors中至少一个事件检测器的g函数为正时，创建的事件检测器的g函数才为正。

起始间隔、阈值和迭代计数设置为detectors中最严格（最小）的值。不使用底层EventDetectors的事件处理程序，而是默认处理程序为ContinueOnEvent。

参数：

detectors - 操作数。必须至少包含一个检测器。

返回：

一个新的事件检测器，它是操作数的逻辑OR。

抛出：

NoSuchElementException - 如果detectors为空。

另请参阅：

BooleanDetector，orCombine(Collection)，andCombine(EventDetector...)，notCombine(EventDetector)

orCombine

public static BooleanDetector orCombine(Collection<? extends EventDetector> detectors)

创建一个新的事件检测器，它是给定事件检测器的逻辑OR。

如果且仅当detectors中至少一个事件检测器的g函数为正时，创建的事件检测器的g函数才为正。

起始间隔、阈值和迭代计数设置为detectors中最严格（最小）的值。不使用底层EventDetectors的事件处理程序，而是默认处理程序为ContinueOnEvent。

参数：

detectors - 操作数。必须至少包含一个检测器。

返回：

一个新的事件检测器，它是操作数的逻辑OR。

抛出：

NoSuchElementException - 如果detectors为空。

另请参阅：

BooleanDetector，orCombine(Collection)，andCombine(EventDetector...)，notCombine(EventDetector)

notCombine

public static NegateDetector notCombine(EventDetector detector)

创建一个新的事件探测器，用于否定另一个探测器的g函数。

此探测器将使用与detector相同的EventDetector.getMaxCheckInterval()、EventDetector.getThreshold()和EventDetector.getMaxIterationCount()进行初始化。底层探测器的事件处理程序不会被使用，而是使用默认处理程序ContinueOnEvent。

参数：

detector - 要否定的探测器。

返回：

一个新的事件探测器，其g函数的大小相同，但与detector的符号相反。

另请参阅：

andCombine(Collection)、orCombine(Collection)、BooleanDetector

g

public double g(SpacecraftState s)

从类中复制的描述： AbstractDetector

计算切换函数的值。此函数必须是连续的（至少在其根的邻域内），因为积分器将需要找到其根以定位事件。

由以下指定：

g 在接口 EventDetector中

由以下指定：

g 在类 AbstractDetector<BooleanDetector>中

参数：

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

返回：

切换函数的值

create

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

从类中复制的描述： AbstractDetector

构建一个新实例。

由以下指定：

create 在类 AbstractDetector<BooleanDetector>中

参数：

newMaxCheck - 最大检查间隔（秒）

newThreshold - 收敛阈值（秒）

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

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

返回：

适当子类型的新实例

init

public void init(SpacecraftState s0,
                 AbsoluteDate t)

从类中复制的描述： AbstractDetector

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

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

默认实现不执行任何操作

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

由以下指定：

init 在接口 EventDetector中

覆盖：

init 在类 AbstractDetector<BooleanDetector>中

参数：

s0 - 初始状态

t - 集成的目标时间

getDetectors

public List<EventDetector> getDetectors()

获取原始探测器的列表。

返回：

原始探测器的列表

自版本：

10.2