# ESMValTool Exercises

## lesson Introduction
### Exercise 1:
What is ESMValTool?

1) What do you already know about or expect from ESMValTool?

### Exercise 2: episode Introduction
Understanding the different section of the recipe:

1) Try to figure out the meaning of the different dataset keys. Hint: they can be found in the documentation of ESMValTool.

## lesson Installation
### Exercise 3
Version of ESMValTool:

1) Can you figure out which version of ESMValTool has been installed?

## lesson Configuration
### Exercise 4
Saving preprocessed data:

1) Later in this tutorial, we will want to look at the contents of the preproc folder. This folder contains preprocessed data and is removed by default when ESMValTool is run. In the configuration file, which settings can be modified to prevent this from happening?

### Exercise 5
Set the destination directory:

1) Let’s name our destination directory esmvaltool_output in the working directory. ESMValTool should write the output to this path, so make sure you have the disk space to write output to this directory. How do we set this in the config-user.yml?

### Exercise 6 [skipped]
Set the correct rootpath:

1) In this tutorial, we will work with data from CMIP5 and CMIP6. How can we modify the rootpath to make sure the data path is set correctly for both CMIP5 and CMIP6? Note: to get the data, check the instructions in Setup.

### Exercise 7 [skipped]
Set the correct drs:

1) In this lesson, we will work with data from CMIP5 and CMIP6. How can we set the correct drs?

### Exercise 8 [skipped]
Explain the default drs (if working on local machine):

1) In the previous exercise, we set the drs of CMIP5 data to default. Can you explain why?
2) Have a look at the directory structure of the OBS data. There is a folder called Tier1. What does it mean?

# Running your first recipe
### Exercise 9
Output files and directories:

After the banner and general information, the output starts with some important locations.

1) Did ESMValTool use the right config file?
2) What is the path to the example recipe?
3) What is the main output folder generated by ESMValTool?
4) Can you guess what the different output directories are for?
5) ESMValTool creates two log files. What is the difference?

## Exercise 10
Analyse the tasks:

1) List all the tasks that ESMValTool is executing for this recipe. Can you guess what this recipe does?

## Exercise 11
Analyse the recipe:

Try to answer the following questions:

1) Who wrote this recipe?
2) Who should be approached if there is a problem with this recipe?
3) How many datasets are analyzed?
4) What does the preprocessor called annual_mean_global do?
5) Which script is applied for the diagnostic called map?
6) Can you link specific lines in the recipe to the tasks that we saw before?

## Exercise 12
Output files:

Have another look at the output directory created by the ESMValTool run.

1) Which files/folders are created by each task

## Exercise 13
Change your location:

1) Modify and run the recipe to analyse the temperature for your own location.

## Conclusion of the basic tutorial
### Exercise 14
What do you want to do next?

1) Think about what you want to do with ESMValTool.
2) Decide what datasets and variables you want to use.
3) Is any observational data available?
4) How will you preprocess the data?
5) What will your diagnostic script need to do?
6) What will your final figure show?

# Instructure notes

- [Download and install mamba](https://github.com/conda-forge/miniforge#unix-like-platforms-mac-os--linux)

if working on CRIB, esmvaltool version 2.6
- use file browser to show hidden esmvaltool directory and working on user config file
- use the command to download esgf config file: `wget https://raw.githubusercontent.com/ESMValGroup/ESMValTool_Tutorial/add-esgf-pyclient-config/files/esgf-pyclient.yml`

if working on wsl:
- to get file browser run explorer.exe . or from wondows file browser, go to path wsl

Participants:

| Name| Answer|
| ---- | ---- |
| Santiago|
| Handini Puteri|
| Shreya Deep Bansod |
| Md Saiful Islam |
| Aamir Imran |
| Salsabila Prasetya |
| Alma Raunak |
| Swagatalaxmi Das|
| Prajwal Khanal |
| Jiangtao CAI |
| Mewcha A.Gebremedhin|
| Resul Comert |
| Serkan Girgin |
| Zengjing song |
| Tanuj Pareek |
| Chakshu Gururani|
| Qianqian Han |
| Hakan Tanyas |
| Ting Duan |
| Kiana Karimi|
| Enting Tang |