Skip to content

Commit

Permalink
Update large_use_case (#230)
Browse files Browse the repository at this point in the history
* Add Santis

* fix typo

Co-authored-by: Michael Jähn <[email protected]>

---------

Co-authored-by: Michael Jähn <[email protected]>
  • Loading branch information
AnnikaLau and mjaehn authored Dec 16, 2024
1 parent 9629a88 commit 3ec8a2d
Showing 1 changed file with 29 additions and 4 deletions.
33 changes: 29 additions & 4 deletions docs/models/icon/usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,11 +75,31 @@ srun -N 1 -c 12 --mem-per-cpu=20G spack install -v -j 12

Information on this section is not yet complete nor final. It will be updated following the progress of the Alps system deployment at CSCS and C2SM's adaptation to this new system. Please use the [C2SM support forum :material-open-in-new:](https://github.com/C2SM/Tasks-Support/discussions){:target="_blank"} in case of questions regarding building ICON on Alps.

On Todi, Spack is also used to build ICON. However, these is no suitable `spack.yaml` file present for the Spack environment. Therefore, create a `spack.yaml` file and use the software stack upstream provided by the user environment.
On Todi, Spack is also used to build ICON. However, there is no suitable `spack.yaml` file present for the Spack environment. Therefore, create a `spack.yaml` file and use the software stack upstream provided by the user environment.

**1. Create a `spack.yaml` file**

From your ICON root folder:
Create the following files from the ICON build folder (different to the ICON root folder in case of a out-of-source build).

For CPU compilation:

=== "config/cscs/spack/v0.21.1.3/todi_cpu_nvhpc/spack.yaml"

```yaml
spack:
specs:
- [email protected]
- icon @develop %nvhpc +grib2 +eccodes-definitions +ecrad ~emvorado +art +dace +acm-license ~aes ~jsbach ~ocean ~coupling ~rte-rrtmgp ~loop-exchange ~async-io-rma +pgi-inlib
view: true
concretizer:
unify: when_possible
develop:
icon:
path: ../../../../..
spec: icon @develop %nvhpc +grib2 +eccodes-definitions +ecrad ~emvorado +art +dace +acm-license ~aes ~jsbach ~ocean ~coupling ~rte-rrtmgp ~loop-exchange ~async-io-rma +pgi-inlib
```
For GPU compilation:
=== "config/cscs/spack/v0.21.1.3/todi_gpu_nvhpc/spack.yaml"
Expand All @@ -99,6 +119,7 @@ From your ICON root folder:
**2. Build ICON**
Run the following from the ICON root folder:
```console
# Load ICON user-environment
uenv start --view=spack icon-wcp/v1:rc4
Expand All @@ -109,14 +130,18 @@ git clone --depth 1 --recurse-submodules --shallow-submodules -b ${SPACK_TAG} ht
. spack-c2sm/setup-env.sh /user-environment

# Build ICON
cd /path/to/icon
cd /path/to/icon-build-folder
spack env activate -d config/cscs/spack/${SPACK_TAG}/todi_gpu_nvhpc
spack install
```


### Santis
Please follow the instructions for Todi, but run the following before loading the ICON user-environment:


```bash
export CLUSTER_NAME=todi
```

## Run test case
In the *run* folder, you find many prepared test cases, which you can convert into run scripts. To generate the runscript of one of the experiment files, e.g. *mch_ch_lowres*, you can use the `make_runscripts` function.
Expand Down

0 comments on commit 3ec8a2d

Please sign in to comment.