org.orekit.propagation.events

Class EventShifter

java.lang.Object

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

org.orekit.propagation.events.EventShifter

All Implemented Interfaces:

EventDetector

public class EventShifter
extends AbstractDetector<EventShifter>

事件发生时间的包装器移位。

此类将事件探测器包装为略微移动事件发生时间。典型用例是处理某些物理事件发生之前或之后的操作延迟。

例如，卫星姿态模式可能会在日食进入几分钟前从指向太阳转换为自旋稳定，并在日食退出几分钟后再转换为指向太阳。通过将日食探测器包装到此类的实例中，可以处理这种行为，其中对于增加事件（日食退出），时间移位为正，对于减少事件（日食进入），时间移位为负。

Author:

Luc Maisonobe

See Also:

Propagator.addEventDetector(EventDetector), EventDetector

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	EventShifter(AdaptableInterval maxCheck, double threshold, int maxIter, EventHandler handler, EventDetector detector, boolean useShiftedStates, double increasingTimeShift, double decreasingTimeShift) 有完整参数的受保护构造函数。
	EventShifter(EventDetector detector, boolean useShiftedStates, double increasingTimeShift, double decreasingTimeShift) 构建一个新实例。

Method Summary

Modifier and Type	Method and Description
protected EventShifter	create(AdaptableInterval newMaxCheck, double newThreshold, int newMaxIter, EventHandler newHandler) 构建一个新实例。
double	g(SpacecraftState s) 计算切换函数的值。
double	getDecreasingTimeShift() 获取减少事件的时间移位。
EventDetector	getDetector() 获取原始未移位事件的探测器。
double	getIncreasingTimeShift() 获取增加事件的时间移位。
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

EventShifter

public EventShifter(EventDetector detector,
                    boolean useShiftedStates,
                    double increasingTimeShift,
                    double decreasingTimeShift)

构建一个新实例。

将使用原始未移位事件的最大检查间隔和收敛阈值来处理移位事件。当事件发生时，将调用原始未移位事件的eventOccurred方法（根据useShiftedStates参数，将使用移位或未移位事件日期的航天器状态）。

参数：

detector - 原始未移位事件的事件探测器

useShiftedStates - 如果为true，则提供给相关handler的eventOccurred方法的状态将保持移位，否则将未移位以对应于基础原始事件。

increasingTimeShift - 增加事件的时间移位。

decreasingTimeShift - 减少事件的时间移位。

EventShifter

protected EventShifter(AdaptableInterval maxCheck,
                       double threshold,
                       int maxIter,
                       EventHandler handler,
                       EventDetector detector,
                       boolean useShiftedStates,
                       double increasingTimeShift,
                       double decreasingTimeShift)

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

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

参数：

maxCheck - 最大检查间隔

threshold - 收敛阈值（s）

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

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

detector - 原始未移位事件的事件探测器

useShiftedStates - 如果为true，则提供给detector的eventOccurred方法的状态将保持移位，否则将未移位以对应于基础原始事件。

increasingTimeShift - 增加事件的时间移位。

decreasingTimeShift - 减少事件的时间移位。

自：

6.1

Method Detail

create

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

构建一个新实例。

由以下指定：

create 在类中 AbstractDetector<EventShifter>

参数：

newMaxCheck - 最大检查间隔（s）

newThreshold - 收敛阈值（s）

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

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

返回：

适当子类型的新实例

getDetector

public EventDetector getDetector()

获取原始未移位事件的探测器。

返回：

原始未移位事件的探测器

自：

11.1

getIncreasingTimeShift

public double getIncreasingTimeShift()

获取增加事件的时间移位。

返回：

增加事件的时间移位

getDecreasingTimeShift

public double getDecreasingTimeShift()

获取减少事件的时间移位。

返回：

减少事件的时间移位

init

public void init(SpacecraftState s0,
                 AbsoluteDate t)

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

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

默认实现不执行任何操作

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

由以下指定：

init 在接口中 EventDetector

覆盖：

init 在类中 AbstractDetector<EventShifter>

参数：

s0 - 初始状态

t - 集成的目标时间

g

public double g(SpacecraftState s)

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

由以下指定：

g 在接口中 EventDetector

由以下指定：

g 在类中 AbstractDetector<EventShifter>

参数：

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

返回：

切换函数的值