Skip to content

Commit 3ec8a2d

Browse files
AnnikaLaumjaehn
andauthored
Update large_use_case (#230)
* Add Santis * fix typo Co-authored-by: Michael Jähn <[email protected]> --------- Co-authored-by: Michael Jähn <[email protected]>
1 parent 9629a88 commit 3ec8a2d

File tree

1 file changed

+29
-4
lines changed

1 file changed

+29
-4
lines changed

docs/models/icon/usage.md

Lines changed: 29 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -75,11 +75,31 @@ srun -N 1 -c 12 --mem-per-cpu=20G spack install -v -j 12
7575

7676
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.
7777

78-
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.
78+
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.
7979

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

82-
From your ICON root folder:
82+
Create the following files from the ICON build folder (different to the ICON root folder in case of a out-of-source build).
83+
84+
For CPU compilation:
85+
86+
=== "config/cscs/spack/v0.21.1.3/todi_cpu_nvhpc/spack.yaml"
87+
88+
```yaml
89+
spack:
90+
specs:
91+
92+
- 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
93+
view: true
94+
concretizer:
95+
unify: when_possible
96+
develop:
97+
icon:
98+
path: ../../../../..
99+
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
100+
```
101+
102+
For GPU compilation:
83103
84104
=== "config/cscs/spack/v0.21.1.3/todi_gpu_nvhpc/spack.yaml"
85105
@@ -99,6 +119,7 @@ From your ICON root folder:
99119
100120
**2. Build ICON**
101121
122+
Run the following from the ICON root folder:
102123
```console
103124
# Load ICON user-environment
104125
uenv start --view=spack icon-wcp/v1:rc4
@@ -109,14 +130,18 @@ git clone --depth 1 --recurse-submodules --shallow-submodules -b ${SPACK_TAG} ht
109130
. spack-c2sm/setup-env.sh /user-environment
110131

111132
# Build ICON
112-
cd /path/to/icon
133+
cd /path/to/icon-build-folder
113134
spack env activate -d config/cscs/spack/${SPACK_TAG}/todi_gpu_nvhpc
114135
spack install
115136
```
116137

117138

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

119-
142+
```bash
143+
export CLUSTER_NAME=todi
144+
```
120145

121146
## Run test case
122147
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.

0 commit comments

Comments
 (0)