ABINIT, Van der Waals input variables:

List and description.


This document lists and provides the description of the name (keywords) of the "Van der Waals" input variables to be used in the main input file of the abinit code.


Copyright (C) 1998-2017 ABINIT group (DCA,XG,RC,YG,FJ)

Content of the file : alphabetical list of "Van der Waals" variables.


A.
B.
C.
D.
E.
F.
G.
H.
I. irdvdw  
J.
K.
L.
M.
N.
O.
P. prtvdw  
Q.
R.
S.
T.
U.
V. vdw_df_acutmin   vdw_df_aratio   vdw_df_damax   vdw_df_damin   vdw_df_dcut   vdw_df_dratio   vdw_df_dsoft   vdw_df_gcut   vdw_df_ndpts   vdw_df_ngpts   vdw_df_nqpts   vdw_df_nrpts   vdw_df_nsmooth   vdw_df_phisoft   vdw_df_qcut   vdw_df_qratio   vdw_df_rcut   vdw_df_rsoft   vdw_df_threshold   vdw_df_tolerance   vdw_df_tweaks   vdw_df_zab   vdw_nfrag   vdw_supercell   vdw_tol   vdw_tol_3bt   vdw_typfrag   vdw_xc  



irdvdw
Mnemonics: Integer that governs the ReaDing of _VDW files
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: integer
Default is 0

Used when vdw_xc>0, to read previously calculated vdW-DF variables.
Supported values:



Go to the top | Complete list of input variables

prtvdw
Mnemonics: PRinT Van Der Waals file
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: printing.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: integer
Default is 0

Print out a NetCDF file containing a vdW-DF kernel.

Go to the top | Complete list of input variables



vdw_df_acutmin
Mnemonics: vdW-DF MINimum Angular CUT-off
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: real
Default is 10

Only relevant if vdw_xc>0

Used when vdw_xc>0, to build angular meshes for the vdW-DF kernel.


Go to the top | Complete list of input variables



vdw_df_aratio
Mnemonics: vdW-DF Angle RATIO between the highest and lowest angles.
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: real
Default is 30

Only relevant if vdw_xc>0

Used when vdw_xc>0, to build angular meshes for the vdW-DF kernel.


Go to the top | Complete list of input variables



vdw_df_damax
Mnemonics: vdW-DF Delta for Angles, MAXimum
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: real
Default is 0.5

Only relevant if vdw_xc>0

Used when vdw_xc>0, to build angular meshes for the vdW-DF kernel.


Go to the top | Complete list of input variables



vdw_df_damin
Mnemonics: vdW-DF Delta for Angles, MINimum
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: real
Default is 0.01

Only relevant if vdw_xc>0

Used when vdw_xc>0, to build angular meshes for the vdW-DF kernel.


Go to the top | Complete list of input variables



vdw_df_dcut
Mnemonics: vdW-DF D-mesh CUT-off
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: real
Default is 30

Only relevant if vdw_xc>0

Used when vdw_xc>0, to build the vdW-DF kernel.


Go to the top | Complete list of input variables



vdw_df_dratio
Mnemonics: vdW-DF, between the highest and lowest D, RATIO.
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: real
Default is 20

Only relevant if vdw_xc>0

Used when vdw_xc>0, to build the vdW-DF kernel.


Go to the top | Complete list of input variables



vdw_df_dsoft
Mnemonics: vdW-DF Distance for SOFTening.
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: real
Default is 1.0

Only relevant if vdw_xc>0

Used when vdw_xc>0, to build the vdW-DF kernel.


Go to the top | Complete list of input variables



vdw_df_gcut
Mnemonics: vdW-DF G-space CUT-off
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: real
Default is 5

Only relevant if vdw_xc>0

Used when vdw_xc>0, to filter the vdW-DF kernel in reciprocal space.


Go to the top | Complete list of input variables



vdw_df_ndpts
Mnemonics: vdW-DF Number of D-mesh PoinTS
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: integer
Default is 20

Only relevant if vdw_xc>0

Used when vdw_xc>0, to build the vdW-DF kernel.


Go to the top | Complete list of input variables



