LMAXFOCKAE: Difference between revisions

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




Description: {{TAG|LMAXFOCKAE}} and {TAG|LMAXFOCKAE}} sets the maximum angular momentum quantum number ''l'' for the "accurate" augmentation of charge densities in Hartree-Fock type routines.
Description: {{TAG|LMAXFOCKAE}} and {{TAG|LMAXFOCKAE}} describes the maximum angular momentum quantum number ''l'' and the number of channels for an "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 and
the pseudo partial waves
<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 terms, the
the ''moments'' of the differences of the all-electron and pseudo charge density are also
restored on the plane wave grid up to a certain ''l'' quantum number (see {{TAG|LMAXFOCK}}).


If {{TAG|LMAXFOCKAE}} is set, the shape of the charge density is restored accurately on the plane wave grid up to a typical plane wave energy of 100 eV. (Beyond that cutoff the polarizability is usually very small (<0.01), necessitating no accurate treatment.)
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 ''shape'' of the charge density difference accurately on the plane wave grid, using the flags {{TAG|LMAXFOCKAE}} and {{TAG|NMAXFOCKAE}}.


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:
To achieve this, <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.


*Thomas-Fermi type screening ({{TAG|LTHOMAS}}=.TRUE.)
*[[GW calculations]]


In these cases, it is recommended to set {{TAG|LMAXFOCKAE}} to twice the maximum ''l'' quantum number found in the {{FILE|POTCAR}} file.
If the {{TAG|NMAXFOCKAE}}=0 (the default for DFT and Hartree-Fock calculations), only the moment and 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
as hybrid functionals, since the one-center terms are implemented.
 
If the {{TAG|NMAXFOCKAE}}=1 is set, the moments of the all-electron charge density are stored 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}} can be used to specify the maximum spherical (l) quantum number up
to which this more accurate treatment is used. The default for {{TAG|LMAXFOCKAE}} is 4.
 
If {{TAG|NMAXFOCKAE}}=2 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
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}}=1 to {{TAG|NMAXFOCKAE}}=2 might change QP energies by 100-200 meV for 3d and late 4d and 5d elements.
 
 
If  {{TAG|NMAXFOCKAE}} is used, the setting for {{TAG|LMAXFOCKAE}} should be also checked. 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
(a d electron can create a density with l-quantum number of 4), whereas for f elements, users
should test whether  {TAG|LMAXFOCKAE}} = 4 is required.


For ''GW'' calculations involving first row elements set {{TAG|LMAXFOCKAE}} = 2. For ''GW'' calculations involving transition metals {{TAG|LMAXFOCKAE}} = 4 is recommended.


== Related Tags and Sections ==
== Related Tags and Sections ==

Revision as of 13:10, 14 March 2017

LMAXFOCKAE = [integer]
Default: LMAXFOCKAE = -1 

NMAXFOCKAE = [integer]
Default: NMAXFOCKAE = 0 


Description: LMAXFOCKAE and LMAXFOCKAE describes the maximum angular momentum quantum number l and the number of channels for an "accurate" augmentation of charge densities in Hartree-Fock type routines.


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 also restored on the plane wave grid up to a certain l quantum number (see LMAXFOCK).

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 shape of the charge density difference accurately on the plane wave grid, using the flags LMAXFOCKAE and NMAXFOCKAE.

To achieve this, is Fourier transformed to reciprocal space and then expanded in a set of orthogonal functions localized at each atomic site.


If the NMAXFOCKAE=0 (the default for DFT and Hartree-Fock calculations), only the moment and 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 as hybrid functionals, since the one-center terms are implemented.

If the NMAXFOCKAE=1 is set, the moments of the all-electron charge density are stored 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. LMAXFOCKAE can be used to specify the maximum spherical (l) quantum number up to which this more accurate treatment is used. The default for LMAXFOCKAE is 4.

If NMAXFOCKAE=2 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, 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=1 to NMAXFOCKAE=2 might change QP energies by 100-200 meV for 3d and late 4d and 5d elements.


If NMAXFOCKAE is used, the setting for LMAXFOCKAE should be also checked. Generally, it suffices to set LMAXFOCKAE to twice the maximum l quantum number found in the POTCAR file. For instance for sp elements, {TAG|LMAXFOCKAE}} = 2 suffices. For d elements, {TAG|LMAXFOCKAE}} = 4 suffices (a d electron can create a density with l-quantum number of 4), whereas for f elements, users should test whether {TAG|LMAXFOCKAE}} = 4 is required.


Related Tags and Sections

LMAXFOCK


Contents