Skip to content

Commit 52fe2c5

Browse files
more updates
1 parent 82198cf commit 52fe2c5

File tree

1 file changed

+15
-14
lines changed

1 file changed

+15
-14
lines changed

docs/software/sciapps/lammps.md

Lines changed: 15 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -56,9 +56,9 @@ uenv start --view develop-kokkos lammps/2024:v2
5656
uenv start --view develop-gpu lammps/2024:v2
5757
```
5858

59-
### Running LAMMPS+kokkos on the HPC Platform
59+
### Running LAMMPS with Kokkos on the HPC Platform
6060

61-
To start a job, two bash scripts are potentially required: a [SLURM] submission script, and a wrapper for numacontrol which sets up cpu and memory binding:
61+
To start a job, two bash scripts are potentially required: a [SLURM] submission script, and a wrapper for `numactl` which sets up CPU and memory binding:
6262

6363
submission script:
6464

@@ -85,7 +85,7 @@ srun ./wrapper.sh lmp -in lj_kokkos.in -k on g 1 -sf kk -pk kokkos gpu/aware on
8585
3. Change `<ACCOUNT>` to your project account name.
8686
4. Change `<LAMMPS_UENV>` to the name (or path) of the LAMMPS uenv you want to use.
8787

88-
numacontrol wrapper:
88+
`numactl` wrapper:
8989

9090
```bash title="wrapper.sh"
9191
#!/bin/bash
@@ -227,19 +227,17 @@ run $t
227227

228228
### Using CMake
229229

230-
```
231-
If you'd like to rebuild LAMMPS from source to add additional packages or to use your own customized code, you can use the develop views contained within the uenv image to provide you with all the necessary libraries and command-line tools you'll need. For the following, we'd recommend obtaining an interactive node and building inside the tempfs directory.
232-
```
230+
If you'd like to rebuild LAMMPS from source to add additional packages or to use your own customized code, you can use the develop views contained within the uenv image to provide you with all the necessary libraries and command-line tools you'll need.
231+
For the following, we'd recommend obtaining an interactive node and building inside the tmpfs directory.
233232

234-
```
233+
```bash
235234
salloc -N1 -t 60 -A <account>
236-
...
237235
srun --pty bash
238-
...
239236
mkdir /dev/shm/lammps_build; cd /dev/shm/lammps_build
240237
```
241238

242-
After you've obtained a version of LAMMPS you'd like to build, extract it in the above temporary folder, and create a build directory. Load one of the two following views:
239+
After you've obtained a version of LAMMPS you'd like to build, extract it in the above temporary folder and create a build directory.
240+
Load one of the two following views:
243241

244242
```
245243
#build environment for lammps +kokkos package, without providing lmp executeable
@@ -248,7 +246,8 @@ uenv start --view develop-kokkos lammps/2024:v2-rc1
248246
uenv start --view develop-gpu lammps/2024:v2-rc1
249247
```
250248

251-
and now you can build your local copy of LAMMPS. For example to build with kokkos and the `MOLECULE` package enabled:
249+
and now you can build your local copy of LAMMPS.
250+
For example to build with kokkos and the `MOLECULE` package enabled:
252251

253252
```
254253
CC=mpicc CXX=mpic++ cmake \
@@ -271,7 +270,9 @@ CC=mpicc CXX=mpic++ cmake \
271270

272271
!!! `Warning` !!!
273272

274-
If you are downloading LAMMPS from github or their website and intend to use kokkos for acceleration, there is an issue with cray-mpich and kokkos versions <= 4.3. For LAMMPS to work correctly on our system, you need a LAMMPS version which provides kokkos >= 4.4. Alternatively, the cmake variable `-DEXTERNAL_KOKKOS=yes` should force cmake to use the kokkos version (4.5.01) provided by the uenv, rather than the one contained within the lammps distribution.
273+
If you are downloading LAMMPS from github or their website and intend to use kokkos for acceleration, there is an issue with cray-mpich and kokkos versions <= 4.3.
274+
For LAMMPS to work correctly on our system, you need a LAMMPS version which provides kokkos >= 4.4.
275+
Alternatively, the cmake variable `-DEXTERNAL_KOKKOS=yes` should force cmake to use the kokkos version (4.5.01) provided by the uenv, rather than the one contained within the lammps distribution.
275276

276277
### Using LAMMPS uenv as an upstream Spack Instance
277278

@@ -280,7 +281,7 @@ If you'd like to extend the existing uenv with additional packages (or your own)
280281
First, set up an environment:
281282

282283
```
283-
uenv start --view develop-gpu lammps/2024:v2-rc1
284+
uenv start --view develop-gpu lammps/2024:v2
284285
285286
git clone -b v0.23.0 https://github.com/spack/spack.git
286287
source spack/share/spack/setup-env.sh
@@ -347,4 +348,4 @@ CG-SPICA GPU KSPACE MANYBODY MOLECULE PYTHON RIGID
347348
[LAMMPS]: https://www.lammps.org
348349
[GNU Public License]: http://www.gnu.org/copyleft/gpl.html
349350
[uenv]: https://eth-cscs.github.io/cscs-docs/software/uenv
350-
[SLURM]: https://slurm.schedmd.com/documentation.html
351+
[SLURM]: https://eth-cscs.github.io/cscs-docs/running/slurm

0 commit comments

Comments
 (0)