LIBXC1 Pn: Difference between revisions

Latest revision as of 14:12, 18 February 2023

Description: LIBXC1_Pn, where $n=1, 2, \ldots$ allows to specify the values of the parameters of the functional implemented in Libxc that is called with LIBXC1.

For many of the functionals implemented in the library of exchange-correlation functionals Libxc^[1]^[2]^[3] it is possible to modify the parameters if one does not want to use the default values. If a functional from Libxc has parameters that can be modified, then they are listed in OUTCAR below "Parameters of Libxc functionals:" as P $n$ ( $n=1, 2, \ldots$ ). LIBXC1_Pn and LIBXC2_Pn are for the functionals called with LIBXC1 and LIBXC2, respectively.

An example is given below for the GGA PBE functional^[4] where the default parameters $\mu=0.21951$ in exchange and $\beta=0.066725$ in correlation are changed to $\mu=10/81\approx0.12345679$ and $\beta=0.046$ to get the PBEsol functional^[5] (of course, the simpler way to use PBEsol from Libxc would be to call it directly with LIBXC1=GGA_X_PBE_SOL and LIBXC2=GGA_C_PBE_SOL).

GGA = LIBXC
LIBXC1 = GGA_X_PBE # or 101
LIBXC2 = GGA_C_PBE # or 130
LIBXC1_P2 = 0.12345679
LIBXC2_P1 = 0.046

Mind: The ALDAX, ALDAC, AGGAX, AGGAC, AMGGAX, and AMGGAC tags are ignored if the Libxc functional is an exchange-correlation functional (those with a tag that contains XC)

For Libxc functionals that are the semilocal component of a hybrid functional, i.e. those with a tag that starts with HYB (LHFCALC=.TRUE. will be set automatically if such a functional is selected), the following explains how it works for the mixing and screening parameters:

Mixing parameter:
- It is usually one of the parameters LIBXC1_Pn, and can therefore be modified.
- For HYB_GGA_XC_PBEH, HYB_GGA_XC_B1WC, HYB_GGA_XC_HSE03, HYB_GGA_XC_HSE06, HYB_GGA_XC_HSE12, and HYB_GGA_XC_HSE12S, the value of AEXX (even if not specified explicitly in INCAR) will be used and automatically passed to the corresponding parameter in Libxc. On the other hand, if this corresponding parameter (LIBXC1_Pn) is specified in INCAR, then it will be used (instead of AEXX), however note that it will be only for the semilocal component of the hybrid functional and not for the exact exchange that will still use AEXX.
- For all hybrid functionals except those listed just above, AEXX will not be considered for the semilocal component of the hybrid functional, but only for the exact exchange component. Therefore, a particular choice for the mixing parameter has to be done by specifying both AEXX (for the exact exchange) and the appropriate LIBXC1_Pn (for the semilocal component).
- The ALDAX, ALDAC, AGGAX, AGGAC, AMGGAX, and AMGGAC tags are ignored if the Libxc functional is an hybrid functional (those with a tag that starts with HYB).
Screening parameter:
- It is usually one of the parameters LIBXC1_Pn if it is a screened functional, and can therefore be modified.
- For HYB_GGA_XC_HSE03, HYB_GGA_XC_HSE06, HYB_GGA_XC_HSE12, and HYB_GGA_XC_HSE12S, the value of HFSCREEN (even if not specified explicitly in INCAR) will be used and automatically passed to the corresponding parameter in Libxc. On the other hand, if this corresponding parameter (LIBXC1_Pn) is specified in INCAR, then it will be used (instead of HFSCREEN), however note that it will be only for the semilocal component of the hybrid functional and not for the exact exchange that will still use HFSCREEN.
- For all hybrid functionals except those listed just above, HFSCREEN will not be considered for the semilocal component of the hybrid functional, but only for the exact exchange component. Therefore, a particular choice for the screening parameter has to be done by specifying both HFSCREEN (for the exact exchange) and the appropriate LIBXC1_Pn (for the semilocal component).

References

[marques:cpc:2012-1] M. A. L. Marques, M. J. T. Oliveira, and T. Burnus, Comput. Phys. Commun., 183, 2272 (2012).

[lehtola:sx:2018-2] S. Lehtola, C. Steigemann, M. J. T. Oliveira, and M. A. L. Marques, SoftwareX, 7, 1 (2018).

[libxc-3] ttps://libxc.gitlab.io

[perdew:prl:1996-4] J. P. Perdew, K. Burke, and M. Ernzerhof, Phys. Rev. Lett., 77, 3865 (1996).

[perdew:prl:2008-5] J. P. Perdew, A. Ruzsinszky, G. I. Csonka, O. A. Vydrov, G. E. Scuseria, L. A. Constantin, X. Zhou, and K. Burke, Phys. Rev. Lett. 100, 136406 (2008).

[1]

[2]

[3]

[4]

[5]

