Skip to content
Merged
Show file tree
Hide file tree
Changes from 5 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/actions/spelling/allow.txt
Original file line number Diff line number Diff line change
Expand Up @@ -181,6 +181,7 @@ gitlab
gmail
gpt
gpu
gromacs
gromos
groundstate
gsl
Expand Down
28 changes: 26 additions & 2 deletions docs/software/sciapps/gromacs.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,20 @@ It is primarily designed for biochemical molecules like proteins, lipids and nuc
[GROMACS] is provided on [Alps][ref-alps-platforms] via [uenv][ref-uenv].
Please have a look at the [uenv documentation][ref-uenv] for more information about uenvs and how to use them.

## Licensing terms & conditions
??? note "Licensing terms and conditions"

GROMACS is a joint effort, with contributions from developers around the world: users agree to acknowledge use of GROMACS in any reports or publications of results obtained with the Software (see [GROMACS Homepage](https://www.gromacs.org/about.html) for details).
GROMACS is a joint effort, with contributions from developers around the world: users agree to acknowledge use of GROMACS in any reports or publications of results obtained with the Software (see [GROMACS Homepage](https://www.gromacs.org/about.html) for details).

??? note "Changelog"
Comment thread
RMeli marked this conversation as resolved.
Outdated

!!! note "2025.0"
Comment thread
RMeli marked this conversation as resolved.
Outdated

* Updated to GROMACS 2025
* Unified view for GROMACS and PLUMED
* Only a single `gromacs` view is provided, which exposes both GROMACS 2025 and PLUMED 2.10.0.
* PLUMED links to PyTorch 2.8.0 (non-distributed version)
* Patched GROMACS 2025 to fix [gromacs#5292](https://gitlab.com/gromacs/gromacs/-/issues/5292)
* Patched PLUMED 2.10.0 with [plumed#1313](https://github.com/plumed/plumed2/pull/1313)

## Key features

Expand Down Expand Up @@ -115,6 +126,19 @@ This submission script is only representative. Users must run their input files
- Given the compute throughput of each Grace-Hopper module (single CPU+GPU), **for smaller-sized problems, it is possible that a single-GPU run is the fastest**. This may happen when the overheads of domain decomposition, communication and orchestration exceed the benefits of parallelism across multiple GPUs. In our test cases, a single Grace-Hopper module (1 CPU+GPU) has consistently shown a 6-8x performance speedup over a single node on Piz Daint (Intel Xeon Broadwell + P100).
- Try runs with and without specifying the GPU IDs explicitly with `-gpu_id 0123`. For the multi-node case, removing it might yield the best performance.

### PLUMED

The PLUMED interface looks for the `PLUMED_KERNEL` environment variable, which should contain the path and the name of a shared object containing the PLUMED kernel (usually called `libplumedKernel.so`). Make sure to appropriately set this variable before running GROMACS.

!!! tip "Find `libplumedKernel.so`"

After loading a view providing PLUMED, you can find the path to the PLUMED kernel shared object by running the following command:
```bash
find /user-environment/ -name libplumedKernel.so -type f
```

Using `-type f` excludes the different symbolic links generated by the different views.

## Scaling

Benchmarking is done with large MD simulations of systems of 1.4 million and 3 million atoms, in order to fully saturate the GPUs, from the [HECBioSim Benchmark Suite](https://www.hecbiosim.ac.uk/access-hpc/hpc-benchmarking-suite).
Expand Down
Loading