25. TRAINING 2019: DATARMOR specific#

25.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_2019/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.

25.2. Creating your work architecture#

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

cd $work
mkdir TRAINING_2019
cd TRAINING_2019
mkdir croco
mkdir CONFIGS

cp -r $CROCO_DIR/SOURCE_CODES/CROCO/croco_git/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_2019/croco/croco

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

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

Investigate by your own the various directories.

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)

25.3. DATA FILES#

Datasets for preparing surface and boundary conditions from climatological dataset can be downloaded on CROCO website. For this training you will find them in $CROCO_DIR/DATA/DATASETS_CROCOTOOLS ; otherwise see the Download tutorial.

You can also find the following global atmospheric reanalysis in $CROCO_DIR/DATA/METEOROLOGICAL_FORCINGS/:

  • ERAI

  • CFSR

And the following ocean reanalysis in $CROCO_DIR/DATA/3D_OCEAN_FORCING:

  • SODA

  • ECCO2

25.4. BASIN configuration for XIOS tutorial#

cp -R /home/datawork-croco/datarmor-only/CONFIGS/TUTO20/BASIN_NO_XIOS/* $confs/BASIN
cd $confs/BASIN

Path for XIOS sources:

::

XIOS_ROOT_DIR=/home/datawork-croco/datarmor-only/SOURCE_CODES/XIOS/XIOS-2.5

25.5. SOURCES for coupling tutorial#

For DATARMOR training, OASIS has already been compiled, so you can just copy the sources and compiled files

mkdir -p $work/TRAINING_2019/oasis
cp -r $CROCO_DIR/SOURCE_CODES/OASIS/OASIS3-MCT_3.0_branch_compiled $work/TRAINING_2019/oasis/OASIS3-MCT_3.0_branch

The configure file for compiling OASIS on DATARMOR, named make.datarmor can be found here

$CROCO_DIR/make.datarmor

For DATARMOR training, WRF has been compiled, and you can just copy the source and compiled files

mkdir -p $work/TRAINING_2019/wrf
cp -r $CROCO_DIR/SOURCE_CODES/WRF/WRFV3.7.1_compiled $work/TRAINING_2019/wrf/WRFV3.7.1

A job for compilation is also provided

::

$CROCO_DIR/job_compile_wrf.pbs

For DATARMOR training, WPS has been compiled, and you can just copy the source and compiled files

cp -r $CROCO_DIR/SOURCE_CODES/WRF/WPSV3.7.1 $work/TRAINING_2019/wrf/.

For DATARMOR training, these data are avaiable in $CROCO_DIR/SOURCE_CODES/WRF/geog.

For DATARMOR training, CFSR data for WRF are available in $CROCO_DIR/DATA/METEOROLOGICAL_FORCINGS/CFSR/GLOBAL/NATIVE_format

For DATARMOR training, WW3 has been compiled, and you can just copy the source and compiled files

mkdir -p $work/TRAINING_2019/ww3
cp -r $CROCO_DIR/SOURCE_CODES/WW3/github/WW3_compiled/* $work/TRAINING_2019/ww3/.

For DATARMOR training, TOY model files are provided here:

cp $CROCO_DIR/SOURCE_CODES/TOY/toy_compiled/toy_model $confs/Run_BENGUELA_LR_cpl/.

cp $CROCO_DIR/DATA/BENGUELA_CPL/toy_files/* $confs/Run_BENGUELA_LR_cpl/.

You should now have the following new files in your configuration directory:

  • toy_model

  • grid_wav.nc

  • TOYNAMELIST.nam

  • toy_wav.nc

An example of fulfilled namcouple is also provided in $CROCO_DIR/DATA/BENGUELA_CPL/oasis_files