The following quick start guide is for versions of CESM that have already been ported to the local target machine. If CESM has not yet been ported to the target machine, please see Chapter 7. If you are new to CESM1, please consider reading the introduction first
These definitions are required to understand this section:
COMPSET refers to the component set.
RES refers to the model resolution.
MACH refers to the target machine.
CCSMROOT refers to the CESM root directory.
CASE refers to the case name.
CASEROOT refers to the full pathname of the root directory
where the case ($
CASE) will be created.
EXEROOT refers to the executable directory. ($
normally NOT the same as $
RUNDIR refers to the directory where CESM actually runs. This is normally
set to $
This is the procedure for quickly setting up and running a CESM case.
Download CESM (see Download CESM).
Select a machine, a component, and a resolution from the list displayed after invoking this command:
> cd $CCSMROOT/scripts > create_newcase -list
See the component set table for a complete list of supported compset options.
See the resolution table for a complete list of model resolutions.
See the machines table for a complete list of machines.
Create a case.
The create_newcase command creates a case directory containing the scripts and xml files to configure a case (see below) for the requested resolution, component set, and machine. create_newcase has several required arguments and if a generic machine is used, several additional options must be set (invoke create_newcase -h for help).
If running on a supported machine, ($MACH), then invoke create_newcase as follows:
> create_newcase -case $CASEROOT \ -mach $MACH \ -compset $COMPSET \ -res $RES
If running on a new target machine, see porting in Chapter 7.
Configure the case.
Issuing the configure command creates component namelists
and machine specific build and run scripts.
Before invoking configure, modify the case settings in $
as needed for the experiment.
cd to the $
> cd $CASEROOT
Modify configuration settings in env_conf.xml and/or in env_mach_pes.xml (optional). (Note: To edit any of the env xml files, use the xmlchange command. invoke xmlchange -h for help.)
Invoke the configure command.
> configure -case
Build the executable.
Modify build settings in env_build.xml (optional).
Run the build script.
Run the case.
Modify runtime settings in env_run.xml (optional). In particular, set the DOUT_S variable to FALSE.
Submit the job to the batch queue. This example uses a submission command for a Cray computer:
> qsub $CASE.$MACH.run
When the job is complete, review the following directories and files
$RUNDIR. This directory is set in the env_build.xml file. This is the location where CESM was run. There should be log files there for every component (ie. of the form cpl.log.yymmdd-hhmmss). Each component writes its own log file. Also see whether any restart or history files were written. To check that a run completed successfully, check the last several lines of the cpl.log file for the string " SUCCESSFUL TERMINATION OF CPL7-CCSM ".
$CASEROOT/logs. The log files should have been copied into this directory if the run completed successfully.
$CASEROOT. There could be a standard out and/or standard error file.
$CASEROOT/CaseDocs. The case namelist files are copied into this directory from the $RUNDIR.
$CASEROOT/timing. There should be a couple of timing files there that summarize the model performance.
$DOUT_S_ROOT/$CASE. This is the archive directory. If DOUT_S is FALSE, then no archive directory should exist. If DOUT_S is TRUE, then log, history, and restart files should have been copied into a directory tree here.