org.orekit.propagation.events

Class GroundAtNightDetector

java.lang.Object

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

org.orekit.propagation.events.GroundAtNightDetector

All Implemented Interfaces:

EventDetector

public class GroundAtNightDetector
extends AbstractDetector<GroundAtNightDetector>

夜间地面位置探测器。

此探测器主要用于安排光学测量（无源望远镜观测卫星与星空背景或主动卫星激光测距）。

当地面处于夜晚时（即太阳低于黎明/黄昏仰角），此探测器的g函数为正。

Since:

9.3

Author:

Luc Maisonobe

Field Summary

Fields

Modifier and Type	Field and Description
static double	ASTRONOMICAL_DAWN_DUSK_ELEVATION 天文黎明/黄昏时太阳仰角（地平线以下18°）。
static double	CIVIL_DAWN_DUSK_ELEVATION 民用黎明/黄昏时太阳仰角（地平线以下6°）。
static double	NAUTICAL_DAWN_DUSK_ELEVATION 航海黎明/黄昏时太阳仰角（地平线以下12°）。

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

DEFAULT_MAX_ITER, DEFAULT_MAXCHECK, DEFAULT_THRESHOLD

Constructor Summary

Constructors

Modifier	Constructor and Description
	GroundAtNightDetector(TopocentricFrame groundLocation, PVCoordinatesProvider sun, double dawnDuskElevation, AtmosphericRefractionModel refractionModel) 简单构造器。
protected	GroundAtNightDetector(TopocentricFrame groundLocation, PVCoordinatesProvider sun, double dawnDuskElevation, AtmosphericRefractionModel refractionModel, AdaptableInterval maxCheck, double threshold, int maxIter, EventHandler handler) 私有构造器。

Method Summary

Modifier and Type	Method and Description
protected GroundAtNightDetector	create(AdaptableInterval newMaxCheck, double newThreshold, int newMaxIter, EventHandler newHandler) 构建一个新实例。
double	g(SpacecraftState state) 计算切换函数的值。

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

Field Detail

CIVIL_DAWN_DUSK_ELEVATION

public static final double CIVIL_DAWN_DUSK_ELEVATION

民用黎明/黄昏时太阳仰角（地平线以下6°）。

NAUTICAL_DAWN_DUSK_ELEVATION

public static final double NAUTICAL_DAWN_DUSK_ELEVATION

航海黎明/黄昏时太阳仰角（地平线以下12°）。

ASTRONOMICAL_DAWN_DUSK_ELEVATION

public static final double ASTRONOMICAL_DAWN_DUSK_ELEVATION

天文黎明/黄昏时太阳仰角（地平线以下18°）。

Constructor Detail

GroundAtNightDetector

public GroundAtNightDetector(TopocentricFrame groundLocation,
                             PVCoordinatesProvider sun,
                             double dawnDuskElevation,
                             AtmosphericRefractionModel refractionModel)

简单构造器。

请注意，地球标准折射模型仅适用于仰角高于-2°的情况。因此，它不适用于与民用黎明/黄昏仰角（-6°）、航海黎明/黄昏仰角（-12°）或天文黎明/黄昏仰角（-18°）一起使用。应优先选择可以计算大负仰角处折射的ITU 453折射模型。

参数：

groundLocation - 要检查的地面位置

sun - 太阳位置提供者

dawnDuskElevation - 我们认为夜晚足够黑暗的太阳仰角以下（弧度）（通常为天文黎明/黄昏仰角）

refractionModel - 折射模型的引用（如果应忽略折射则为null）

GroundAtNightDetector

protected GroundAtNightDetector(TopocentricFrame groundLocation,
                                PVCoordinatesProvider sun,
                                double dawnDuskElevation,
                                AtmosphericRefractionModel refractionModel,
                                AdaptableInterval maxCheck,
                                double threshold,
                                int maxIter,
                                EventHandler handler)

私有构造器。

参数：

groundLocation - 进行测量的地面位置

sun - 太阳位置提供者

dawnDuskElevation - 我们认为夜晚足够黑暗的太阳仰角以下（弧度）（通常为天文黎明/黄昏仰角）

refractionModel - 折射模型的引用（如果应忽略折射则为null）

maxCheck - 最大检查间隔

threshold - 收敛阈值（秒）

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

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

Method Detail

create

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

构建一个新实例。

由：

create 在类 AbstractDetector<GroundAtNightDetector>

参数：

newMaxCheck - 最大检查间隔（秒）

newThreshold - 收敛阈值（秒）

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

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

返回：

适当子类型的新实例

g

public double g(SpacecraftState state)

计算切换函数的值。此函数必须连续（至少在其根的邻域内），因为积分器将需要找到其根以定位事件。

当地面处于夜晚时（即太阳低于黎明/黄昏仰角），此探测器的g函数为正。

此函数仅取决于日期，而不取决于航天器的实际位置。

由：

g 在接口 EventDetector

由：

g 在类 AbstractDetector<GroundAtNightDetector>

参数：

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

返回：

切换函数的值