Review Questions#

If time allows here are some review questions to go back over the material in the Introduction and Basics sections.

Question 1: What is the CESM Workspace? How many separate directory areas are there?

Click here for the solution

The CESM model consists of five main directory tree areas that make up the CESM Workspace. The individual directories represent different elements including the source code, your experiment cases, the area where the model runs, the location of input data, and the location where the output data from the model will be archived for later use.

Question 2: Where is the CESM Code Development Managed?

Click here for the solution

The CESM Project is hosted on Github under under the Earth System Community Modeling Portal (ESCOMP) which is managed by the University Corporation for Atmospheric Research (UCAR). Code can be directly downloaded from Github using Git commands.

Question 3: Where do you find the create_newcase command? What does it do?

Click here for the solution

The create_newcase script is located in the CIME Scrips Directory. The create_newcase script creates a new case in your CASE Directory. The command takes the new casename, compset, and resolution as values.

Question 4: What are the three commands required to start running a new case?

Click here for the solution

After create_newcase you need to change to the new case directory where you need to run case.setup, case.build and case.submit. As an additional step you can run the script preview_namelists.

Question 5: How can you monitor your CESM submission while it is running?

Click here for the solution

There are three main ways to monitor your CESM job while it is running. The first is with the qstat command, the second is with the build/run directory files, and the last is with the archive directory files.

Question 6: What is the main way to understand how a CESM simulation ran?

Click here for the solution

The main output from your CESM job is the history files. These can be specified to output the status of the component models at various levels of detail and for different time averaging periods.

Question 7: What is an XML file? What is it used for in the Case Directory?

Click here for the solution

The XML files are Markup Language files that contain variables used by the CESM scripts. In the Case Directory there are seven xml files:

  • env_archive.xml specifies rules for short-term archival script case.st_archive

  • env_batch.xml set by create_newcase to define batch specific settings used by script case.submit

  • env_build.xml specifies build information used by script case.build

  • env_case.xml set by create_newcase and cannot be modified

  • env_mach_pes.xml specifies PE layout of components used by script case.run

  • env_mach_specific.xml specifies machine specific information used by script case.build

  • env_run.xml sets run time information (such as length of run, frequency of restarts, …) User interacts with this file most frequently

Question 8: What are the main ways to investigate and modify XML values in the Case Directory?

Click here for the solution

While the values in XML files can be modified directly with an editor, CESM provides tools for querying and changing values. The xmlquery and xmlchange tools ensure that the values found and updated are valid for the files they belong to and that any changes made are recorded in the CaseStatus file in the CASE Directory.