NMAXFOCKAE: Difference between revisions

From VASP Wiki
No edit summary
No edit summary
Line 2: Line 2:


{{TAGDEF|LMAXFOCKAE|[integer]}}
{{TAGDEF|LMAXFOCKAE|[integer]}}
{{DEF|LAXMFOCKAE|-1|for DFT, Hartree-Fock |  4 | for post DFT methods}}
{{DEF|LAXMFOCKAE|-1|for Hartree-Fock and hybrid functionals |  4 | for post DFT methods}}


Description: {{TAG|NMAXFOCKAE}} and {{TAG|LMAXFOCKAE}} determine whether  
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.
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.).  


----
----
Line 16: Line 17:
(one-center terms inside the PAW spheres). To describe long range electrostatic terms, the  
(one-center terms inside the PAW spheres). To describe long range electrostatic terms, the  
the ''moments'' of the differences of the all-electron and pseudo charge density are usually
the ''moments'' of the differences of the all-electron and pseudo charge density are usually
also added on the plane wave grid up to a certain ''l'' quantum number (see {{TAG|LMAXFOCK}}).
also added on the plane wave grid up to a certain l quantum number (see {{TAG|LMAXFOCK}}).
These augmentation charges restore the moments of the all-electron density on the plane wave
These augmentation charges restore the moments of the all-electron density on the plane wave
grid.
grid.
Line 24: Line 25:
in particular for 3d and (to a lesser extent) 2p, 4d and 5d elements.
in particular for 3d and (to a lesser extent) 2p, 4d and 5d elements.
To correct for this error, an alternative treatment is implemented
To correct for this error, an alternative treatment is implemented
on the plane wave grid. This  allows to restore the all-electron charge density accurately on the plane wave grid, using the flags {{TAG|LMAXFOCKAE}} and {{TAG|NMAXFOCKAE}}.
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, <math> Q_{\alpha\beta}(r) </math> is Fourier transformed  
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
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
in a set of orthogonal functions localized at each atomic site.
are then added to the pseudo charge densities on the plane wave grid.




If the {{TAG|LMAXFOCKAE}}=-1 (the default for DFT and Hartree-Fock calculations), only the moments of the all-electron charge density is restored on the plane wave grid. This setting is exact for density functional theory, Hartree-Fock as well
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  
as hybrid functionals, since the one-center terms are implemented.
since the one-center terms are implemented.  


If {{TAG|NMAXFOCKAE}}=1 and {{TAG|LMAXFOCKAE}} is set, the moments of the all-electron charge density are restored on the plane wave grid. Furthermore, 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  
If {{TAG|LMAXFOCKAE}} is set to value 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.
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 no accurate augmentation is desired by the user, simply set {{TAG|LMAXFOCKAE}}=-1 in the INCAR file.


If {{TAG|NMAXFOCKAE}}=2 and {{TAG|LMAXFOCKAE}} is set, the charge density is restored accurately on the plane wave grid up to a typical plane wave energies of 380 eV. As before,  {{TAG|LMAXFOCKAE}} can be used to specify the maximum spherical (l) quantum number up  
If {{TAG|LMAXFOCKAE}} is set to value larger than -1 and {{TAG|NMAXFOCKAE}}=2, the charge density is restored accurately on the plane wave grid up to a typical plane wave energies 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  
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
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
Line 45: Line 47:




If  {{TAG|NMAXFOCKAE}} is used, 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.
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.
For instance for sp elements, {{TAG|LMAXFOCKAE}} = 2 suffices. For d elements, {{TAG|LMAXFOCKAE}} = 4 suffices
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 number of 4), whereas for f elements, users
(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.
should test whether  {{TAG|LMAXFOCKAE}} = 6 is required.


In summary, usefully manual setting of {{TAG|NMAXFOCKAE}}  and {{TAG|LMAXFOCKAE}} are:
In summary, usefully manual setting of {{TAG|NMAXFOCKAE}}  and {{TAG|LMAXFOCKAE}} are:
*  {{TAG|LMAXFOCKAE}}=-1, to switch off the accurate augmentation altogether (fall back to the DFT treatment)
*  {{TAG|LMAXFOCKAE}}=-1, to switch off the accurate augmentation altogether  
* {{TAG|LMAXFOCKAE}}=4 (or larger) to force an accurate treatment for the HF part even in Hartree-Fock calculations
* {{TAG|LMAXFOCKAE}}=4 (or larger) to force an accurate treatment for the HF part even in Hartree-Fock calculations
* {{TAG|NMAXFOCKAE}}=2, to select the very accurate augmentation. Please check whether the VASP default setting for {{TAG|LMAXFOCKAE}} suffices (OUTCAR file).
* {{TAG|NMAXFOCKAE}}=2, to select the very accurate augmentation. Please check whether the VASP default setting for {{TAG|LMAXFOCKAE}} suffices (OUTCAR file).




== Related Tags and Sections ==
== Related Tags and Sections ==
{{TAG|LMAXFOCK}}
{{TAG|LMAXFOCK}} {{TAG|QMAXFOCKAE}}
----
----
[[The_VASP_Manual|Contents]]
[[The_VASP_Manual|Contents]]


[[Category:INCAR]][[Category:Hybrids]]
[[Category:INCAR]][[Category:Hybrids]]

Revision as of 14:02, 14 March 2017

NMAXFOCKAE = 1|2
Default: NMAXFOCKAE = 1 

LMAXFOCKAE = [integer] 

Default: LAXMFOCKAE = -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 terms, the the moments of the differences of the all-electron and pseudo charge density are usually also added on the plane wave grid up to a certain l quantum number (see LMAXFOCK). These augmentation charges restore the moments of the all-electron density on the plane wave grid.

For the RPA, GW, and most post DFT methods, the one-center terms are presently, however, 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 value 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 value larger than -1 and NMAXFOCKAE=2, the charge density is restored accurately on the plane wave grid up to a typical plane wave energies 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, usefully manual setting 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 HF part even in Hartree-Fock calculations
  • NMAXFOCKAE=2, to select the very accurate augmentation. Please check whether the VASP default setting for LMAXFOCKAE suffices (OUTCAR file).


Related Tags and Sections

LMAXFOCK QMAXFOCKAE


Contents