CESM1.1.z User's Guide
CESM Software Engineering Group (CSEG)
Table of Contents
How To Use This Document
CESM Software/Operating System Prerequisites
CESM Component Sets
Downloading the code and scripts
Obtaining new release versions of CESM
Downloading input data
Quick Start (CESM Workflow)
Creating and Setting Up A Case
How to create a new case
How to set up a case and customize the PE layout
Changing the PE layout
New multi-instance component functionality
Modifying an xml file
Cloning a case (Experts only)
How do I build my model?
User-created input data
Using the input data server
Rebuilding the model
Customizing runtime settings
Controlling starting, stopping and restarting a run
Customizing component-specific namelist settings
Controlling output data
Load balancing a case
Model timing data
Using model timing data
Setting the time limits
Submitting the run
Restarting a run
Data flow during a model run
Testing a case
Porting and Validating CESM on a new platform
Step 1: Use create_newcase with a userdefined machine name
Step 2: Enabling out-of-the box capability for your machine
Step 3: Port Validation
Adding a new user-defined grid (EXPERTS ONLY)
Use Cases and FAQs
BASICS: A basic example
BASICS: How do I set up a branch or hybrid run?
BASICS: What calendars are supported in CESM?
BASICS: How do I change processor counts and component layouts on processors?
BASICS: What are CESM1 xml variables and CESM1 environment variables?
BASICS: How do I modify the value of CESM xml variables?
BASICS: Why aren't my $CASEROOT xml variable changes working?
BASICS: How do I use the ESMF library and ESMF interfaces?
BASICS: Why is there file locking and how does it work?
BASICS: What are the directories and files in my case directory?
IO: What is pio?
IO: How do I use pnetcdf?
CAM: How do I customize CAM output fields?
CAM: How do I customize CAM forcings?
CAM/CLM: How do I change history file output frequency and content for CAM and CLM during a run?
CAM: How do I use B compset history output to create SST/ICE data files to drive an F compset?
POP/CICE: How are CICE and POP decompositions set and how do I override them?
POP: How do I initialize POP2 with a spun-up initial condition?
DRIVER: Is there more information about the coupler/driver implementation?
DRIVER: How do I pass in new fields between components?
EXPERTS: How do I create my own compset?
EXPERTS: How do I run multiple cases all using a single executable?
EXPERTS: How do I carry out data assimilation using CAM and DART?
EXERPTS: Adding a new CESM component
Debugging Tests That Fail
Troubleshooting job submission problems
Troubleshooting runtime problems
List of Tables
Recommmended Software Package Versions by Machine
Result of invoking
Result of invoking