Version 43 (modified by acosce, 6 months ago) (diff)


The LMDZORINCA configurations

The LMDZORINCA configurations (LMDZORINCA and LMDZORINCA_v5) allow you to couple the LMDz atmospheric circulation model, the ORCHIDEE land model, and the INCA atmospheric chemistry model close to the CMIP6 coupled model.

Person in charge: Anne Cozic

1. Description of the configuration

1.1. LMDZORINCA_v6.1.11

LMDZORINCA_v6.1.11 is the default configuration for Inca forced model. It is compatible with the IPSLCM6.1.11_LR, LMDZOR_v6.1.11 models. It is constructed with the following models:

  • LMDZ branches/IPSLCM6.0.15 rev 3643 for the gcm and the create_etat0_limit
  • ORCHIDEE tag tags/ORCHIDEE_2_0/ORCHIDEE rev 6592
  • INCA tags/INCA5_CMIP rev 928

This configuration allows you to work with the INCA version tuned for 39 levels and old LMDZ physics scheme for NMHC, NMHC_AER, NMHC_AER_S, AER, GES and DUSS, and on 79 levels and new LMDZ physics scheme for AER.

The same version of INCA is used in IPSLCM5A2CHT.1 configuration.

1.2. LMDZORINCA_v6.2_work

LMDZORINCA_v6.2_work is a configuration close to LMDZORINCA_v6.1.10 with updated versions of components: LMDZ, ORCHIDEE, XIOS

  • LMDZ6 trunk rev 3651) for the gcm and the create_etat0_limit
  • ORCHIDEE branches/ORCHIDEE_2_2/ORCHIDEE rev 6594
  • INCA trunk/INCA6 rev 927

1.3. LMDZORINCA_v6.2.2

LMDZORINCA_v6.2.2 is the 6.2 configuration for production, close to IPSLCM6.2.2 and LMDZOR_v6.2.2

  • LMDZ6/branches/IPSL-CM6A-MR rev 3855 for the gcm and the create_etat0_limit
  • branches/ORCHIDEE_Quest/ORCHIDEE rev 7086
  • tags/INCA6.2 rev 980

This configuration use the new way of compilation (with a script). Read here the documentation on it.

2. Technical details

2.1. How to use it

2.1.1. Compilation of LMDZORINCA_v6.1.10

To compile LMDZORINCA_v6.1.10 configuration you need to use the Makefile store in config/LMDZORINCA/ directory. You can choose between several target :

  • VLR and Old LMDZ Physics scheme
    • NMHC_AERxLMD9695-L39 (default one)
    • NMHC_AER_SxLMD9695-L39
    • NMHCxLMD9695-L39
    • AERxLMD9695-L39
    • DUSSxLMD9695-L39
    • GESxLMD9695-L39
  • LR and New LMDZ Physics scheme
    • AERxLMD144142-L79
  • no maintened anymore - ask to Anne COZIC if you want to use it
    • DUSSxLMD144142-L39

You can add the compilation of another resolution by copying the syntax of an existing resolution. If you do so, you will need to regrid all input files for the chosen chemistry model. documentation To regrid the inca files

2.1.2. Compilation LMDZORINCA_v6.2_work

To compile LMDZORINCA_v6.2_work configuration you need to use the script Options to use this script are :

  • -regular_latlon : default is 96x95x39
  • -chimie : default is NMHC_AER_S
  • -clean_inca : active it if you want to recompile full inca model. This option will make a remove of mdoles/INCA/build/ directory.
  • -full : active it you want to recompile full configuration.
  • -debug, -dev, -prod(default) : choose in which mode you want to compile your configuration.

./ -regular_latlon 144x142x79 
./ -chimie DUSS 
./ -clean_inca
./ -full
./ -debug
./ -regular_latlon 144x142x79  -chimie AER -full

If you compile in debug or in dev mode you need to modify the parameter OptMode in config.card. If you change the resolution at the compilation you need to modify the parameter ResolAtm in config.card

Even if the script allow you to compile any resolution for any chemistry, support ones are the same than for LMDZORINCA_v6.1.10 (see above)

2.2. Computing performances

  • for VLR resolution (96x95x39) we advice to work with 48MPI and 12OMP for the gcm executable (config.card)
  • for LR resolution (144x142x79) we advice to work with 71MPI and 8 OMP for the gcm executable (config.card)
ATM= (gcm_${ResolAtm}_${OptMode}_${ConfChem}.e, lmdz.x, 48MPI, 12OMP)

2.3. Restart files

For LMDZ and ORCHIDEE you can use restart files from any simulation of v6.1.10 family (even coupled model). For Inca you can start without any restart, or use one from a simulation using a version with a revision number bigger than 838

