MARS util 工具
页面定位
覆盖后处理、重网格、柱积分、观测模拟和 1D 输入生成工具。
兼容性关注:影响离线工作流、变量命名和输出兼容性,不参与主积分。
本页是 5.3 到 6.3 版本差异详情页,只解释改动职责与影响,不展开逐行代码差异。
变化统计
本主题覆盖 22 个路径事件:新增 8、删除 0、修改 14。
主要变化
util/aeropt_mod.F90:新增离线工具或辅助文件aeropt_mod.F90,其中定义aeropt_mod、read_optpropfile、interp_wvl_reff、create_logfile;该实现进入 6.3。util/aeroptical.def:重排 aeroptical 输入格式,新增柱积分光学厚度开关,并把各气溶胶的质量混合比、有效半径、密度和光学表改为逐行配置。util/aeroptical.F90:把气溶胶光学工具扩展为任意气溶胶配置,支持常数或字段 reff、消光/吸收剖面与柱积分输出,并通过多种坐标来源回退计算层厚。util/check_co2cycle.def:新增 check_co2cycle.e 的批量输入模板,指定输入/输出目录、NetCDF 文件名和 sol/Ls 输出时间单位。util/check_co2cycle.F90:由旧 xvik 工具重命名并扩展为 check_co2cycle,继续生成着陆点气压、日平均和谐波诊断。util/compile:更新 util 编译脚本,新增 Irene/Adastra 编译环境,并让 aeroptical 工具联编 aeropt_mod。util/concatnc.F90:扩展 concatnc 对传统 diagfi 与 XIOS 文件的兼容:识别 lat/lon、time_counter、controle_axe、area 和 phisfi 等坐标、时间、控制轴、面积及地表位势别名。util/expandstartfi.F90:扩展 startfi 工具以适配坡面维状态,并修正极区网格扩展时的索引与字段复制。util/extractcolumnfor1D.F90:新增 3D 文件柱提取工具,可按 i/j/time 索引选择变量并生成 testphys1d 使用的 profile_* 文件。util/gencol.def:新增 gencol.e 的批量输入模板,指定输入 NetCDF、待积分变量及输出文件约定。util/gencol.F90:新增 gencol 柱积分工具,可从质量/体积混合比或浓度计算选定 tracer 的柱含量。util/README:扩展 util 使用说明:补充气溶胶柱光学厚度,并新增 gencol、check_co2cycle 与 extractcolumnfor1D 工作流。- 其余 10 项见下表和全量索引。
受影响路径
| 编号 | 5.3 路径 | 6.3 路径 | 类型 | SHA-256 核验 | 改动概述 | 官方记录 |
|---|---|---|---|---|---|---|
M-0286 |
— | util/aeropt_mod.F90 |
新增 | —→3035e9cf1d9e(已核验) |
新增离线工具或辅助文件 aeropt_mod.F90,其中定义 aeropt_mod、read_optpropfile、interp_wvl_reff、create_logfile;该实现进入 6.3。 |
官方记录:14/11/2022,AB;23/11/2022,AB |
M-0287 |
util/aeroptical.def |
util/aeroptical.def |
修改 | 5988a590e6f4→4292d8412912(已核验) |
重排 aeroptical 输入格式,新增柱积分光学厚度开关,并把各气溶胶的质量混合比、有效半径、密度和光学表改为逐行配置。 | 官方记录:14/11/2022,AB;23/11/2022,AB |
M-0288 |
util/aeroptical.F90 |
util/aeroptical.F90 |
修改 | ab6a217b5eb6→367655e0b979(已核验) |
把气溶胶光学工具扩展为任意气溶胶配置,支持常数或字段 reff、消光/吸收剖面与柱积分输出,并通过多种坐标来源回退计算层厚。 | 官方记录:14/11/2022,AB;23/11/2022,AB;23/02/2023,AB |
M-0289 |
— | util/check_co2cycle.def |
新增 | —→b77da3e40726(已核验) |
新增 check_co2cycle.e 的批量输入模板,指定输入/输出目录、NetCDF 文件名和 sol/Ls 输出时间单位。 | 官方记录:30/04/2026,JM |
M-0290 |
— | util/check_co2cycle.F90 |
新增 | —→49b58c4733c1(已核验) |
由旧 xvik 工具重命名并扩展为 check_co2cycle,继续生成着陆点气压、日平均和谐波诊断。 | 官方记录:30/04/2026,JM |
M-0291 |
util/compile |
util/compile |
修改 | 641260c87422→791f674aabe8(已核验) |
更新 util 编译脚本,新增 Irene/Adastra 编译环境,并让 aeroptical 工具联编 aeropt_mod。 | 官方记录:29/11/2022,AB;05/10/2023,AB |
M-0292 |
util/concatnc.F90 |
util/concatnc.F90 |
修改 | 5ba0655f329d→63cb71fd62a3(已核验) |
扩展 concatnc 对传统 diagfi 与 XIOS 文件的兼容:识别 lat/lon、time_counter、controle_axe、area 和 phisfi 等坐标、时间、控制轴、面积及地表位势别名。 | 源码差异;未找到对应 Changelog 条目 |
M-0293 |
util/expandstartfi.F90 |
util/expandstartfi.F90 |
修改 | 439bd90a29fb→6ad1daf1250c(已核验) |
扩展 startfi 工具以适配坡面维状态,并修正极区网格扩展时的索引与字段复制。 | 官方记录:30/05/2023,RV;06/07/2023,EM |
M-0294 |
— | util/extractcolumnfor1D.F90 |
新增 | —→c31ce5ab6f48(已核验) |
新增 3D 文件柱提取工具,可按 i/j/time 索引选择变量并生成 testphys1d 使用的 profile_* 文件。 | 官方记录:05/06/2026,EM |
M-0295 |
— | util/gencol.def |
新增 | —→f1a3df09fd2b(已核验) |
新增 gencol.e 的批量输入模板,指定输入 NetCDF、待积分变量及输出文件约定。 | 官方记录:16/06/2025,JM |
M-0296 |
— | util/gencol.F90 |
新增 | —→9db1fefe07c3(已核验) |
新增 gencol 柱积分工具,可从质量/体积混合比或浓度计算选定 tracer 的柱含量。 | 官方记录:16/06/2025,JM |
M-0297 |
util/README |
util/README |
修改 | 24d08c9b6a73→f5f3f1c74e41(已核验) |
扩展 util 使用说明:补充气溶胶柱光学厚度,并新增 gencol、check_co2cycle 与 extractcolumnfor1D 工作流。 | 官方记录:16/06/2025,JM |
M-0298 |
util/simu_MCS.F90 |
util/simu_MCS.F90 |
修改 | 8380b34202ae→c36c5c837916(已核验) |
适配 aeroptical 新尘埃光学厚度变量 opa_dust,同时保留旧 opadust 名称的向后兼容读取。 | 官方记录:09/06/2023,AB |
M-0299 |
util/startarchive2icosa/compile |
util/startarchive2icosa/compile |
修改 | ad7f11e6d113→85837b912840(已核验) |
更新 startarchive2icosa 编译脚本的源码清单、编译选项或依赖链接设置。 | 官方分组记录:08/11/2022,RV |
M-0300 |
util/startarchive2icosa/icosa_finalize.bash |
util/startarchive2icosa/icosa_finalize.bash |
修改 | 6eb6ad6c858c→c9de97e1c9d0(已核验) |
更新 DYNAMICO 转换环境收尾脚本,调整模块环境恢复与清理步骤。 | 官方分组记录:08/11/2022,RV |
M-0301 |
util/startarchive2icosa/iodef.xml |
util/startarchive2icosa/iodef.xml |
修改 | 79781ffe5f4c→052ba3c3ebff(已核验) |
更新 XIOS/XML 配置 iodef.xml 的对象定义或输出选择,涉及 ZMEA_clean、ZSTD_clean、ZSIG_clean、ZGAM_clean。 |
官方分组记录:08/11/2022,RV |
M-0302 |
util/startarchive2icosa/README |
util/startarchive2icosa/README |
修改 | 5a7e72f3c2d4→25fdb22443cf(已核验) |
更新 startarchive2icosa 工具说明,补充当前编译、环境装载和转换使用约定。 | 官方分组记录:08/11/2022,RV |
M-0303 |
util/startarchive2icosa/rearrange_startphy.f90 |
util/startarchive2icosa/rearrange_startphy.f90 |
修改 | 21574d9e5d4b→e37ca31b8522(已核验) |
扩展 startphy 重排以识别 subslope、index、inter_slope 和 nslope 维度,并支持坡面及土壤×坡面数组。 | 官方分组记录:08/11/2022,RV |
M-0304 |
— | util/startarchive2icosa/run_icosa.def_no_start |
新增 | —→9f3ba5879d3f(已核验) |
新增离线工具或辅助文件 run_icosa.def_no_start,包含 nbp、llm、disvert、optim_it 等配置项;该配置进入 6.3。 |
官方分组记录:08/11/2022,RV |
M-0305 |
util/startarchive2icosa/start_archive2icosa.f90 |
util/startarchive2icosa/start_archive2icosa.f90 |
修改 | 5c4858422eed→3c627ef2b66f(已核验) |
扩展 DYNAMICO 初始场转换:tracer 数由 7 增至 11,加入 subslope 轴与字段,并把地表温度、发射率、表面 tracer 和土壤温度改为坡面维。 | 官方分组记录:08/11/2022,RV |
M-0306 |
— | util/startarchive2icosa/tracer.def_no_start |
新增 | —→710acc744350(已核验) |
新增离线工具或辅助文件 tracer.def_no_start,列出 default、co2、dust_number、dust_mass 等条目;该配置进入 6.3。 |
官方分组记录:08/11/2022,RV |
M-0307 |
util/zrecast.F90 |
util/zrecast.F90 |
修改 | 3677230ff7cf→b16a4150de2f(已核验) |
为新 NCO 补充 _FillValue 读写兼容,并在对数插值中把非正值映射到数值精度以下的近零值。 | 官方记录:27/09/2023,YL+AB |
证据边界
- 路径状态和哈希关系来自两棵本地快照的机械比较。
- 官方记录来自 MARS Changelog 增量;COMMON 命中仅表示间接记录。
- 未找到 Changelog 条目不等于改动无意义,只表示没有可直接关联的官方文字记录。
- 本页不把未运行的数值或性能影响写成既定事实。