Home

Welcome to the C-ESM-EP wiki!

---

NEWS: the C-ESM-EP v2 is now the default branch!

The new features of v2 compared with v1 is mainly a new structure of the main driver main_C-ESM-EP.py, for better readability and maintenance of the code. The user will also find a more user-friendly code to write personal diagnostics.

The C-ESM-EP v2 now works on Ciclad, at CNRM, CERFACS and on Irene at TGCC.

---

The C-ESM-EP consists of a set of predefined – community validated (IPSL-CNRM-CERFACS) set of evaluation diagnostics by component/thematic (follow this link to see the standard comparison as example) that can be run typically on a set of climate model simulations during the development phase of an ESM. It provides an efficient way to systematically compare results of different simulations while benefiting from the mechanisms of Atlas Explorer to finess the analysis (choosing the periods for a set of diagnostics, controlling the plot parameters…). The result is a front html page with links to the html pages of the atlases of the different components/thematics.

Atlas Explorer is an easy and flexible way to produce an html page showing climatologies and difference maps (with a reference) on a set of datasets (simulations, models, different periods…). The main goal of the Atlas Explorer is to provide the user with a set of predefined features to assess a variable (plotting parameters, default observational reference) while keeping a lot of control on the diagnostics from only one parameter file.

The C-ESM-EP works on Ciclad and Curie (soon on Irene), and at CNRM.

---

Scientific content of the C-ESM-EP

All you need to know about the scientific content (available atlases/diagnostics) of the C-ESM-EP: follow this link.

Structure and content of the code of the C-ESM-EP

Everything you need to know about the default (v2) is here.. For v1 (previous version), it's here.

---

You will find here everything you need to know to run the C-ESM-EP on Ciclad and Curie and at CNRM. And don't forget to subscribe to cesmep-users at lists.lsce.ipsl.fr !

How to use the C-ESM-EP

Follow the steps below to fully enjoy using the C-ESM-EP!

• Do not miss the FAQ at the bottom of the page

• Have a look at the requirements to set yourself properly.

• Get started with the page The C-ESM-EP in a nutshell. If running at CNRM, some specific directives do apply.

• You can carry on with Building my comparison part 1 and part 2 ; In part 1 you will find:

  • 1. Adding my datasets to datasets_setup.py
  • 2. Using the common_keys
  • 3. ts_period, clim_period and the period manager
  • 4. The customname: control the name in the plot
  • 5. Control the reference used to compute the differences
  • 6. One word on colors to identify your datasets in the C-ESM-EP

• See here how to add your files (your own data trees, results, that are stored in your directories)

• Next, have a look at how to use set_available_period_ts_clim.py to take advantage of a faster C-ESM-EP.

• See how you can customize the bias maps in your atlas using the Atlas Explorer mechanism that provides a great number of possibilities!

• You want to add new variables to your atlas?

• And in case that was not enough to fit your needs, you can always add your own diagnostic/script to the C-ESM-EP (see here for C-ESM-EP_v1)

• Really important!! In case of a highly unprobable error (yes, it can happen :) ) or blank images that you do not expect to be missing, go to this page.

• Eventually, in case of an error that you can't fix with those pages, you can send an e-mail to jerome . servonnat at lsce . ipsl . fr or write an issue on the C-ESM-EP github page. If you reach this point, do not hesitate to report your errors there to contribute to the documentation of the most common errors!

FAQ:

• I want to use the C-ESM-EP on my own datasets, how can I do it?
• How to add new variables to an existing atlas?
• How to add my own diagnostic?