org.orekit.propagation.events

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

java.lang.Object

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

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

Type Parameters:

T - the type of the field elements

All Implemented Interfaces:

FieldEventDetector<T>

public class FieldEclipseDetector<T extends org.hipparchus.CalculusFieldElement<T>>
extends FieldAbstractDetector<FieldEclipseDetector<T>,T>

卫星日食相关事件的查找器。

此类查找日食事件，即卫星在本影（全食）或半影（偏食）中。

默认实现行为是在进入日食时继续传播，而在退出日食时停止传播。可以在构造后调用FieldAbstractDetector.withHandler(FieldEventHandler)来更改此行为。

Author:

Pascal Parraud

See Also:

FieldPropagator.addEventDetector(FieldEventDetector)

Field Summary

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

DEFAULT_MAX_ITER, DEFAULT_MAXCHECK, DEFAULT_THRESHOLD

Constructor Summary

Constructors

Modifier	Constructor and Description
	FieldEclipseDetector(org.hipparchus.Field<T> field, ExtendedPVCoordinatesProvider occulted, double occultedRadius, OneAxisEllipsoid occulting) 构建一个新的日食探测器。
	FieldEclipseDetector(org.hipparchus.Field<T> field, OccultationEngine occultationEngine) 构建一个新的日食探测器。
protected	FieldEclipseDetector(FieldAdaptableInterval<T> maxCheck, T threshold, int maxIter, FieldEventHandler<T> handler, OccultationEngine occultationEngine, T margin, boolean totalEclipse) 具有完整参数的受保护构造函数。

Method Summary

Modifier and Type	Method and Description
protected FieldEclipseDetector<T>	create(FieldAdaptableInterval<T> newMaxCheck, T newThreshold, int nawMaxIter, FieldEventHandler<T> newHandler) 构建一个新实例。
T	g(FieldSpacecraftState<T> s) 计算切换函数的值。
T	getMargin() 获取用于日食检测的角度边距。
OccultationEngine	getOccultationEngine() 获取遮挡引擎。
boolean	getTotalEclipse() 获取全食日食检测标志。
FieldEclipseDetector<T>	withMargin(T newMargin) 设置角度检测的边距。
FieldEclipseDetector<T>	withPenumbra() 设置探测器以检测半影。
FieldEclipseDetector<T>	withUmbra() 设置探测器以检测全影。

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

Constructor Detail

FieldEclipseDetector

public FieldEclipseDetector(org.hipparchus.Field<T> field,
                            ExtendedPVCoordinatesProvider occulted,
                            double occultedRadius,
                            OneAxisEllipsoid occulting)

构建一个新的日食探测器。

新实例是一个具有默认最大检查间隔（FieldAbstractDetector.DEFAULT_MAXCHECK）和收敛阈值（FieldAbstractDetector.DEFAULT_THRESHOLD）的全食（本影）探测器。

参数：

field - 默认使用的字段

occulted - 被遮挡的天体

occultedRadius - 被遮挡天体的半径（米）

occulting - 遮挡天体

自：

12.0

FieldEclipseDetector

public FieldEclipseDetector(org.hipparchus.Field<T> field,
                            OccultationEngine occultationEngine)

构建一个新的日食探测器。

新实例是一个具有默认最大检查间隔（FieldAbstractDetector.DEFAULT_MAXCHECK）和收敛阈值（FieldAbstractDetector.DEFAULT_THRESHOLD）的全食（本影）探测器。

参数：

field - 默认使用的字段

occultationEngine - 遮挡引擎

自：

12.0

FieldEclipseDetector

protected FieldEclipseDetector(FieldAdaptableInterval<T> maxCheck,
                               T threshold,
                               int maxIter,
                               FieldEventHandler<T> handler,
                               OccultationEngine occultationEngine,
                               T margin,
                               boolean totalEclipse)

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

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

参数：

maxCheck - 最大检查间隔

threshold - 收敛阈值（秒）

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

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

occultationEngine - 遮挡引擎

margin - 应用于日食角度的边距（弧度）

totalEclipse - 本影（true）或半影（false）检测标志

自：

12.0

Method Detail

create

protected FieldEclipseDetector<T> create(FieldAdaptableInterval<T> newMaxCheck,
                                         T newThreshold,
                                         int nawMaxIter,
                                         FieldEventHandler<T> newHandler)

构建一个新实例。

由以下指定：

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

参数：

newMaxCheck - 最大检查间隔

newThreshold - 收敛阈值（秒）

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

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

返回：

适当子类型的新实例

withUmbra

public FieldEclipseDetector<T> withUmbra()

设置探测器以检测全影。

如果之前已配置半影/本影标志，则将覆盖该标志。

返回：

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

自：

6.1

另请参阅：

withPenumbra()

withPenumbra

public FieldEclipseDetector<T> withPenumbra()

设置探测器以检测半影。

如果之前已配置半影/本影标志，则将覆盖该标志。

返回：

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

自：

6.1

另请参阅：

withUmbra()

withMargin

public FieldEclipseDetector<T> withMargin(T newMargin)

设置角度检测的边距。

正边距意味着日食“更大”，因此进入比具有0边距的探测器更早，退出比具有0边距的探测器更晚。

参数：

newMargin - 应用于日食检测的角度边距（弧度）

返回：

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

自：

12.0

getMargin

public T getMargin()

获取用于日食检测的角度边距。

返回：

用于日食检测的角度边距（弧度）

自：

12.0

getOccultationEngine

public OccultationEngine getOccultationEngine()

获取遮挡引擎。

返回：

遮挡引擎

自：

12.0

getTotalEclipse

public boolean getTotalEclipse()

获取全食日食检测标志。

返回：

全食日食检测标志（true表示本影事件检测，false表示半影事件检测）

g

public T g(FieldSpacecraftState<T> s)

计算切换函数的值。当进入阴影区域时，此函数变为负值，当退出时变为正值。

由以下指定：

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

由以下指定：

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

参数：

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

返回：

切换函数的值