Precompiler options

From VASP Wiki
Revision as of 17:06, 20 January 2022 by Ftran (talk | contribs) (→‎-DUSELIBXC)

Precompiler flags are used to activate/deactivate certain code features at the time of compilation, e.g., the use of MPI, the advanced molecular dynamics features, etc. Many precompiler flags are set by default in the templates provided for the makefile.include file. The commands are as follows:

CPP
The command to invoke the precompiler you want to use, for instance:
  • Using Intel's Fortran precompiler:
CPP=fpp -f_com=no -free -w0 $*$(FUFFIX) $*$(SUFFIX) $(CPP_OPTIONS)
  • Using cpp:
CPP=/usr/bin/cpp -P -C -traditional $*$(FUFFIX) >$*$(SUFFIX) $(CPP_OPTIONS)
Mind: This variable has to include $(CPP_OPTIONS). If not, CPP_OPTIONS will be ignored!
CPP_OPTIONS
Specify the precompiler flags:
CPP_OPTIONS=[-Dflag1 [-Dflag2] ... ]
Mind: CPP_OPTIONS is only used in makefile.include, where it is added to the CPP variable.

Default

-DHOST=[string]

A string (20 characters max.) that describes the platform on which VASP is compiled, e.g., -DHOST=\"LinuxIFC\" for a Linux host using an Intel Fortran compiler.

-DMPI

(Mandatory) Set this to compile the parallel version of VASP.

-Duse_collective

Set this to use MPI collectives in the all-to-all communication and global summations.
In case one specifies this, the value of MPI_BLOCK (below) will be meaningless.

-DMPI_BLOCK=[integer]

Specifies the block size used by the in-house MPI all-to-all communication and global summations.

-DscaLAPACK

Set this to use scaLAPACK.

-DCACHE_SIZE=[integer]

Specifies the size of the cache memory. Only used by the in-house real-to-complex FFT routines (fft3dlib.F).
By default these are no longer used, instead we use the real-to-complex FFT routines from fftw3.

-Davoidalloc

Set this to use automatic instead of allocatable arrays in many routines related to the real space projection operators.

-Dvasp6

Set this to activate all VASP.6.X.X specific features.

-Dtbdyn

Adds the advanced molecular dynamics routines.

-Dfock_dblbuf

Uses double buffer technique for the computation of exchange potential. Available as of VASP.6, N/A for the CUDA-C GPU-port.

-D_OPENMP

(Optional for hybrid MPI + OpenMP parallelization) Activate all OpenMP related code paths.

Specific for the OpenACC port to GPUs

-D_OPENACC

Mandatory: Activate all OpenACC related code paths.

-DUSENCCL

Mandatory: Use the NVIDIA Collective Communications Library (NCCL) instead of MPI for relevant instances of collective reduction operations (MPI_Allreduce).

-DUSENCCLP2P

Optional but strongly recommended (requires NCCL >= 2.7.8): Use the NVIDIA Collective Communications Library (NCCL) instead of MPI for relevant instances of all-to-all operations (MPI_Alltoallv).

-Dqd_emulate

Mandatory: To compile the OpenACC GPU-port you need either the NVIDIA HPC-SDK or a recent version (>= 19.10) of PGI's Compilers & Tools. Both of these compilers do not natively support quadruple precision and require the use of the QD library to emulate quadruple precision arithmetic.

Optional

-DVASP_HDF5

(Strongly recommended) Set this to add support for reading and writing HDF5 files. This option is available since VASP 6.2.0.

-Duse_shmem

Use MPI-3 shared memory segments to reduce memory demands. This can be really helpful to keep the memory demands of GW calculations at an acceptable level.

-Dshmem_bcast_buffer

-Dshmem_rproj

-Dsysv

-DVASP2WANNIER90

Set this to include the interface between VASP and Wannier90.
Deprecated: For VASP<6.2.0, see -DVASP2WANNIER90 and -DVASP2WANNIER90v2 in the deprecated section below!

-Dlibbeef

Set this to include the BEEF class of van-der-Waals functionals.
N.B.: one needs to add libbeef to makefile.include.

-DDFTD4

Set this to include the DFTD4 van-der-Waals functional.
Note that you need to install DFTD4 and add it to the makefile.include.

-DPROFILING

Switches on detailed profiling of the code. This carries a (slight) performance penalty.

-DUSELIBXC

Set this to include the library of exchange-correlation functionals Libxc.
Note that you need to install Libxc >= 5.2.0 (or the master version from gitlab for the latest implemented functionals) with the option --disable-fhc and add it to the makefile.include.

-DLAPACK36

Required for LAPACK-3.6.0 and newer to replaced deprecated routine DGEGV by DGGEV.

Deprecated

Deprecated: -DNGZhalf, -DwNGZhalf, -DNGXhalf, -DwNGXhalf are deprecated options. Building the standard, gamma-only, or non-collinear version of the code is specified through an additional argument to the make command as discussed in Installing VASP.6.X.X.

-DnoAugXCmeta

This option was added to compute the metaGGA contributions from the non-augmented pseudo density (instead of the augmented density). There is a condition concerning the behavior of the von-Weizsäcker kinetic energy density (second derivative of the charge density) and the kinetic energy density computed from the orbitals ingrained into TPSS and revTPSS. This condition can be strongly violated when one augments the charge density. For the TPSS and revTPSS the functionals can become unstable in those cases. SCAN and its derivates (RSCAN, R2SCAN, etc) do not assume the aforementioned conditions to be met and remain stable for the augmented density as well so this option should not be used as it may negatively affect the final results.

-DVASP2WANNIER90 and -DVASP2WANNIER90v2

Set this to include the interface between VASP and Wannier90.
Up to VASP 6.1.x you need to set -DVASP2WANNIER90 to interface with Wannier90 v.1.x, and -DVASP2WANNIER90v2 for Wannier90 v.2.x, and add the Wannier90 library to makefile.include.
Since VASP 6.2.0 you need to set -DVASP2WANNIER90 to interface with Wannier90 v.2.x or v.3.x.

Contents