1. Prepare the executable

CHIMERE is a heavy and complex code written in Fortran90. It is thus required to compile it before running. This can be done either manually or automatically.

If you are using the CIF for the first time on your cluster, it is recommended to check manually that the compiling works properly. With the manual compilation, the executable can be prepared once for all outside the CIF with the following steps and then stored in a reference directory for later use.

Warning

CHIMERE is a research code under developments. It may happen that the source code is changed to fix bugs or add new features. When a working case with CHIMERE suddenly stops working after a pycif update, please force re-compiling the executables.

1.1. Manual compilation

Detailed options are given here.

In directory model_sources/chimereGES, compile the fortran chemistry-transport model:

./compile_chimere -m D

Option -m D indicates that the forward code is compiled.

In case of a previous compilation,

./compile_chimere -m D -c

ensures that the new compilation starts from scratch.

⟹ check that you obtain an executable in sub-directory src named fwdchimere.e, about 2.5M in size.

Warning

When manually compiling (outside pyCIF), make sure that your environment is consistent with what pyCIF uses for your platform. In particular, make sure that environment variables and modules (e.g., NetCDF) are well set-up.

1.2. Automatic compilation

It is also possible to opt for a compilation made by the CIF when required: this is done by specifying the option auto-recompile (and associated options compile-mode and compile-clean) in plugin model in the yaml (see details in Model (model)). In this case, no previous preparation of the executable is required.