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: @@
+{{DISPLAYTITLE:LIBXC1_Pn}}
 {{TAGDEF|LIBXC1_Pn|[real]}}
-Description: {{TAG|LIBXC1_Pn}} and [[LIBXC1_Pn|LIBXC2_Pn]], where <math>n=1, 2, ...</math> allow to specify the values of the parameters of the functionals implemented in Libxc that are called with {{TAG|LIBXC1}} and {{TAG|LIBXC2}}, respectively.
+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}}.
 ----
-For many 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, ...</math>).
+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.
-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}}=116 and {{TAG|LIBXC2}}=133).
+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
+  {{TAG|LIBXC1}} = GGA_X_PBE # or 101
-  [[LIBXC1|LIBXC2]] = 130
+  {{TAG|LIBXC2}} = GGA_C_PBE # or 130
   [[LIBXC1_Pn|LIBXC1_P2]] = 0.12345679
-  [[LIBXC1_Pn|LIBXC2_P1]] = 0.046
+  [[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)}}
-For Libxc functionals that are the semilocal component of a hybrid functional (those with a tag that starts with HYB), how it works for the mixing and screening parameters is the following.
+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:
 *Mixing parameter:
 **It is usually one of the parameters {{TAG|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 {{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 AEXX.
+**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}}.
 **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).
-**The parameters {{TAG|AGGAX}}, {{TAG|AGGAC}} and {{TAG|ALDAC}} are ignored if the Libxc functional specified with {{TAG|LIBXC1}} (or {{TAG|LIBXC2}}) is an exchange-correlation functional (those with a tag that contains _XC_{{cite|libxc}}, which is the case of the majority of the hybrid functionals).
+**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).
 *Screening parameter:
 **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 HFSCREEN.
+**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).
-== Related Tags and Sections ==
+== Related tags and articles ==
 {{TAG|LIBXC1}},
+{{TAG|LIBXC2}},
+{{TAG|LIBXC2_Pn}},
+{{TAG|LTBOUNDLIBXC}},
 {{TAG|GGA}},
 {{TAG|METAGGA}},
+{{TAG|LHFCALC}},
 {{TAG|AEXX}},
+{{TAG|ALDAX}},
+{{TAG|ALDAC}},
 {{TAG|AGGAX}},
 {{TAG|AGGAC}},
-{{TAG|ALDAC}},
+{{TAG|AMGGAX}},
-[[Hartree-Fock_and_HF/DFT_hybrid_functionals|hybrid functionals]],
+{{TAG|AMGGAC}},
-[[specific_hybrid_functionals|settings for specific hybrid functionals]]
+[[list_of_hybrid_functionals|List of hybrid functionals]]
+{{sc|LIBXC1_Pn|Examples|Examples that use this tag}}
-{{sc|LIBXC1|Examples|Examples that use this tag}}
+== References ==
+<references/>
 ----
-[[Category:INCAR]][[Category:XC Functionals]][[Category:GGA]][[Category:metaGGA]][[Category:Hybrids]]
+[[Category:INCAR tag]][[Category:Exchange-correlation functionals]][[Category:GGA]][[Category:meta-GGA]][[Category:Hybrid_functionals]]