LMAXFOCKAE: Difference between revisions

From VASP Wiki
No edit summary
 
(22 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{TAGDEF|LMAXFOCKAE|[integer]|-1}}
#REDIRECT [[NMAXFOCKAE and LMAXFOCKAE]]
 
{{TAGDEF|LMAXFOCKAE|[integer]}}
{{DEF|LMAXFOCKAE|-1|for Hartree-Fock and hybrid functionals |  4 | for post DFT methods}}
 
Description: {{TAG|NMAXFOCKAE}} and {{TAG|LMAXFOCKAE}} determine whether
the overlap densities in the Fock exchange and correlated wave function methods are accurately reconstructed on the plane wave grid. This flag generally only applies to the Fock-exchange part as well as many-body
post DFT methods (GW, RPA, MP2, etc.).


Description: {{TAG|LMAXFOCKAE}} sets the maximum angular momentum quantum number ''l'' for the "accurate" augmentation of charge densities in Hartree-Fock type routines.
----
----
Usually VASP restores only the ''moments'' of the all-electron charge density on the plane wave grid (see {{TAG|LMAXFOCK}}) up to a certain ''l'' quantum number. It is, however, also possible to restore the ''shape'' of the charge density accurately on the plane wave grid, using the flag {{TAG|LMAXFOCKAE}}.
In the PAW method, the difference between the charge density of the all-electron partial waves <math>\phi_\beta</math> and
the pseudo partial waves <math>\tilde \phi_\beta</math>
<math>
Q_{\alpha\beta}(r)= \phi^*_\alpha(r)\phi_\beta(r)  - \tilde \phi^*_\alpha(r)\tilde \phi_\beta(r)
</math>
is usually restored on spherical grids centered at each atom
(one-center terms inside the PAW spheres).  To describe long range electrostatic effect, the ''moments'' of the differences of the all-electron and pseudo charge density
also need to added to the pseudo density on the plane wave grid. This is done up to a certain ''l'' quantum number.
These augmentation charges exactly restore the moments of the all-electron density on the plane wave
grid. For the charge densities used in the Hartree and DFT term,
this augmentation is done exactly up to the maximum ''l'' quantum number required by the POTCAR files,
whereas for the Fock exchange,  the augmentation on the plane wave grid is controlled by {{TAG|LMAXFOCK}}.
 
For the RPA, GW, and most post DFT methods, the one-center terms are, however, presently
not implemented. Depending on the material, this can cause sizable errors
in particular for 3d and (to a lesser extent) 2p, 4d and 5d elements.
To correct for this error, an alternative treatment is implemented
on the plane wave grid. This  allows to restore the all-electron densities accurately on the plane wave grid
instead of the one-center grids by specifying the flags {{TAG|LMAXFOCKAE}} and {{TAG|NMAXFOCKAE}}.
 
To achieve this improved treatment on the plane wave grid, <math> Q_{\alpha\beta}(r) </math> is Fourier transformed  to reciprocal space <math> Q_{\alpha\beta}(q) </math> and then expanded
in a set of orthogonal functions localized at each atomic site. These augmentation charges
are then added to the pseudo charge densities on the plane wave grid.
 
 
For {{TAG|LMAXFOCKAE}}=-1 (the default for DFT and Hartree-Fock calculations), only the moments of the all-electron charge densities are restored on the plane wave grid. This setting is exact for Hartree-Fock
since the one-center terms are implemented.
 
If {{TAG|LMAXFOCKAE}} is set to values larger than -1 (and {{TAG|NMAXFOCKAE}}=1), not only the moments of the all-electron charge density are restored, but also the all-electron charge density is restored up to a typical plane wave energy of 140 eV. This setting yields very accurate results for post DFT methods (MP2, RPA, GW, etc.) for most sp bonded materials.  {{TAG|LMAXFOCKAE}} is used to specify the maximum spherical (l) quantum number up
to which this more accurate treatment is used. The default is {{TAG|LMAXFOCKAE}}=4 for post DFT methods.
If no accurate augmentation is desired by the user, simply set {{TAG|LMAXFOCKAE}}=-1 in the INCAR file.
 
