CESM 中文教程必看导读

本组教程依据 CESM 官方文档、CESM2 Quick Start、CESM2 下载说明与 CIME 用户指南整理，并结合 CESM.run Toolkit 的实际功能，将官方工作流转写为面向中文科研用户的操作说明。

建议初学者按本文档顺序阅读：先理解 CESM 源码与外部组件的获取方式，再检查计算环境，随后进入创建 case、setup、build、submit、续跑和平台移植流程。已有 CESM 使用经验的用户可以直接跳转到环境诊断、构建运行或平台移植相关章节。

文档清单

1. 01_CESM2_源码获取与组件检出.md 说明 CESM2 源码下载、外部组件检出、git 与 svn 依赖，以及输入数据目录的基本原则。

2. 02_计算环境诊断与依赖准备.md 说明 CESM 对 MPI、CMake、NetCDF 等环境的基本要求，并加入 cesmrun doctor 与 cesmrun install 的辅助用法。

3. 03_创建Case与选择配置.md 说明 create_newcase 的基本参数、case 命名、compset、resolution 与 machine 的关系。

4. 04_Case_Setup与XML变量.md 说明 case.setup 的作用、xmlquery 与 xmlchange 的基本使用，以及 setup 前应修改的变量类型。

5. 05_构建Case与输入数据.md 说明 case.build、构建日志、EXEROOT、RUNDIR 与 check_input_data 的关系。

6. 06_提交运行与结果检查.md 说明 preview_run、case.submit、队列参数、CaseStatus 与运行是否成功的初步判断。

7. 07_续跑重启归档与故障排查.md 说明 CONTINUE_RUN、STOP_N、RESUBMIT、RUN_TYPE、短期归档与常见错误定位。

8. 08_新平台移植与CESMrun配置生成.md 说明 CIME 新平台移植要点，并对应 CESM.run Toolkit 的 configure-cesm1 与 configure-cesm2 使用场景。

官方依据

• CESM Documentation & Tools: https://docs.cesm.ucar.edu/
• CESM2.2 Quick Start: https://escomp.github.io/CESM/versions/cesm2.2/html/quickstart.html
• CESM2.1 Downloading CESM2: https://escomp.github.io/CESM/versions/cesm2.1/html/downloading_cesm.html
• CIME User Guide: https://esmci.github.io/cime/versions/master/html/users_guide/index.html
• CIME Porting Documentation: https://esmci.github.io/cime/versions/master/html/users_guide/porting-cime.html