vdw_df_ngpts
Mnemonics: vdW-DF Number of G-mesh PoinTS
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: integer
Default is -1

Only relevant if vdw_xc>0

Used when vdw_xc>0, to build the vdW-DF kernel.


Go to the top | Complete list of input variables



vdw_df_nqpts
Mnemonics: vdW-DF Number of Q-mesh PoinTS
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: integer
Default is 30

Only relevant if vdw_xc>0

Used when vdw_xc>0, to build the vdW-DF kernel.


Go to the top | Complete list of input variables



vdw_df_nrpts
Mnemonics: vdW-DF Number of R-PoinTS
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: integer
Default is 2048

Only relevant if vdw_xc>0

Used when vdw_xc>0, to define the sampling of the vdW-DF-kernel in real-space.


Go to the top | Complete list of input variables



vdw_df_nsmooth
Mnemonics: vdW-DF Number of SMOOTHening iterations
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: integer
Default is 12

Only relevant if vdw_xc>0

Used when vdw_xc>0, to exponentially smoothen q near q0.


Go to the top | Complete list of input variables



vdw_df_phisoft
Mnemonics: vdW-DF PHI value SOFTening.
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: real
Default is -1.0

Only relevant if vdw_xc>0

Used when vdw_xc>0, to build the vdW-DF kernel.


Go to the top | Complete list of input variables



vdw_df_qcut
Mnemonics: vdW-DF Q-mesh CUT-off
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: real
Default is 5

Only relevant if vdw_xc>0

Used when vdw_xc>0, to build the vdW-DF kernel.


Go to the top | Complete list of input variables



vdw_df_qratio
Mnemonics: vdW-DF, between highest and lowest Q, RATIO .
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: real
Default is 20

Only relevant if vdw_xc>0

Used when vdw_xc>0, .


Go to the top | Complete list of input variables



vdw_df_rcut
Mnemonics: vdW-DF Real-space CUT-off
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: real
Default is 100

Only relevant if vdw_xc>0

Used when vdw_xc>0, to define the vdW-DF kernel cut-off radius.


Go to the top | Complete list of input variables



vdw_df_rsoft
Mnemonics: vdW-DF radius SOFTening.
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: real
Default is 0.0

Only relevant if vdw_xc>0

Used when vdw_xc>0, to build the vdW-DF kernel.


Go to the top | Complete list of input variables



vdw_df_threshold
Mnemonics: vdW-DF energy calculation THRESHOLD
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: real
Default is 0.01

Only relevant if vdw_xc>0

Sets a threshold for the energy gradient that, when reached, will cause the vdW-DF interactions to be calculated.
Adjust it to a big value (e.g. 1e12) to enable it all along the SCF calculation. Too small values, as well as negative values, will result in the vdW-DF energy contributions never being calculated.



Go to the top | Complete list of input variables

vdw_df_tolerance
Mnemonics: vdW-DF global TOLERANCE.
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: real
Default is 1e-13

Only relevant if vdw_xc>0

Used when vdw_xc>0, to build the vdW-DF kernel.


Go to the top | Complete list of input variables



vdw_df_tweaks
Mnemonics: vdW-DF TWEAKS.
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: integer
Default is 0

Only relevant if vdw_xc>0

Used when vdw_xc>0, to build the vdW-DF kernel.
IMPORTANT NOTE: modifying this variable will likely transform the calculated energies and their gradients into garbage. You have been warned!


Go to the top | Complete list of input variables



vdw_df_zab
Mnemonics: vdW-DF ZAB parameter
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {vdwxc:[03]}.
Variable type: real
Default is -0.8491

Only relevant if vdw_xc>0

Used when vdw_xc>0, as introduced in doi:10.1103/PhysRevLett.92.246401 .


Go to the top | Complete list of input variables



