org.orekit.propagation.events

Class AngularSeparationFromSatelliteDetector

java.lang.Object

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

org.orekit.propagation.events.AngularSeparationFromSatelliteDetector

All Implemented Interfaces:

EventDetector

public class AngularSeparationFromSatelliteDetector
extends AbstractDetector<AngularSeparationFromSatelliteDetector>

检测两个移动物体在航天器视角下靠近的情况。

此探测器的主要用例是当主要物体实际上是地面站，被建模为一个TopocentricFrame，而次要物体是太阳，用于计算光学反射。

默认的处理程序行为是在物体进入接近区域时停止传播。可以通过在构造后调用AbstractDetector.withHandler(EventHandler)来更改此行为。

Since:

11.0

Author:

Luc Maisonobe, Thomas Paulet

See Also:

Propagator.addEventDetector(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	AngularSeparationFromSatelliteDetector(AdaptableInterval maxCheck, double threshold, int maxIter, EventHandler handler, PVCoordinatesProvider primaryObject, PVCoordinatesProvider secondaryObject, double proximityAngle) 具有完整参数的受保护构造函数。
	AngularSeparationFromSatelliteDetector(PVCoordinatesProvider primaryObject, PVCoordinatesProvider secondaryObject, double proximityAngle) 构建一个新的角度分离探测器。

Method Summary

Modifier and Type	Method and Description
protected AngularSeparationFromSatelliteDetector	create(AdaptableInterval newMaxCheck, double newThreshold, int newMaxIter, EventHandler newHandler) 构建一个新实例。
double	g(SpacecraftState s) 计算切换函数的值。
PVCoordinatesProvider	getPrimaryObject() 获取位于接近区域中心的主要物体。
double	getProximityAngle() 获取接近角度（弧度）。
PVCoordinatesProvider	getSecondaryObject() 获取次要物体。

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

Constructor Detail

AngularSeparationFromSatelliteDetector

public AngularSeparationFromSatelliteDetector(PVCoordinatesProvider primaryObject,
                                              PVCoordinatesProvider secondaryObject,
                                              double proximityAngle)

构建一个新的角度分离探测器。

参数：

primaryObject - 位于接近区域中心的主要物体

secondaryObject - 次要物体，从航天器视角下可能靠近主要物体

proximityAngle - 从航天器视角下看到的接近角度，触发事件的角度（弧度）

AngularSeparationFromSatelliteDetector

protected AngularSeparationFromSatelliteDetector(AdaptableInterval maxCheck,
                                                 double threshold,
                                                 int maxIter,
                                                 EventHandler handler,
                                                 PVCoordinatesProvider primaryObject,
                                                 PVCoordinatesProvider secondaryObject,
                                                 double proximityAngle)

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

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

参数：

maxCheck - 最大检查间隔

threshold - 收敛阈值（秒）

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

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

primaryObject - 位于接近区域中心的主要物体

secondaryObject - 次要物体，从航天器视角下可能靠近主要物体

proximityAngle - 从次要物体视角下看到的接近角度，触发事件的角度（弧度）

Method Detail

create

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

构建一个新实例。

由以下指定：

create 在类 AbstractDetector<AngularSeparationFromSatelliteDetector>

参数：

newMaxCheck - 最大检查间隔（秒）

newThreshold - 收敛阈值（秒）

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

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

返回：

适当子类型的新实例

getPrimaryObject

public PVCoordinatesProvider getPrimaryObject()

获取位于接近区域中心的主要物体。

返回：

主要物体

getSecondaryObject

public PVCoordinatesProvider getSecondaryObject()

获取次要物体。

返回：

次要物体

getProximityAngle

public double getProximityAngle()

获取接近角度（弧度）。

返回：

接近角度

g

public double g(SpacecraftState s)

计算切换函数的值。

此函数测量从航天器视角下看到的主要和次要物体之间的角度分离减去接近角度。因此，当次要物体进入接近区域时触发减小事件，当次要物体离开接近区域时触发增加事件。

不考虑阴影效应，因此此方法是计算的，即使次要物体在主要物体后面，也可能触发事件。如果必须考虑这种效应，则探测器必须与基于日食条件的谓词过滤器关联，其中谓词函数基于日食条件。

由以下指定：

g 在接口 EventDetector

由以下指定：

g 在类 AbstractDetector<AngularSeparationFromSatelliteDetector>

参数：

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

返回：

切换函数的值