Frequently Asked Questions#

Is there a mailing list?#

Yes, you can subscribe to the ESMValTool user mailing list and join the discussion on general topics (installation, configuration, etc). See User mailing list.

What is YAML?#

While .yaml or .yml is a relatively common format, users may not have encountered this language before. The key information about this format is:

  • yaml is a human friendly markup language;

  • yaml is commonly used for configuration files (gradually replacing the venerable .ini);

  • the syntax is relatively straightforward;

  • indentation matters a lot (like Python)!

  • yaml is case sensitive;

More information can be found in the yaml tutorial and yaml quick reference card. ESMValTool uses the yamllint linter tool to check recipe syntax.

Re-running diagnostics#

If a diagnostic fails, you will get the message

INFO    To re-run this diagnostic script, run:

If you run the command in the stdout you will be able to re-run the diagnostic without having to re-run the whole preprocessor. If you add the -f argument (available only for Python diagnostics, check your options with --help) that will force an overwrite, and it will delete not just the failed diagnostic, but the contents of its work_dir and plot_dir directories - this is useful when needing to redo the whole work. Adding -i or --ignore-existing will not delete any existing files, and it can be used to skip work that was already done successfully, provided that the diagnostic script supports this.

Enter interactive mode with iPython#

Sometimes it is useful to enter an interactive session to have a look what’s going on. Insert a single line in the code where you want to enter IPython: import IPython; IPython.embed()

This is a useful functionality because it allows the user to fix things on-the-fly and after quitting the Ipython console, code execution continues as per normal.

Use multiple config-user.yml files#

The user selects the configuration yaml file at run time. It’s possible to have several configurations files. For instance, it may be practical to have one config file for debugging runs and another for production runs.

Can ESMValTool plot arbitrary model output?#

General model evaluation provides a set of recipes that can be used for a basic climate model evaluation with observational data. This is especially useful to get an overview of the general performance of a simulation.

Furthermore, recipe Monitor allows for the plotting of any preprocessed model. The plotting parameters are set through a yaml configuration file, and the type of plots to be generated are determined in the recipe.

Moreover, recipe Psyplot Diagnostics and the corresponding diagnostic provide a high-level interface to the Psyplot package which can be used to create a large variety of different plots.

Similarly, recipe Seaborn Diagnostics and the corresponding diagnostic provide a high-level interface to the Seaborn package which can also be used to create a large variety of different plots.

See also General-purpose diagnostics.