vdw_nfrag
Mnemonics: Van Der Waals Number of interacting FRAGments
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [3/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {wannier90:[11,12,13]}.
Variable type: integer
Default is 1

Only relevant if vdw_xc in [10,11]

The absolute value of vdw_nfrag is the number of vdW interacting fragments in the unit cell. As wannierization takes place in reciprocal space, the MLWF center positions could be translated by some lattice vector from the cell where atoms are placed. If vdw_nfrag >= 1 then MLWFs are translated to the original unit cell, otherwise the program will keep the positions obtained by Wannier90. The later is usually correct if some atoms are located at the corners or at limiting faces of the unit cell.



Go to the top | Complete list of input variables

vdw_supercell
Mnemonics: Van Der Waals correction from Wannier functions in SUPERCELL
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [3/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {wannier90:[11,12,13]}.
Variable type: integer(3)
Default is [0, 0, 0]

Only relevant if vdw_xc in [10,11]

Set of dimensionless positive numbers which define the maximum multiples of the primitive translations (rprimd) in the supercell construction. Each component of vdw_supercell indicates the maximum number of cells along both positive or negative directions of the corresponding primitive vector i.e. the components of rprimd. In the case of layered systems for which vdW interactions occur between layers made of tightly bound atoms, the evaluation of vdW corrections coming from MLWFs in the same layer (fragment) must be avoided. Both a negative or null value for one component of vdw_supercell will indicate that the corresponding direction is normal to the layers.



Go to the top | Complete list of input variables

vdw_tol
Mnemonics: Van Der Waals TOLerance
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [4/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {v7:[97,98,99],vdwxc:[10]}.
Variable type: real
Default is 1e-10

Only relevant if vdw_xc==5

The DFT-D methods (S. Grimme approach) dispersion potentials, vdw_xc==5 or 6 or 7, include a pair potential. The number of pairs of atoms contributing to the potential is necessarily limited. To be included in the potential a pair of atom must have contribution to the energy larger than vdw_tol.



Go to the top | Complete list of input variables

vdw_tol_3bt
Mnemonics: Van Der Waals TOLerance for 3-Body Term
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [1/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {v7:[97]}.
Variable type: real
Default is -1 (Comment: Do include the 3-body term in the correction)

Only relevant if vdw_xc == 6

Control the computation of the 3-body correction inside DFT-D3 dispersion correction (Grimme approach) to the total energy:
-If vdw_tol_3bt<0, no 3-body correction.
-If vdw_tol_3bt>0, the 3-body term is included with a tolerance = vdw_tol_3bt

DFT-D3 as proposed by S. Grimme adds two contributions to the total energy in order to take into account of the dispersion:

The last term has been predicted to have an important effect for large molecules (see for e.g. Grimme S., J. Chem. Phys. 132, 154104 (2010) ). It is however quite costly in computational time for periodic systems and seems to lead to an overestimation of lattice parameters for weakly bound systems (see for e.g. Reckien W., J. Chem. Phys. 132, 154104(2010) ). Still, its contribution to energy, to forces and to stress is available (not planned for elastic constants, dynamical matrix and internal strains)


Go to the top | Complete list of input variables

vdw_typfrag
Mnemonics: Van Der Waals TYPe of FRAGment
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [3/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {wannier90:[11,12,13]}.
Variable type: integer(natom)
Default is 1*natom

Only relevant if vdw_xc in [10,11]

This array defines the interacting fragments by assigning to each atom an integer index from 1 to vdw_nfrag . The ordering of vdw_typfrag is the same as typat or xcart. Internally each MLWF is assigned to a given fragment by computing the distance to the atoms. MLWFs belong to the same fragment as their nearest atom. The resulting set of MLWFs in each interacting fragment can be found in the output file in xyz format for easy visualization.



Go to the top | Complete list of input variables

vdw_xc
Mnemonics: Van Der Waals eXchange-Correlation functional
Executable: abinit
Characteristic: DEVELOP
Mentioned in topic: vdw.
Rarely used: [8/907] in abinit tests, [0/136] in tuto abinit tests. Test list: {v7:[97,98,99],vdwxc:[03,10],wannier90:[11,12,13]}.
Variable type: integer
Default is 0

Selects a van-der-Waals density functional to apply the corresponding correction to the exchange-correlation energy. If set to zero, no correction will be applied.
Possible values are:

For vdw_xc=1 and vdw_xc=2, the implementation follows the strategy devised in the article of Román-Pérez and Soler (doi:10.1103/PhysRevLett.103.096102)



Go to the top | Complete list of input variables