VASP
Description
The Vienna Ab initio Simulation Package (VASP) is a first-principles code for electronic structure calculations and molecular dynamics simulations in materials science and engineering. It is based on plane wave basis sets combined with the projector-augmented wave method or pseudopotentials. VASP is maintained by the Computational Materials Physics Group at the University of Vienna.
More information is available on the VASP website and from the VASP wiki.
Usage Conditions
Access to VASP executables is restricted to users who satisfy the following criteria:
- The user must be a member of a research group owning a VASP license.
- The user must employ VASP only for work on projects of this research group.
- The user must be registered in Vienna as a VASP user of this research group. This is done via the VASP Portal where new users register using their institutional e-mail address.
Only members of the groups vasp5_2 or vasp6 have access to VASP executables. To have their user ID included in these groups, users can ask their consultant or submit a support request. It is recommended that users make sure that they already got registered in Vienna beforehand, as this will be verified. Users whose research group did not upgrade its VASP license to version 6.x cannot become member of the vasp6 group.
Modules
VASP is an MPI-parallel application. We recommend to use mpirun as the job starter for VASP. The environment module providing the mpirun command associated with a particular VASP installation needs to be loaded ahead of the environment module for VASP.
VASP Version | User Group | VASP Modulefile | Compute Partitions | MPI Requirement | CPU/GPU | Lise/Emmy | Supported Features |
---|---|---|---|---|---|---|---|
vasp/5.4.4.p1 | impi/2019.5 | ||||||
vasp/6.4.1 | impi/2021.7.1 | ||||||
vasp/6.4.2 | impi/2021.7.1 | ||||||
6.4.3 | vasp6 | vasp/6.4.3 | Rocky Linux 9 | impi/2021.13 | / | / | OpenMP, HDF5, Wannier90, Libxc, DFTD4 van-der-Waals functional, libbeef |
6.4.1 | vasp6 | vasp/6.4.1 | GPU A100 | nvhpc-hpcx/23.1 | / | / | OpenMP, HDF5, Wannier90 |
Executables
Our installations of VASP comprise the regular executables (vasp_std
, vasp_gam
, vasp_ncl
) and, optionally, community driven modifications to VASP as shown in the table below. They are available in the directory added to the PATH
environment variable by one of the vasp
environment modules.
Executable | Description |
---|---|
vasp_std | multiple k-points (formerly vasp_cd ) |
vasp_gam | Gamma-point only (formerly vasp_gamma_cd ) |
vasp_ncl | non-collinear calculations, spin-orbit coupling (formerly vasp ) |
vaspsol_[std|gam|ncl] | set of VASPsol-enabled executables (only for v. 5.4.4) |
vasptst_[std|gam|ncl] | set of VTST-enabled executables (only for v. 5.4.4) |
vasptstsol_[std|gam|ncl] | set of executables combining these modifications (only for v. 5.4.4) |
N.B.: The VTST script collection is not available from the vasp
environment modules. Instead, it is provided by the vtstscripts
environment module(s).
Example Jobscripts
The following example shows a job script that will run on the Nvidia A100 GPU nodes (Berlin). Per default, VASP will use one GPU per MPI task. If you plan to use 4 GPUs per node, you need to set 4 MPI tasks per node. Then, set the number of OpenMP threads to 18 (because 4x18=72 which is the number of CPU cores on GPU A100 partition) to speed up your calculation. This, however, also requires proper process pinning.
#!/bin/bash #SBATCH --time=12:00:00 #SBATCH --nodes=2 #SBATCH --tasks-per-node=4 #SBATCH --cpus-per-task=18 #SBATCH --partition=gpu-a100 # Set the number of OpenMP threads as given by the SLURM parameter "cpus-per-task" export OMP_NUM_THREADS=${SLURM_CPUS_PER_TASK} # Binding OpenMP threads export OMP_PLACES=cores export OMP_PROC_BIND=close # Avoid hcoll as MPI collective algorithm export OMPI_MCA_coll="^hcoll" # You may need to adjust this limit, depending on the case export OMP_STACKSIZE=512m module load nvhpc-hpcx/23.1 module load vasp/6.4.1 # Carefully adjust ppr:2, if you don't use 4 MPI processes per node mpirun --bind-to core --map-by ppr:2:socket:PE=${SLURM_CPUS_PER_TASK} vasp_std
The following job script exemplifies how to run vasp 6.4.3 making use of OpenMP threads. Here, we have 2 OpenMP threads and 48 MPI tasks per node (the product of these 2 numbers should ideally be equal to the number of CPU cores per node).
In many cases, running VASP with parallelization over MPI alone already yields good performance. However, certain application cases can benefit from hybrid parallelization over MPI and OpenMP. A detailed discussion is found here. If you opt for hybrid parallelization, please pay attention to process pinning, as shown in the example below.
#!/bin/bash #SBATCH --time=12:00:00 #SBATCH --nodes=2 #SBATCH --tasks-per-node=48 #SBATCH --cpus-per-task=2 #SBATCH --partition=cpu-clx export SLURM_CPU_BIND=none # Set the number of OpenMP threads as given by the SLURM parameter "cpus-per-task" export OMP_NUM_THREADS=$SLURM_CPUS_PER_TASK # Adjust the maximum stack size of OpenMP threads export OMP_STACKSIZE=512m # Binding OpenMP threads export OMP_PLACES=cores export OMP_PROC_BIND=close # Binding MPI tasks export I_MPI_PIN=yes export I_MPI_PIN_DOMAIN=omp export I_MPI_PIN_CELL=core module load impi/2021.13 module load vasp/6.4.3 # This is to avoid the (harmless) warning message "MPI strtup(): warning I_MPI_PMI_LIBRARY will be ignored since the hydra process manager was found" unset I_MPI_PMI_LIBRARY # Our tests have shown that vasp has better performance with psm2 as libfabric provider # Check if this also apply to your system # To stick to the default provider, comment out the following line export FI_PROVIDER=psm2 mpirun vasp_std
Here is the same example, but for the compute nodes with CentOS7
#!/bin/bash #SBATCH --time=12:00:00 #SBATCH --nodes=2 #SBATCH --tasks-per-node=48 #SBATCH --cpus-per-task=2 #SBATCH --partition=standard96 export SLURM_CPU_BIND=none # Set the number of OpenMP threads as given by the SLURM parameter "cpus-per-task" export OMP_NUM_THREADS=$SLURM_CPUS_PER_TASK # Adjust the maximum stack size of OpenMP threads export OMP_STACKSIZE=512m # Binding OpenMP threads export OMP_PLACES=cores export OMP_PROC_BIND=close # Binding MPI tasks export I_MPI_PIN=yes export I_MPI_PIN_DOMAIN=omp export I_MPI_PIN_CELL=core module load impi/2021.7.1 module load vasp/6.4.1 Â mpirun vasp_std
The last example demonstrates how to run a job with vasp 5.4.4.p1 on nodes withe CentOS7
#!/bin/bash #SBATCH --time 12:00:00 #SBATCH --nodes 2 #SBATCH --tasks-per-node 96 export SLURM_CPU_BIND=none module load impi/2019.5 module load vasp/5.4.4.p1 mpirun vasp_std