Skip to content

Latest commit

 

History

History
99 lines (82 loc) · 3.63 KB

index.md

File metadata and controls

99 lines (82 loc) · 3.63 KB
layout root permalink
lesson
.
index.html

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 such that the main body of the tutorial, up to the episode 7, can be done in one sitting. From episode 8, 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.

What will you learn in this course

  • What is ESMValTool
  • How to install ESMValTool
  • How to configure ESMValTool for your local system
  • How to run ESMValTool
  • How to work with ESMValTool's suite of preprocessors
  • How to debug your recipes
  • How to access and deploy recipes from the ESMValTools gallery (Advanced)
  • How to develop your own diagnostics and recipes (Advanced)
  • How to contribute your recipes and diagnostics back into ESMValTool (Advanced)
  • How to include new observational datasets (Advanced)

{: .checklist}

Prerequisites

Minimal requirements:

  • Basic understanding of your preferred command line interface (ie a bash terminal)
  • Laptop/desktop with (mini)conda installed
  • Access to CMIP data

Optional, but useful:

  • Basic understanding of git
  • Access to a suitable computing system (eg CEDA-Jasmin, DKRZ-Mistral)
  • GitHub account

{: .prereq}

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 or via the ESMValTool email list.

  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”.

Additional Resources

{: .callout}

How to cite ESMValTool

Please cite this tutorial as:

Please cite ESMValTool as:

  • Lauer, A., Eyring, V., Bellprat, O., Bock, L., Gier, B. K., Hunter, A., Lorenz, R., Pérez-Zanón, N., Righi, M., Schlund, M., Senftleben, D., Weigel, K., and Zechlau, S.: Earth System Model Evaluation Tool (ESMValTool) v2.0 – diagnostics for emergent constraints and future projections from Earth system models in CMIP, Geosci. Model Dev. Discuss., https://doi.org/10.5194/gmd-2020-60, in review, 2020.

{% include links.md %}