1. Prepare the executable

CHIMERE is a large Fortran 90 code that must be compiled before running. Compilation can be done either manually or automatically.

If you are using the CIF for the first time on your cluster, it is recommended to verify manually that compilation works correctly. With manual compilation, the executable can be built once outside the CIF and stored in a reference directory for later reuse.

Warning

CHIMERE is a research code under active development. Its source code may change to fix bugs or add new features. If a previously working CHIMERE case breaks after a pyCIF update, force a recompilation of 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 compiles the forward code.

To start from scratch in case of a previous compilation:

./compile_chimere -m D -c

⟹ Verify that an executable named fwdchimere.e (approximately 2.5 MB) appears in sub-directory src.

Warning

When compiling manually (outside pyCIF), ensure that your environment is consistent with the one pyCIF uses for your platform. In particular, check that all environment variables and modules (e.g. NetCDF) are correctly set.

1.2. Automatic compilation

The CIF can also compile CHIMERE automatically when needed. To enable this, specify the auto-recompile option (along with compile-mode and compile-clean) in the model plugin in the YAML (see Model (model) for details). No manual preparation of the executable is required in this case.