Preface

This user’s and developer’s guide consists of parts targeting two overlapping categories of scientists working with the Earth System Model Evaluation Tool (ESMValTool):

  1. Part I: User’s Guide: this part gives an introduction to the ESMValTool including installation, running the ESMValTool, and available user settings of existing diagnostics and performance metrics. The target group would typically consist of scientists mostly interested in running the ESMValTool as provided either on CMIP model simulations or on simulations performed with other Earth system models, and on observations. An overview on the available diagnostics and metrics packages including a description of the user settings and example plots can be found in Annex C (to be added for v2).
  2. Part II: Developer’s Guide: this part gives additional technical details on the ESMValTool not necessarily needed to apply the ESMValTool as well as an introduction to implementing new variables and new diagnostics. This part is mostly intended for scientists interested in technical details as well as in contributing to the development of the ESMValTool by adding new nameslists and code for additional diagnostics or performance metrics.

For the developer’s guide (Part II), it is assumed that the user/developer is already familiar with the ESMValTool framework introduced in part I.

Please report problems and bugs to the ESMValTool Core Development Team (Main contacts and http://www.esmvaltool.org/). Thank you!