AE9/AP9/SPM | 输入文件

发表于2021-02-27更新于2021-03-02字数统计1k阅读次数

输入文件构造

  文件的基本格式是键值对：Key:Value，关键字和键值都不区分大小写，以#开头的行将被认为是注释。各参数可以分为以下四类：

  • 基本模型参数(Basic Model Inputs)：核心参数，任何输入文件都需要
  • 高级模型参数(Advanced Model Inputs)：类似输入输出格式或者俯仰角的可选参数
  • 聚合参数(Accumulation and Aggregation Inputs)：用于组合复杂输出结果的可选参数
  • 剂量计算参数(Dose Calculation Inputs)：驱动ShieldDose2模型进行计算的可选参数
  • 轨道预报参数(Orbit Propagator Inputs)：用于生成轨道星历的可选参数

Tip
可以使用环境变量来代替表示路径或者文件名的参数值，例如在环境变量中设置好AX9HOME，然后可以在文件中使用MagFieldDB: %AX9HOME%/modelData/igrfDB.h5

基本参数

关键字 可选值 默认 必选 描述
ModelType AE9 AP9 PLASMA Y 模型类型，需要在ModelDB参数中指定的相应数据库文件
除非指定了俯仰角或方向矢量，否则计算得出的模型结果将是全方向的
ModelDB Y 用于驱动模型的数据库文件，与选定的ModelType相对应
必须包含文件的路径(绝对路径或相对于CmdLineAe9Ap9应用程序执行位置的路径)
对于PLASMA：指定适当的SPM*种类文件：E(电子)/H/HE(He)/O
MagFieldDB igrfDB.h5 Y 磁场模型的数据库文件
KPhiNNetDB fastPhi_net.mat Y K/Phi坐标神经网络的数据库文件
KHminNNetDB fast_hmin_net.mat Y K/Hmin坐标神经网络的数据库文件
OutFile 有效路径和文件名 Y 生成模型输出文件时使用的路径和文件名前缀
OrbitFile 星历文件的有效路径和文件名 Y 包含时间和位置信息的文件，有以下两种方式：
1. 输出：同时指定轨道类型和预测参数时，将生成星历表并写入该文件
通过TimeSpec，CoordSys，CoordUnits，CoordOrder和DataDelim描述格式
2. 输入：从现有文件中读取
通过InTimeSpec，InCoordSys，InCoordUnits，InCoordOrder和InDataDelim描述格式
FluxType 1PtDiff 2PtDiff* Integral [1] Y 计算的通量类型
Energies AE9: 0.04 – 10.0 (MeV)
AP9: 0.1 – 2000.0 (MeV)
Plasma/electrons: 0.001 – 0.040 (MeV)
Plasma/ions: 0.00115 – 0.1643 (MeV)		 Y 以MeV表示的能级列表计算通量值，能量值限制在模型的范围内
Energies2 同Energies N 仅在FluxType=2PtDiff时使用
FluxOut Mean
Percentile, ##
Perturbed, ###
MonteCarlo, ###* [2]		 Y 要生成/输出的通量数据模式，此参数可能会出现多次
百分数在1-99之间
扰动均值和蒙特卡洛scenario identification numbers在1-999之间
FluenceOut
FlueOut		 True or False F N 要生成/输出的通量数据
DoseRateOut
DoseOut		 True or False F N 要生成/输出的剂量率数据 [3]
DoseAccumOut
CDoseOut		 True or False F N 要生成/输出的累积剂量数据 [3:1]

高级参数

  待更新

聚合参数

  待更新

计量参数

  待更新

轨道参数

  待更新

附录

支持的坐标系

  有关坐标系的完整说明，参见Bhavnani和Vancour, 1991[4][5]

简称 全称 默认参数及单位[6]
GEI 地心惯性系 X(Re), Y(Re), Z(Re)[7]
GEO 地理坐标系 X(Re), Y(Re), Z(Re)
GDZ World Geodetic System 1984 Altitude(km), Lat(deg), Lon(deg)
GSM 地心太阳磁轴系 X(Re), Y(Re), Z(Re)
GSE 地心太阳黄道系 X(Re), Y(Re), Z(Re)
SM 太阳磁坐标 X(Re), Y(Re), Z(Re)
MAG 地磁坐标系 X(Re), Y(Re), Z(Re)
SPH 球坐标 Radius(Re), Colatitude(deg), Lon(deg)
RLL 半径，纬度，经度 Radius(Re), Lat(deg), Lon(deg)

  1. 剂量计算只能使用1PtDiff ↩︎

  2. 可以在同一行上用逗号分割多个值，例如perturbed,1,2,5-10,20 ↩︎

  3. 不适用于SPM模型 ↩︎ ↩︎

  4. NASA参考系说明：https://sscweb.gsfc.nasa.gov/users_guide/Appendix_C.html ↩︎

  5. ESA参考系说明：https://www.spenvis.oma.be/help/background/coortran/coortran.html ↩︎

  6. 坐标范围：Latitude=-90°—90°;Colatitude=0°—180°;Longitude=-180°—360° ↩︎

  7. 1 Re = 6371.2 km ↩︎