@@ Line 1: / Line 1: @@
-{{TAGDEF|LIBXC1_Pn|[real]
+{{DISPLAYTITLE:LIBXC1_Pn}}
+{{TAGDEF|LIBXC1_Pn|[real]}}
-Description: {{TAG|LIBXC1}} and [[LIBXC1|LIBXC2]] specify the functionals from the library of exchange-correlation functionals Libxc {{cite|marques:cpc:2012}}{{cite|lehtola:sx:2018}} that one wants to use.
+Description: {{TAG|LIBXC1_Pn}}, where <math>n=1, 2, \ldots</math> allows to specify the values of the parameters of the functional implemented in Libxc that is called with {{TAG|LIBXC1}}.
 ----
-{{TAG|LIBXC1}} and [[LIBXC1|LIBXC2]] can be either integers or strings. The available functionals are listed on the Libxc website<ref name="libxc"/> along with their associated tag and number (e.g., GGA_X_PBE and 101 for PBE exchange). The tag indicates if this is an exchange (X), correlation (C) or exchange-correlation (XC) functional, and to which family it belongs to, namely LDA (LDA or HYB_LDA), GGA (GGA or HYB_GGA) or meta-GGA (MGGA or HYB_MGGA).
-The possibilities for {{TAG|LIBXC1}} and [[LIBXC1|LIBXC2]] are the following:
-*Both {{TAGDEF|LIBXC1}} and [[LIBXC1|LIBXC2]] are specified and correspond to the exchange and correlation functionals, respectively, or vice versa.
-*Only {{TAGDEF|LIBXC1}} (or [[LIBXC1|LIBXC2]]) is specified and corresponds to an exchange or exchange-correlation functional. It can also be a correlation functional, but such a calculation without exchange would not make sense.
-One has to specify also {{TAG|GGA}} = LIBXC for LDA, GGA and GGA-based hybrid functionals or {{TAG|METAGGA}} = LIBXC for meta-GGA functionals (hybrid-based meta-GGA functionals are not yet available in VASP).
-In addition, many of the functionals implemented in Libxc have parameters that can be modified. This can be done with the tags {{TAG|LIBXC1_Pn}} and {{TAG|LIBXC2_Pn}}, where ''n=1, 2, ...'' in {{FILE|INCAR}}.
-Examples of how to specify a Libxc functional in {{FILE|INCAR}} are given below for the GGA PBE{{cite|perdew:prl:1996}}, meta-GGA SCAN{{cite|sun:prl:15}} and hybrid PBEh (PBE0){{cite|adamo:jcp:1999}} functionals.
+For many of the functionals implemented in the library of exchange-correlation functionals Libxc{{cite|marques:cpc:2012}}{{cite|lehtola:sx:2018}}{{cite|libxc}} it is possible to modify the parameters if one does not want to use the default values. If a functional from Libxc has parameters that can be modified, then they are listed in {{FILE|OUTCAR}} below "Parameters of Libxc functionals:" as P<math>n</math> (<math>n=1, 2, \ldots</math>). {{TAG|LIBXC1_Pn}} and {{TAG|LIBXC2_Pn}} are for the functionals called with {{TAG|LIBXC1}} and {{TAG|LIBXC2}}, respectively.
-*PBE
+An example is given below for the GGA PBE functional{{cite|perdew:prl:1996}} where the default parameters <math>\mu=0.21951</math> in exchange and <math>\beta=0.066725</math> in correlation are changed to <math>\mu=10/81\approx0.12345679</math> and <math>\beta=0.046</math> to get the PBEsol functional{{cite|perdew:prl:2008}} (of course, the simpler way to use PBEsol from Libxc would be to call it directly with {{TAG|LIBXC1}}=GGA_X_PBE_SOL and {{TAG|LIBXC2}}=GGA_C_PBE_SOL).
- {{TAG|GGA}} = LIBXC
- {{TAG|LIBXC1}} = 101
- [[LIBXC1|LIBXC2]] = 130
-or
   {{TAG|GGA}} = LIBXC
-  {{TAG|LIBXC1}} = GGA_X_PBE
+  {{TAG|LIBXC1}} = GGA_X_PBE # or 101
-  [[LIBXC1|LIBXC2]] = GGA_C_PBE
+ {{TAG|LIBXC2}} = GGA_C_PBE # or 130
+  [[LIBXC1_Pn|LIBXC1_P2]] = 0.12345679
+ [[LIBXC2_Pn|LIBXC2_P1]] = 0.046
+{{NB|mind|The {{TAG|ALDAX}}, {{TAG|ALDAC}}, {{TAG|AGGAX}}, {{TAG|AGGAC}}, {{TAG|AMGGAX}}, and {{TAG|AMGGAC}} tags are ignored if the Libxc functional is an exchange-correlation functional (those with a tag that contains XC)}}
-*SCAN
+For Libxc functionals that are the semilocal component of a hybrid functional, i.e. those with a tag that starts with HYB ({{TAG|LHFCALC}}=.TRUE. will be set automatically if such a functional is selected), the following explains how it works for the mixing and screening parameters:
- {{TAG|METAGGA}} = LIBXC
+*Mixing parameter:
- {{TAG|LIBXC1}} = 263
+**It is usually one of the parameters {{TAG|LIBXC1_Pn}}, and can therefore be modified.
- [[LIBXC1|LIBXC2]] = 267
+**For HYB_GGA_XC_PBEH, HYB_GGA_XC_B1WC, HYB_GGA_XC_HSE03, HYB_GGA_XC_HSE06, HYB_GGA_XC_HSE12, and HYB_GGA_XC_HSE12S, the value of {{TAG|AEXX}} (even if not specified explicitly in {{FILE|INCAR}}) will be used and automatically passed to the corresponding parameter in Libxc. On the other hand, if this corresponding parameter ({{TAG|LIBXC1_Pn}}) is specified in {{FILE|INCAR}}, then it will be used (instead of {{TAG|AEXX}}), however note that it will be only for the semilocal component of the hybrid functional and not for the exact exchange that will still use {{TAG|AEXX}}.
-or
+**For all hybrid functionals except those listed just above, {{TAG|AEXX}} will not be considered for the semilocal component of the hybrid functional, but only for the exact exchange component. Therefore, a particular choice for the mixing parameter has to be done by specifying both {{TAG|AEXX}} (for the exact exchange) and the appropriate {{TAG|LIBXC1_Pn}} (for the semilocal component).
- {{TAG|METAGGA}} = LIBXC
+**The {{TAG|ALDAX}}, {{TAG|ALDAC}}, {{TAG|AGGAX}}, {{TAG|AGGAC}}, {{TAG|AMGGAX}}, and {{TAG|AMGGAC}} tags are ignored if the Libxc functional is an hybrid functional (those with a tag that starts with HYB).
- {{TAG|LIBXC1}} = MGGA_X_SCAN
+*Screening parameter:
- [[LIBXC1|LIBXC2]] = MGGA_C_SCAN
+**It is usually one of the parameters {{TAG|LIBXC1_Pn}} if it is a screened functional, and can therefore be modified.
+**For HYB_GGA_XC_HSE03, HYB_GGA_XC_HSE06, HYB_GGA_XC_HSE12, and HYB_GGA_XC_HSE12S, the value of {{TAG|HFSCREEN}} (even if not specified explicitly in {{FILE|INCAR}}) will be used and automatically passed to the corresponding parameter in Libxc. On the other hand, if this corresponding parameter ({{TAG|LIBXC1_Pn}}) is specified in {{FILE|INCAR}}, then it will be used (instead of {{TAG|HFSCREEN}}), however note that it will be only for the semilocal component of the hybrid functional and not for the exact exchange that will still use {{TAG|HFSCREEN}}.
+**For all hybrid functionals except those listed just above, {{TAG|HFSCREEN}} will not be considered for the semilocal component of the hybrid functional, but only for the exact exchange component. Therefore, a particular choice for the screening parameter has to be done by specifying both {{TAG|HFSCREEN}} (for the exact exchange) and the appropriate {{TAG|LIBXC1_Pn}} (for the semilocal component).
-*PBEh (PBE0)
+== Related tags and articles ==
- {{TAG|LHFCALC}} = .TRUE.
+{{TAG|LIBXC1}},
- {{TAG|AEXX}} = 0.25
+{{TAG|LIBXC2}},
- {{TAG|GGA}} = LIBXC
+{{TAG|LIBXC2_Pn}},
- {{TAG|LIBXC1}} = 406
+{{TAG|LTBOUNDLIBXC}},
-or
+{{TAG|GGA}},
- {{TAG|LHFCALC}} = .TRUE.
+{{TAG|METAGGA}},
- {{TAG|AEXX}} = 0.25
+{{TAG|LHFCALC}},
- {{TAG|GGA}} = LIBXC
+{{TAG|AEXX}},
- {{TAG|LIBXC1}} = HYB_GGA_XC_PBEH
+{{TAG|ALDAX}},
+{{TAG|ALDAC}},
+{{TAG|AGGAX}},
+{{TAG|AGGAC}},
+{{TAG|AMGGAX}},
+{{TAG|AMGGAC}},
+[[list_of_hybrid_functionals|List of hybrid functionals]]
-<references>
-<ref name="libxc">https://www.tddft.org/programs/libxc/]</ref>
-</references>
-== Related Tags and Sections ==
+{{sc|LIBXC1_Pn|Examples|Examples that use this tag}}
-{{TAG|AGGAX}},
-{{TAG|AGGAC}},
-{{TAG|ALDAC}},
-{{TAG|LHFCALC}},
-[[Hartree-Fock_and_HF/DFT_hybrid_functionals|hybrid functionals]],
-[[specific_hybrid_functionals|settings for specific hybrid functionals]]
-{{sc|AEXX|Examples|Examples that use this tag}}
+== References ==
+<references/>
 ----
-[[Category:INCAR]][[Category:XC Functionals]][[Category:Hybrids]]
+[[Category:INCAR tag]][[Category:Exchange-correlation functionals]][[Category:GGA]][[Category:meta-GGA]][[Category:Hybrid_functionals]]