Jump to content

Requests for technical support from the VASP team should be posted in the VASP Forum.

LMODELHF: Difference between revisions

From VASP Wiki
Kresse (talk | contribs)
No edit summary
Ftran (talk | contribs)
No edit summary
 
(35 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{TAGDEF|LMODELHF|.TRUE. {{!}} .FALSE.|.FALSE.}}
{{TAGDEF|LMODELHF|.TRUE. {{!}} .FALSE.|.FALSE.}}


Description: {{TAG|LMODELHF}} selects a decomposition of the exchange functional  with full exchange in the short range, and {{TAG|AEXX}} in the long range.
Description: {{TAG|LMODELHF}} selects dielectric-dependent range-separated hybrid functionals with {{TAG|AEXX}} and {{TAG|BEXX}} for the exact Hartree-Fock exchange at long- and short-range, respectively.
----
----
{{TAG|LMODELHF}}=.TRUE. selects the range separated hybrid functional suggested in Ref.<ref name="chen2018nonempirical"/>
By setting {{TAG|LMODELHF}}=.TRUE. various types of range-separated hybrid functionals using the error function for the screening can be specified. The general form of hybrid functionals that can be constructed with {{TAG|LMODELHF}} is given by
and Ref. <ref name="cui2018doubly"/> under the name dielectric-dependent hybrid functionals (DDH) and  doubly screened hybrid (DSH), respectively. These two functionals are completely identical, but for the way the amount
of exact exchange is determined in the long range limit (short wave length limit).


The corresponding functional has been available in VASP since VASP.5.2 released in 2009 (so way before
:<math>E_{\mathrm{xc}}^{\mathrm{hybrid}}=a_{\mathrm{SR}} E_{\mathrm{x,SR}}^{\mathrm{HF}}(\mu) + a_{\mathrm{LR}} E_{\mathrm{x,LR}}^{\mathrm{HF}}(\mu) + (1-a_{\mathrm{SR}})E_{\mathrm{x,SR}}^{\mathrm{SL}}(\mu) + (1-a_{\mathrm{LR}})E_{\mathrm{x,LR}}^{\mathrm{SL}}(\mu) + E_{\mathrm{c}}^{\mathrm{SL}}</math>
the two publications), although the gradient contribution had been erroneously implemented in all
VASP.5 releases and is only correct in VASP.6.
The corresponding bug fix has been made available by the authors of Ref.  <ref name="cui2018doubly"/>.
The non-local exchange part of the functional has also been used and documented in Ref.  <ref name="bokdam:scr:6"/>, and
is covered in [[Improving the dielectric function]].


Typically the INCAR file will show the following tags for a calculation selecting dielectric-dependent hybrid functionals:
where
*<math>a_{\mathrm{SR}}</math> ({{TAG|BEXX}}) and <math>a_{\mathrm{LR}}</math> ({{TAG|AEXX}}) are the '''mixing parameters (fraction of HF exchange) at short and long range''', respectively.
*<math>\mu</math> ({{TAG|HFSCREEN}}) is the '''screening parameter''' that determines the separation between short range (SR) and long range (LR).
 
Examples of such functionals are those proposed in Refs. {{cite|skone:prb:2016}}{{cite|chen2018nonempirical}}{{cite|cui2018doubly}}. These hybrid functionals are based on a common model for the dielectric function, but differ in the way how the range-separation parameters are obtained from first-principles calculations. Their connection and performance have been discussed for instance in Ref. {{cite|liu2019assessing}}. In principle,
they can be considered to be a smartly constructed approximation to COH-SEX (local Coulomb hole plus screened exchange),
albeit fulfilling many important constraints that the exact exchange correlation functional must observe.
 
The corresponding functional has been available in VASP since VASP.5.2 released in 2009 (before the two publications), although the gradient contribution had been erroneously implemented in all VASP.5 releases and is only correct in VASP.6. The related bug fix has been made available by the authors of Ref. {{cite|cui2018doubly}}. The nonlocal exchange part of the functional has also been used and documented in Ref. {{cite|bokdam:scr:2016}} and is covered in [[Improving the dielectric function]].
 
