设置 Case 变量

创建案例后，案例的一些方面是固定的（env_case.xml 中的任何变量）。在运行 case.setup 之前，必须修改 pe 布局（参见修改 Pes ）或您可能正在使用的批处理系统的一些方面。

3.1. 调用 case.setup

创建案例或更改案例的某些方面（如 pe 布局）后，从 $CASEROOT 调用 case.setup 命令。这会在 $CASEROOT 中创建以下附加文件和目录：

文件名	解释
.case.run	一个隐藏的、包含运行模型所需命令的文件（例如“mpirun”）以及任何需要的批处理指令。指令值是使用 env_mach_pes.xml 的内容生成的运行 case.setup –clean 将删除此文件。此文件不应直接编辑，而应受控通过 env_batch.xml 中的 XML 变量进行。它也不应该被直接运行。
CaseStatus	包含当前案例中执行的操作列表的文件。
case.st_archive	用于对案例进行短期归档到磁盘的脚本输出。注意此脚本由正常的 CIME 工作流程自动运行。
Depends	需要特殊构建选项的源代码文件列表。
Macros.cmake	包含针对目标平台/编译器的机器特定 makefile 指令的文件。如果该文件不存在，则会创建该文件。用户可以修改该文件以更改构建的某些方面，例如编译器标志。运行 case.setup –clean 不会删除已创建的文件。但是，如果您删除或重命名 Macros.make 文件，运行 case.setup 会重新创建它。
user_nl_xxx[_NNNN]	所有用户对组件命名列表进行的修改都保存在这些文件中。 xxx 是针对案例的目标组件之一。例如，对于一个完整的活跃 CESM 组件集，xxx 是 cam、clm 或 rtm 等。 NNNN 从 0001 到该组件的实例数量。（参见多个实例）对于一个每个组件有 1 个实例的案例（默认情况），NNNN 不会出现在用户 nl 文件名中。一个给定名称的用户 nl 文件只会创建一次。调用 case.setup –clean 不会删除任何 user_nl 文件。修改 env_mach_pes.xml 文件中的实例数量将只会向 `$CASEROOT` 添加新的 user_nl 文件。
CaseDocs/	包含运行所有组件名称列表的目录。这是仅供参考，此目录中的文件不应被编辑，因为它们将在构建时和运行时可能会被覆盖。
.env_mach_specific.*	总结模块加载命令和环境变量设置的文件，当 `$CASEROOT` 中的脚本被调用。这些文件不被案例使用，但可以用于调试 module load 和环境设置。
software_environment.txt	这个文件记录了案例构建所使用的计算系统的某些方面，例如 shell 环境。