EventDetector (OREKIT 12.0.1 API)

All Known Implementing Classes:

AbstractDetector, AdapterDetector, AlignmentDetector, AltitudeDetector, AngularSeparationDetector, AngularSeparationFromSatelliteDetector, ApsideDetector, BooleanDetector, DateDetector, EclipseDetector, ElevationDetector, ElevationExtremumDetector, EventEnablingPredicateFilter, EventShifter, EventSlopeFilter, ExtremumApproachDetector, FieldOfViewDetector, FootprintOverlapDetector, FunctionalDetector, GeographicZoneDetector, GroundAtNightDetector, GroundFieldOfViewDetector, HaloXZPlaneCrossingDetector, ImpulseManeuver, InterSatDirectViewDetector, LatitudeCrossingDetector, LatitudeExtremumDetector, LongitudeCrossingDetector, LongitudeExtremumDetector, MagneticFieldDetector, NegateDetector, NodeDetector, ParameterDrivenDateIntervalDetector, PositionAngleDetector
```
public interface EventDetector
```
这个接口表示了空间动力学感知事件探测器。
它反映了来自Hipparchus的ODEEventHandler接口，但提供了一种空间动力学接口来处理方法。

事件探测器是满足传播器关于离散条件要求的一个有用解决方案。传播器会定期查询每个事件探测器的状态，至少每隔最大检查间隔一次，但可能更频繁。当基础的g切换函数的符号发生变化时，将运行一个根查找算法来精确定位事件，直到配置的收敛阈值。因此，最大检查间隔用于分离根，通常远大于收敛阈值。

g切换函数的物理意义实际上并未被事件检测算法使用。它的含义因事件探测器而异。一个例子是可见性探测器，它可以使用卫星在地平线以上的角仰角作为g切换函数。在这种情况下，当卫星升高到地平线以上时，函数会从负值切换到正值，当卫星再次降落到地平线以下时，函数会从正值切换到负值。另一个例子是近地点探测器，它可以使用位置和速度的点积。在这种情况下，当卫星穿过近地点时，函数会从负值切换到正值，当卫星穿过远地点时，函数会从正值切换到负值。

当准确定位到g切换函数变化的状态时，通过调用相关的eventOccurred方法来触发相应的事件，该方法由关联的handler调用。该方法可以对事件进行任何需要的操作（记录、执行一些处理、忽略...）。方法的返回值将被传播器用于停止或恢复传播，可能会改变状态向量。

Author:

Luc Maisonobe, Véronique Pommier-Maurussane

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`double`	`g(SpacecraftState s)` 计算切换函数的值。
`EventHandler`	`getHandler()` 获取处理器。
`AdaptableInterval`	`getMaxCheckInterval()` 获取切换函数检查之间的最大时间间隔。
`int`	`getMaxIterationCount()` 获取事件时间搜索中的最大迭代次数。
`double`	`getThreshold()` 获取事件时间搜索中的收敛阈值。
`default void`	`init(SpacecraftState s0, AbsoluteDate t)` 在传播开始时初始化事件处理器。

- Method Detail
  - init
```
default void init(SpacecraftState s0,
                  AbsoluteDate t)
```
    在传播开始时初始化事件处理器。
    此方法在传播开始时调用一次。如果需要，事件处理器可以用它来初始化一些内部数据。
    
    默认实现不执行任何操作
    
    参数：
    
    s0 - 初始状态
    
    t - 集成的目标时间
  - g
```
double g(SpacecraftState s)
```
    计算切换函数的值。该函数必须是连续的（至少在其根的邻域内），因为积分器需要找到其根以定位事件。
    
    参数：
    
    s - 当前状态信息：日期、运动学、姿态
    
    返回：
    
    切换函数的值
  - getThreshold
```
double getThreshold()
```
    获取事件时间搜索中的收敛阈值。
    
    返回：
    
    收敛阈值（秒）
  - getMaxCheckInterval
```
AdaptableInterval getMaxCheckInterval()
```
    获取切换函数检查之间的最大时间间隔。
    
    返回：
    
    切换函数检查之间的最大时间间隔（秒）
  - getMaxIterationCount
```
int getMaxIterationCount()
```
    获取事件时间搜索中的最大迭代次数。
    
    返回：
    
    事件时间搜索中的最大迭代次数
  - getHandler
```
EventHandler getHandler()
```
    获取处理器。
    
    返回：
    
    在事件发生时调用的事件处理器
    
    自版本：
    
    12.0

Interface EventDetector

Method Summary

Method Detail

init

g

getThreshold

getMaxCheckInterval

getMaxIterationCount

getHandler