libf 核心源码目录

路径

LMDZ.MARS\libf

职责

libf 是 LMDZ.MARS 的核心 Fortran 源码目录，包含火星大气物理过程的全部实现。该目录不包含完整的 GCM 动力核心，而是作为物理包供其他框架（如 LMDZ 动力框架）调用。

源码依据：README 说明 libf 包含 "Fortran source code of the Mars physics package"。

目录内容

子目录详解

phymars/ - 核心物理模块

包含火星大气物理过程的实现，是最重要的目录。按功能分类：

aeronomars/ - 高层大气模块

处理 80km 以上高层大气物理过程：

dynphy_lonlat/ - 动力-物理耦合

负责物理过程与动力核心的耦合：

推断：dynphy_lonlat 中的代码负责将 phymars 中的物理过程与 lon-lat 网格的动力核心连接起来。

与其他目录的关系

关键文件

典型运行流程

物理过程在主循环中被调用，基本流程：

1. 初始化阶段：

   • 读取配置参数
   • 初始化辐射数据
   • 初始化尘埃、水、CO2 等示踪剂

2. 每时间步：

   • 调用 physiq() 主入口
   • 辐射计算 (callradite)
   • 尘埃 lifting 和传输
   • 水循环（凝结、蒸发、云形成）
   • CO2 循环（凝结、升华）
   • 边界层/湍流混合
   • 重力波拖曳
   • 对流调整
   • 示踪剂输运

3. 输出阶段：

   • 诊断变量输出
   • XIOS NetCDF 输出

复现要点

• 需要外部动力框架（如 LMDZ 通用动力核心）提供时间步进和网格
• 需要配置 callphys.def 开启/关闭各物理过程
• 需要辐射数据文件（存在于 datadir 中）
• 不同配置级别（GCM5/GCM6/MCD5/MCD6）对应不同的物理模块组合

细节入口

本页只做 libf/ 目录总览；调用链、耦合方式和配置开关已拆到更细页面维护：

• 物理主调度见 physiq_mod，水循环和 CO2 循环的关键调用点见 physiq-water-cycle-callpoints.md 与 physiq-co2-cycle-callpoints.md。
• dynphy_lonlat 到 phymars 的 3D 耦合入口是 call_physiq 调用 physiq，初始化入口是 iniphysiq；对应页面见 callphysiq_mod、iniphysiq_mod。
• 1D 模式入口是 testphys1d，初始化由 init_testphys1d 完成，随后每步直接调用 physiq；对应页面见 testphys1d 和 init_testphys1d_mod。
• 配置读取和开关影响见 config-system.md、co2-cycle-config.md、water-cycle-config.md、testphys1d-config.md。