26.1.1. First step :install#

26.1.1.1. Getting the good environment#

Warning

This is specific to DATARMOR cluster used for this training; if you are working on you own computer, follow the System Requirements and Downloading the code tutorials to download the code, and set-up your environment

An environment script has been created for this training on DATARMOR. It will load the necessary modules and set some useful paths and environment variables. Copy this croco_env.csh script and source it. If you already have a .cshrc or .tcshrc or .bashrc environment script, please copy it to .chsrc.bck to avoid overdefinitions and use only croco_env.csh during the training period.

cd $HOME
cp /home/datawork-croco/datarmor-only/TRAININGS/TRAINING_2021/croco_env.* .
source croco_env.csh

Now the $CROCO_DIR environment variable is defined and you will find useful material for this training in this directory.

26.1.1.2. Creating your work architecture#

Let’s work on your WORKDIR to avoid disk space issues.

cd $work
mkdir TRAINING_2021
cd TRAINING_2021
mkdir croco
mkdir CONFIGS

cp -r $CROCO_DIR/../../SOURCE_CODES/CROCO/croco_git/croco_master/croco croco/.
cp -r $CROCO_DIR/../../SOURCE_CODES/CROCO/croco_git/croco_tools croco/.

If you have followed this architecture, the following environment variables have also been placed to facilitate navigation:

  • $croco point to your croco sources: $work/TRAINING_2021/croco/croco

  • $tools point to your croco sources: $work/TRAINING_2021/croco/croco_tools

  • $confs point to your croco sources: $work/TRAINING_2021/CONFIGS

Warning

do not modify any of the files contained in your source directories $croco and $tools to keep your source files clean; modifications should be perfomed in your configuration directories (as we will see later)

  1. Investigate by your own the various directory below ./croco

    AGRIF : AGRIF refinement library
    CVTK : to check mpi reproductibility
    OCEAN : sources code themselves
    PISCES : biogeochemical code
    Run/TEST_CASES : the crocos.in for the various test_cases
    XIOS : input-ouput server that can be coupled to croco
    etc ...
    

26.1.2. Second step: launch a test case#

BASIN

26.1.3. Third step: set up your own test case#

Set up you own test case