Welcome to the CTSM mini-tutorial

This tutorial was first offered during Spring 2022.

The materials and notebooks in this tutorial is published as a Jupyter book here.

This repository includes materials for the Community Terrestrial Systems Model (CTSM) 2022 mini-tutorial (link to agenda and resources).

These tutorials are designed as an introduction to running the Community Terrestrial Systems Model (CTSM). We will go through three configurations that include running a:

0. Supported NEON tower site,
1. Global FATES-SP simulation, and
2. Generic single point simulation.

We'll also learn how to:

• Visualize results,
• Analyze model output, and
• Make simple code modifications.

This video will walk you through the initial steps of the tutorial, but the steps for quick start are also summarized below.

The full set of lectures from the tutorial can be found here, and will be posted after the tutorial.

Quick Start

Step 1: Open up CESM-Lab

• In your web browser go to https://ctsmworkshop2022.cesm.cloud/

  It will automatically open up a portal to connect to the cloud:

  

• Enter your username and password provided with your tutorial registration

• This should launch a JupyterLab window in your browser.

Step 2: Clone CTSM Tutorial Repository

• Click on the Terminal icon to open a terminal window.

• Run the following command to clone this repository. (Just copy and paste the text below into the terminal window that opens in JupyterLab)

git clone https://github.com/NCAR/CTSM-Tutorial-2022

This gives you a local copy of the material you'll need for the tutorial

Can you see a new directory on your navigation sidebar called CTSM-Tutorial-2022? (See the left sidebar of your JupyterLab window)

Step 3: Navigate to notebooks directory

• Click on the CTSM-Tutorial-2022 directory
• Click on the notebooks directory
• Click on the Day0a_GitStarted.ipynb notebook in the sidebar of your JupyterLab window.

Now you're ready to get started with the pre-tutorial homework. Let's git started by following along in the Day0a notebook

📚 Resources

CTSM Repository which includes the CTSM Wiki page that has lots of resources, including much of the following:

• CTSM Technical Documentation
• CTSM User's Guide
• Quickstart Guide for Various Model Configuraions
• Running single-point cases other than NEON
• Running NEON cases with a container -- Running CTSM for NEON cases on a laptop

CLM5 Overview Paper Lawrence et al. 2019 JAMES

CLM5 Diagnostic plots, from the overview paper.

CLM5 ILAMB page, also from the overview paper.

❓ Questions

For questions about running simulations, please use DiscussCESM Forums:

Containers & Cloud Platforms Forum

CTSM Forum

👍 Acknowledgements

A number of people have been critical to this effort, including:

• Adrianna Foster, Negin Sobhani, Danica Lombardozzi & Will Wieder who put together tutorial materials.
• Brian Dobbins, who put together the AWS configuration of CESM-Lab;
• Jackie Shuman, Polly Buotte, & Keith Oleson, who tested tutorial materials;
• Erik Kluzek & Bill Sacks, who made CTSM tags needed for running simulations.
• Elizabeth Faircloth and Ryan Johnson who helped with tutorial registration, logistics and webpages; and finally the rest of the
• TSS staff who provided lecture materials and helped answer questions during the tutorial.

This material is based upon work supported by the National Center for Atmospheric Research (NCAR), which is a major facility sponsored by the National Science Foundation (NSF) under Cooperative Agreement No. 1852977. Staff time on this project was also supported by NSF award numbers 2039932, 2031238, 1926413, and 2120804.