org.orekit.models.earth.atmosphere.data

Class MarshallSolarActivityFutureEstimation

java.lang.Object

org.orekit.models.earth.atmosphere.data.AbstractSolarActivityData<MarshallSolarActivityFutureEstimationLoader.LineParameters,MarshallSolarActivityFutureEstimationLoader>

org.orekit.models.earth.atmosphere.data.MarshallSolarActivityFutureEstimation

All Implemented Interfaces:

Serializable, DTM2000InputParameters, NRLMSISE00InputParameters

public class MarshallSolarActivityFutureEstimation
extends AbstractSolarActivityData<MarshallSolarActivityFutureEstimationLoader.LineParameters,MarshallSolarActivityFutureEstimationLoader>

此类提供大气模型所需的太阳活动数据：F107太阳通量、Ap和Kp指数。

数据来自NASA Marshall Solar Activity Future Estimation (MSAFE)，作为每月F10.7平均太阳通量和Ap地磁参数的估算值（请参阅Marshall Solar Activity网站）。

数据可以在NASA Marshall Solar Activity存档预测中检索。在这里，Kp指数是从Ap指数推导出来的，而Ap指数则是检索到的Ap值的等效表格。

如果有多个MSAFE文件可用，某些日期可能会出现在多个文件中（例如，2007年8月出现在从1999年3月首次发布的所有文件到2008年2月的文件中）。在这种情况下，将使用最新文件中的数据，旧文件将被丢弃。假定文件的日期是其第一个条目之后的6个月（这解释了为什么以2007年8月作为其第一个条目的文件是2008年2月的文件）。这意味着MSAFE文件不能被编辑以更改其时间跨度，否则这将破坏旧条目覆盖机制。

使用这些数据，getInstantFlux(AbsoluteDate)和getMeanFlux(AbsoluteDate)方法返回相同的值，get24HoursKp(AbsoluteDate)和getThreeHourlyKP(AbsoluteDate)方法返回相同的值。

从MSAFE文件中的Ap指数值转换为大气模型使用的Kp值是使用Jacchia方程完成的[1]。

使用这些数据，getAp(AbsoluteDate date)方法返回七倍相同的每日Ap值的数组，即仅适用于将开关＃9设置为1的NRLMSISE00大气模型。

参考资料

1. Jacchia, L. G. “CIRA 1972, recent atmospheric models, and improvements in progress.” COSPAR, 21st Plenary Meeting. Vol. 1. 1978.

Author:

Bruno Revelin, Luc Maisonobe, Evan Ward, Pascal Parraud, Vincent Cucchietti

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MarshallSolarActivityFutureEstimation.StrengthLevel 活动强度级别。

Nested classes/interfaces inherited from class org.orekit.models.earth.atmosphere.data.AbstractSolarActivityData

AbstractSolarActivityData.LocalSolarActivity, AbstractSolarActivityData.SolarActivityGenerator

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_SUPPORTED_NAMES 适用于所有官方发布文件的支持名称的默认正则表达式。

Fields inherited from class org.orekit.models.earth.atmosphere.data.AbstractSolarActivityData

N_NEIGHBORS

Constructor Summary

Constructors

Constructor and Description
MarshallSolarActivityFutureEstimation(DataSource source, MarshallSolarActivityFutureEstimation.StrengthLevel strengthLevel) 使用默认数据上下文的简单构造函数。
MarshallSolarActivityFutureEstimation(DataSource source, MarshallSolarActivityFutureEstimation.StrengthLevel strengthLevel, TimeScale utc) 简单构造函数。
MarshallSolarActivityFutureEstimation(DataSource source, MarshallSolarActivityFutureEstimation.StrengthLevel strengthLevel, TimeScale utc, int maxSlots, double maxSpan, double maxInterval, double minimumStep) 具有可自定义的线程安全缓存配置的构造函数。
MarshallSolarActivityFutureEstimation(String supportedNames, MarshallSolarActivityFutureEstimation.StrengthLevel strengthLevel) 简单构造函数。
MarshallSolarActivityFutureEstimation(String supportedNames, MarshallSolarActivityFutureEstimation.StrengthLevel strengthLevel, DataProvidersManager dataProvidersManager, TimeScale utc) 允许指定MSAFE辅助数据文件的来源的构造函数。
MarshallSolarActivityFutureEstimation(String supportedNames, MarshallSolarActivityFutureEstimation.StrengthLevel strengthLevel, DataProvidersManager dataProvidersManager, TimeScale utc, int maxSlots, double maxSpan, double maxInterval, double minimumStep) 允许指定MSAFE辅助数据文件的来源和可自定义的线程安全缓存配置的构造函数。

Method Summary

