CESM2.1.3实战：手把手完成你的第一个‘Hello World’案例（含环境配置避坑指南）
CESM2.1.3实战：从零搭建你的第一个气候模拟案例
在气候建模领域，CESM（Community Earth System Model）就像是一套精密的乐高积木，允许研究者自由组合大气、海洋、陆地等模块来构建自己的地球系统实验室。作为初学者，最令人兴奋的时刻莫过于看到自己配置的第一个案例成功运行并输出数据。本文将带你用CESM2.1.3版本，完成从环境配置到案例运行的完整流程，特别针对Linux服务器环境中的常见陷阱提供解决方案。
1. 环境准备与源码获取
1.1 系统需求检查
在开始之前，确保你的Linux系统满足以下基本要求：
- 操作系统：推荐CentOS 7+或Ubuntu 18.04+
- 存储空间：至少50GB可用空间（源码+输入数据）
- 内存：建议16GB以上
- 编译器：Intel或GNU编译器套件
运行以下命令检查基础依赖：
# 检查系统版本 cat /etc/os-release # 检查gcc版本 gcc --version # 检查Python版本（需要3.6+） python3 --version1.2 依赖库安装
CESM运行需要几个关键库支持，使用包管理器一键安装：
# 对于CentOS/RHEL系统 sudo yum install -y netcdf-fortran-devel netcdf-devel \ hdf5-devel m4 cmake perl git # 对于Ubuntu/Debian系统 sudo apt-get install -y libnetcdff-dev libnetcdf-dev \ libhdf5-dev m4 cmake perl git注意：如果是在超算集群上操作，通常这些库已预装，可通过
module avail命令查看可用版本
1.3 获取CESM源代码
官方推荐通过Git获取最新代码，这里我们指定2.1.3版本：
git clone -b release-cesm2.1.3 https://github.com/ESCOMP/CESM.git cd CESM ./manage_externals/checkout_externals如果遇到网络问题导致子模块下载失败，可以尝试分段执行：
# 分步下载大体积子模块 cd cime git submodule update --init src/share git submodule update --init src/components/data_comps/datm2. 创建并配置第一个案例
2.1 案例初始化
我们选择最基础的F2000climo预置案例作为起点：
cd cime/scripts ./create_newcase --case ~/cesm_cases/first_run \ --res f19_g17 --compset F2000climo \ --driver nuopc --run-unsupported参数说明：
--res f19_g17：使用1.9°x2.5°大气网格和1°海洋网格--compset F2000climo：固定2000年气候条件的组件集--driver nuopc：使用NUOPC耦合器
2.2 机器环境配置
编辑案例目录下的env_mach_specific.xml文件，关键设置包括：
<entry id="MPILIB" value="openmpi"> <type>char</type> <valid_values>mpich,openmpi,mpt</valid_values> </entry> <entry id="NETCDF_PATH" value="/usr/local/netcdf"> <type>char</type> </entry>常见配置问题解决方案：
| 错误类型 | 表现特征 | 修复方法 |
|---|---|---|
| MPI库缺失 | mpif90: command not found | 加载环境模块：module load openmpi |
| NetCDF路径错误 | Could not find nc-config | 显式设置export NETCDF=/path/to/netcdf |
| 权限不足 | Permission denied | 对$HOME/.cime目录执行chmod 755 |
2.3 输入数据准备
CESM需要下载约15GB的初始条件数据，执行以下命令自动获取：
./check_input_data --download如果下载中断，可以手动指定镜像源：
export CESM_INPUTDATA_SERVER="https://svn-ccsm-inputdata.cgd.ucar.edu/trunk" ./check_input_data --download --server $CESM_INPUTDATA_SERVER3. 编译与运行实战
3.1 案例编译步骤
分阶段执行编译能更好定位问题：
# 预处理阶段 ./cesm_setup # 构建阶段（建议在screen/tmux中运行） ./case.build # 检查构建结果 ls -lh bld/cesm.exe编译成功的关键指标：
- 最终生成
cesm.exe可执行文件（通常500MB+） - 无
Error级别日志（警告Warning可忽略）
3.2 提交作业配置
对于不同运行环境，需要调整env_run.xml：
<!-- 本地工作站配置 --> <entry id="JOB_QUEUE" value="batch"> <type>char</type> </entry> <entry id="JOB_WALLCLOCK_TIME" value="01:00:00"> <type>char</type> </entry> <!-- 超算SLURM系统配置示例 --> <entry id="BATCH_SYSTEM" value="slurm"> <type>char</type> </entry> <entry id="PROJECT" value="your_account"> <type>char</type> </entry>3.3 运行监控与调试
启动运行后，实时监控日志：
# 跟踪运行日志 tail -f run/cesm.log.* # 检查资源使用 grep "Model throughput" run/cesm.log.*常见运行错误处理技巧：
段错误(Segmentation fault)
尝试减少MPI进程数：./xmlchange NTASKS=8时间步长不收敛
调整user_nl_cam中的参数：dt = 1800输出文件权限问题
提前设置：umask 022
4. 结果验证与进阶指导
4.1 基础输出检查
成功运行的案例应生成以下关键文件：
first_run/run/ ├── cesm.log.1234567 # 主日志文件 ├── atm.log.1234567 # 大气组件日志 ├── lnd.log.1234567 # 陆地组件日志 ├── cesm.exe # 可执行文件 └── hist/ # 历史输出目录 ├── first_run.cam.h0.0001-01.nc └── first_run.clm2.h0.0001-01.nc使用NCO工具快速检查结果：
ncdump -h hist/first_run.cam.h0.0001-01.nc | head -204.2 性能优化建议
当案例能基本运行后，可以尝试以下调优：
# 启用OpenMP并行 ./xmlchange OMP_NUM_THREADS=4 # 调整MPI进程布局 ./xmlchange ROOTPE_OCN=8,NTHRDS_ATM=2典型配置方案对比：
| 配置类型 | 进程数 | 线程数 | 适用场景 |
|---|---|---|---|
| 纯MPI | 32 | 1 | 内存充足时 |
| 混合并行 | 16 | 2 | 多核CPU |
| 高吞吐 | 8 | 4 | 小规模测试 |
4.3 下一步学习路径
掌握基础案例后，推荐尝试：
- 修改
user_nl_*文件调整物理参数 - 创建自定义组件集（COMPSET）
- 添加用户诊断输出变量
- 学习使用CESM Python分析工具（如PyCESM）