Skip to content

Commit 61cb123

Browse files
update qe docs
1 parent 1e17b6e commit 61cb123

File tree

1 file changed

+64
-2
lines changed

1 file changed

+64
-2
lines changed
Lines changed: 64 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,66 @@
11
[](){#ref-uenv-quantumespresso}
22
# Quantum ESPRESSO
3-
!!! todo
4-
complete docs
3+
4+
Quantum ESPRESSO is an integrated suite of Open-Source computer codes for electronic-structure calculations and materials modeling at the nanoscale. It is based on density-functional theory, plane waves, and pseudopotentials:
5+
6+
PWscf (Plane-Wave Self-Consistent Field)
7+
FPMD (First Principles Molecular Dynamics)
8+
CP (Car-Parrinello)
9+
10+
## ALPS (GH200)
11+
### Setup
12+
Download the uenv image for QuantumESPRESSO:
13+
14+
15+
### List available images
16+
17+
```bash
18+
uenv image find quantumespresso
19+
```
20+
21+
### Pull the image of interest
22+
23+
```
24+
uenv image pull quantumespresso/v7.4:v2
25+
```
26+
27+
28+
QuantumESPRESSO can be compiled from source using the above uenv. The procedure is described in https://eth-cscs.github.io/alps-uenv/uenv-qe/#building-a-custom-version.
29+
30+
### How to run
31+
32+
=== "GH200"
33+
Either run uenv start quantumespresso/v7.4 and then submit the job or set --uenv sbatch option accordingly. The following sbatch script can be used as a template.
34+
35+
```bash
36+
#SBATCH -N 1
37+
#SBATCH --ntasks-per-node=4
38+
#SBATCH --cpus-per-task=71
39+
#SBATCH --gpus-per-task=1
40+
#SBATCH -A <account>
41+
#SBATCH --uenv=quantumespresso/v7.4:v2
42+
#SBATCH --view=default
43+
44+
export OMP_NUM_THREADS=20
45+
export MPICH_GPU_SUPPORT_ENABLED=1
46+
export OMP_PLACES=cores
47+
48+
srun -u --cpu-bind=socket /user-environment/env/default/bin/pw.x < pw.in
49+
```
50+
51+
=== "Eiger"
52+
Either run uenv start quantumespresso/v7.4 and then submit the job or set --uenv sbatch option accordingly. The following sbatch script can be used as a template.
53+
54+
```bash
55+
#SBATCH -N 1
56+
#SBATCH --ntasks-per-node=128
57+
#SBATCH -A <account>
58+
#SBATCH --uenv=quantumespresso/v7.4:v2
59+
#SBATCH --view=default
60+
#SBATCH --hint=nomultithread
61+
62+
export OMP_NUM_THREADS=1
63+
64+
srun -u /user-environment/env/default/bin/pw.x < pw.in
65+
```
66+

0 commit comments

Comments
 (0)