Modifier and Type	Method and Description
double	get24HoursKp(AbsoluteDate date) Kp指数是从Ap指数派生出来的。
double[]	getAp(AbsoluteDate date) 获取Ap地磁指数。
double	getAverageFlux(AbsoluteDate date) 获取以当前日期为中心的81天平均F10.7太阳通量的值。
double	getDailyFlux(AbsoluteDate date) 获取前一天的每日F10.7太阳通量的值。
DateComponents	getFileDate(AbsoluteDate date) 获取指定日期数据来自的文件的日期。
double	getInstantFlux(AbsoluteDate date) 获取瞬时太阳通量的值。
double	getMeanFlux(AbsoluteDate date) 获取平均太阳通量的值。
MarshallSolarActivityFutureEstimation.StrengthLevel	getStrengthLevel() 获取活动的强度级别。
double	getThreeHourlyKP(AbsoluteDate date) 获取3小时地磁指数的值。

Methods inherited from class org.orekit.models.earth.atmosphere.data.AbstractSolarActivityData

getCache, getLinearInterpolation, getLinearInterpolation, getMaxDate, getMinDate, getSupportedNames, getUTC

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_SUPPORTED_NAMES

public static final String DEFAULT_SUPPORTED_NAMES

适用于所有官方发布文件的支持名称的默认正则表达式。

自从:

10.0

另请参阅:

常量字段值

Constructor Detail

MarshallSolarActivityFutureEstimation

@DefaultDataContext
public MarshallSolarActivityFutureEstimation(String supportedNames,
                                                                 MarshallSolarActivityFutureEstimation.StrengthLevel strengthLevel)

简单构造函数。此构造函数使用默认数据上下文。

NASA Marshall太空中心使用的原始文件名的形式为：may2019f10_prd.txt或Oct1999F10.TXT。因此，适用于所有已发布文件的支持名称的推荐正则表达式是：DEFAULT_SUPPORTED_NAMES。

它为线程安全缓存提供了默认配置：

• 插槽数：OrekitConfiguration.getCacheSlotsNumber()
• 最大跨度：Constants.JULIAN_YEAR
• 最大跨度间隔：0

参数:

supportedNames - 支持的文件名的正则表达式

strengthLevel - 选择的活动强度级别

另请参阅:

MarshallSolarActivityFutureEstimation(String, StrengthLevel, DataProvidersManager, TimeScale)

MarshallSolarActivityFutureEstimation

public MarshallSolarActivityFutureEstimation(String supportedNames,
                                             MarshallSolarActivityFutureEstimation.StrengthLevel strengthLevel,
                                             DataProvidersManager dataProvidersManager,
                                             TimeScale utc)

允许指定MSAFE辅助数据文件的来源的构造函数。

它为线程安全缓存提供了默认配置：

• 插槽数：OrekitConfiguration.getCacheSlotsNumber()
• 最大跨度：31 * Constants.JULIAN_DAY
• 最大间隔：0
• 最小步长：27 * Constants.JULIAN_DAY

参数:

supportedNames - 支持的文件名的正则表达式

strengthLevel - 选择的活动强度级别

dataProvidersManager - 提供对辅助数据文件的访问

utc - UTC时间刻度

自从:

10.1

MarshallSolarActivityFutureEstimation

public MarshallSolarActivityFutureEstimation(String supportedNames,
                                             MarshallSolarActivityFutureEstimation.StrengthLevel strengthLevel,
                                             DataProvidersManager dataProvidersManager,
                                             TimeScale utc,
                                             int maxSlots,
                                             double maxSpan,
                                             double maxInterval,
                                             double minimumStep)

允许指定MSAFE辅助数据文件的来源和可自定义的线程安全缓存配置的构造函数。

参数:

supportedNames - 支持的文件名的正则表达式

strengthLevel - 选择的活动强度级别

dataProvidersManager - 提供对辅助数据文件的访问

utc - UTC时间刻度

maxSlots - 时间戳缓存中独立缓存时间槽的最大数量

maxSpan - 时间戳缓存中一个槽的最大持续时间跨度（以秒为单位）

maxInterval - 时间戳缓存中创建新槽的时间间隔

minimumStep - 用于非均匀表格值的覆盖最小步长。例如，用于缓存每月表格值时使用。可能为null。

自从:

10.1

MarshallSolarActivityFutureEstimation

@DefaultDataContext
public MarshallSolarActivityFutureEstimation(DataSource source,
                                                                 MarshallSolarActivityFutureEstimation.StrengthLevel strengthLevel)

使用默认数据上下文的简单构造函数。

它为线程安全缓存提供了默认配置：

• 插槽数：OrekitConfiguration.getCacheSlotsNumber()
• 最大跨度：31 * Constants.JULIAN_DAY
• 最大间隔：0
• 最小步长：27 * Constants.JULIAN_DAY

参数:

source - 数据源

strengthLevel - 选择的活动强度级别

自从:

12.0

MarshallSolarActivityFutureEstimation

public MarshallSolarActivityFutureEstimation(DataSource source,
                                             MarshallSolarActivityFutureEstimation.StrengthLevel strengthLevel,
                                             TimeScale utc)

