org.orekit.propagation.events

Class FieldDateDetector<T extends org.hipparchus.CalculusFieldElement<T>>

java.lang.Object

org.orekit.propagation.events.FieldAbstractDetector<FieldDateDetector<T>,T>

org.orekit.propagation.events.FieldDateDetector<T>

Type Parameters:

T - type of the field elements

All Implemented Interfaces:

FieldEventDetector<T>, FieldTimeStamped<T>

public class FieldDateDetector<T extends org.hipparchus.CalculusFieldElement<T>>
extends FieldAbstractDetector<FieldDateDetector<T>,T>
implements FieldTimeStamped<T>

日期事件查找器。

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

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

• 可以在没有先前日期的情况下定义（FieldDateDetector(Field, FieldTimeStamped...)）
• 可以添加多个日期（addEventDate(FieldAbsoluteDate)）

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

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

Author:

Luc Maisonobe, Pascal Parraud

See Also:

FieldPropagator.addEventDetector(FieldEventDetector)

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.FieldAbstractDetector

DEFAULT_MAX_ITER, DEFAULT_MAXCHECK

Constructor Summary

Constructors

Modifier	Constructor and Description
	FieldDateDetector(org.hipparchus.Field<T> field, FieldTimeStamped<T>... dates) 构建一个新实例。
protected	FieldDateDetector(FieldAdaptableInterval<T> maxCheck, T threshold, int maxIter, FieldEventHandler<T> handler, double minGap, FieldTimeStamped<T>... dates) 具有完整参数的受保护构造函数。

Method Summary

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

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

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.FieldTimeStamped

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

FieldDateDetector

@SafeVarargs
public FieldDateDetector(org.hipparchus.Field<T> field,
                                      FieldTimeStamped<T>... dates)

构建一个新实例。

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

参数:

field - 日期所属的字段

dates - 事件日期列表

自版本:

12.0

另请参阅:

addEventDate(FieldAbsoluteDate)

FieldDateDetector

@SafeVarargs
protected FieldDateDetector(FieldAdaptableInterval<T> maxCheck,
                                         T threshold,
                                         int maxIter,
                                         FieldEventHandler<T> handler,
                                         double minGap,
                                         FieldTimeStamped<T>... dates)

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

此构造函数不是公共的，因为预期用户使用建造者API以可读的方式设置实例，而不使用大量参数。

参数:

maxCheck - 最大检查间隔

threshold - 收敛阈值（秒）

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

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

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

dates - 事件日期列表

Method Detail

withMinGap

public FieldDateDetector<T> withMinGap(double newMinGap)

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

参数:

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

返回:

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

自版本:

12.0

create

protected FieldDateDetector<T> create(FieldAdaptableInterval<T> newMaxCheck,
                                      T newThreshold,
                                      int newMaxIter,
                                      FieldEventHandler<T> newHandler)

构建一个新实例。

由以下指定:

create 在类 FieldAbstractDetector<FieldDateDetector<T extends org.hipparchus.CalculusFieldElement<T>>,T extends org.hipparchus.CalculusFieldElement<T>>

参数:

newMaxCheck - 最大检查间隔

newThreshold - 收敛阈值（秒）

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

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

返回:

适当子类型的新实例

getDates

public List<FieldTimeStamped<T>> getDates()

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

返回:

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

自版本:

12.0

g

public T g(FieldSpacecraftState<T> s)

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

由以下指定:

g 在接口 FieldEventDetector<T extends org.hipparchus.CalculusFieldElement<T>>

由以下指定:

g 在类 FieldAbstractDetector<FieldDateDetector<T extends org.hipparchus.CalculusFieldElement<T>>,T extends org.hipparchus.CalculusFieldElement<T>>

参数:

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

返回:

切换函数的值

getDate

public FieldAbsoluteDate<T> getDate()

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

由以下指定:

getDate 在接口 FieldTimeStamped<T extends org.hipparchus.CalculusFieldElement<T>>

返回:

事件日期

addEventDate

public void addEventDate(FieldAbsoluteDate<T> target)
                  throws IllegalArgumentException

添加事件日期。

要添加的日期必须：

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

参数:

target - 目标日期

抛出:

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

另请参阅:

FieldDateDetector(Field, FieldTimeStamped...)