Pending confirmation triage
快速理解
它做什么: 收束 wiki 中的 待确认 与源码疑点,按 P0-P3 优先级分级。
关键结果: P0 影响数值/守恒/索引/restart 复现,优先用最小运行案例确认。
页面定位
本页汇总 Mars Wiki 中的 待确认 与源码疑点,并按验证需求分级:运行验证、外部数据或文献验证,以及尚待集中复核的源码边界。
处理原则:
- 能由源码直接确认的内容,不再保留为旧缺页或旧登记占位。
- 不能由源码单独确认的内容,保留
待确认,并说明需要哪类证据。 - 不把推断写成事实;需要运行、构建日志、外部数据版本或维护者判断的内容继续显式标注。
优先级分类
| 等级 | 含义 | 处理方式 |
|---|---|---|
| P0 | 可能影响数值结果、守恒性、数组索引或 restart 复现 | 优先用最小运行案例或维护者确认。 |
| P1 | 影响物理解释、外部数据版本或诊断可比性 | 需要文献、数据文件版本或实验配置佐证。 |
| P2 | 影响构建、并行行为或工具链复现 | 用 build log、脚本和实际工具运行核验。 |
| P3 | 遗留变量、注释、命名或未使用导入 | 保留在页面内,批量清理时再处理。 |
P0 源码疑点
| 页面 | 疑点 | 需要的证据 |
|---|---|---|
| co2cloud_mod | SatIndex 或相邻饱和索引逻辑中疑似使用了容易混淆的数组下标。 |
小列例子复现 CO2 云激活层选择,并与预期饱和剖面对比。 |
| conduction | 热传导系数或层索引边界在高层热层路径中有待确认项。 | 单列热层测试或与原论文/历史版本对比。 |
| vdifc-water-surface-exchange | 水汽地表交换段的 .or. 守卫疑似恒真,可能影响 h2o_ice 注入路径理解。 |
最小水循环配置运行,记录该分支的进入条件与 tendency 输出。 |
| topmons_mod | qbar_number_pbl 等 PBL 平均量的单位和数浓度解释仍需确认。 |
追踪调用方输入单位,或用诊断输出核对量纲。 |
| writerestart1D_mod | 文本 restart 中 q 实参维度和读取端格式的完全对应关系待确认。 |
testphys1d 写出再读入闭环测试。 |
P1 物理参数和外部数据
| 页面 | 疑点 | 需要的证据 |
|---|---|---|
| reaction-rates | 热层化学反应速率常数的外部版本来源尚未完全归档。 | 对照 chemthermos_reactionrates.def 的历史来源、JPL/UMIST 或项目文档。 |
| radiation 与辐射相关文件页 | 气溶胶、辐射表或典型光学参数的推荐范围不能仅由源码判断。 | 数据表版本、运行配置和基准实验说明。 |
| dust-cycle / dust-free-evolution-tests | dustscaling_mode=0 的 10 天 free-dust 试验已给出 dust devil 候选,但长积分稳定性、质量收支闭合和 two-moment 风应力阈值 lifting 仍未确认。 |
长积分输出、尘埃收支诊断,以及针对 doubleq 分支的源码改造设计或维护者确认。 |
| aeropt_mod / aeroptical | ASCII 光学性质表的具体文件版本、半径范围和波长范围需要与 datadir 实物对应。 | 实际 datadir 文件清单和表头检查。 |
| soilwater 与 soil | 土壤吸附、地下冰和热惯量常数的物理来源需要外部资料补强。 | 对照配置、论文或维护者说明。 |
| simu_MCS | MCS 分箱文件版本、Ls-sol 换算和观测高度坐标约定需与实际观测产品一致。 | 观测文件元数据和一组已知对比案例。 |
P2 构建和边界契约
| 页面 | 疑点 | 需要的证据 |
|---|---|---|
| common-dependencies | temps_mod 串行/并行版本选择取决于构建目标。 |
实际 make/cmake 编译日志或目标配置。 |
| xios-config | XIOS server/client 模式、重复 field id 和实际输出开关组合需要运行验证。 | 运行日志、iodef.xml 和 XIOS 输出文件。 |
| util-toolchain | 多个 util 工具串联时插值顺序会影响结果。 | 固定输入文件和 .def 后做端到端工具链记录。 |
| startarchive2icosa | XIOS/MPI 编译链和硬编码文件名对现代环境的兼容性。 | 本机编译和一次 start archive 转换运行。 |
| mod_const_mpi / parallel_lmdz | 1D XIOS、MPI、OpenMP 条件路径的实际组合。 | 1D 不同编译选项下的运行日志。 |
P3 遗留注释和局部代码清理
这些条目通常不阻塞 Wiki 交付,但应保留在源文件页中,避免误删历史语义:
| 页面 | 条目 |
|---|---|
| iniphysiq_mod | 源码 TODO 指出 comgeomfi_h 内容可能应迁移到 geometry_mod。 |
| mvc_horiz_mod | pi 声明赋值但未使用,纬度方向假设北到南递减。 |
| subslope_mola | 多个 regular_lonlat_mod 导入常量未直接使用;crit 的物理解释需结合坡面约定。 |
| fit_Iceinertia_MONSicedepth | xvik 输出命名与该工具硬编码读取名之间存在历史兼容性风险。 |
已做掉的占位类问题
本轮收尾已把以下“缺页面”类占位转为实际导航或边界说明:
| 原占位 | 处理 |
|---|---|
inigeomphy_mod 旧缺页占位 |
收束到 common-dependencies 的 COMMON 几何边界说明。 |
temps_mod 旧缺页占位 |
收束到 common-dependencies 的时间状态边界说明。 |
interp_horiz 旧登记缺口 |
收束到 common-dependencies 的水平插值边界说明,并区分 hrecast 本地同名子程序。 |
geometry_mod 旧缺页占位 |
收束到 common-dependencies 的几何共享状态说明。 |
| util 工具链主题/索引待写 | 新增 util-toolchain。 |
后续处理规则
- 新增
待确认时必须说明它需要源码、运行、外部数据、构建日志还是维护者判断。 - 仅凭“看起来合理”不得移除
待确认。 - 若运行验证通过,应在对应页面补一句验证证据,并在本页把条目移到“已确认”或删除。
- 若发现真实源码问题,应新建维护任务或 issue,不在 Wiki 中直接修改源码。