If {{TAG|LMAXFOCKAE}} is set to values larger than -1 and {{TAG|NMAXFOCKAE}}=2, the charge density is restored accurately on the plane wave grid up to a typical plane wave energy of 380 eV. As before, {{TAG|LMAXFOCKAE}} can be used to specify the maximum spherical (l) quantum number up
to which this more accurate treatment is used.  {{TAG|NMAXFOCKAE}}=2 yields very accurate results for
post DFT methods (MP2, RPA, GW) even for difficult 3d elements. For RPA and MP2 total energy calculations, differences between {{TAG|NMAXFOCKAE}}=1 and {{TAG|NMAXFOCKAE}}=2 are usually tiny for total energy differences. Since the absolute correlation energies might change, it is vital to use the same setting for
{{TAG|NMAXFOCKAE}} and {{TAG|LMAXFOCKAE}}, if energy differences are calculated.
For GW calculations, increasing  {{TAG|NMAXFOCKAE}} from 1 to 2 might change QP energies by 100-200 meV for 3d and late 4d and 5d elements.


This flag usually hardly changes the total energy or one-electron states, since the one-center-terms are calculated exactly for most Hamiltonians (the one-center terms are defined as the difference between the pseudized one-center terms and the all-electron one-center terms). However for the following type of Hamiltonians, one-center terms are currently not implemented, or only approximately implemented:


*Thomas-Fermi type screening ({{TAG|LTHOMAS}}=.TRUE.)
The setting for {{TAG|LMAXFOCKAE}} should be also considered carefully. Generally, it suffices to set {{TAG|LMAXFOCKAE}} to twice the maximum ''l'' quantum number found in the {{FILE|POTCAR}} file.
*[[GW|GW type calculations]]
For instance for sp elements, {{TAG|LMAXFOCKAE}} = 2 suffices. For d elements, {{TAG|LMAXFOCKAE}} = 4 suffices
(a d electron can create charge densities with ''l''-quantum numbers up to 4), whereas for f elements, users
should test whether  {{TAG|LMAXFOCKAE}} = 6 is required.


In these cases, it is recommended to set {{TAG|LMAXFOCKAE}} to twice the maximum ''l'' quantum number found in the {{FILE|POTCAR}} file.
In summary, useful manual settings of {{TAG|NMAXFOCKAE}}  and {{TAG|LMAXFOCKAE}} are:
*  {{TAG|LMAXFOCKAE}}=-1, to switch off the accurate augmentation altogether
* {{TAG|LMAXFOCKAE}}=4 (or larger) to force an accurate treatment for the charge augmentation on the plane wave grid (can be selected even in Hartree-Fock type calculations).
* {{TAG|NMAXFOCKAE}}=2, to select the very accurate augmentation on the plane wave grid. Please check whether the VASP default setting for {{TAG|LMAXFOCKAE}} suffices (OUTCAR file).


For GW calculations involving transition metals {{TAG|LMAXFOCKAE}} = 4 is recommended. For GW calculations involving transitions metals and/or first row elements {{TAG|LMAXFOCKAE}} = 2 is recommended.


== Related Tags and Sections ==
== Related tags and articles ==
{{TAG|LMAXFOCK}}
{{TAG|LMAXFOCK}}, {{TAG|NMAXFOCKAE}}, {{TAG|QMAXFOCKAE}}, {{TAG|LFOCKAEDFT}}
----
----
[[The_VASP_Manual|Contents]]


[[Category:INCAR]][[Category:Hybrids]]
[[Category:INCAR tag]][[Category:Hybrids]][[Category:GW]]

Latest revision as of 14:38, 8 April 2022

LMAXFOCKAE = [integer] 

Default: LMAXFOCKAE = -1 for Hartree-Fock and hybrid functionals
= 4 for post DFT methods

Description: NMAXFOCKAE and LMAXFOCKAE determine whether the overlap densities in the Fock exchange and correlated wave function methods are accurately reconstructed on the plane wave grid. This flag generally only applies to the Fock-exchange part as well as many-body post DFT methods (GW, RPA, MP2, etc.).


