Page Comparison

Description

Quantum ESPRESSO is an integrated suite of computer codes for electronic-structure calculations and materials modeling at the nanoscale. It is based on density-functional theory, plane waves, and pseudopotentials (both norm-conserving and ultrasoft).

More information

- Homepage: https://www.quantum-espresso.org

Available Versions of QuantumESPRESSO

This table is generated automatically. If you need other versions please contact click pc2-support@uni-paderborn.de.

...

If you need support in using this software or example job scipts please contact pc2-support@uni-paderborn.de.

Build Instructions for Customized QuantumESPRESSO

If the above versions of QuantumESPRESSO built with EasyBuild cannot fulfill your requirement. A customized version of QuantumESPRESSO can be built on Noctua by the following steps.

1. Navigate to the directory, where you want to build QuantumESPRESSO, e.g. $PC2PFS/YOUR_PROJECT/QE. Please replace YOUR_PROJECT with the name of your project.
2. Load the modules for building the customized version of QuantumESPRESSO. In the example below Intel toolchain (compilers, MPI and math libraries etc) and CMake are used. In addition the libxc library is enabled as addon in this build.
3. Download your required version (or your customized version) of QuantumESPRESSO. In this example we use QuantumESPRESSO 7.0 (the latest version when writing this tutorial).
4. Configure the build of QuantumESPRESSO and install it in your required directory, e.g. $PC2PFS/YOUR_PROJECT/QE, where YOUR_PROJECT is the name of your project.

...

SLURM Jobscript for Using the QuantumESPRESSO Module Built with EasyBuild

The following is an example SLURM jobscript for using the QuantumESPRESSO module built by EasyBuild (see the table above). The AUSURF112 benchmark is used for demonstration.

Please note: on Noctua 2 one compute node has 128 CPU cores, while one compute node for Noctua 1 has 40 CPU cores. The example Slurm jobscript below targets a single compute node for Noctua 2. If you use Noctua 1, please adapt the options for --ntasks-per-node and --cpus-per-task for 40 CPU cores in a single compute node.

#!/usr/bin/env bash
#SBATCH --job-name=buildqe_QEausurf112
#SBATCH --nodes=1
#SBATCH --ntasks=128-per-node=16
#SBATCH --cpus-per-task=8
#SBATCH --time=0100:0010:00
#SBATCH --exclusivepartition=normal
#
# parallelization 1.for goa tosingle thenode directory,of whereNoctua you2
want#
to# build| QE, e.g. $PC2PFS/YOUR_PROJECT/QE
#
cd $PC2PFS/YOUR_PROJECT/QE
#
# 2. load the modules for building QE
#  - Intel toolchain (compilers, MPI and math libraries etc)
#  - CMake (cmake)
#  - libxc (addon to QE)
#
module reset
module load toolchain/intel/2021a
module load devel/CMake/3.20.1-GCCcore-10.3.0
module load chem/libxc/5.1.5-intel-compilers-2021.2.0
#
# 3. download QE 7.0
#
wget https://gitlab.com/QEF/q-e/-/archive/qe-7.0/q-e-qe-7.0.tar.bz2
tar xf q-e-qe-7.0.tar.bz2
cd     q-e-qe-7.0
#
# 4. configure the QE build and install it in, e.g. $PC2PFS/YOUR_PROJECT/QE/QE_root
#
mkdir build
cd    build
cmake -DCMAKE_C_COMPILER=mpiicc         \
      -DCMAKE_Fortran_COMPILER=mpiifort \
      -DQE_ENABLE_OPENMP=ON             \
      -DQE_ENABLE_LIBXC=ON              \
      -DCMAKE_INSTALL_PREFIX=$PC2PFS/YOUR_PROJECT/QE/QE_root ..
make -j 128 installparallelization                  | value    |
# |----------------------------------|----------|
# | number of allocated node         | 1        |
# | number of MPI ranks per node     | 16       |
# | number of CPU cores per MPI rank | 8        |
#
# thus total number of CPU cores used is 1 x 16 x 8 = 128
#
# load your required QuantumESPRESSO module
# 
module reset
module load chem/QuantumESPRESSO/7.3-foss-2023a
#
# download the input files of AUSURF112
#
wget https://raw.githubusercontent.com/QEF/benchmarks/master/AUSURF112/ausurf.in
wget https://raw.githubusercontent.com/QEF/benchmarks/master/AUSURF112/Au.pbe-nd-van.UPF
#
# run the AUSURF112 benchmark
#
export OMP_NUM_THREADS=${SLURM_CPUS_PER_TASK}
srun pw.x -ni 1 -nk 2 -nt 1 -nd 1 -input ausurf.in > benchmark.out 2> benchmark.err

Please note that this example might not guarantee the best computation performance, because the computation performance of QuantumESPRESSO depends on many factors, e.g. the version of QuantumESPRESSO, the compilers, the MPI library and involved math libraries, as well as the configuration for parallelization.

Further Information

• official documentation of QuantumESPRESSO
• CMake build system for QuantumESPRESSO
• QuantumESPRESSO Benchmark in GitHub