<a id="tutorial-overview"></a>

# ESMValTool Tutorial

This tutorial helps you to use ESMValTool.

The Earth System Model Evaluation Tool (ESMValTool) is a community developed
software toolkit that aims to facilitate the diagnosis and evaluation of the
causes and effects of model biases and inter-model spread within the CMIP model
ensemble.

This tutorial is structured into `basic` and `advanced` topics such that
episodes starting from the **Introduction** up to the episode on **Conclusion
of the basic tutorial** all cover basic topics and can be done in one sitting.

The remaining episodes cover the `advanced` topics and each episode is a
mini-tutorial covering an advanced aspect of working with ESMValTool. These
mini-tutorials can be appended to the main tutorial or worked through
independently.

## Main things you need to know before starting this course

1. This tutorial can be taken online independently or taught by one of our
   instructors.
2. Don’t be alarmed if you can’t work through the entire tutorial in one
   sitting. It may take some time to get used to working with ESMValTool.
3. If you get stuck, help is always available from the tutors, from ESMValTool
   developers via the [github issues page](https://github.com/ESMValGroup/ESMValTool/issues)
   or via the [ESMValTool discussion page](https://github.com/ESMValGroup/ESMValTool/discussions).
4. This tutorial includes several advanced lessons after the conclusion. These
   advanced lessons should be treated like “mini-tutorials”, and include aspects
   like **Developing your own diagnostic** or **How to include observations**.

## How to cite the tutorial

Please use citation information available at
[https://doi.org/10.5281/zenodo.3974591](https://doi.org/10.5281/zenodo.3974591).

## Schedule

|                                                         | [Setup](tutorial_setup.html.md)                                                                              | Download files required for the lesson                                                                                                                                                                         |
|---------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 00:00<br/><br/><br/><br/>                               | [Introduction](episode_1_introduction.html.md)<br/><br/><br/><br/>                                                   | What is ESMValTool?<br/><br/><br/>Who are the people behind ESMValTool?<br/><br/>                                                                                                                              |
| 00:15<br/><br/><br/><br/><br/><br/><br/><br/>           | [Quickstart guide](episode_2_quickstart.html.md)<br/><br/><br/><br/><br/><br/><br/><br/>                           | What is the purpose of the quickstart guide?<br/><br/><br/>How do I load and check the ESMValTool environment?<br/><br/><br/>How do I configure ESMValTool?<br/><br/><br/>How do I run a recipe?<br/><br/>     |
| 00:25<br/><br/><br/><br/>                               | [Installation](episode_3_installation.html.md)<br/><br/><br/><br/>                                                   | What are the prerequisites for installing ESMValTool?<br/><br/><br/>How do I confirm that the installation was successful?<br/><br/>                                                                           |
| 00:45                                                   | [Configuration](episode_4_configuration.html.md)                                                                      | What is the user configuration file and how should I use it?                                                                                                                                                   |
| 01:10<br/><br/><br/><br/>                               | [Running your first recipe](episode_5_recipe.html.md)<br/><br/><br/><br/>                                      | How to run a recipe?<br/><br/><br/>What happens when I run a recipe?<br/><br/>                                                                                                                                 |
| 01:40<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/> | [Conclusion of the basic tutorial](episode_6_conclusion.html.md)<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/> | What do I do now?<br/><br/><br/>Where can I get help?<br/><br/><br/>What if I find a bug?<br/><br/><br/>Where can I find more information about ESMValtool?<br/><br/><br/>How can I cite ESMValtool?<br/><br/> |

The actual schedule may vary slightly depending on the topics and exercises
chosen by the instructor and how fast you work your way through the different
episodes.
