View source for Building EC-Earth4 on Tetralith


The documentation below gives the minimal steps required to build EC-Earth 4 on [https://nsc.liu.se/systems/tetralith/ Tetralith]. Please see the [https://ec-earth-4-tutorial.readthedocs.io/en/latest/introduction.html EC-Earth 4 getting started tutorial] for more details.

;Getting the sources

The source code can be downloaded form the [https://dev.ec-earth.org/projects/ec-earth-4 EC-Earth development portal] source code repository. Check available model versions using:
<pre>
> svn ls https://svn.ec-earth.org/ecearth4/trunk
</pre>

The source code should be downloaded into the <tt>/home</tt> file system. This ensures that your code, and configuration files are backed up. For example:
<pre>
> mkdir Projects
> cd ~/Projects
> svn co https://svn.ec-earth.org/ecearth4/trunk ECE4-trunk
</pre>

;ECE4 conda environment

A pre-prepared conda environment for EC-Earth4 is available for use in <tt>/proj/bolinc/shared/software/Python/ECE4</tt>. To activate this environment:
<pre>
> module load Anaconda/2020.07-nsc1
> conda activate /proj/bolinc/shared/software/Python/ECE4
</pre>

;Building the EC-Earth 4 components

Edit the <tt><base>/sources/se/user-settings.yml</tt> line 9 such that the "base_dir" variable points to the correct path for your EC-Earth 4 model. From the example above: 

       base_dir: "/home/x_abcde/Projects/ECE4-trunk"

Load the intel 2018a-eb build envirunment module:

<pre>
> module load buildenv-intel/2018a-eb
</pre>

You can now build individual components using the "se" (ScriptEngine) python module, and the platforms/nsc-tetralith.yml platform definition, e.g. oasis
<pre>
> se user-settings.yml platforms/nsc-tetralith.yml compile-oasis.yml > se-output-oasis.log 2>&1
</pre>