<a id="epsiode-1-introduction"></a>

# Introduction

## What is ESMValTool?

This tutorial is a first introduction to ESMValTool. Before diving into the
technical steps, let’s talk about what ESMValTool is all about.

## A tool to analyse climate data

ESMValTool takes care of finding, opening, checking, fixing, concatenating,
and preprocessing CMIP data and several other supported datasets.

The central component of ESMValTool that we will see in this tutorial is the
**recipe**. Any ESMValTool recipe is basically a set of instructions to
reproduce a certain result. The basic structure of a recipe is as follows:

* **Documentation** with relevant (citation) information
* **Datasets** that should be analysed
* **Preprocessor** steps that must be applied
* **Diagnostic** scripts performing more specific evaluation steps

An example recipe could look like this:

```bash
documentation:
title: This is an example recipe.
description: Example recipe
authors:
   - lastname_firstname

datasets:
- {dataset: UKESM1-0-LL, project: CMIP6, exp: historical, mip: Amon,
   ensemble: r1i1p1f2, start_year: 1960, end_year: 2005}

preprocessors:
global_mean:
   area_statistics:
      operator: mean

diagnostics:
hockeystick_plot:
   description: plot of global mean temperature change
   variables:
      temperature:
      short_name: tas
      preprocessor: global_mean
   scripts: hockeystick.py
```

## A collection of diagnostics for reproducible climate science

More than a tool, ESMValTool is a collection of publicly available recipes and
diagnostic scripts. This makes it possible to easily reproduce important
results.

## A community effort

ESMValTool is built and maintained by an active community of scientists and
software engineers. It is an open source project to which anyone can
contribute. Many of the interactions take place on GitHub. Here, we briefly
introduce you to some of the most important pages.

## Conclusion

This concludes the introduction of the tutorial. You now have a basic
knowledge of ESMValTool and its community. The following episodes will walk
you through the installation, configuration and running your first recipes.
