Skip to content

Commit

Permalink
More detailed instructions for out-of-source builds
Browse files Browse the repository at this point in the history
  • Loading branch information
AnnikaLau committed Oct 18, 2024
1 parent 876a2c4 commit d73dc15
Showing 1 changed file with 12 additions and 1 deletion.
13 changes: 12 additions & 1 deletion docs/models/icon/large_use_cases.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,18 @@ Then set up an ICON test case with a low number of grid points and a few time st

Follow the step-by-step guide in [How to add experiments to a buildbot list :material-open-in-new:](https://gitlab.dkrz.de/icon/wiki/-/wikis/How-to-setup-new-test-experiments-for-buildbot#how-to-add-experiments-to-a-buildbot-list){:target="_blank"} to add your test case to the checksuite. Start with the `checksuite_modes` for the mpi and nproma tests (`'nm'`) for the machine you are testing on.

We recommend you to do out-of-source builds for CPU and GPU so that you can have two compiled versions of ICON in the same repository. Therefore, you simply need to create to folders in the the ICON root folder (e.g. `nvhpc_cpu` and `nvhpc_cpu`) and copy the folders `config` and `scripts` from the root folder into it. Then follow the instructions in [Configure and compile :material-open-in-new:](usage.md/#configure-and-compile){:target="_blank"} to compile ICON on CPU and on GPU from within those folders.
We recommend you to do out-of-source builds for CPU and GPU so that you can have two compiled versions of ICON in the same repository. Therefore, you simply need to create to folders in the the ICON root folder (e.g. `nvhpc_cpu` and `nvhpc_cpu`) and copy the folders `config` and `scripts` from the root folder into it:

```bash
mkdir nvhpc_cpu
cd nvhpc_cpu
cp -r ../config ../scripts .
mkdir nvhpc_gpu
cd nvhpc_gpu
cp -r ../config ../scripts .
```

Then follow the instructions in [Configure and compile :material-open-in-new:](usage.md/#configure-and-compile){:target="_blank"} to compile ICON on CPU and on GPU from within those folders.

### 1.2 Local testing

Expand Down

0 comments on commit d73dc15

Please sign in to comment.