In the PAW method, the difference between the charge density of the all-electron partial waves and the pseudo partial waves is usually restored on spherical grids centered at each atom (one-center terms inside the PAW spheres). To describe long range electrostatic effect, the moments of the differences of the all-electron and pseudo charge density also need to added to the pseudo density on the plane wave grid. This is done up to a certain l quantum number. These augmentation charges exactly restore the moments of the all-electron density on the plane wave grid. For the charge densities used in the Hartree and DFT term, this augmentation is done exactly up to the maximum l quantum number required by the POTCAR files, whereas for the Fock exchange, the augmentation on the plane wave grid is controlled by LMAXFOCK.

For the RPA, GW, and most post DFT methods, the one-center terms are, however, presently not implemented. Depending on the material, this can cause sizable errors in particular for 3d and (to a lesser extent) 2p, 4d and 5d elements. To correct for this error, an alternative treatment is implemented on the plane wave grid. This allows to restore the all-electron densities accurately on the plane wave grid instead of the one-center grids by specifying the flags LMAXFOCKAE and NMAXFOCKAE.

To achieve this improved treatment on the plane wave grid, is Fourier transformed to reciprocal space and then expanded in a set of orthogonal functions localized at each atomic site. These augmentation charges are then added to the pseudo charge densities on the plane wave grid.


For LMAXFOCKAE=-1 (the default for DFT and Hartree-Fock calculations), only the moments of the all-electron charge densities are restored on the plane wave grid. This setting is exact for Hartree-Fock since the one-center terms are implemented.

If LMAXFOCKAE is set to values larger than -1 (and NMAXFOCKAE=1), not only the moments of the all-electron charge density are restored, but also the all-electron charge density is restored up to a typical plane wave energy of 140 eV. This setting yields very accurate results for post DFT methods (MP2, RPA, GW, etc.) for most sp bonded materials. LMAXFOCKAE is used to specify the maximum spherical (l) quantum number up to which this more accurate treatment is used. The default is LMAXFOCKAE=4 for post DFT methods. If no accurate augmentation is desired by the user, simply set LMAXFOCKAE=-1 in the INCAR file.

If LMAXFOCKAE is set to values larger than -1 and NMAXFOCKAE=2, the charge density is restored accurately on the plane wave grid up to a typical plane wave energy of 380 eV. As before, LMAXFOCKAE can be used to specify the maximum spherical (l) quantum number up to which this more accurate treatment is used. NMAXFOCKAE=2 yields very accurate results for post DFT methods (MP2, RPA, GW) even for difficult 3d elements. For RPA and MP2 total energy calculations, differences between NMAXFOCKAE=1 and NMAXFOCKAE=2 are usually tiny for total energy differences. Since the absolute correlation energies might change, it is vital to use the same setting for NMAXFOCKAE and LMAXFOCKAE, if energy differences are calculated. For GW calculations, increasing NMAXFOCKAE from 1 to 2 might change QP energies by 100-200 meV for 3d and late 4d and 5d elements.


The setting for LMAXFOCKAE should be also considered carefully. Generally, it suffices to set LMAXFOCKAE to twice the maximum l quantum number found in the POTCAR file. For instance for sp elements, LMAXFOCKAE = 2 suffices. For d elements, LMAXFOCKAE = 4 suffices (a d electron can create charge densities with l-quantum numbers up to 4), whereas for f elements, users should test whether LMAXFOCKAE = 6 is required.

In summary, useful manual settings of NMAXFOCKAE and LMAXFOCKAE are:

  • LMAXFOCKAE=-1, to switch off the accurate augmentation altogether
  • LMAXFOCKAE=4 (or larger) to force an accurate treatment for the charge augmentation on the plane wave grid (can be selected even in Hartree-Fock type calculations).
  • NMAXFOCKAE=2, to select the very accurate augmentation on the plane wave grid. Please check whether the VASP default setting for LMAXFOCKAE suffices (OUTCAR file).


Related tags and articles

LMAXFOCK, NMAXFOCKAE, QMAXFOCKAE, LFOCKAEDFT