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?#
.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
the syntax is relatively straightforward;
indentation matters a lot (like
yaml is case sensitive;
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
argument (available only for Python diagnostics, check your options with
that will force an overwrite, and it will delete not just the failed diagnostic,
but the contents of its
plot_dir directories - this is useful when needing to
redo the whole work. Adding
--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?#
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 psyplot_diag.py 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 seaborn_diag.py 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.