This guide instructs both novice and experienced users on building and running CESM. If you are a new user, we recommend that the introductory sections be read before moving onto other sections or the Quick Start procedure. This document is written so, as much as possible, individual sections stand on their own and the user's guide can be scanned and sections read in a relatively ad hoc order. In addition, the web version provides clickable links that tie different sections together.
The chapters attempt to provide relatively detailed information about specific aspects of CESM1 like setting up a case, building the model, running the model, porting, and testing. There is also a large section of use cases and a Frequently Asked Questions (FAQ) section.
Throughout the document, this presentation style indicates shell commands and options, fragments of code, namelist variables, etc. Where examples from an interactive shell session are presented, lines starting with ">" indicate the shell prompt.
Please feel free to provide feedback to CESM about how to improve the documentation.