Pending confirmation triage

页面定位

本页收束 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 文件清单和表头检查。
soilwatersoil 土壤吸附、地下冰和热惯量常数的物理来源需要外部资料补强。 对照配置、论文或维护者说明。
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

后续处理规则

  1. 新增 待确认 时必须说明它需要源码、运行、外部数据、构建日志还是维护者判断。
  2. 仅凭“看起来合理”不得移除 待确认
  3. 若运行验证通过,应在对应页面补一句验证证据,并在本页把条目移到“已确认”或删除。
  4. 若发现真实源码问题,应新建维护任务或 issue,不在 Wiki 中直接修改源码。