VASP

From CC Doc
Jump to navigation Jump to search
This site replaces the former Compute Canada documentation site, and is now being managed by the Digital Research Alliance of Canada.

Ce site remplace l'ancien site de documentation de Calcul Canada et est maintenant géré par l'Alliance de recherche numérique du Canada.

Other languages:
The Vienna ab initio Simulation Package (VASP) is a computer program for atomic scale materials modelling, e.g. electronic structure calculations and quantum mechanical molecular dynamics, from first principles.
Reference: VASP website

Licensing

VASP is a commercial software which can only be licensed to groups that are hired by a single legal entity, which is incompatible with the way the Compute Canada Federation operates. We have tried to negotiate an agreement with the licensor which would let us install the software on our infrastructure, but without success. For that reason, VASP is not available on our infrastructure, and users must install the software themselves. Please read the terms of your own license, as you are likely subject to the same restriction. This limits the support we are allowed to offer to users who need help installing the software. Please see below for instructions on installing the software.

Site exceptions

Simon Fraser University and the University of Waterloo own Cedar and Graham, and have a license with VASP. Some of their employees are therefore allowed to access and install specific versions of VASP on those clusters and provide limited support.

If you wish to use the prebuilt VASP binaries on Cedar and/or Graham, you must contact Technical support requesting access to VASP with the following information:

  • Include license holder (your PI) information:
    • Name
    • Email address
    • Department and institution (university)
  • Include license information:
    • Version of the VASP license (VASP version 4 or version 5)
    • License number
    • Provide an updated list of who is allowed to use your VASP license. For example, forward to us the most recent email from the VASP license administrator that contains the list of licensed users.

If you are licensed for version 5 you may also use version 4, but a version 4 license does not permit you to use version 5. The same for version 6, if you are licensed for version 6 you may also use version 5 and 4.

Using prebuilt VASP

Prebuilt VASP binary files have been installed only on Cedar and Graham. According to our license agreement we are not allowed to install VASP centrally on other computer clusters. However, users may want to install VASP on their own home directory. Please have a look at Building VASP yourself. To load prebuilt VASP please do the following:

  1. Run module spider vasp to see which versions are available.
  2. Choose your version and run module spider vasp/<version> to see which dependencies you need to load for this particular version.
  3. Load the dependencies and the VASP module, for example:
module load intel/2020.1.217  intelmpi/2019.7.217 vasp/5.4.4

See Using modules for more information.

Pseudopotential files

All pseudopotentials have been downloaded from the official VASP website and untarred. They are all located in $EBROOTVASP/pseudopotentials/ on Cedar and Graham and can be accessed once the VASP module is loaded.

Executable programs

For VASP-4.6, executable files are:

  • vasp for standard NVT calculations with non gamma k points
  • vasp-gamma for standard NVT calculations with only gamma points
  • makeparam to estimate how much memory is required to run VASP for a particular cluster

For VASP-5.4.1, 5.4.4 and 6.1.0 (without CUDA support), executable files are:

  • vasp_std for standard NVT calculations with non gamma k points
  • vasp_gam for standard NVT calculations with only gamma points
  • vasp_ncl for NPT calculations with non gamma k points

For VASP-5.4.4 and 6.1.0 (with CUDA support), executable files are:

  • vasp_gpu for standard NVT calculations with gamma and non gamma k points
  • vasp_gpu_ncl for NPT calculations with gamma and non gamma k points

Two extensions have also been incorporated:

If you need a version of VASP that does not appear here, you can either build it yourself (see below) or write to us and ask that it be built and installed.

Vasp-GPU

Fig.1 Simulation time as a function of the number of CPUs for GPU=0, 1, and 2

