
# Welcome to the [CLM Tutorial](https://ncar.github.io/CLM-Tutorial/README.html)

<br>

This repository includes materials designed to be an introduction to running the Community Land Model (CLM), the terrestrial component of CESM. 
The materials were developed to support the CLM tutorial and serve as reference documentation for all CLM users.

In 1983 NCAR created the _Community Climate Model_ (CCM) as a freely available global atmosphere model for use by the climate research community. The scope of CCM development continued to expand and in 1994 NCAR scientists released the _Climate System Model_ (CSM), a global model that included component models for the atmosphere, land surface, ocean, and sea-ice, communicating through a central coupler component. To recognize the broad community of users and sponsors contributing to this effort, the CSM was renamed the _Community Climate System Model_ (CCSM). The CCSM model evolved to include ice sheet and biogeochemical modeling and was renamed the _Community Earth System Model_ (CESM) in 2013.

## Goals of This Tutorial

The overarching goal of the tutorial is to __introduce the science and practice of using CLM as a research tool.__ Lecture and practicals aim to link science and code  by highlighting model assumptions and hypotheses.

As a result of attending the CLM Tutorial, attendees will:
- Gain a foundational scientific understanding of CLM and its features. 
- Be able to run and modify the model and use the output. 
- Have opportunities to network with peers and CLM scientists. 
- Attain an understanding of High Performance Computing (HPC) needed for CLM. 
- Perceive the tutorials to be an inclusive learning environment.

The materials are primarily based on CLM6 concepts and workflows, although many of the principles apply to other versions of CLM as well.</strong>

## Semi-Yearly In-Person Tutorials

The CLM tutorials were started in 2014 and is typically offered as an in-person workshop. If you are interested in attending the tutorial, please see the [CESM events webpage](https://www.cesm.ucar.edu/events/tutorials) for the most up to date information about when the tutorial will next be offered in Boulder, Colorado and the timeline for applying.

## CESM Project Funding 

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 the Climate and Global Dynamics (CGD) laboratory.

## Acknowledgements

Materials here were heavily borrowed from the CESM tutorial. A number of people have been critical to this effort, including:
- Cecile Hannay, Alice DuVivier, David Bailey, Peter Lawrence, Hui Li, Sophia Macarewich, Jesse Nusbaumer, Adam Phillips, Kate Thayer-Calder, and William Xu who serve on the CESM tutorial committee and put together the tutorial materials.
- Brian Dobbins, Gunter Leguy, and Gustavo Marques, who helped test materials and have contributed substantially.
- Elizabeth Faircloth, who supports the CESM program administratively and without whom everything would probably fall apart.
- David Lawrence, who supported this effort as CESM chief scientist.
- Testers, others...

Specific modification and development for the CLM tutorial were made by:
- Will Wieder, Adrianna Foster, Linnia Hawkins, Sam Levis, Erik Kluzek, Samar Minallah, Danniel Kennedy, Sam Rabin, and Keith Oleson.
 
<br>

<div>