An example of tags to specify in the [[INCAR]] file is given for the DD-RSH-CAM functional:{{cite|chen2018nonempirical}}{{cite|cui2018doubly}}


  {{TAGBL|LHFCALC}} = .TRUE.
  {{TAGBL|LHFCALC}} = .TRUE.
  {{TAGBL|LMODELHF}} = .TRUE.
  {{TAGBL|LMODELHF}} = .TRUE.
  {{TAGBL|HFSCREEN}} = 1.26
  {{TAGBL|AEXX}} = <math>\varepsilon_{\infty}^{-1}</math>
  {{TAGBL|AEXX}} = 0.1
  {{TAGBL|BEXX}} = 1.0   #The default value. Available since VASP.6.6.0.
{{TAGBL|HFSCREEN}} = <math>\mu</math>
{{TAGBL|GGA}} = PE


In this case, {{TAG|AEXX}} specifies the amount of exact exchange in the long range, that is for short
where <math>\varepsilon_{\infty}^{-1}</math> is the inverse dielectric constant and <math>\mu</math> is the screening parameter.
wave vectors (<math> \mathbf{G} \to 0 </math>). In the short range, that is for large wave vectors, always the full non-local exchange is used. The {{TAG|HFSCREEN}} determines how quickly the non-local exchange changes from
{{TAG|AEXX}} and {{TAG|BEXX}} specify the amount of exact exchange in the long and short range, respectively, that is for short (<math> \mathbf{G} \to 0 </math>) and large (<math> \mathbf{G} \to \infty </math>) wave vectors, respectively. The screening parameter {{TAG|HFSCREEN}} determines how quickly the nonlocal exchange changes from {{TAG|AEXX}} to {{TAG|BEXX}}.
{{TAG|AEXX}} to 1.  
 