Vasp-GPU executable files run on both GPUs and CPUs of a node. Basically, calculation on a GPU is much more expensive than on a CPU, therefore we highly recommend to perform a benchmark using one or 2 GPUs to make sure they are getting a maximum performance from the GPU use. Fig.1 shows a benchmark of Si crystal which contains 256 Si-atoms in the simulation box. Blue, black and red lines show simulation time as a function of Number of CPU for GPU=0, 1, and 2 respectively. It shows the performance for GPU=1,2 and CPU=1 is more than 5 times better compared to GPU=0 and CPU=1. However, a comparison of calculations with GPU=1 and GPU=2 indicates that there is not much performance gain from GPU=1 to GPU=2. In fact, use for GPU=2 is around 50% in our monitoring system. Therefore we recommend users to first perform a benchmark like this for their own system to make sure they are not wasting any computer resources.

Example of a VASP job script

The following is a job script to run VASP in parallel using the Slurm job scheduler:


File : vasp_job.sh

#!/bin/bash
#SBATCH --account=<ACCOUNT>
#SBATCH --ntasks=4             # number of MPI processes
#SBATCH --mem-per-cpu=1024M    # memory
#SBATCH --time=0-00:05         # time (DD-HH:MM)
module load intel/2020.1.217  intelmpi/2019.7.217 vasp/<VERSION>
srun <VASP>


  • The above job script requests four CPU cores and 4096MB memory (4x1024MB).
  • <ACCOUNT> is a Slurm account name; see Accounts and projects to know what to enter there.
  • <VERSION> is the number for the VASP version you want to use: 4.6, 5.4.1, 5.4.4 or 6.1.0.
  • Use module spider vasp/<VERSION> to see how you can change this particular version.
  • <VASP> is the name of the executable. Refer to section Executable programs above for the executables you can select for each version.


File : vasp_gpu_job.sh

#!/bin/bash
#SBATCH --account=<ACCOUNT>
#SBATCH --cpus-per-task=1      # number of CPU processes
#SBATCH --gres=gpu:p100:1      # Number of GPU type:p100 (valid type only for cedar)
#SBATCH --mem=3GB              # memory
#SBATCH --time=0-00:05         # time (DD-HH:MM)
module load intel/2020.1.217  cuda/11.0  openmpi/4.0.3 vasp/<VERSION>
srun <VASP>


  • The above job script requests one CPU core and 1024MB memory.
  • The above job script requests one GPU type p100 which is only available on Cedar. For other clusters, please see the GPU types available.
  • The above job uses srun to run VASP.

VASP uses four input files named as INCAR, KPOINTS, POSCAR, POTCAR. It is best to prepare VASP input files in a separate directory for each job. To submit the job from that directory, use:

sbatch vasp_job.sh

If you do not know how much memory you need for your job, prepare all your input files and then run makeparam in an interactive job submission. Then use the result as required memory for the next run. However, for a more accurate estimate for future jobs, check the maximum stack size used by completed jobs and use this as the memory requirement per processor for the next job.

If you want to use 32 or more cores, please read about whole-node scheduling.

Building VASP yourself

If you are licensed to use VASP and have access to VASP source code, you can install VASP-5.4.4, 6.1.2, 6.2.1 and 6.3.0 in your /home directory on all our clusters (except Niagara) using one of the following EasyBuild commands. The VASP build will be the same as the ones on Cedar and Graham, and will include the Transition State Tools and VASPsol extensions.

eb -f VASP-5.4.4-iimpi-2020a.eb --sourcepath=SOURCEPATH

eb -f VASP-6.1.2-iimpi-2020a.eb --sourcepath=SOURCEPATH

eb -f VASP-6.2.1-iimpi-2020a.eb --sourcepath=SOURCEPATH

eb -f VASP-6.3.0-iimpi-2020a.eb --sourcepath=SOURCEPATH

where SOURCEPATH is the path to the VASP source file. The source files for vasp-5.4.4, 6.1.2, 6.2.1, and 6.3.0 are vasp.5.4.4.pl2.tgz , vasp.6.1.2_patched.tgz , vasp.6.2.1.tgz and vasp.6.3.0.tgz respectively. You may download the source code from the VASP website. Running the command will take some time, perhaps more than an hour. Once it is done you will be able to load and run VASP using module commands just as explained above in Using prebuilt VASP.

Alternatively to build a custom version of VASP, please see Installing software in your home directory and Installing VASP 5 or Installing VASP 6.