You can also use default restart files (initial states files) :
With the LMDZ model you can create initial files (, and for each simulation (for this, use the experiments : EXPERIMENTS/LMDZORINCA/CREATE_erai/). However, file only contain zero-values for tracers when the model is coupled to INCA. You must therefore work on those values or use output files from existing simulations. By default, we provide one initial state per configuration.



  • ${R_INIT} = igcmg shared space (TGCC and IDRIS - you can find the path in the main Job) $shared_path/IGCM/INIT
  • ${RESOL_CHM} = 9695-L39 / 9695-L19 / 144142-L19 / 144142-L39

They are defined in the [InitialStateFiles] section of lmdz.card


2.4. Output frequencies

2.4.1. Output frequencies for LMDZORINCA_v6.1 configurations

for Inca output frequencies, you can choose by default between 1 day and / or 1 month. For this you need to fill in your choice in section WriteFrequency? for chemistry part

#D-- CHM -
#D-- choose inca ... 
#D-- you can also ...


#D-- choose inca ...
#D-- you can also ...
WriteFrequency="1D 1M"


#D-- choose inca ...
#D-- you can also ...

If you want another output frequency you need to modify the file_def_inca_.xml file in modeles/INCA/src/INCA_XML/ directory. You will find two files for each chemistry configurations (ex: file_def_inca_NMHC_daily.xml and file_def_inca_NMHC_monthly.xml).

2.4.2. Output frequencies for LMDZORINCA_v6.2 configurations

Now the output frequencies and the files to write is set in inca.card (idem for LMDZ in lmdz.card, ORCHIDEE in orchidee.card ans stomate.card). See comments in the corresponding files. The WriteFrequency? option in config.card is not used any more.

2.5. Flags to manage LMDZORINCA configuration

In inca.card, lmdz.card and orchidee.card you can modify several parameters in sections [UsersChoices]

LMDZ_10m_winds y (use LMDZ 10 meters winds) n (use offline winds)
wind_parameter0.85 (default parameter value for threshold scheme to adjust 10 meters winds calculated by LMDZ)
feedb0 (no feedback from aerosol on climate with Old Physics scheme) 1 (aerosol effects selected by ok_ade and ok_aie in lmdz.card)
CoupOrchIncay (coupled model with ORCHIDEE for VOC) n
calcul_fluxy (calcul and write in output the chemistry flux of reactions) n
flag_plane0 (no aircraft) 1 (old inca aircraft scheme) 2 (new subsonic inca aircraft scheme) 3 (subsonic + hypersonic inca aircraft scheme)
emi_interp_time0 (no time interpolation when using emission files) 1 (point to point time interpolation when using emissions files - default)

2.5.10. meters winds

If you choose to use offline winds, you need to define their path in the BoundaryFiles part of inca.card
For Example :

List=	    ($CCCWORKDIR/../../subipsl/subipsl/ECMWF320x160/AN${year}/165_${year}${month}.nc      ,\
	    ($CCCWORKDIR/../../subipsl/subipsl/ECMWF320x160/AN${year}/166_${year}${month}.nc      ,\
	    (${R_BC}/ATM/LMDZORINCA/${RESOL_ATM}/NUDGE_FILES/ERAI/AN${year}/u10m_ecmwf_${year}${month}.nc ,  )\
	    (${R_BC}/ATM/LMDZORINCA/${RESOL_ATM}/NUDGE_FILES/ERAI/AN${year}/v10m_ecmwf_${year}${month}.nc ,  )

2.5.11. The BVOC and Surface coupling

If you choose to activate the bvoc calcul in Orchidee (CHEMISTRY_BVOC=y in Orchidee.def) you can copy the new flux value in Inca. For this you need to modify the parameter CoupOrchInca in inca.card. By default it will copy all bvoc flux : iso - mono - ORVOC - MBO - methanol - acetone - acetal - formal - acetic - formic - no_soil - nox - fertil_no - apinen - bpinen - limonen - myrcen - sabinen - camphen - 3caren - tbocimen - othermono - sesquiter. And iso and mono are use in inca instead of the value read in
WARNING it can only work with NMHC_AER configuration.

snow, lai, veget, vegetfrac are also copy from Orchidee to Inca. You can choose to copy only these variables, for this you need to add in PARAM/inca.def the line :


If you want copy some flux, but not all the list, you need to modify your inca.def

emi_FromOrch=ORVOC acetone bpinen

You need to modify orchidee.card


# to decomment if we want to calcul bvoc - for this we need to activate CHEMISTRY_BVOC in orchidee.def_Choi
ListNonDel= (${R_IN}/SRF/chemistry/, .), \
            (${R_IN}/SRF/chemistry/, .)

and inca.card


2.6. Lengths, frequencies

We advice you to use a PeriodLength of 1 month or 1 year, and a Pack Frequency of 1 year.

2.7. Computing centers

LMDZORINCA_v6.1.10is available on TGCC and IDRIS computers

2.7.1. IDRIS-JeanZay

Because of JeanZay architecture (computing nodes based on sockets of 20 cores), we advice you to use 2, 4, 5, 10 or 20 OpenMP threads for LMDZ-ORCHIDEE component. By default, the number of OpenMP threads defined in config.card is 8. To change that, you have to edit and modify config.card as follows :

#D- For each component, Real name of executable, Name of executable for oasis
ATM= (gcm.e, lmdz.x, 48MPI, 10OMP)

Do not forget to install a new Job (command ins_job) in order to take into account these modifications.