FieldElevationDetector (OREKIT 12.0.1 API)

java.lang.Object
- org.orekit.propagation.events.FieldAbstractDetector<FieldElevationDetector<T>,T>
- - org.orekit.propagation.events.FieldElevationDetector<T>

Type Parameters:

T - type of the field elements

All Implemented Interfaces:

FieldEventDetector<T>
```
public class FieldElevationDetector<T extends org.hipparchus.CalculusFieldElement<T>>
extends FieldAbstractDetector<FieldElevationDetector<T>,T>
```
卫星升起/落下事件的查找器，允许设置方位角和/或仰角边界或地面方位角/仰角掩模输入。每个计算都可以配置为使用大气折射。
默认实现行为是在卫星升起时继续传播，在卫星落下时停止传播。这可以通过在构造后调用FieldAbstractDetector.withHandler(FieldEventHandler)来更改。

Author:

Hank Grabowski

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
	`FieldElevationDetector(org.hipparchus.Field<T> field, TopocentricFrame topo)` 根据传入的地心框架和最小仰角角度创建仰角检测器的实例。
`protected`	`FieldElevationDetector(FieldAdaptableInterval<T> maxCheck, T threshold, int maxIter, FieldEventHandler<T> handler, double minElevation, ElevationMask mask, AtmosphericRefractionModel refractionModel, TopocentricFrame topo)` 具有完整参数的受保护构造函数。
	`FieldElevationDetector(T maxCheck, T threshold, TopocentricFrame topo)` 根据传入的地心框架和默认最大检查间隔和收敛阈值值的覆盖创建仰角检测器的实例。

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected FieldElevationDetector<T>`	`create(FieldAdaptableInterval<T> newMaxCheck, T newThreshold, int newMaxIter, FieldEventHandler<T> newHandler)` 构建一个新实例。
`T`	`g(FieldSpacecraftState<T> s)` 计算切换函数的值。
`ElevationMask`	`getElevationMask()` 返回当前配置的仰角掩模。
`double`	`getMinElevation()` 返回当前配置的最小有效仰角值。
`AtmosphericRefractionModel`	`getRefractionModel()` 返回当前配置的折射模型。
`TopocentricFrame`	`getTopocentricFrame()` 返回当前配置的地心框架定义。
`FieldElevationDetector<T>`	`withConstantElevation(double newMinElevation)` 设置检测的最小仰角。
`FieldElevationDetector<T>`	`withElevationMask(ElevationMask newElevationMask)` 使用传入的掩模对象设置检测的仰角掩模。
`FieldElevationDetector<T>`	`withRefraction(AtmosphericRefractionModel newRefractionModel)` 设置仰角检测器在其计算中使用大气折射模型。

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
  - FieldElevationDetector
```
public FieldElevationDetector(org.hipparchus.Field<T> field,
                              TopocentricFrame topo)
```
    根据传入的地心框架和最小仰角角度创建仰角检测器的实例。
    使用默认值进行最大检查间隔（FieldAbstractDetector.DEFAULT_MAXCHECK）和收敛阈值（FieldAbstractDetector.DEFAULT_THRESHOLD）。
    
    参数：
    
    field - 元素的类型
    
    topo - 地心模型的引用
    
    另请参阅：
    
    withConstantElevation(double), withElevationMask(ElevationMask), withRefraction(AtmosphericRefractionModel)
  - FieldElevationDetector
```
public FieldElevationDetector(T maxCheck,
                              T threshold,
                              TopocentricFrame topo)
```
    根据传入的地心框架和覆盖默认最大检查间隔和收敛阈值值创建仰角检测器的实例。
    
    参数：
    
    maxCheck - 最大检查间隔（秒）
    
    threshold - 最大发散阈值（秒）
    
    topo - 地心模型的引用
    
    另请参阅：
    
    withConstantElevation(double), withElevationMask(ElevationMask), withRefraction(AtmosphericRefractionModel)
  - FieldElevationDetector
```
protected FieldElevationDetector(FieldAdaptableInterval<T> maxCheck,
                                 T threshold,
                                 int maxIter,
                                 FieldEventHandler<T> handler,
                                 double minElevation,
                                 ElevationMask mask,
                                 AtmosphericRefractionModel refractionModel,
                                 TopocentricFrame topo)
