创建 Case 与选择模型配置

在 CESM/CIME 工作流中，case 是一次具体模型试验的工作目录。它保存该试验的 XML 配置、构建脚本、运行脚本、用户 namelist 修改和状态记录。创建 case 是运行 CESM 的第一步。

1. 进入 CIME scripts 目录

通常在 CESM 源码目录下进入：

cd my_cesm_sandbox/cime/scripts

可先查看可用的模型配置：

./query_config --help

query_config 可用于查询可用的 component set、分辨率和机器配置。正式教程中建议结合具体版本给出一个固定示例，避免初学者在配置空间中迷失。

2. create_newcase 的三个核心参数

create_newcase 至少需要三个参数：

./create_newcase --case CASENAME --compset COMPSET --res GRID

其中：

• --case 指定 case 名称或 case 目录路径。该值会进入 $CASE 与 $CASEROOT 等元数据。
• --compset 指定 component set，即大气、陆面、海洋、海冰等组件的组合方式。
• --res 指定模型网格或分辨率。

在需要项目账号的集群上，可能还需要：

./create_newcase --case CASENAME --compset COMPSET --res GRID --project PROJECT_ID

如果机器不能被自动识别，应显式指定：

./create_newcase --case CASENAME --compset COMPSET --res GRID --machine MACHINE_NAME

3. 示例

以下示例仅用于说明命令结构，实际教学应替换为目标平台支持的 compset、resolution 和 machine：

./create_newcase \
  --case /path/to/cases/b.e20.B1850.f19_g17.test \
  --compset B1850 \
  --res f19_g17 \
  --machine mycluster

创建完成后进入 case 目录：

cd /path/to/cases/b.e20.B1850.f19_g17.test

4. 建例后的基本检查

进入 $CASEROOT 后，可查询关键变量：

./xmlquery CASE,CASEROOT,COMPSET,GRID,MACH

如果输出的 case 名称、路径、分辨率或机器名不符合预期，应在后续 setup 前重新创建 case。env_case.xml 中的一些变量在 case 创建后即固定，不建议在不理解影响范围的情况下强行修改。

5. 学习提示

阅读本节时应区分“官方示例命令”和“实际平台模板”。对于国内集群用户，应优先确认本机是否已经在 CESM/CIME 中有可用 machine 配置；若没有，应先完成机器配置或使用 CESM.run Toolkit 生成配置草案。

官方参考

• CESM2.2 Quick Start: https://escomp.github.io/CESM/versions/cesm2.2/html/quickstart.html
• CIME create_newcase: https://esmci.github.io/cime/versions/master/html/Tools_user/create_newcase.html