简单构造函数。

它为线程安全缓存提供了默认配置：

• 插槽数：OrekitConfiguration.getCacheSlotsNumber()
• 最大跨度：31 * Constants.JULIAN_DAY
• 最大间隔：0
• 最小步长：27 * Constants.JULIAN_DAY

参数:

source - 数据源

strengthLevel - 选择的活动强度级别

utc - UTC时间刻度

自从:

12.0

MarshallSolarActivityFutureEstimation

public MarshallSolarActivityFutureEstimation(DataSource source,
                                             MarshallSolarActivityFutureEstimation.StrengthLevel strengthLevel,
                                             TimeScale utc,
                                             int maxSlots,
                                             double maxSpan,
                                             double maxInterval,
                                             double minimumStep)

具有可自定义的线程安全缓存配置的构造函数。

参数:

source - 数据源

strengthLevel - 选择的活动强度级别

utc - UTC时间标度

maxSlots - 时间戳缓存中最大独立缓存时间槽的数量

maxSpan - 时间戳缓存中一个时间槽的最大持续时间（以秒为单位）

maxInterval - 在时间戳缓存中创建新时间槽的时间间隔

minimumStep - 用于非均匀表格值的覆盖最小步长。例如，在缓存月度表格值时使用。否则使用Double.NaN。

自版本:

12.0

Method Detail

getInstantFlux

public double getInstantFlux(AbsoluteDate date)

获取瞬时太阳辐射通量的值。

参数:

date - 当前日期

返回:

瞬时太阳辐射通量

getMeanFlux

public double getMeanFlux(AbsoluteDate date)

获取平均太阳辐射通量的值。

参数:

date - 当前日期

返回:

平均太阳辐射通量

getThreeHourlyKP

public double getThreeHourlyKP(AbsoluteDate date)

获取3小时地磁指数的值。在极点延迟3小时，赤道延迟6小时，使用公式：延迟=6-abs(lat)*0.033（lat为度）。

参数:

date - 当前日期

返回:

3小时地磁指数

getFileDate

public DateComponents getFileDate(AbsoluteDate date)

获取指定日期数据来自的文件日期。

如果有多个MSAFE文件可用，则某些日期可能出现在多个文件中（例如，2007年8月在从1999年3月发布的第一个文件到2008年2月文件的所有文件中都有）。在这种情况下，使用最近文件的数据，旧文件将被丢弃。假定文件的日期为其第一个条目之后的6个月（这解释了为什么以2007年8月作为第一个条目的文件是2008年2月的文件）。这意味着MSAFE文件不能编辑以更改其时间跨度，否则将破坏旧条目覆盖机制。

参数:

date - 太阳活动数据的日期

返回:

文件的日期

get24HoursKp

public double get24HoursKp(AbsoluteDate date)

Kp指数是从Ap指数派生而来。

使用的方法在NOAA网站上解释如下：

该比例为0到9，以单位的三分之一表示，例如，5-为4 2/3，5为5，5+为5 1/3。ap（等效范围）指数从Kp指数派生如下：

Kp / Ap 转换表

Kp	0o	0+	1-	1o	1+	2-	2o	2+	3-	3o	3+	4-	4o	4+
ap	0	2	3	4	5	6	7	9	12	15	18	22	27	32
Kp	5-	5o	5+	6-	6o	6+	7-	7o	7+	8-	8o	8+	9-	9o
ap	39	48	56	67	80	94	111	132	154	179	207	236	300	400

参数:

date - Kp数据的日期

返回:

24小时地磁指数

getDailyFlux

public double getDailyFlux(AbsoluteDate date)

获取前一天的每日F10.7太阳辐射通量的值。

参数:

date - 当前日期

返回:

前一天的每日F10.7通量

getAverageFlux

public double getAverageFlux(AbsoluteDate date)

从接口复制的描述: NRLMSISE00InputParameters

获取以当前日期为中心的81天平均F10.7太阳辐射通量的值。

参数:

date - 当前日期

返回:

以当前日期为中心的81天平均F10.7太阳辐射通量

getAp

public double[] getAp(AbsoluteDate date)

获取A_p地磁指数。

A_p指数以数组形式提供，例如：

• 0 → 每日A_p
• 1 → 当前时间的3小时A_p指数
• 2 → 当前时间前3小时的3小时A_p指数
• 3 → 当前时间前6小时的3小时A_p指数
• 4 → 当前时间前9小时的3小时A_p指数
• 5 → 从当前时间前12到33小时的八个3小时A_p指数的平均值
• 6 → 从当前时间前36到57小时的八个3小时A_p指数的平均值

参数:

date - 当前日期

返回:

A_p指数数组

getStrengthLevel

public MarshallSolarActivityFutureEstimation.StrengthLevel getStrengthLevel()

获取活动的强度级别。

返回:

要设置的强度级别