Running simulations with ORCHIDEE-CNP

Experiments with ORCHIDEE usually require a set consisting of two and more simulations: a simulation to equilibrate the biogeochemical cycles to the boundary conditions of the initial state (e.g. pre-industrial conditions) & a second simulation restarting from the first one which consists of simulation of the historic period (pre-industrial to period of interest). We have template folders for these and additional types of simualtions available. Please get in touch with your supervisor regarding the templates.

MIND: The exact setup depends on your objectives. Here we only provide a general template which works for most applications. Please get in touch with your supervisor to design a simulation setup suited for your application.

1.1 Copy a configuration folder

cd ../../config/ORCHIDEE_OL/

cp -fr TEMPLATE MY_EXPERIMENT

cd MY_EXPERIMENT.SPIN/

Replace TEMPLATE with the name of template folder and MY_EXPERIMENT with your experiment name.

1.2 adjust the config.card

Follow the instructions for the ORCHIDEE trunk version. To select the correct driving dataset in the COMP/*.card file get in touch with your supervisors.

1.3 Create the Job file

../../libIGCM/ins_job

The command creates a Job file named Job_ followed by the JobName? from config.card

1.4 Adjust the Job file

Besides the modifications described for the trunk version of ORCHIDEE (see there), some additional changes need to be done when using the ORCHIDEE-CNP version. We report here only the CNP specific changes, for the others see documents of the main version (e.g. training course).

1.4.1 enhance the computational efficiency

Replace

IGCM_comp_GetInputBoundaryFiles 

With

IGCM_comp_GetInputBoundaryFiles "ln" 

Replace

IGCM_comp_GetInputRestartFiles  

With

IGCM_comp_GetInputRestartFiles "ln"

1.4.2 Setting paths on obelix

On obelix, specify the path to the directory you want to have the output using this variable

ARCHIVE=YOURPATH

Replace YOURPATH with the path you want.

Also specify the running directory to minimize the risk of model crashes using

RUN_DIR_PATH=YOURPATH

Replace YOURPATH with the path you want. Mind, you have to regularly remove the directories in the RUN_DIR_PATH as they are not automatically cleaned.

1.5 submit the job

This is similar to ORCHIDEE trunk & you find more information there.

on obelix:

qsub Job_ID

Replace ID with the simulation name (JobName? in config.card).

1.6 restart / rerun a job after crash

It is important that you stick to the libIGCM regulations. The libIGCM of ORCHIDEE-CNP uses a tool which is different from trunk. We use /libIGCM/clean_Month It resets run.card. You can also delete run.card, run.card.bak as well as the experiment folder in the archive folder if you want to start from scratch. To avoid headaches, it is recommended to always delete all file which you want to redo , for example in the experiment output in IGCM_OUT, etc