MARS 顶层结构、配置与平台
页面定位
覆盖 deftank、datadir、startfiles、平台脚本、样例配置和顶层文档。
兼容性关注:影响运行目录组织、配置键、样例默认值和集群作业启动。
本页是 5.3 到 6.3 版本差异详情页,只解释改动职责与影响,不展开逐行代码差异。
变化统计
本主题覆盖 50 个路径事件:新增 22、删除 8、修改 20。
主要变化
- 顶层
README的历史记录职责拆分到changelog.txt;deftank/z2sig.def的等内容样例在 6.3 以z2sig.def.MCD6命名。 - XIOS XML 从
deftank/根目录集中到deftank/xios/,context 文件同时采用context_pcm_physics.xml名称。 changelog.txt:新增独立 Changelog 文件;其前缀继承 5.3 README 中的历史记录。datadir/README:新增 datadir 获取说明,指向官方在线火星运行数据归档,而不在源码树内复制整套数据。deftank/adastra/adastra_cpu_binding.sh:新增 Slurm CPU/GPU 亲和性包装脚本,按本地 rank 与 MPI/OpenMP 组合选择 NUMA CPU 集合,并在需要时绑定 GPU。deftank/adastra/README:新增 Adastra 运行目录说明,描述 GCM 作业脚本、逐月续跑方式及需要按账户和队列调整的参数。deftank/adastra/run0:新增运行脚本run0,用于deftank/adastra下的环境准备、作业提交或续跑流程;该脚本进入 6.3。deftank/adastra/run_month1:新增运行脚本run_month1,用于deftank/adastra下的环境准备、作业提交或续跑流程;该脚本进入 6.3。deftank/adastra/run_year1:新增运行脚本run_year1,用于deftank/adastra下的环境准备、作业提交或续跑流程;该脚本进入 6.3。deftank/callphys.def.co2clouds.GCM5:更新运行配置或作业样例callphys.def.co2clouds.GCM5:新增配置项outputs_per_sol、max_icecap_albedo、reff_lift_dust、albedo_h2o_cap、call_mass_fixer_dyn;移除配置项tracer、lwrite、albedo_h2o_ice、thermoswater。deftank/callphys.def.GCM5:由旧 callphys.def.watercycle 重命名为 GCM5 配置模板,明确其对应 CO2、尘埃和水循环组合。deftank/callphys.def.GCM6:更新运行配置或作业样例callphys.def.GCM6:新增配置项outputs_per_sol、calllott_nonoro、nonoro_gwd_epflux_max、nonoro_gwd_sat、nonoro_gwd_rdiss、nonoro_gwd_kmax、nonoro_gwd_kmin、nonoro_gwd_xlaunch、max_icecap_albedo、reff_lift_dust、temp_dependent_m、cloud_adapt_ts、albedo_h2o_cap、call_mass_fixer_dyn;移除配置项tracer、lwrite、temp_dependant_m、albedo_h2o_ice、thermoswater。deftank/callphys.def.hdo.GCM5:更新运行配置或作业样例callphys.def.hdo.GCM5:新增配置项outputs_per_sol、max_icecap_albedo、reff_lift_dust、albedo_h2o_cap、call_mass_fixer_dyn;移除配置项tracer、lwrite、albedo_h2o_ice、thermoswater。deftank/callphys.def.MCD5:更新运行配置或作业样例callphys.def.MCD5:新增配置项outputs_per_sol、max_icecap_albedo、reff_lift_dust、albedo_h2o_cap、call_mass_fixer_dyn;移除配置项tracer、lwrite、albedo_h2o_ice、thermoswater。- 其余 38 项见下表和全量索引。
受影响路径
| 编号 | 5.3 路径 | 6.3 路径 | 类型 | SHA-256 核验 | 改动概述 | 官方记录 |
|---|---|---|---|---|---|---|
M-0001 |
— | changelog.txt |
新增 | —→8bcb67808eaa(已核验) |
新增独立 Changelog 文件;其前缀继承 5.3 README 中的历史记录。 | 源码差异;未找到对应 Changelog 条目 |
M-0002 |
— | datadir/README |
新增 | —→53948ff11298(已核验) |
新增 datadir 获取说明,指向官方在线火星运行数据归档,而不在源码树内复制整套数据。 | 源码差异;未找到对应 Changelog 条目 |
M-0003 |
— | deftank/adastra/adastra_cpu_binding.sh |
新增 | —→97e8bc551304(已核验) |
新增 Slurm CPU/GPU 亲和性包装脚本,按本地 rank 与 MPI/OpenMP 组合选择 NUMA CPU 集合,并在需要时绑定 GPU。 | 官方记录:27/06/2025,EM |
M-0004 |
— | deftank/adastra/README |
新增 | —→cd03dbcaa982(已核验) |
新增 Adastra 运行目录说明,描述 GCM 作业脚本、逐月续跑方式及需要按账户和队列调整的参数。 | 官方分组记录:27/06/2025,EM |
M-0005 |
— | deftank/adastra/run0 |
新增 | —→9c1af3917a8e(已核验) |
新增运行脚本 run0,用于 deftank/adastra 下的环境准备、作业提交或续跑流程;该脚本进入 6.3。 |
官方分组记录:27/06/2025,EM |
M-0006 |
— | deftank/adastra/run_month1 |
新增 | —→3838d2696757(已核验) |
新增运行脚本 run_month1,用于 deftank/adastra 下的环境准备、作业提交或续跑流程;该脚本进入 6.3。 |
官方分组记录:27/06/2025,EM |
M-0007 |
— | deftank/adastra/run_year1 |
新增 | —→e8a9dcf213fe(已核验) |
新增运行脚本 run_year1,用于 deftank/adastra 下的环境准备、作业提交或续跑流程;该脚本进入 6.3。 |
官方记录:17/07/2025,JBC |
M-0008 |
deftank/callphys.def.co2clouds.GCM5 |
deftank/callphys.def.co2clouds.GCM5 |
修改 | e3c7d0125bc3→c90c4be4ae15(已核验) |
更新运行配置或作业样例 callphys.def.co2clouds.GCM5:新增配置项 outputs_per_sol、max_icecap_albedo、reff_lift_dust、albedo_h2o_cap、call_mass_fixer_dyn;移除配置项 tracer、lwrite、albedo_h2o_ice、thermoswater。 |
官方分组记录:24/10/2024,EM;29/01/2026,EM;06/02/2026,EM;10/02/2026,JM;25/03/2026,EM;26/03/2026,YCL |
M-0009 |
— | deftank/callphys.def.GCM5 |
新增 | —→c94b1eef02e8(已核验) |
由旧 callphys.def.watercycle 重命名为 GCM5 配置模板,明确其对应 CO2、尘埃和水循环组合。 | 官方记录:16/01/2024,EM |
M-0010 |
deftank/callphys.def.GCM6 |
deftank/callphys.def.GCM6 |
修改 | 5ae21ce36114→06adbb485a9c(已核验) |
更新运行配置或作业样例 callphys.def.GCM6:新增配置项 outputs_per_sol、calllott_nonoro、nonoro_gwd_epflux_max、nonoro_gwd_sat、nonoro_gwd_rdiss、nonoro_gwd_kmax、nonoro_gwd_kmin、nonoro_gwd_xlaunch、max_icecap_albedo、reff_lift_dust、temp_dependent_m、cloud_adapt_ts、albedo_h2o_cap、call_mass_fixer_dyn;移除配置项 tracer、lwrite、temp_dependant_m、albedo_h2o_ice、thermoswater。 |
官方记录:28/09/2023,EM;30/09/2023,AB;24/10/2024,EM;29/01/2026,EM;06/02/2026,EM;10/02/2026,JM;25/03/2026,EM;26/03/2026,YCL |
M-0011 |
deftank/callphys.def.hdo.GCM5 |
deftank/callphys.def.hdo.GCM5 |
修改 | 2804efbd0528→fa39eb5dfed0(已核验) |
更新运行配置或作业样例 callphys.def.hdo.GCM5:新增配置项 outputs_per_sol、max_icecap_albedo、reff_lift_dust、albedo_h2o_cap、call_mass_fixer_dyn;移除配置项 tracer、lwrite、albedo_h2o_ice、thermoswater。 |
官方记录:20/09/2024,EM;24/10/2024,EM;29/01/2026,EM;06/02/2026,EM;10/02/2026,JM;25/03/2026,EM;26/03/2026,YCL |
M-0012 |
deftank/callphys.def.MCD5 |
deftank/callphys.def.MCD5 |
修改 | 461a3f17c5b6→b9d5e92fdb12(已核验) |
更新运行配置或作业样例 callphys.def.MCD5:新增配置项 outputs_per_sol、max_icecap_albedo、reff_lift_dust、albedo_h2o_cap、call_mass_fixer_dyn;移除配置项 tracer、lwrite、albedo_h2o_ice、thermoswater。 |
官方分组记录:24/10/2024,EM;29/01/2026,EM;06/02/2026,EM;10/02/2026,JM;25/03/2026,EM;26/03/2026,YCL |
M-0013 |
— | deftank/callphys.def.MCD6 |
新增 | —→521ff1d569b7(已核验) |
新增运行配置或作业样例 callphys.def.MCD6,包含 datadir、outputs_per_sol、diurnal、season 等配置项;该配置进入 6.3。 |
官方记录:28/09/2023,EM;30/01/2024,CS |
M-0014 |
deftank/callphys.def.notracers |
— | 删除 | 18a1ea0ecd4c→—(已核验) |
移除运行配置或作业样例 callphys.def.notracers,包含 tracer、diurnal、season、lwrite 等配置项;该配置不再随 6.3 分发。 |
官方记录:28/09/2023,EM |
M-0015 |
deftank/callphys.def.watercycle |
— | 删除 | 30078461a755→—(已核验) |
移除旧 watercycle 命名的物理配置模板;同一内容体系在 6.3 以 callphys.def.GCM5 名称承接。 | 官方记录:16/01/2024,EM |
M-0016 |
deftank/ciclad/run0 |
deftank/ciclad/run0 |
修改 | 1122feb0f1bf→7fbfa6fddb58(已核验) |
增强续跑脚本的 GCM 可执行文件和 start 输入检查、失败退出及崩溃报告,同时规范 num_run/numnew 推进。 | 官方分组记录:14/05/2025,JBC |
M-0017 |
deftank/ciclad/run_month1 |
deftank/ciclad/run_month1 |
修改 | 0f3a47861048→b4d34adfcf63(已核验) |
增强月度续跑脚本的 run.def.ref、run0 和 run_monthN 前置检查、ERR 陷阱与失败退出,并规范月份编号推进。 | 官方分组记录:14/05/2025,JBC |
M-0021 |
deftank/irene/run0 |
deftank/irene/run0 |
修改 | 281e34f24418→0be4e51e2574(已核验) |
增强续跑脚本的 GCM 可执行文件和 start 输入检查、失败退出及崩溃报告,同时规范 num_run/numnew 的推进。 | 官方分组记录:14/05/2025,JBC |
M-0022 |
deftank/irene/run_month1 |
deftank/irene/run_month1 |
修改 | 8ba69ef461a7→ab2920cc28af(已核验) |
增强月度续跑脚本的 run.def.ref、run0 和 run_monthN 前置检查、ERR 陷阱与失败退出,并规范月份编号推进。 | 官方分组记录:14/05/2025,JBC |
M-0023 |
— | deftank/launch_1Dchained.sh |
新增 | —→6b29c82e0b84(已核验) |
新增运行脚本 launch_1Dchained.sh,用于 deftank 下的环境准备、作业提交或续跑流程;该脚本进入 6.3。 |
官方记录:09/02/2024,JBC |
M-0024 |
— | deftank/launch_orb_1Dchained.sh |
新增 | —→79dbb1aae199(已核验) |
新增运行脚本 launch_orb_1Dchained.sh,用于 deftank 下的环境准备、作业提交或续跑流程;该脚本进入 6.3。 |
官方记录:09/02/2024,JBC;31/05/2024,JBC |
M-0025 |
— | deftank/mesu/README |
新增 | —→c3347b5321bf(已核验) |
新增 MESU 集群逐月续跑说明,说明 run_month1→run_monthN 链及 run0/run.def.ref 的适配要求。 | 源码差异;未找到对应 Changelog 条目 |
M-0026 |
— | deftank/mesu/run0 |
新增 | —→8264f88c084b(已核验) |
新增运行脚本 run0,用于 deftank/mesu 下的环境准备、作业提交或续跑流程;该脚本进入 6.3。 |
源码差异;未找到对应 Changelog 条目 |
M-0027 |
— | deftank/mesu/run_month1 |
新增 | —→306504050bdf(已核验) |
新增运行脚本 run_month1,用于 deftank/mesu 下的环境准备、作业提交或续跑流程;该脚本进入 6.3。 |
官方分组记录:09/03/2026,JBC |
M-0028 |
deftank/occigen/run0 |
deftank/occigen/run0 |
修改 | 7142623e8421→dc0fb1cc52da(已核验) |
增强续跑脚本的 GCM 可执行文件和 start 输入检查、失败退出及崩溃报告,同时规范 num_run/numnew 的推进。 | 官方分组记录:14/05/2025,JBC |
M-0029 |
deftank/occigen/run_month1 |
deftank/occigen/run_month1 |
修改 | d673657e14f5→ab6b763dcc5e(已核验) |
增强月度续跑脚本的 run.def.ref、run0 和 run_monthN 前置检查、ERR 陷阱与失败退出,并规范月份编号推进。 | 官方分组记录:14/05/2025,JBC |
M-0030 |
deftank/README |
deftank/README |
修改 | d154d204b3ee→3ddbe34b97f8(已核验) |
更新标准配置说明:样例命名转向 GCM5/GCM6/MCD5/MCD6,并将 MCD6 标准垂直网格说明更新到约 250 km。 | 源码差异;未找到对应 Changelog 条目 |
M-0031 |
deftank/run.def.1d |
deftank/run.def.1d |
修改 | 25f8db257b50→5d60fcac6a79(已核验) |
更新运行配置或作业样例 run.def.1d:新增配置项 startfiles_1D、diagsoil、slow_diagfi、ctrl_h2ovap、relaxtime_h2ovap、ctrl_h2oice、relaxtime_h2oice;调整配置项 time、ndt、psurf、co2ice、slope_inclination、slope_orientation。 |
官方记录:19/06/2024,JBC;30/10/2025,JM |
M-0032 |
deftank/run.def.32x24x25.GCM5 |
deftank/run.def.32x24x25.GCM5 |
修改 | 942484928612→4be5c26aae97(已核验) |
移除已废弃的 ecritphy;输出频率改由 outputs_per_sol 统一控制。 | 官方分组记录:12/06/2024,EM |
M-0033 |
deftank/run.def.32x24x32.GCM5 |
deftank/run.def.32x24x32.GCM5 |
修改 | 942484928612→4be5c26aae97(已核验) |
移除已废弃的 ecritphy;输出频率改由 outputs_per_sol 统一控制。 | 官方分组记录:12/06/2024,EM |
M-0034 |
deftank/run.def.64x48x32.GCM5 |
deftank/run.def.64x48x32.GCM5 |
修改 | 0e12b2150dfb→1669ef36bc61(已核验) |
移除已废弃的 ecritphy;输出频率改由 outputs_per_sol 统一控制。 | 官方分组记录:12/06/2024,EM |
M-0035 |
deftank/run.def.64x48x49.MCD5 |
deftank/run.def.64x48x49.MCD5 |
修改 | c7b6a9bda724→9e51debdb068(已核验) |
移除已废弃的 ecritphy;输出频率改由 outputs_per_sol 统一控制。 | 官方分组记录:12/06/2024,EM |
M-0036 |
deftank/run.def.64x48x54.GCM6 |
deftank/run.def.64x48x54.GCM6 |
修改 | b69aee9fc8ee→6db9933ee23c(已核验) |
移除已废弃的 ecritphy;输出频率改由 outputs_per_sol 统一控制。 | 官方分组记录:12/06/2024,EM |
M-0037 |
— | deftank/run.def.64x48x73.MCD6 |
新增 | —→be948e99e717(已核验) |
新增运行配置或作业样例 run.def.64x48x73.MCD6,包含 planet_type、nday、day_step、iperiod 等配置项;该配置进入 6.3。 |
源码差异;未找到对应 Changelog 条目 |
M-0038 |
deftank/run0 |
deftank/run0 |
修改 | adcc36a0ac66→243a0eacf13a(已核验) |
增强顶层续跑脚本的 GCM 可执行文件和 start 输入检查、失败退出及崩溃报告,同时规范 gcm/numnew 推进。 | 官方分组记录:14/05/2025,JBC |
M-0039 |
— | deftank/spirit/README |
新增 | —→15acaafaba94(已核验) |
新增 SPIRIT/MESOIPSL 集群逐月续跑说明,说明 run_month1→run_monthN 链及配套脚本适配。 | 源码差异;未找到对应 Changelog 条目 |
M-0040 |
— | deftank/spirit/run0 |
新增 | —→14975ec012b6(已核验) |
新增运行脚本 run0,用于 deftank/spirit 下的环境准备、作业提交或续跑流程;该脚本进入 6.3。 |
官方分组记录:30/03/2023,EM |
M-0041 |
— | deftank/spirit/run_month1 |
新增 | —→229338eb2930(已核验) |
新增运行脚本 run_month1,用于 deftank/spirit 下的环境准备、作业提交或续跑流程;该脚本进入 6.3。 |
官方分组记录:30/03/2023,EM |
M-0042 |
deftank/traceur.def.MCD5 |
deftank/traceur.def.MCD5 |
修改 | 86e87545ff91→ac86c8445ae2(已核验) |
更新配置 traceur.def.MCD5 的默认值、条目组织或平台参数。 |
官方记录:16/01/2024,EM |
M-0043 |
— | deftank/traceur.def.MCD6 |
新增 | —→dd78963cae16(已核验) |
新增运行配置或作业样例 traceur.def.MCD6,列出 co2、co、o、o1d 等条目;该配置进入 6.3。 |
源码差异;未找到对应 Changelog 条目 |
M-0048 |
deftank/z2sig.def |
— | 删除 | 0f97272dcf6f→—(已核验) |
旧通用垂直坐标样例在 6.3 中以 MCD6 名称组织;内容与 z2sig.def.MCD6 相同。 | 官方分组记录:28/09/2023,EM |
M-0049 |
— | deftank/z2sig.def.MCD6 |
新增 | —→0f97272dcf6f(已核验) |
新增 MCD6 命名的垂直坐标样例;与 5.3 z2sig.def 哈希相同。 | 官方记录:28/09/2023,EM |
M-0088 |
libf/callphys.def |
— | 删除 | d22a033ea78e→—(已核验) |
移除文件 callphys.def,包含 tracer、diurnal、season、callstats 等配置项;该配置不再随 6.3 分发。 |
源码差异;未找到对应 Changelog 条目 |
M-0089 |
libf/callphys_conrath.def |
— | 删除 | 6bcf57df28b1→—(已核验) |
移除文件 callphys_conrath.def,包含 tracer、diurnal、season、callstats 等配置项;该配置不再随 6.3 分发。 |
源码差异;未找到对应 Changelog 条目 |
M-0090 |
libf/callphys_nowater.def |
— | 删除 | 6893ac5d15a2→—(已核验) |
移除文件 callphys_nowater.def,包含 tracer、diurnal、season、callstats 等配置项;该配置不再随 6.3 分发。 |
源码差异;未找到对应 Changelog 条目 |
M-0091 |
libf/callphys_nowater_conrath.def |
— | 删除 | 42757ffaf696→—(已核验) |
移除文件 callphys_nowater_conrath.def,包含 tracer、diurnal、season、callstats 等配置项;该配置不再随 6.3 分发。 |
源码差异;未找到对应 Changelog 条目 |
M-0282 |
README |
README |
修改 | a2e01420bd66→5911da2385df(已核验) |
把根 README 从历史日志改为简短目录概览,并将连续版本历史拆分到 changelog.txt。 | 源码差异;未找到对应 Changelog 条目 |
M-0283 |
— | startfiles/README |
新增 | —→184ef7a6dadd(已核验) |
新增 start 文件获取与 1D 输入说明,区分 MCD5.3/MCD6.1 归档并说明 start1D.txt 的层数和 tracer 顺序。 | 源码差异;未找到对应 Changelog 条目 |
M-0284 |
— | startfiles/start1D.txt |
新增 | —→39b0159ac8f8(已核验) |
新增 1D 八层初始状态样例,给出地表压强、CO2/水/尘 tracer、风和位温剖面。 | 官方记录:26/09/2023,JBC;04/03/2026,JBC |
M-0285 |
user_manual.pdf |
— | 删除 | ab677fc00697→—(已核验) |
源码树不再附带旧 PDF 手册,文档入口转向官方在线 Wiki。 | 官方记录:05/02/2026,EM |
证据边界
- 路径状态和哈希关系来自两棵本地快照的机械比较。
- 官方记录来自 MARS Changelog 增量;COMMON 命中仅表示间接记录。
- 未找到 Changelog 条目不等于改动无意义,只表示没有可直接关联的官方文字记录。
- 本页不把未运行的数值或性能影响写成既定事实。