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)
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 ...