org.orekit.propagation.events

Class DateDetector

java.lang.Object

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

org.orekit.propagation.events.DateDetector

All Implemented Interfaces:

EventDetector, TimeStamped

public class DateDetector
extends AbstractDetector<DateDetector>
implements TimeStamped

日期事件查找器。

此类用于查找日期事件（即预定义日期的发生）。

从版本5.1开始，它是一个增强的日期探测器：

• 可以在没有先前日期的情况下定义（DateDetector(TimeStamped...)）
• 可以添加多个日期（addEventDate(AbsoluteDate)）

添加的日期之间的间隔必须大于最小间隔。

默认实现行为是在第一个事件日期发生时停止传播。可以在构造后调用AbstractDetector.withHandler(EventHandler)来更改此行为。

Author:

Luc Maisonobe, Pascal Parraud

See Also:

Propagator.addEventDetector(EventDetector)

Field Summary

Fields

Modifier and Type	Field and Description
static double	DEFAULT_MAX_CHECK 最大检查的默认值。
static double	DEFAULT_MIN_GAP 添加日期之间的最小间隔的默认值。
static double	DEFAULT_THRESHOLD 收敛阈值的默认值。

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

DEFAULT_MAX_ITER, DEFAULT_MAXCHECK

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DateDetector(AdaptableInterval maxCheck, double threshold, int maxIter, EventHandler handler, double minGap, TimeStamped... dates) 具有完整参数的受保护构造函数。
	DateDetector(TimeStamped... dates) 构建一个新实例。

Method Summary

Modifier and Type	Method and Description
void	addEventDate(AbsoluteDate target) 添加事件日期。
protected DateDetector	create(AdaptableInterval newMaxCheck, double newThreshold, int newMaxIter, EventHandler newHandler) 构建一个新实例。
double	g(SpacecraftState s) 计算切换函数的值。
AbsoluteDate	getDate() 根据推算器获取当前事件日期。
List<TimeStamped>	getDates() 获取当前管理的所有事件日期，按时间顺序排列。
DateDetector	withMinGap(double newMinGap) 设置添加日期之间的最小间隔。

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

Methods inherited from interface org.orekit.time.TimeStamped

durationFrom

Field Detail

DEFAULT_MAX_CHECK

public static final double DEFAULT_MAX_CHECK

最大检查的默认值。

自版本:

12.0

另请参阅:

常量字段值

DEFAULT_MIN_GAP

public static final double DEFAULT_MIN_GAP

添加日期之间的最小间隔的默认值。

自版本:

12.0

另请参阅:

常量字段值

DEFAULT_THRESHOLD

public static final double DEFAULT_THRESHOLD

收敛阈值的默认值。

自版本:

12.0

另请参阅:

常量字段值

Constructor Detail

DateDetector

public DateDetector(TimeStamped... dates)

构建一个新实例。

首个事件日期在此处设置，但其他日期可以稍后使用addEventDate(AbsoluteDate)添加。

参数:

dates - 事件日期列表

自版本:

12.0

另请参阅:

addEventDate(AbsoluteDate)

DateDetector

protected DateDetector(AdaptableInterval maxCheck,
                       double threshold,
                       int maxIter,
                       EventHandler handler,
                       double minGap,
                       TimeStamped... dates)

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

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

参数:

maxCheck - 最大检查间隔

threshold - 收敛阈值（秒）

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

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

minGap - 添加日期之间的最小间隔（秒）

dates - 事件日期列表

自版本:

12.0

Method Detail

withMinGap

public DateDetector withMinGap(double newMinGap)

设置添加日期之间的最小间隔。

参数:

newMinGap - 添加日期之间的新最小间隔

返回:

更新配置的新探测器（实例未更改）

自版本:

12.0

create

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

构建一个新实例。

由以下指定:

create 在类 AbstractDetector<DateDetector>

参数:

newMaxCheck - 最大检查间隔（秒）

newThreshold - 收敛阈值（秒）

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

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

返回:

适当子类型的新实例

getDates

public List<TimeStamped> getDates()

获取当前管理的所有事件日期，按时间顺序排列。

返回:

当前管理的所有事件日期，按时间顺序排列

自版本:

11.1

g

public double g(SpacecraftState s)

计算切换函数的值。此函数衡量当前日期与目标日期之间的差异。

由以下指定:

g 在接口 EventDetector

由以下指定:

g 在类 AbstractDetector<DateDetector>

参数:

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

返回:

切换函数的值

getDate

public AbsoluteDate getDate()

根据推算器获取当前事件日期。

由以下指定:

getDate 在接口 TimeStamped

返回:

事件日期

addEventDate

public void addEventDate(AbsoluteDate target)
                  throws IllegalArgumentException

添加事件日期。

要添加的日期必须：

• 小于已注册的最小事件日期减去maxCheck
• 或大于已注册的最大事件日期加上maxCheck

参数:

target - 目标日期

抛出:

IllegalArgumentException - 如果日期与已定义的间隔太接近

另请参阅:

DateDetector(TimeStamped...)