AE9/AP9/SPM | 输入文件
输入文件构造
文件的基本格式是键值对: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) |
剂量计算只能使用
1PtDiff
↩︎可以在同一行上用逗号分割多个值,例如
perturbed,1,2,5-10,20
↩︎NASA参考系说明:https://sscweb.gsfc.nasa.gov/users_guide/Appendix_C.html ↩︎
ESA参考系说明:https://www.spenvis.oma.be/help/background/coortran/coortran.html ↩︎
坐标范围:Latitude=-90°—90°;Colatitude=0°—180°;Longitude=-180°—360° ↩︎
1 Re = 6371.2 km ↩︎