org.orekit.propagation.events

Class GeographicZoneDetector

java.lang.Object

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

org.orekit.propagation.events.GeographicZoneDetector

All Implemented Interfaces:

EventDetector

public class GeographicZoneDetector
extends AbstractDetector<GeographicZoneDetector>

区域入口/出口的探测器，由地理边界定义。

该探测器标识了当飞船穿越定义在地球表面上的一般形状边界时。感兴趣的典型形状可以是国家、陆地或物理区域，如南大西洋异常区。形状可以是任意复杂的：凸多边形或非凸多边形，可以是一个整体或几个非连接的岛屿，它们可以包括极点，也可以像里海那样有洞（当然，如果只关心陆地，这将是一个洞）。复杂的形状当然需要比简单形状更多的计算时间。

Since:

6.2

Author:

Luc Maisonobe

See Also:

FootprintOverlapDetector

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	GeographicZoneDetector(AdaptableInterval maxCheck, double threshold, int maxIter, EventHandler handler, BodyShape body, org.hipparchus.geometry.spherical.twod.SphericalPolygonsSet zone, org.hipparchus.geometry.enclosing.EnclosingBall<org.hipparchus.geometry.spherical.twod.Sphere2D,org.hipparchus.geometry.spherical.twod.S2Point> cap, double margin) 具有完整参数的受保护构造函数。
	GeographicZoneDetector(BodyShape body, org.hipparchus.geometry.spherical.twod.SphericalPolygonsSet zone, double margin) 构建一个新的探测器。
	GeographicZoneDetector(double maxCheck, double threshold, BodyShape body, org.hipparchus.geometry.spherical.twod.SphericalPolygonsSet zone, double margin) 构建一个探测器。

Method Summary

Modifier and Type	Method and Description
protected GeographicZoneDetector	create(AdaptableInterval newMaxCheck, double newThreshold, int newMaxIter, EventHandler newHandler) 构建一个新实例。
double	g(SpacecraftState s) 计算探测函数的值。
BodyShape	getBody() 获取定义地理区域的天体。
double	getMargin() 获取要应用的角度边界（弧度）。
org.hipparchus.geometry.spherical.twod.SphericalPolygonsSet	getZone() 获取地理区域。
GeographicZoneDetector	withMargin(double newMargin) 设置探测器边界。

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

GeographicZoneDetector

public GeographicZoneDetector(BodyShape body,
                              org.hipparchus.geometry.spherical.twod.SphericalPolygonsSet zone,
                              double margin)

构建一个新的探测器。

新实例使用默认值进行最大检查间隔（AbstractDetector.DEFAULT_MAXCHECK）和收敛阈值（AbstractDetector.DEFAULT_THRESHOLD）。

参数：

body - 定义地理区域的天体

zone - 要考虑的地理区域

margin - 要应用到区域的角度边界

GeographicZoneDetector

public GeographicZoneDetector(double maxCheck,
                              double threshold,
                              BodyShape body,
                              org.hipparchus.geometry.spherical.twod.SphericalPolygonsSet zone,
                              double margin)

构建一个探测器。

参数：

maxCheck - 最大检查间隔（秒）

threshold - 收敛阈值（秒）

body - 定义地理区域的天体

zone - 要考虑的地理区域

margin - 要应用到区域的角度边界

GeographicZoneDetector

protected GeographicZoneDetector(AdaptableInterval maxCheck,
                                 double threshold,
                                 int maxIter,
                                 EventHandler handler,
                                 BodyShape body,
                                 org.hipparchus.geometry.spherical.twod.SphericalPolygonsSet zone,
                                 org.hipparchus.geometry.enclosing.EnclosingBall<org.hipparchus.geometry.spherical.twod.Sphere2D,org.hipparchus.geometry.spherical.twod.S2Point> cap,
                                 double margin)

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

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

参数：

maxCheck - 最大检查间隔

threshold - 收敛阈值（秒）

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

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

body - 定义地理区域的天体

zone - 要考虑的地理区域

cap - 包围区域的球形帽

margin - 要应用到区域的角度边界

Method Detail

create

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

构建一个新实例。

由以下指定：

create 在类 AbstractDetector<GeographicZoneDetector>

参数：

newMaxCheck - 最大检查间隔（秒）

newThreshold - 收敛阈值（秒）

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

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

返回：

适当子类型的新实例

withMargin

public GeographicZoneDetector withMargin(double newMargin)

设置探测器边界。

参数：

newMargin - 要应用到区域的角度边界

返回：

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

getBody

public BodyShape getBody()

获取定义地理区域的天体。

返回：

定义地理区域的天体

getZone

public org.hipparchus.geometry.spherical.twod.SphericalPolygonsSet getZone()

获取地理区域。

返回：

地理区域

getMargin

public double getMargin()

获取要应用的角度边界（弧度）。

返回：

要应用的角度边界（弧度）

g

public double g(SpacecraftState s)

计算探测函数的值。

该值是到边界的有符号距离减去边界。如果飞船在区域外部，则为正，如果在区域内部，则为负。

由以下指定：

g 在接口 EventDetector

由以下指定：

g 在类 AbstractDetector<GeographicZoneDetector>

参数：

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

返回：

到边界的有符号距离减去边界