Other examples of dielectric-dependent range-separated functionals proposed in the literature{{cite|skone:prb:2016}}{{cite|chen2018nonempirical}}{{cite|cui2018doubly}} can be found [[Hybrid_functionals:_formalism#HF_exchange_at_short_range_and_long_range_%28error-function_screening%29_with_different_mixings|here]] and their corresponding INCAR files at [[list_of_hybrid_functionals|list of hybrid functionals]].
{{NB|mind|
*If {{TAG|LMODELHF}}{{=}}.TRUE., then {{TAG|LHFCALC}}{{=}}.TRUE. is automatically set.
*The {{TAG|BEXX}} tag is available only since VASP.6.6.0. {{TAG|BEXX}} was hard-coded to 1 in versions prior to VASP.6.6.0.
}}


Specifically, in VASP, the  Coulomb kernel <math> 4 \pi e^2 / (\mathbf{q}+\mathbf{G})^2</math> in the exact exchange is multiplied by a model for the dielectric function <math> \epsilon^{-1} (\mathbf{q}+\mathbf{G})</math>:
Specifically, in VASP, the  Coulomb kernel <math> 4 \pi e^2 / (\mathbf{q}+\mathbf{G})^2</math> in the exact exchange is multiplied by a model for the dielectric function <math> \epsilon^{-1} (\mathbf{q}+\mathbf{G})</math>:


:<math> \epsilon^{-1} (\mathbf{q}+\mathbf{G})=1-(1-{{\varepsilon}_{\infty}^{-1}})\text{exp}(-\frac{|\mathbf{q+G}|^2}{4{\mu}^2})</math>.
:<math> \epsilon^{-1} (\mathbf{q}+\mathbf{G})=1-(1-{{\varepsilon}_{\infty}^{-1}})\text{exp}\left(-\frac{|\mathbf{q+G}|^2}{4{\mu}^2}\right)</math>.


where <math> \mu  </math> corresponds to {{TAG|HFSCREEN}}, and  <math> {{\varepsilon}_{\infty}^{-1}} </math> is specified by {{TAG|AEXX}}. In real space this correspond to a Coulomb kernel  
where <math> \mu  </math> corresponds to {{TAG|HFSCREEN}}, and  <math> {{\varepsilon}_{\infty}^{-1}} </math> is specified by {{TAG|AEXX}}. In real space this correspond to a Coulomb kernel  
:<math> V(r) =\left[1-\left(1-{{\varepsilon}_{\infty}^{-1}}\right)\text{erf}( {\mu} r)\right] \frac{e^2}{r} </math>.




:<math> V(r) =(1-(1-{{\varepsilon}_{\infty}^{-1}})\text{erf}( {\mu} r)) \frac{e^2}{r} </math>.
The remaining part of the exchange is handled by an appropriate semi-local exchange correlation functional. For further detail we refer to the literature listed below.
 
 
The remaining part of the exchange is handled by an appropriate  
semi-local exchange correlation functional. For further detail we refer to the literature listed below.


Typical values for {{TAG|HFSCREEN}} are listed in the table below
AlP  1.24
AlAs 1.18
AlSb 1.13
BN  1.7
CdO  1.34
CdS  1.19
CdSe 1.18
CdTe 1.07
C    1.70
GaN  1.39
GaP  1.24
GaAs 1.18
GaSb 1.12
Ge  1.18
InP  1.14
InAs 1.09
InSb 1.05
LiF  1.47
MgO  1.39
SiC  1.47
Si  1.26
ZnO  1.34
ZnS  1.27
ZnSe 1.20
ZnTe 1.12
These values have been obtained from fits of the dielectric function using the Nanoquanta kernel and partially self-consistent GW calculations as used in Ref. {{cite|grueneis2014ionization}}. The values can be also estimated from simple dimensional scaling relations of the valence electron density. Furthermore band gap predictions are not very sensitive to the choice of {{TAG|HFSCREEN}}.


== Related Tags and Sections ==
== Related tags and articles ==
{{TAG|LHFCALC}},
{{TAG|LHFCALC}},
{{TAG|HFSCREEN}},
{{TAG|HFSCREEN}},
{{TAG|AEXX}},
{{TAG|AEXX}},
[[Hartree-Fock_and_HF/DFT_hybrid_functionals|hybrid functionals]],
{{TAG|BEXX}},
[[Hartree-Fock_and_HF/DFT_hybrid_functionals#Thomas_Fermi|Thomas-Fermi screening]],
{{TAG|LTHOMAS}},
[[specific_hybrid_functionals|settings for specific hybrid functionals]]
{{TAG|LRHFCALC}},
[[list_of_hybrid_functionals|List of hybrid functionals]],
[[Hybrid_functionals:_formalism|Hybrid functionals: formalism]],


== References ==
<references/>


[[Category:INCAR]][[Category:XC Functionals]][[Category:Hybrids]]


== References ==
[[Category:INCAR tag]][[Category:Exchange-correlation functionals]][[Category:Hybrid_functionals]]
<references>
<ref name="chen2018nonempirical">[https://doi.org/10.1103/PhysRevMaterials.2.073803 W. Chen, G. Miceli, G.M. Rignanese, A. Pasquarello Physical Review Materials 2, 073803 (2018). ]</ref>
<ref name="cui2018doubly">[https://doi.org/10.1021/acs.jpclett.8b00919 Z.H. Cui, Y.C. Wang, M.Y. Zhang, X. Xu, H. Jiang,  J. Phys. Chem. Lett., 9, 2338-2345  (2018). ]</ref>
<ref name="bokdam:scr:6">[https://www.nature.com/articles/srep28618 M. Bokdam, T. Sander, A. Stroppa, S. Picozzi, D. D. Sarma, C. Franchini, G. Kresse, Scientific Reports 6, 28618 (2016). ]</ref>
</references>
 
----

Latest revision as of 11:18, 2 March 2026

LMODELHF = .TRUE. | .FALSE.
Default: LMODELHF = .FALSE. 

Description: LMODELHF selects dielectric-dependent range-separated hybrid functionals with AEXX and BEXX for the exact Hartree-Fock exchange at long- and short-range, respectively.


By setting LMODELHF=.TRUE. various types of range-separated hybrid functionals using the error function for the screening can be specified. The general form of hybrid functionals that can be constructed with LMODELHF is given by

[math]\displaystyle{ E_{\mathrm{xc}}^{\mathrm{hybrid}}=a_{\mathrm{SR}} E_{\mathrm{x,SR}}^{\mathrm{HF}}(\mu) + a_{\mathrm{LR}} E_{\mathrm{x,LR}}^{\mathrm{HF}}(\mu) + (1-a_{\mathrm{SR}})E_{\mathrm{x,SR}}^{\mathrm{SL}}(\mu) + (1-a_{\mathrm{LR}})E_{\mathrm{x,LR}}^{\mathrm{SL}}(\mu) + E_{\mathrm{c}}^{\mathrm{SL}} }[/math]

where

  • [math]\displaystyle{ a_{\mathrm{SR}} }[/math] (BEXX) and [math]\displaystyle{ a_{\mathrm{LR}} }[/math] (AEXX) are the mixing parameters (fraction of HF exchange) at short and long range, respectively.
  • [math]\displaystyle{ \mu }[/math] (HFSCREEN) is the screening parameter that determines the separation between short range (SR) and long range (LR).

Examples of such functionals are those proposed in Refs. [1][2][3]. These hybrid functionals are based on a common model for the dielectric function, but differ in the way how the range-separation parameters are obtained from first-principles calculations. Their connection and performance have been discussed for instance in Ref. [4]. In principle, they can be considered to be a smartly constructed approximation to COH-SEX (local Coulomb hole plus screened exchange), albeit fulfilling many important constraints that the exact exchange correlation functional must observe.

The corresponding functional has been available in VASP since VASP.5.2 released in 2009 (before the two publications), although the gradient contribution had been erroneously implemented in all VASP.5 releases and is only correct in VASP.6. The related bug fix has been made available by the authors of Ref. [3]. The nonlocal exchange part of the functional has also been used and documented in Ref. [5] and is covered in Improving the dielectric function.

An example of tags to specify in the INCAR file is given for the DD-RSH-CAM functional:[2][3]

LHFCALC = .TRUE.
LMODELHF = .TRUE.
AEXX = [math]\displaystyle{ \varepsilon_{\infty}^{-1} }[/math]
BEXX = 1.0   #The default value. Available since VASP.6.6.0.
HFSCREEN = [math]\displaystyle{ \mu }[/math]
GGA = PE

where [math]\displaystyle{ \varepsilon_{\infty}^{-1} }[/math] is the inverse dielectric constant and [math]\displaystyle{ \mu }[/math] is the screening parameter. AEXX and BEXX specify the amount of exact exchange in the long and short range, respectively, that is for short ([math]\displaystyle{ \mathbf{G} \to 0 }[/math]) and large ([math]\displaystyle{ \mathbf{G} \to \infty }[/math]) wave vectors, respectively. The screening parameter HFSCREEN determines how quickly the nonlocal exchange changes from AEXX to BEXX.

Other examples of dielectric-dependent range-separated functionals proposed in the literature[1][2][3] can be found here and their corresponding INCAR files at list of hybrid functionals.

Specifically, in VASP, the Coulomb kernel [math]\displaystyle{ 4 \pi e^2 / (\mathbf{q}+\mathbf{G})^2 }[/math] in the exact exchange is multiplied by a model for the dielectric function [math]\displaystyle{ \epsilon^{-1} (\mathbf{q}+\mathbf{G}) }[/math]:

[math]\displaystyle{ \epsilon^{-1} (\mathbf{q}+\mathbf{G})=1-(1-{{\varepsilon}_{\infty}^{-1}})\text{exp}\left(-\frac{|\mathbf{q+G}|^2}{4{\mu}^2}\right) }[/math].

where [math]\displaystyle{ \mu }[/math] corresponds to HFSCREEN, and [math]\displaystyle{ {{\varepsilon}_{\infty}^{-1}} }[/math] is specified by AEXX. In real space this correspond to a Coulomb kernel

[math]\displaystyle{ V(r) =\left[1-\left(1-{{\varepsilon}_{\infty}^{-1}}\right)\text{erf}( {\mu} r)\right] \frac{e^2}{r} }[/math].


The remaining part of the exchange is handled by an appropriate semi-local exchange correlation functional. For further detail we refer to the literature listed below.

Typical values for HFSCREEN are listed in the table below

AlP  1.24
AlAs 1.18
AlSb 1.13
BN   1.7
CdO  1.34
CdS  1.19
CdSe 1.18
CdTe 1.07
C    1.70
GaN  1.39
GaP  1.24
GaAs 1.18
GaSb 1.12
Ge   1.18
InP  1.14
InAs 1.09
InSb 1.05
LiF  1.47
MgO  1.39
SiC  1.47
Si   1.26
ZnO  1.34
ZnS  1.27
ZnSe 1.20
ZnTe 1.12

These values have been obtained from fits of the dielectric function using the Nanoquanta kernel and partially self-consistent GW calculations as used in Ref. [6]. The values can be also estimated from simple dimensional scaling relations of the valence electron density. Furthermore band gap predictions are not very sensitive to the choice of HFSCREEN.

Related tags and articles

LHFCALC, HFSCREEN, AEXX, BEXX, LTHOMAS, LRHFCALC, List of hybrid functionals, Hybrid functionals: formalism,

References