NCAR Climate and Global Dynamics Laboratory 2022 CSTM Tutorial, 16 May 2022

Previous Meeting

⏯

youtube image

►

From YouTube: 2022 CTSM Tutorial Getting Started

Description

Adrianna Foster of NCAR discusses how to log onto the system and start their homework assignments for the 2022 CTSM.

For more information:
https://www.cesm.ucar.edu/events/2022/ctsm-tutorial/

A

Hello welcome to the 2022 ctsm mini tutorial. Today, I'm going to walk you through the initial steps of the tutorial, including signing on to the platform we will be using to run the simulations downloading the necessary tutorial materials and going through our first tutorial notebook.

A

Through this tutorial, we will introduce you to running the community terrestrial systems model or ctsm.

A

We will go over several configurations of ctsm, as well as some tools for running and developing the model, including running ctsm, at a supported neon, tower site, running a global fate, simulation running ctsm at a generic single point and modifying ctsm code and keeping track of your changes using github.

A

So, first we need to sign on to the platform we'll be using for this tutorial. So in your web, browser of choice go to the github page for this tutorial. The link can be seen here here. You can navigate to this link. Ctsm workshop 2022.

A

This will prompt you to enter your username and password provided to you. If you don't know this, you can contact the tutorial leads, which are shown here.

A

This will then launch a jupiter lab in your browser in this browser. We have a terminal window that should open up, but if it doesn't, you can just click on it here.

A

So now we're going to download the notebooks associated with this tutorial. Let's go back to this readme.

A

And we're going to copy this command from the readme and then we're going to paste it back into the terminal window in jupiter lab, and this will give you a local copy of all the tutorial material you'll need. We can see that a folder should appear in the navigation window on the left yep. If we click on that and then into the notebooks folder, we can see all of the notebooks we'll be using during this tutorial as homework. You should complete both day: zero tutorials, let's walk through day zero. A now.

A

So this tutorial is an intro to ctsm cesm lab the platform. We're using and get. This tutorial is also a prerequisite for the following tutorials, so we will be working with ctsm for this tutorial. Ctsm is the community terrestrial systems model. There are many configurations of ctsm, and in this tutorial we will be using the community land model or clm, which is the climate and biogeochemistry mode of ctsm.

A

Ctsm is the land component of the community earth systems model and is connected via seam? We will go over these topics later in the tutorial.

A

There's also more information available on various websites which are linked on this tutorial's notebook, so we're currently working in cesm lab, which is a containerized environment with cesm and jupiter lab now. Ctsm requires quite a bit of computing resources and libraries that can be difficult to set up on a new computing system, so cesm lab allows you to easily run the model in any type of system, including uh the cloud or your own personal computer.

A

So what is a container? A container is a pre-configured portable application that can reliably run on any computing infrastructure, including your mac windows or linux, personal computer or in the cloud, because it's pre-configured, no installation is required and all users get the same environment.

A

Now. During this tutorial, we will be using jupyter notebooks. These are interactive computing environments that allow you to run discrete cells of the text or documentation, as well as executable code and to execute these cells. You can hit the run button with your cursor inside the executable cells.

A

Any results from your code, including plots, will appear below that cell now, just note that you usually need to run each cell in order. Otherwise you may encounter some errors. So a lot of this tutorial will require some simple linux command line operations.

A

You can either run these commands directly inside the jupiter notebook or you can copy them and run them in a terminal window. So like on other systems like your own computer or ncar's cheyenne machine, you will likely be using a terminal to interact with and run the model. So, let's check out the terminal window. Now: okay, let's go over some basic linux commands.

A

To see what direct you're in type pwd to see, what's in your current directory type ls the command cd changes into a new directory here, I am to moving into the tutorial directory.

A

Typing cd dot dot moves up one directory, so this directory structure should mirror what you see on the left hand side of the notebook okay. Now, let's clone the ctsm code base from github onto our system, all of the software and updates to ctsm are publicly available on github.

A

Here you can find information about the software, create and track issues and download the code. Git is a version control system that allows you to track changes you make to the files. Github provides a centralized online service to host your files and implement git version control.

A

We will cover many features of git and github in one of our day, 2 tutorials, but there are also some other places to start learning which are linked in this notebook. So, let's go to the ctsm github repository.

A

Here we're going to click on the green code button and we will see a link that we can use to copy the url to this repository.

A

Back in the jupiter notebook.

A

We can run these cells below to clone the source code. Note that you can either copy these commands and paste them in the jupiter terminal, or you can run them here by hitting the run button or entering command enter on your keyboard.

A

This command will clone and set up the ctsm source code in your home directory.

A

Now we need to move into this new directory and run the checkout externals command this command clones and sets up other github repositories that are needed to run ctsm.

A

So once you've completed this command, you're all set up for running simulations with ctsm in the cloud. Next, you should move on to the day0b tutorial, which will walk you through running a simulation at a supported neon tower site.

A

If you've encountered any problems with this or the next tutorial, you can file an issue on the ncar ctsm tutorial github repository page linked here or you can email. The tutorial leads thanks for watching and we'll see you all soon.