```
    具有完整参数的受保护构造函数。
    此构造函数不是公共的，因为预期用户将使用各种withXxx()方法的构建器API来设置实例，而不是使用大量参数。
    
    参数：
    
    maxCheck - 最大检查间隔
    
    threshold - 收敛阈值（秒）
    
    maxIter - 事件时间搜索中的最大迭代次数
    
    handler - 事件发生时要调用的事件处理程序
    
    minElevation - 仰角的最小值（弧度）
    
    mask - 仰角掩模的引用
    
    refractionModel - 折射模型的引用
    
    topo - 地心模型的引用
- Method Detail
  - create
```
protected FieldElevationDetector<T> create(FieldAdaptableInterval<T> newMaxCheck,
                                           T newThreshold,
                                           int newMaxIter,
                                           FieldEventHandler<T> newHandler)
```
    构建一个新实例。
    
    由：
    
    create 在类中 FieldAbstractDetector<FieldElevationDetector<T extends org.hipparchus.CalculusFieldElement<T>>,T extends org.hipparchus.CalculusFieldElement<T>>
    
    参数：
    
    newMaxCheck - 最大检查间隔
    
    newThreshold - 收敛阈值（秒）
    
    newMaxIter - 事件时间搜索中的最大迭代次数
    
    newHandler - 事件发生时要调用的事件处理程序
    
    返回：
    
    适当子类型的新实例
  - getElevationMask
```
public ElevationMask getElevationMask()
```
    返回当前配置的仰角掩模。
    
    返回：
    
    仰角掩模（如果实例已配置为使用withConstantElevation(double)则为null）
    
    另请参阅：
    
    withElevationMask(ElevationMask)
  - getMinElevation
```
public double getMinElevation()
```
    返回当前配置的最小有效仰角值。
    
    返回：
    
    最小仰角值（如果实例已配置为使用withElevationMask(ElevationMask)则为Double.NaN）
    
    另请参阅：
    
    withConstantElevation(double)
  - getRefractionModel
```
public AtmosphericRefractionModel getRefractionModel()
```
    返回当前配置的折射模型。
    
    返回：
    
    折射模型
    
    另请参阅：
    
    withRefraction(AtmosphericRefractionModel)
  - getTopocentricFrame
```
public TopocentricFrame getTopocentricFrame()
```
    返回当前配置的地心框架定义。
    
    返回：
    
    地心框架定义
  - g
```
public T g(FieldSpacecraftState<T> s)
```
    计算切换函数的值。此函数测量当前仰角（如果需要还包括方位角）与参考掩模或最小值之间的差异。
    
    由：
    
    g 在接口中 FieldEventDetector<T extends org.hipparchus.CalculusFieldElement<T>>
    
    由：
    
    g 在类中 FieldAbstractDetector<FieldElevationDetector<T extends org.hipparchus.CalculusFieldElement<T>>,T extends org.hipparchus.CalculusFieldElement<T>>
    
    参数：
    
    s - 当前状态信息：日期、运动学、姿态
    
    返回：
    
    切换函数的值
  - withConstantElevation
```
public FieldElevationDetector<T> withConstantElevation(double newMinElevation)
```
    设置检测的最小仰角。
    如果之前已配置为这样，这将覆盖仰角掩模。
    
    参数:
    
    newMinElevation - 最小可见高度，以弧度表示 (rad)
    
    返回:
    
    具有更新配置的新探测器（实例未更改）
    
    自版本:
    
    6.1
    
    另请参阅:
    
    getMinElevation()
  - withElevationMask
```
public FieldElevationDetector<T> withElevationMask(ElevationMask newElevationMask)
```
    设置使用传入的掩模对象进行检测的高度掩模。
    
    参数:
    
    newElevationMask - 用于计算的高度掩模
    
    返回:
    
    具有更新配置的新探测器（实例未更改）
    
    自版本:
    
    6.1
    
    另请参阅:
    
    getElevationMask()
  - withRefraction
```
public FieldElevationDetector<T> withRefraction(AtmosphericRefractionModel newRefractionModel)
```
    设置高度探测器在其计算中使用大气折射模型。
    要在复制现有高度探测器时禁用折射，请使用空参数调用此方法。
    
    参数:
    
    newRefractionModel - 用于计算的折射模型
    
    返回:
    
    具有更新配置的新探测器（实例未更改）
    
    自版本:
    
    6.1
    
    另请参阅:
    
    getRefractionModel()

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

Field Summary

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

Constructor Summary

Method Summary

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

Methods inherited from class java.lang.Object

Constructor Detail

FieldElevationDetector

FieldElevationDetector

FieldElevationDetector

Method Detail

create

getElevationMask

getMinElevation

getRefractionModel

getTopocentricFrame

g

withConstantElevation

withElevationMask

withRefraction