This lesson is being piloted (Beta version)

Conclusion of the basic tutorial


Teaching: 10 min
Exercises: 0 min
Compatibility: ESMValTool v2.8.0
  • What do I do now?

  • Where can I get help?

  • What if I find a bug?

  • Where can I find more information about ESMValtool?

  • How can I cite ESMValtool?

  • Breathe - you’re finished now!

  • Congratulations & Thanks!

  • Find out about the mini-tutorials, and what to do next.


Congratulations on completing the ESMValTool tutorial! You should be now ready to go and start using ESMValTool independently.

The rest of this tutorial contains individual mini-tutorials to help work through a specific issue (not developed yet).

What next?

From here, there are lots of ways that you can continue to use ESMValTool.

Exercise: What do you want to do next?

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

Where can I get more information on ESMValTool?

Additional resources:

Where can I get more help?

There are lots of resources available for helping you use ESMValTool.

The ESMValTool Discussions page is a good place to learn about general issues, or to see if your question has been already addressed. If you have a GitHub account, you can also post your questions on the page.

If you get stuck, a great starting point is to create a new issue. Note that you will need a GitHub account for this.

There is also an ESMValTool email list. Please see


on how to subscribe to user mailing list.

What if I find a bug?

If you find a bug, please report it back to the ESMValTool team. This will help us fix it, so that you can continue working, but also it means that ESMValTool will be more stable for everyone else as well.

To report a bug, please create a new issue using the new issue page.

In your bug report, please describe the problem as clearly and as completely as possible. You may need to include a recipe or the output log as well.

How do I cite the Tutorial?

Please use citation information available at

Key Points

  • Individual mini-tutorials help work through a specific issue (not developed yet).

  • We are constantly improving this tutorial.