# Build EC-EARTH on LUCIA

EC-Earth is a global coupled climate model. It is developed by a consortium of European research institutions.
The goal of this project is to adapt this model for our needs in ELIC: install, run management, etc.

## User requirements

First, load the required env modules

```bash
    module load EasyBuild/2023a
    export MODULEPATH=$MODULEPATH:/gpfs/projects/acad/ecearth/softs/easybuild/2023a/modules/all
    module load netCDF-Fortran/4.6.1-iompi-2023a
    module load CDO/2.2.2-iompi-2023a
    module load NCO/5.1.3-iomkl-2023a
    module load ecCodes/2.31.0-iompi-2023a
```

Then, clone this EC-Earth fork repository (3.3.4.2)

```bash
mkdir -p ~/models
cd ~/models
git clone -b 3.3.4.2 https://gogs.elic.ucl.ac.be/pbarriat/ecearth3.git ecearth_3.3.4.2
```

## Compile

* Compile **oasis**:

```bash
cd ~/models/ecearth_3.3.4.2/sources/oasis3-mct/util/make_dir
make BUILD_ARCH=ecconf -f TopMakefileOasis3
```

> If rebuild, do `make BUILD_ARCH=ecconf -f TopMakefileOasis3 realclean` before

* Compile **xios**:

```bash
cd ~/models/ecearth_3.3.4.2/sources/xios-2.5
module load Perl-bundle-CPAN/5.36.1-GCCcore-12.3.0

./make_xios --prod --arch ecconf --use_oasis oasis3_mct --netcdf_lib netcdf4_par -j 4
```

> If rebuild, add `--full` to the command above

* Compile **IFS**:

```bash
cd ~/models/ecearth_3.3.4.2/sources/ifs-36r4
./makeifs -j 4
```

> If rebuild, do `make BUILD_ARCH=ecconf realclean` before

* Compile **NEMO**:

```bash
cd ~/models/ecearth_3.3.4.2/sources/nemo-3.6/CONFIG
module load Perl-bundle-CPAN/5.36.1-GCCcore-12.3.0

./makenemo -n ORCA1L75_LIM3 -m ecconf -j4
```

> If rebuild, do `rm -rf ~/models/ecearth_3.3.4.2/sources/nemo-3.6/CONFIG/ORCA1L75_LIM3/BLD/` before

* Compile **runoff-mapper**:

```bash
cd ~/models/ecearth_3.3.4.2/sources/runoff-mapper/src
make
```

> If rebuild, do `make clean` before

* Compile **lpjg**:

```bash
cd ~/models/ecearth_3.3.4.2/sources/lpjg
module load CMake/3.26.3-GCCcore-12.3.0

mkdir build
cd build
cmake ..
make
```

> If rebuild, do `rm -rf ~/models/ecearth_3.3.4.2/sources/lpjg/build` before

## Run

Check the `ecconf.cfg` the first job script `EC01.sh` and submit

```bash
cd ~/models/ecearth_3.3.4.2/runtime/classic
sbatch EC01.sh
```

Check the first job script `EC02.sh` (same as EC01 with **lpjg**) and submit
```bash
cd ~/models/ecearth_3.3.4.2/runtime/classic
sbatch EC01.sh
```

### Data

I prepared all the input files in `/gpfs/scratch/acad/ecearth/data/bsc32/` directory.

### Very first try

|  CC   | Release | RES |  XIOS  | NEMO | IFS | LPJG | #NODES |  WTIME per YEAR        |
| ----- | --- | ---- | ------ | -------------- | ---- | ------ | ------- | -------------------- |
| `EC01.sh` | iomkl/2023a | T255L91_ORCA1L75 |  1  |  98  |   392   |  20  | 4       | **145min**      |
| `EC02.sh` | iomkl/2023a | T255L91_ORCA1L75 |  1  |  98  |   392   |  20  | 4       | **144min**      |

- 1 year (1850), restart every year

## Contributors

- ELIC members [@pbarriat](https://gogs.elic.ucl.ac.be/pbarriat)