Debugging and blank images

If an atlas failed, you have different options.

First, check the value of the variable safe_mode in the associated parameter file (in comparison/component).

• safe_mode = True means that the C-ESM-EP will keep going if it encounters an error, and return a blank image for the associated plot
• safe_mode = False means that the C-ESM-EP will stop when there is an error

As well, be sure that you set

clog('debug')

to maximize the volume of informations provided by the C-ESM-EP.

Then, you have two methods to track down the error:

• in the .e (error) and .o (output) files in the associated directory comparison/component (with the params_[...].py file) if you submitted the jobs using run_C-ESM-EP.py
• or by running the atlas interactively (only on Ciclad!! see below).

In both cases, the most common error comes from a bad dataset specification in datasets_setup (No File Found error). Check this page for more details

Running the C-ESM-EP interactively for debugging (only on Ciclad)

Running the C-ESM-EP interactively can be more convenient to get the error more quickly. Have a look at this page to see how to do it.

The execution of the C-ESM-EP will stop at the error, that you will have to understand to solve it. If you don't understand it, send an e-mail to [email protected] or post an issue with the error message (at the end of the .e file or the end of the interactive execution) and the path to your .e and .o files.

Note: the shell can have display issues when working on a submitted interactive session. If you want to edit a file (do a correction after finding an error for instance) it's more convenient to work on another shell in parallel.