Practical guide to GW calculations: Difference between revisions

From VASP Wiki
 
(79 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__TOC__
The [[The GW approximation of Hedin's equations|GW approximation]] is an approximation to the self-energy. GW calculations are available as of VASP.5.X. For details on the implementation and use of the ''GW'' routines, we recommend the papers by Shishkin ''et al.'' {{cite|shishkin:prb:2006}}{{cite|shishkin:prb:2007}}{{cite|shishkin:prl:2007}} and Fuchs ''et al.''{{cite|fuchs:prb:2007}}
A brief summary of the theoretical background can be found [[The GW approximation of Hedin's equations|here]].


Available as of VASP.5.X. For details on the implementation and use of the ''GW'' routines we recommend the papers by Shishkin ''et al.''<ref name="shishkin-PRB74"/><ref name="shishkin-PRB75"/><ref name="shishkin:prl:07"/> and Fuchs ''et al.''<ref name="fuchs-PRB76"/>
<span id="GW_in_one_go">
= Single step procedure: GW in one go =


As of VASP.6 all GW approximations can be selected directly via the {{TAG|ALGO}} tag (omitting {{TAG|NBANDS}}) without a preceding DFT calculation. However, for older versions a two step procedure is required, where the first step is always a DFT calculation.
As of VASP.6.3 all GW approximations can be run in one single run by selecting the corresponding {{TAG|ALGO}} tag and omitting {{TAG|NBANDS}}), for instance like so
The actual GW calculation is performed in the second step. Furthermore, cubic scaling algorithms are available.  
{{TAGBL|System}} = SiC
{{TAGBL|ALGO}} = EVGW0, QPGW0, EVGW, QPGW, GW0R or GWR # use an algorithgm described below
{{TAGBL|NELMGW}} = 1,2,.. # number of self-consistency cycles
{{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05  ! small sigma is required to avoid partial occupancies
{{TAGBL|LOPTICS}} = .TRUE. # for insulators, omit for metals
Note, {{TAG|NBANDS}} must not be present in the INCAR to select this procedure.
{{NB|important|In older versions a two step procedure is required, where the first step is always a DFT calculation and the second step the actual GW calculation.}}
The two-step procedure is described below.
 
== Caveats ==
The single-step GW procedure performs a DFT step internally with an exact diagonalization of the Kohn-Sham Hamiltonian using the maximum available {{TAGBL|NBANDS}} supported for the chosen {{TAGBL|ENCUT}} value.
Consequently, a large number of unoccupied bands is initialized with random plane-wave coefficients. In rare cases, this yields two linearly dependent column vectors in the Hamiltonian and results in LAPACK errors like "ZPOTRF fails". These errors can be prevented using the two-step GW procedure as described below. Furthermore, one can "ramp up" NBANDS to the maximum value by repeatedly restarting the DFT calculation from a pre-converged {{TAGBL|WAVECAR}} with fewer bands.


<span id="DFT_Step_for_GW">
<span id="DFT_Step_for_GW">
= First step: DFT calculation =
= First step: DFT calculation =
''GW'' calculations always require a one-electron basis set. Usually this set is obtained from a standard DFT calculation and written into the {{FILE|WAVECAR}} file and can be calculated for instance the following INCAR file:
''GW'' calculations always require a one-electron basis set. Usually this set is obtained from a standard DFT calculation and written into the {{FILE|WAVECAR}} file and can be calculated for instance the following INCAR file:
  {{TAGBL|System}} = SiC
  {{TAGBL|System}} = SiC
  {{TAGBL|NBANDS}} = 512
  {{TAGBL|NBANDS}} = 512
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05  ! small sigma is required to avoid partial occupancies
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05  ! small sigma is required to avoid partial occupancies
  {{TAGBL|LOPTICS}} = .TRUE.
  {{TAGBL|LOPTICS}} = .TRUE.
 
Note, that a significant number of empty bands is required for ''GW'' calculations, so that it might be better to perform the calculations in two steps: first a standard ground-state calculation with few unoccupied orbitals only,
Note, that a significant number of empty bands is required for ''GW'' calculations, so that it might be better to perform the calculations in two steps: first a standard grounstate calculation with few unoccupied orbitals only,
  {{TAGBL|System}} = SiC ground-state occupied orbitals
 
  {{TAGBL|System}} = SiC groundstate occupied orbitals
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05  ! small sigma is required to avoid partial occupancies
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05  ! small sigma is required to avoid partial occupancies
  {{TAGBL|EDIFF}} = 1E-8              ! required tight tolerance for groundstate orbitals
  {{TAGBL|EDIFF}} = 1E-8              ! required tight tolerance for ground-state orbitals
 
and, second, a calculation of a large number of unoccupied orbitals
and, second, a calculation of a large number of unoccupied orbitals
  {{TAGBL|System}}  = SiC unoccupied orbitals
  {{TAGBL|System}}  = SiC unoccupied orbitals
  {{TAGBL|ALGO}} = Exact              ! use exact diagonalization of the Hamiltonian
  {{TAGBL|ALGO}} = Exact              ! use exact diagonalization of the Hamiltonian
Line 30: Line 37:
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05  ! small sigma is required to avoid partial occupancies
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05  ! small sigma is required to avoid partial occupancies
  {{TAGBL|LOPTICS}} = .TRUE.
  {{TAGBL|LOPTICS}} = .TRUE.
 
Furthermore, note that the flag {{TAG|LOPTICS}}=.TRUE. is required to write the file {{FILE|WAVEDER}}, which contains the derivative of the orbitals with respect to '''k'''.  
Furthermore note that the flag {{TAG|LOPTICS}}=.TRUE. is required in order to write the file {{FILE|WAVEDER}}, which contains the derivative of the orbitals with respect to '''k'''.  
This derivative is used to construct the head and wings of the dielectric matrix employing '''k'''&middot;'''p''' perturbation theory and is important to accelerate k-point convergence for insulators and semiconductors. {{NB|warning|For metals, in general, we recommend omitting the {{TAG|LOPTICS}} tag and removing the {{FILE|WAVEDER}} file from the directory.}}
This derivative is used to construct the head and wings of the dielectric matrix employing '''k'''&middot;'''p''' perturbation theory and is important to accelerate k-point convergence for insulators and semiconductors. For metals, in general, we recommend to omit the {{TAG|LOPTICS}} tag and remove the {{FILE|WAVEDER}} file from the directory.  


== Optional: Use Hybrid functionals ==
== Optional: Use Hybrid functionals ==
Optionally, one can start a ''GW'' calculation from a hybrid functional, such as HSE.  
Optionally, one can start a ''GW'' calculation from a [[:Category:Hybrid_functionals|hybrid functional]], such as HSE.  
For hybrid functionals, the two step procedure will accordingly involve the following {{FILE|INCAR}} files. In the first step, converged [[Hartree-Fock_and_HF/DFT_hybrid_functionals#HSE|HSE03]] orbitals are determined (see  [[Specific hybrid functionals|here]] for a selection of available hybrid functionals):
For hybrid functionals, the two step procedure will accordingly involve the following {{FILE|INCAR}} files. In the first step, converged [[List_of_hybrid_functionals#HSE|HSE03]] orbitals are determined (see  [[List_of_hybrid_functionals|here]] for a selection of available hybrid functionals):
 
  {{TAGBL|System}}  = SiC ground-state occupied orbitals
  {{TAGBL|System}}  = SiC groundstate occupied orbitals
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|ALGO}} = Damped ; {{TAGBL|TIME}} = 0.5  ! or {{TAGBL|ALGO}} = Conjugate
  {{TAGBL|ALGO}} = Damped ; {{TAGBL|TIME}} = 0.5  ! or {{TAGBL|ALGO}} = Conjugate
  {{TAGBL|LHFCALC}} = .TRUE. ; {{TAGBL|AEXX}} = 0.25 ; {{TAGBL|HFSCREEN}} = 0.3  
  {{TAGBL|LHFCALC}} = .TRUE. ; {{TAGBL|AEXX}} = 0.25 ; {{TAGBL|HFSCREEN}} = 0.3  
  {{TAGBL|EDIFF}} = 1E-6      ! required tight tolerance for groundstate orbitals
  {{TAGBL|EDIFF}} = 1E-6      ! required tight tolerance for ground-state orbitals
 
Secondly, determine the HSE03 orbitals for unoccupied states:
Secondly, determine the HSE03 orbitals for unoccupied states:
  {{TAGBL|System}}  = SiC unoccupied orbitals
  {{TAGBL|System}}  = SiC unoccupied orbitals
  {{TAGBL|NBANDS}} = 512      ! maybe even larger
  {{TAGBL|NBANDS}} = 512      ! maybe even larger
Line 52: Line 55:
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|LHFCALC}} = .TRUE. ; {{TAGBL|AEXX}} = 0.25 ; {{TAGBL|HFSCREEN}} = 0.3  
  {{TAGBL|LHFCALC}} = .TRUE. ; {{TAGBL|AEXX}} = 0.25 ; {{TAGBL|HFSCREEN}} = 0.3  
  {{TAGBL|LOPTICS}} = .TRUE.
  {{TAGBL|LOPTICS}} = .TRUE. # for insulators
 
</span>
</span>


= Step 2: GW step=
= Second step: GW calculation=
The actual ''GW'' calculation is done in a second step. Here different ''GW'' flavors are possible and are selected with the {{TAG|ALGO}} tag.  
The actual ''GW'' calculation is done in a second step. Here different ''GW'' flavors are possible and are selected with the {{TAG|ALGO}} tag.  


Line 62: Line 64:


<span id="G0W0">
<span id="G0W0">
== Single shot quasi-particle energies: G<sub>0</sub>W<sub>0</sub> ==
== Single shot quasiparticle energies: G<sub>0</sub>W<sub>0</sub> ==
This is the simplest ''GW'' calculation and computationally the most efficient one.  
This is the simplest ''GW'' calculation and computationally the most efficient one.  
A single-shot calculation is often referred to as G<sub>0</sub>W<sub>0</sub> and calculates the quasi-particle energies from a single ''GW'' iteration by neglecting all off-diagonal matrix elements of the self-energy and employing a Taylor expansion of the self-energy around the DFT energies <math>E_{n{\bf q}}^{(0)}</math>. The corresponding equation becomes
A single-shot calculation is often referred to as G<sub>0</sub>W<sub>0</sub> and calculates the quasiparticle energies from a single ''GW'' iteration by neglecting all off-diagonal matrix elements of the self-energy and employing a Taylor expansion of the self-energy around the DFT energies <math>E_{n{\bf q}}^{(0)}</math>. The corresponding equation becomes


<span id="G0W0_eigenvalues">
<span id="G0W0_eigenvalues">
Line 81: Line 83:


In VASP, G<sub>0</sub>W<sub>0</sub> calculations are selected using an {{TAG|INCAR}} file such as
In VASP, G<sub>0</sub>W<sub>0</sub> calculations are selected using an {{TAG|INCAR}} file such as
  {{TAGBL|System}}  = SiC
  {{TAGBL|System}}  = SiC
  {{TAGBL|NBANDS}} = 512
  {{TAGBL|NBANDS}} = 512
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|NELM}} = 1 ; {{TAGBL|ALGO}} = EVGW0 ! use "GW0" for VASP.5.X
  {{TAGBL|NELMGW}} = 1 ! use NELM for VASP.6.2 and older
{{TAGBL|ALGO}} = EVGW0 ! use "GW0" for VASP.5.X
  {{TAGBL|NOMEGA}} = 50
  {{TAGBL|NOMEGA}} = 50
{{NB|mind|Convergence with respect to the number of empty bands {{TAG|NBANDS}} and with respect to the number of frequencies {{TAG|NOMEGA}} must be checked carefully.}}


Convergence with respect to the number of empty bands {{TAG|NBANDS}} and with respect to the number of frequencies {{TAG|NOMEGA}} must be checked carefully.
To avoid complicated inter-nested tests, we recommend calculating all orbitals that the plane-wave basis set allows to calculate (except for simple tests). For further reading, please consult the section on {{TAG|ENCUTGW}}.


To avoid complicated inter-nested tests, we recommend to calculate all orbitals that the plane wave basis set allows to calculate (except for simple tests). For further reading please consult the section on {{TAG|ENCUTGW}}.
After a successful G<sub>0</sub>W<sub>0</sub> run, VASP will write the quasiparticle energies into the {{TAG|OUTCAR}} file for a set of {{TAG|NBANDSGW}} bands for every k-point in the Brillouin zone. Look for lines similar to  
 
After a successful G<sub>0</sub>W<sub>0</sub> run, VASP will write the quasi-particle energies into the {{TAG|OUTCAR}} file for a set of {{TAG|NBANDSGW}} bands for every k-point in the Brillouin zone. Look for lines similar to  
 
  QP shifts <psi_nk| G(iteration)W_0 |psi_nk>: iteration 1
  QP shifts <psi_nk| G(iteration)W_0 |psi_nk>: iteration 1
  for sc-GW calculations column KS-energies equals QP-energies in previous step  
  for sc-GW calculations column KS-energies equals QP-energies in previous step  
Line 107: Line 107:
       5      0.4603      -0.4663    -13.7603    -12.5200    -18.1532      0.7471      2.0000      0.2167
       5      0.4603      -0.4663    -13.7603    -12.5200    -18.1532      0.7471      2.0000      0.2167
       6      0.4603      -0.4663    -13.7603    -12.5200    -18.1532      0.7471      2.0000      0.2167
       6      0.4603      -0.4663    -13.7603    -12.5200    -18.1532      0.7471      2.0000      0.2167
 
The first column is the band index and the third column denotes the quasiparticle energies <math>E_{n{\bf q}}</math>. Column two, four, five and seven refer to the DFT energies <math>E_{n{\bf q}}^{(0)}</math>, diagonal matrix elements of the self-energy <math>\langle \phi^{(0)}_{n{\bf q}}|\Sigma(\omega=E_{n{\bf q}}^{(0)}) |\phi^{(0)}_{n{\bf q}}\rangle</math>, the exchange-correlation potential <math>\langle \phi^{(0)}_{n{\bf q}}|V_{xc} |\phi^{(0)}_{n{\bf q}}\rangle</math> and the renormalization factor <math>Z_{n{\bf q}}</math> defined above, respectively.
The first column is the band index and the thrid column denotes the quasi-particle energies <math>E_{n{\bf q}}</math>. Column two, four, five and seven refer to the DFT energies <math>E_{n{\bf q}}^{(0)}</math>, diagonal matrix elements of the self-energy <math>\langle \phi^{(0)}_{n{\bf q}}|\Sigma(\omega=E_{n{\bf q}}^{(0)}) |\phi^{(0)}_{n{\bf q}}\rangle</math>, the exchange-correlation potential <math>\langle \phi^{(0)}_{n{\bf q}}|V_{xc} |\phi^{(0)}_{n{\bf q}}\rangle</math> and the renormalization factor <math>Z_{n{\bf q}}</math> defined above, respectively.
</span>


<span id="gw0">
<span id="gw0">
Line 123: Line 121:
</span>
</span>


but keeping <math>W</math> and the orbitals <math>\phi^{(0)}_{n{\bf q}}</math> fixed to the initial DFT level. This method goes back to Hybertsen and Louie<ref name="HybertsenLouie"/> and can be achieved in two ways.  
but keeping <math>W</math> and the orbitals <math>\phi^{(0)}_{n{\bf q}}</math> fixed to the initial DFT level. This method goes back to Hybertsen and Louie {{cite|hybertsen:prb:1986}} and can be achieved in two ways.  
 
If the spectral method is not selected ({{TAG|LSPECTRAL}}=.FALSE., requiring much more compute time), the quasi-particle (QP) shifts are iterated automatically four times, and one finds four sets of QP shifts in the {{FILE|OUTCAR}} file. The first one corresponds to the G<sub>0</sub>W<sub>0</sub> case. The {{FILE|INCAR}} file is simply:


If the spectral method is not selected ({{TAG|LSPECTRAL}}=.FALSE., requiring much more compute time), the quasiparticle (QP) shifts are iterated automatically four times, and one finds four sets of QP shifts in the {{FILE|OUTCAR}} file. The first one corresponds to the G<sub>0</sub>W<sub>0</sub> case. The {{FILE|INCAR}} file is simply:
  {{TAGBL|System}} = SiC
  {{TAGBL|System}} = SiC
  {{TAGBL|NBANDS}} = 512
  {{TAGBL|NBANDS}} = 512
Line 132: Line 129:
  {{TAGBL|ALGO}} = EVGW0 ! use "GW0" in VASP.5.X
  {{TAGBL|ALGO}} = EVGW0 ! use "GW0" in VASP.5.X
  {{TAGBL|LSPECTRAL}} =.FALSE.
  {{TAGBL|LSPECTRAL}} =.FALSE.
{{NB|tip|In self-consistent GW calculations, convergence with the number of updated bands {{TAG|NBANDSGW}} must be checked carefully.}}


For technical reasons, it is not possible to iterate <math>G</math> in this manner if {{TAG|LSPECTRAL}}=.TRUE. is set in the {{FILE|INCAR}} file (this is the default). In this case, an iteration number must be supplied in the {{FILE|INCAR}} file using the {{TAG|NELM}}-tag. Usually three to four iterations are sufficient to obtain accurate QP shifts.
For technical reasons, it is not possible to iterate <math>G</math> in this manner if {{TAG|LSPECTRAL}}=.TRUE. is set in the {{FILE|INCAR}} file (this is the default). In this case, an iteration number must be supplied in the {{FILE|INCAR}} file using the {{TAG|NELMGW}} tag. Usually, three to four iterations are sufficient to obtain accurate QP shifts.
 
  {{TAGBL|System}} = SiC
  {{TAGBL|System}} = SiC
  {{TAGBL|NBANDS}} = 512
  {{TAGBL|NBANDS}} = 512
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|ALGO}} = EVGW0 ! use "GW0" in VASP.5.X
  {{TAGBL|ALGO}} = EVGW0 ! use "GW0" in VASP.5.X
  {{TAGBL|NELM}} = 4
  {{TAGBL|NELMGW}} = 4 ! use NELM in VASP.6.2 and older
</span>
</span>


The results are found again in the {{TAGBL|OUTCAR}} file
The results are found again in the {{TAGBL|OUTCAR}} file
  QP shifts <psi_nk| G(iteration)W_0 |psi_nk>: iteration 4
  QP shifts <psi_nk| G(iteration)W_0 |psi_nk>: iteration 4
   
   
Line 156: Line 152:
       6      -0.6957      -0.7006    -13.6827      12.9802    -18.1531      0.7264      2.0000      0.2769
       6      -0.6957      -0.7006    -13.6827      12.9802    -18.1531      0.7264      2.0000      0.2769
       7      -0.6957      -0.7006    -13.6827      12.9802    -18.1531      0.7264      2.0000      0.2769
       7      -0.6957      -0.7006    -13.6827      12.9802    -18.1531      0.7264      2.0000      0.2769
 
In contrast to single shot GW calculations, the second column represent now the QP-energies from the previous iteration.   
In contrast to single shot GW calculations, the second column represent now the QP-energies form previous iteration.   
<span id="qpgw0">
<span id="qpgw0">


== Partially self-consistent quasi-particle calculations: QPGW<sub>0</sub> ==  
== Partially self-consistent quasiparticle calculations: QPGW<sub>0</sub> ==  
If non diagonal components of the self-energy (in the orbital basis) should be included use {{TAG|ALGO}}=QPGW0. The following setting can be used:
If non diagonal components of the self-energy (in the orbital basis) should be included use {{TAG|ALGO}}=QPGW0. The following setting can be used:
  {{TAGBL|System}} = SiC
  {{TAGBL|System}} = SiC
  {{TAGBL|NBANDS}} = 512
  {{TAGBL|NBANDS}} = 512
Line 168: Line 162:
  {{TAGBL|ALGO}} = QPGW0 ! or "scGW0" for VASP.5.2.11 and older  
  {{TAGBL|ALGO}} = QPGW0 ! or "scGW0" for VASP.5.2.11 and older  
  {{TAGBL|LOPTICS}} = .TRUE. ; {{TAGBL|LPEAD}} = .TRUE. ! ommit this lines for metals
  {{TAGBL|LOPTICS}} = .TRUE. ; {{TAGBL|LPEAD}} = .TRUE. ! ommit this lines for metals
  {{TAGBL|NELM}} = 4
  {{TAGBL|NELMGW}} = 4 ! use NELM for VASP.6.2 and older
 
In this case, the orbitals are updated as well by constructing a hermitian (energy independent) approximation to the self-energy {{cite|shishkin:prl:2007}}. The "static" COHSEX approximation can be selected by setting {{TAG|NOMEGA}} = 1 {{cite|bruneval:prb:06}}. To improve convergence to the ground-state, the charge density (and the charge density only) is mixed using a Kerker type mixing in VASP.5.3.2 and more recent versions (see {{TAG|IMIX}}). The mixing parameters {{TAG|AMIX}}, {{TAG|BMIX}}, {{TAG|AMIX_MAG}}, {{TAG|BMIX_MAG}}, {{TAG|AMIN}} can be adjusted, if convergence problems are encountered.
In this case, the orbitals are updated as well by constructing a hermitian (energy independent) approximation to the self-energy.<ref name="shishkin:prl:07"/> The "static" COHSEX approximation can be selected by setting {{TAG|NOMEGA}} = 1.<ref name="bruneval:prb:06"/> To improve convergence to the groundstate, the charge density (and the charge density only) is mixed using a Kerker type mixing in VASP.5.3.2 and more recent versions (see {{TAG|IMIX}}). The mixing parameters {{TAG|AMIX}}, {{TAG|BMIX}}, {{TAG|AMIX_MAG}}, {{TAG|BMIX_MAG}}, {{TAG|AMIN}} can be adjusted, if convergence problems are encountered.
We strongly urge the user to monitor convergence by inspecting the lines <pre>charge density residual</pre> in the {{FILE|OUTCAR}} files.
We strongly urge the user to monitor convergence by inspecting the lines <pre>charge density residual</pre> in the {{FILE|OUTCAR}} files.


Alternatively the mixing may be switched off by setting {{TAG|IMIX}}=0 and controlling the step width for the orbitals using the parameter {{TAG|TIME}} (which defaults to 0.4). This selects a fairly sophisticated damped MD algorithm, that is also used for DFT methods when {{TAG|ALGO}}=Damped. In general, this method is more reliable for metals and materials with strong charge sloshing.
Alternatively, the mixing may be switched off by setting {{TAG|IMIX}}=0 and controlling the step width for the orbitals using the parameter {{TAG|TIME}} (which defaults to 0.4). This selects a fairly sophisticated damped MD algorithm that is also used for DFT methods when {{TAG|ALGO}}=Damped. This method is generally more reliable for metals and materials with strong charge sloshing.


After every iteration VASP writes following lines into the {{TAG|OUTCAR}} file
After every iteration, VASP writes the following lines into the {{TAG|OUTCAR}} file
QP shifts <psi_nk| G(iteration)W_0 |psi_nk>: iteration 1
    GWSYM:  cpu time  15.8978: real time  15.9528
   
   
  k-point  1 :      0.0000    0.0000    0.0000
  k-point  1 :      0.0000    0.0000    0.0000
   band No. DFT-energies  QP-energies  QP-e(diag)  sigma(DFT)    Z            occupation
   band No. DFT-energies  QP-energies  QP-e(diag)  sigma(DFT)    Z            occupation
   
   
       1      -6.4074     -6.9604     -6.9316     -7.0758       0.7843       2.0000
       1      -7.1626     -8.4217     -8.3038     -8.9978       0.6219       2.0000
       2       5.5804      5.1885      5.1918      5.0683       0.7589       2.0000
       2     -2.0899      -3.4394      -3.4347      -3.5765       0.9047       2.0000
       3       5.5804      5.1885      5.1918      5.0683       0.7589       2.0000
       3     -2.0899      -3.4394      -3.4347      -3.5765       0.9047       2.0000
       4       5.5804      5.1885      5.1918      5.0683       0.7589       2.0000
       4     -2.0899      -3.4394      -3.4347      -3.5765       0.9047       2.0000
       5      8.1035      8.3022      8.3477      8.4313       0.7449       0.0000
       5      0.4604      -0.4787      -0.4663      -0.7800       0.7471       2.0000
       6      8.1035      8.3022      8.3477      8.4313       0.7449       0.0000
       6      0.4604      -0.4787      -0.4663      -0.7800       0.7471       2.0000
       7      8.1035      8.3022      8.3477      8.4313       0.7449       0.0000
       7      0.4604      -0.4787      -0.4663      -0.7800       0.7471       2.0000
       8      8.9494       9.3052       9.3129       9.4313       0.7543       0.0000
       8      5.1013       4.1883       4.2149       3.9518       0.7711       2.0000
 
For the first iteration, here, the fourth column should be identical to the third column of the G<sub>0</sub>W<sub>0</sub> results discussed above. The third column reports the quasiparticle energies obtained from including the off-diagonal matrix elements in the eigenvalue equation.  
For the first iteration, here the forth column should be identical to the third column of the G<sub>0</sub>W<sub>0</sub> results discussed above, while the third column reports the quasi-particle energies obtained from including the off-diagonal matrix elements in the eigenvalue equation.  


=== Caveats ===
=== Caveats ===
The ''QPGW0'' (or ''scGW0'' in VASP.5.2.11 and older) must be used with great caution, in particular, in combination with symmetry.
The ''QPGW0'' (or ''scGW0'' in VASP.5.2.11 and older) must be used with great caution, particularly in combination with symmetry.
Symmetry is handled in a rather sophisticated manner, specifically, only the minimal number of required combination of ''q'' and ''k'' points is considered. In this case, symmetry must be applied to restore the full star of ''q''. This is done by determining degenerate eigenvalue/eigenvector pairs and restoring their symmetry according to their irreducible representation. Although the procedure is generally rather reliable, it fails to work properly if the degenerate states do not posses eigenvalues that are sufficiently close, due to insufficient convergence in the preceding DFT calculations. States are treated as degenerate if, and only if, their eigenenergies are within 0.01 eV.
Symmetry is handled in a rather sophisticated manner. Specifically, only the minimal number of required combinations of ''q'' and ''k'' points is considered. In this case, symmetry must be applied to restore the full star of ''q''. This is done by determining degenerate eigenvalue/eigenvector pairs and restoring their symmetry according to their irreducible representation. Although the procedure is generally relatively reliable, it fails to work properly if the degenerate states do not possess eigenvalues that are sufficiently close due to insufficient convergence in the preceding DFT calculations. That is because states are treated as degenerate if, and only if, their eigenenergies are within 0.01 eV.


For large supercells with low symmetry, we strongly recommend to switch off symmetry.
For large supercells with low symmetry, we strongly recommend switching off symmetry.
</span>
</span>


Line 202: Line 196:
== Self-consistent EVGW and QPGW calculations ==
== Self-consistent EVGW and QPGW calculations ==
Self-consistent ''QPGW'' calculations are only supported in a QP picture. As for ''QPGW''<sub>0</sub>, it is possible to update the eigenvalues only ({{TAG|ALGO}}=''EVGW'' or ''GW'' for VASP.5.X), or the eigenvalues and one-electron orbitals ({{TAG|ALGO}}=''QPGW'' or ''scGW'' in VASP.5.2.11 and older). In all cases, a QP picture is maintained, ''i.e.'', satellite peaks (shake ups and shake downs) can not be accounted for in the self-consistency cycle. Self-consistent ''QPGW'' calculations can be performed by simply repeatedly calling VASP using:
Self-consistent ''QPGW'' calculations are only supported in a QP picture. As for ''QPGW''<sub>0</sub>, it is possible to update the eigenvalues only ({{TAG|ALGO}}=''EVGW'' or ''GW'' for VASP.5.X), or the eigenvalues and one-electron orbitals ({{TAG|ALGO}}=''QPGW'' or ''scGW'' in VASP.5.2.11 and older). In all cases, a QP picture is maintained, ''i.e.'', satellite peaks (shake ups and shake downs) can not be accounted for in the self-consistency cycle. Self-consistent ''QPGW'' calculations can be performed by simply repeatedly calling VASP using:
  {{TAGBL|System}} = SiC
  {{TAGBL|System}} = SiC
  {{TAGBL|NBANDS}} = 512
  {{TAGBL|NBANDS}} = 512
Line 208: Line 201:
  {{TAGBL|ALGO}} = EVGW    ! "GW" in VASP.5.X, eigenvalues only  or alternatively
  {{TAGBL|ALGO}} = EVGW    ! "GW" in VASP.5.X, eigenvalues only  or alternatively
  {{TAGBL|ALGO}} = QPGW    ! "scGW" in VASP.5.2.11 and older, eigenvalues and one electron orbitals
  {{TAGBL|ALGO}} = QPGW    ! "scGW" in VASP.5.2.11 and older, eigenvalues and one electron orbitals
For QPGW0 or QPGW, nondiagonal terms in the Hamiltonian are accounted for, ''e.g.'' the linearized QP equation is diagonalized, and the one-electron orbitals are updated {{cite|shishkin:prl:2007}}.
For QPGW0 or QPGW non diagonal terms in the Hamiltonian are accounted for, ''e.g.'' the linearized QP equation is diagonalized, and the one electron orbitals are updated.<ref name="shishkin:prl:07"/>
Alternatively (and preferably), the user can specify an electronic iteration counter using {{TAG|NELMGW}} ({{TAG|NELM}} in VASP.6.2 and older):
Alternatively (and preferably), the user can specify an electronic iteration counter using {{TAG|NELM}}:
 
  {{TAGBL|System}} = SiC
  {{TAGBL|System}} = SiC
  {{TAGBL|NBANDS}} = 512
  {{TAGBL|NBANDS}} = 512
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|NELM}} = 3
  {{TAGBL|NELMGW}} = 3   ! use NELM in VASP.6.2 and older
  {{TAGBL|ALGO}} = EVGW  ! "GW" in VASP.5.X  
  {{TAGBL|ALGO}} = EVGW  ! "GW" in VASP.5.X  
  # or   
  # or   
  {{TAGBL|ALGO}} = QPGW  ! "scGW" in VASP.5.2.11 and older
  {{TAGBL|ALGO}} = QPGW  ! "scGW" in VASP.5.2.11 and older
In this case, the one-electron energies (=QP energies) are updated 3 times (starting from the DFT eigenvalues) in both G and W. For {{TAG|ALGO}}=''QPGW'' (or {{TAG|ALGO}}=''scGW'' in VASP.5.2.11 and older), the one electron energies and one electron orbitals are updated 3 times {{cite|shishkin:prl:2007}}. As for {{TAG|ALGO}} = ''QPGW0'' (or ''scGW0'' in vasp.5.2.11 and older), the "static" COHSEX approximation can be selected by setting {{TAG|NOMEGA}}=1 {{cite|bruneval:prb:06}}.


In this case, the one-electron energies (=QP energies) are updated 3 times (starting from the DFT eigenvalues) in both G and W. For {{TAG|ALGO}}=''QPGW'' (or {{TAG|ALGO}}=''scGW'' in VASP.5.2.11 and older), the one electron energies and one electron orbitals are updated 3 times.<ref name="shishkin:prl:07"/> As for {{TAG|ALGO}} = ''QPGW0'' (or ''scGW0'' in vasp.5.2.11 and older), the "static" COHSEX approximation can be selected by setting {{TAG|NOMEGA}}=1.<ref name="bruneval:prb:06"/>
To improve convergence to the ground-state, the charge density is mixed using a Kerker type mixing starting with VASP.5.3.2 (see {{TAG|IMIX}}). The mixing parameters {{TAG|AMIX}}, {{TAG|BMIX}}, {{TAG|AMIX_MAG}}, {{TAG|BMIX_MAG}}, {{TAG|AMIN}} can be adjusted, if convergence problems are encountered.
 
Alternatively, the mixing may be switched off by setting {{TAG|IMIX}}=0 and controlling the step width for the orbitals using the parameter {{TAG|TIME}} (which defaults to 0.4). This selects a fairly sophisticated damped MD algorithm that is also used for DFT methods when {{TAG|ALGO}}=Damped. This method is generally more reliable for metals and materials with strong charge sloshing.
To improve convergence to the groundstate, the charge density is mixed using a Kerker type mixing starting with VASP.5.3.2 (see {{TAG|IMIX}}). The mixing parameters {{TAG|AMIX}}, {{TAG|BMIX}}, {{TAG|AMIX_MAG}}, {{TAG|BMIX_MAG}}, {{TAG|AMIN}} can be adjusted, if convergence problems are encountered.
Alternatively the mixing may be switched off by setting {{TAG|IMIX}}=0 and controlling the step width for the orbitals using the parameter {{TAG|TIME}} (which defaults to 0.4). This selects a fairly sophisticated damped MD algorithm, that is also used for DFT methods when {{TAG|ALGO}}=Damped. In general, this method is more reliable for metals and materials with strong charge sloshing.


Additional information about this method is found [[The GW approximation of Hedin's equations#GWLimitations|here]].
Additional information about this method is found [[The GW approximation of Hedin's equations#GWLimitations|here]].


=== Caveats ===
=== Caveats ===
Fully self-consistent QPGW calculations with an update of the orbitals in <math>G</math> and <math>W</math><ref name="shishkin:prl:07"/> require significant care and are prone to diverge (QPGW0 calculations are usually less critical). As discussed, above, one can select this mode using:
Fully self-consistent QPGW calculations with an update of the orbitals in <math>G</math> and <math>W</math>{{cite|shishkin:prl:2007}} require significant care and are prone to diverge (QPGW0 calculations are usually less critical). As discussed, above, one can select this mode using:
 
  {{TAGBL|System}} = SiC
  {{TAGBL|System}} = SiC
  {{TAGBL|NBANDS}} = 512
  {{TAGBL|NBANDS}} = 512
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|ALGO}} = QPGW  ! or "scGW" in VASP.5.2.11 and older, eigenvalues and one-electron orbitals
  {{TAGBL|ALGO}} = QPGW  ! or "scGW" in VASP.5.2.11 and older, eigenvalues and one-electron orbitals
  {{TAGBL|NELM}} = number of steps
  {{TAGBL|NELMGW}} = number of steps ! use NELM for VASP.6.2 and older
 
However, one ''caveat'' applies to this case: when the orbitals are updated, the derivatives of the orbitals with respect to <math>k</math> (stored in the {{FILE|WAVEDER}} file) will become incompatible with the orbitals.
However, one ''caveat'' applies to this case: when the orbitals are updated, the derivatives of the orbitals with respect to <math>k</math> (stored in the {{FILE|WAVEDER}} file) will become incompatible with the orbitals.
This can cause severe problems and convergence to the incorrect solution. For metals, we recommend to avoid using the {{FILE|WAVEDER}} file alltogether ({{TAG|LOPTICS}}=.TRUE. should not be used in the preparatory DFT runs).
This can cause severe problems and convergence to the incorrect solution.  
{{NB|warning|For metals, in general, we recommend omitting the {{TAG|LOPTICS}} tag and removing the {{FILE|WAVEDER}} file from the directory.}}


For insulators, VASP (version 5.3.2 or higher) can update the {{FILE|WAVEDER}} file in each electronic iteration if the finite difference method is used to calculate the first derivative of the orbitals with respect to <math> k </math>:
For insulators, VASP (version 5.3.2 or higher) can update the {{FILE|WAVEDER}} file in each electronic iteration if the finite difference method is used to calculate the first derivative of the orbitals with respect to <math> k </math>:
  {{TAGBL|System}} = SiC
  {{TAGBL|System}} = SiC
  {{TAGBL|NBANDS}} = 512
  {{TAGBL|NBANDS}} = 512
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|ALGO}} = QPGW ! "scGW" in VASP.5.2.11 and older, eigenvalues and one-electron orbitals
  {{TAGBL|ALGO}} = QPGW ! "scGW" in VASP.5.2.11 and older, eigenvalues and one-electron orbitals
  {{TAGBL|NELM}}  = 10
  {{TAGBL|NELMGW}}  = 10 ! use NELM in VASP.6.2 and older
  {{TAGBL|LOPTICS}} = .TRUE. ; {{TAGBL|LPEAD}} = .TRUE.
  {{TAGBL|LOPTICS}} = .TRUE. ; {{TAGBL|LPEAD}} = .TRUE.
The combination <tt>{{TAG|LOPTICS}}=.TRUE.; {{TAG|LPEAD}}=.TRUE.</tt> is required since <math>\frac{\delta H-\epsilon_{n{\bf k}}S}{\delta {k}_i}</math> is not available for ''GW'' like methods.
The combination <tt>{{TAG|LOPTICS}}=.TRUE.; {{TAG|LPEAD}}=.TRUE.</tt> is required since <math>\frac{\delta H-\epsilon_{n{\bf k}}S}{\delta {k}_i}</math> is not available for ''GW'' like methods.
{{TAG|LPEAD}}=.TRUE. circumvents this problems by calculating the derivatives of the orbitals using numerical differentiation on the finite k-point grid (this option is presently limited to insulators).
{{TAG|LPEAD}}=.TRUE. circumvents this problem by calculating the derivatives of the orbitals using numerical differentiation on the finite k-point grid (this option is presently limited to insulators).


Vertex corrections are presently not documented. This is a feature still under construction, and we recommend to collaborate with the Vienna group if you are desperately in need of that feature.
Vertex corrections are presently not documented. This is a feature still under construction, and we recommend collaborating with the Vienna group if you desperately need that feature.
</span>
</span>


<span id="LowGW">
<span id="LowGW">
= Low scaling GW algorithms =
= Low scaling GW algorithms =
</span>
The GW implementations in VASP described in the papers of Shishkin ''et al.''{{cite|shishkin:prb:2006}} {{cite|shishkin:prb:2007}} avoids storage of the Green's function <math>G</math> as well as Fourier transformations between time and frequency domain entirely. That is, all calculations are performed solely on the real frequency axis using Kramers-Kronig transformations for convolutions in the equation of <math>\chi</math> and <math>\Sigma</math> in reciprocal space.


The GW implementations in VASP described in the papers of Shishkin ''et al.''<ref name="shishkin-PRB74"/><ref name="shishkin-PRB75"/> avoids storage of the Green's function <math>G</math> as well as Fourier transformations between time and frequency domain entirely. That is, all calculations are performed solely on the real frequency axis using Kramers-Kronig transformations for convolutions in the equation of <math>\chi</math> and <math>\Sigma</math> in reciprocal space.
As of VASP.6 a new cubic scaling GW algorithm {{cite|liu:prb:2016}} (called space-time implementation in the following) can be selected. This approach follows the idea of Rojas ''et al.'' {{cite|rojas:prl:1995}} and performs the GW self-consistency cycle on imaginary time <math>t\to i\tau</math> and imaginary frequency axes <math>\omega\to i\omega</math>.  
 
{{NB|tip|Using the low-scaling GW algorithm also calculates the total energy in the Random Phase approximation (RPA), which is described in a [[ACFDT/RPA calculations#ACFDTR/RPAR|separate article]].}}
As of VASP.6 a new cubic scaling GW algorithm<ref name="liu"/> (called space-time implementation in the following) can be selected. This approach follows the idea of Rojas ''et al.''<ref name="rojas"/> and performs the GW self-consistency cycle on imaginary time <math>t\to i\tau</math> and imaginary frequency axes <math>\omega\to i\omega</math>.  


<span id="G0W0R">
<span id="G0W0R">
== Low scaling, single shot GW calculations: G0W0R==
== Low scaling, single shot GW calculations: G<sub>0</sub>W<sub>0</sub>R==
The low-scaling analogue of G<sub>0</sub>W<sub>0</sub> is selected with {{TAGBL|ALGO}}=G0W0R.  
The low-scaling analogue of G<sub>0</sub>W<sub>0</sub> is selected with {{TAGBL|ALGO}}=G0W0R.  
In contrast to the [[GW calculations#G0W0|single-shot GW calculations on the real-axes]],  
In contrast to the [[GW calculations#G0W0|single-shot GW calculations on the real-axes]],  
Line 271: Line 258:


This algorithm evaluates:
This algorithm evaluates:
* Single-shot GW quasi-particle energies (from an analytical continuation of the self-energy to the real axis)<ref name="liu"/>
* Single-shot GW quasiparticle energies (from an analytical continuation of the self-energy to the real axis){{cite|liu:prb:2016}}
 
* Natural orbitals from the first order change of the density matrix (i.e. <math>G_0 \Sigma G_0</math>), see the {{TAG|NATURALO}} tag for more information.<ref name="ramberger">
 
'''N.B.''' This selection ignores {{TAG|NELM}}.


* Natural orbitals from the first order change of the density matrix (i.e. <math>G_0 \Sigma G_0</math>), see the {{TAG|NATURALO}} tag for more information {{cite|ramberger:jcp:2019}}.
{{NB|mind|This selection ignores {{TAG|NELMGW}}.}}
Following {{TAGBL|INCAR}} file selects the low-scaling GW algorithm:
Following {{TAGBL|INCAR}} file selects the low-scaling GW algorithm:
  {{TAGBL|System}} = SiC
  {{TAGBL|System}} = SiC
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
Line 284: Line 268:
  {{TAGBL|ALGO}} = G0W0R
  {{TAGBL|ALGO}} = G0W0R
  {{TAGBL|NOMEGA}} = 12 ! small number of frequencies necessary
  {{TAGBL|NOMEGA}} = 12 ! small number of frequencies necessary
Search the {{TAGBL|OUTCAR}} file for the following lines
Search the {{TAGBL|OUTCAR}} file for following lines
 
   QP shifts evaluated in KS or natural orbital/ Bruckner basis
   QP shifts evaluated in KS or natural orbital/ Bruckner basis
   k-point  1 :      0.0000    0.0000    0.0000
   k-point  1 :      0.0000    0.0000    0.0000
Line 297: Line 279:
         5      0.4603      -0.8219      -0.4904      0.7414      -0.4814      0.7273      2.0000      -0.1902      0.0000  2
         5      0.4603      -0.8219      -0.4904      0.7414      -0.4814      0.7273      2.0000      -0.1902      0.0000  2
         6      0.4603      -0.8219      -0.4904      0.7414      -0.4814      0.7273      2.0000      -0.1902      -0.0000  2
         6      0.4603      -0.8219      -0.4904      0.7414      -0.4814      0.7273      2.0000      -0.1902      -0.0000  2
Here column four is obtained by a linearization of the self-energy around the Kohn-Sham energies (second column) and can be compared to the third column of [[GW calculations#G0W0|single-shot GW calculations on the real axis]].
Here column four is obtained by a linearization of the self-energy around the Kohn-Sham energies (second column) and can be compared to the third column of [[GW calculations#G0W0|single-shot GW calculations on the real axis]].
Column six represents an other set of QP-energies that is obtained from the roots of following equation
Column six represents another set of QP-energies that is obtained from the roots of the following equation


<math>
<math>
Line 306: Line 287:


These roots represent the poles of the Green's function in the spectral representation.  
These roots represent the poles of the Green's function in the spectral representation.  
</span>


<span id="QPR">
<span id=OutputGW>
=== Output description ===
The meaning of each column is explained briefly in the following.


== Low scaling, self-consistent quasi-particle calculations: QPGW0R ==
* <code>band No.</code> the band index of KS orbital at given k-point
If quasi-particle calculations are performed, the self-energy is transformed to reciprocal space in combination with a Pade approximation and the quasi-particle eigenvalue problem is solved.<ref name="liu"/> The previously discussed self-consistent quasi-particle GW approximations (QPGW[0]) can be performed within this formalism by adding an additional ''R'' to the {{TAG|ALGO}} option, ''e.g.'' single-shot GW calculations or partially self-consistent quasi-particle energies can be selected via the following lines
* <code>KS-energies</code> eigenenergies corresponding to band index
* <code>sigma(KS)</code> diagonal matrix elements of self-energy evaluated at KS energies
{{TAGBL|System}} = SiC
* <code>QP-e(linear)</code> quasiparticle energies obtained from linearizing frequency dependence of diagonal self-energy around KS energies
{{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
* <code>Z</code> renormalization factor obtained from five-point stencil for derivative of self-energy w.r.t. frequency
{{TAGBL|LOPTICS}} = .TRUE. ; {{TAGBL|LPEAD}} = .TRUE. 
* <code>QP-e(zeros)</code> quasiparticle energies obtained from full frequency dependence of self-energy, i.e. real part of complex pole <math>\omega</math> of Green's function
{{TAGBL|NELM}} = number of iterations wanted ! set 1 for G0W0
* <code>Z</code> renormalization factor obtained from central difference for derivative of self-energy w.r.t. frequency
{{TAGBL|ALGO}} = QPGW0R
* <code>occupation</code> occupation number for band at given k-point
{{TAGBL|NOMEGA}} = 12 ! small number of frequencies necessary
* <code>Imag(E_QP)</code> imaginary part of complex pole <math>\omega</math>, i.e. measure for inverse lifetime of quasi-particle
* <code>QP_DIFF</code> difference of QP energies (of linearized self-energy) obtained from Eq. 77 of Liu et. al.{{cite|liu:prb:2016}} and M. Grumets thesis{{cite|grumet:thesis:2017}}.
</span>
</span>


Note, that a preceding DFT calculation is not necessary with this setting, but required if one wants to start from a hybrid functional calculation. Due to the analytical continuation of the self-energy small deviations in the quasi-particle energies and orbitals can be expected. however, deviations of the QP energies around the Fermi energy are usually smaller than 0.05 eV.<ref name="liu"/>
<span id=RPAFORCES>


After a successful run, VASP writes the following lines into the {{TAG|OUTCAR}} file
== Optional: RPA Forces ==
 
Optionally, RPA forces can be calculated by adding following line to the {{TAGBL|INCAR}}:
  QP shifts evaluated in KS or natural orbital/ Bruckner basis
  {{TAGBL|LRPAFORCE}} = .TRUE.
  k-point  1 :       0.0000    0.0000    0.0000
After the QP-energies, VASP performs a linear-response calculation that is required for the RPA forces.{{cite|ramberger:prl:118}}
band NoKS-energies  sigma(KS)    QP-e(linear)    Z        QP-e(zeros)     Z        occupation    Imag(E_QP)    QP_DIFF
Following data block in the {{TAGBL|OUTCAR}} file can be found after a successful run:
  POSITION                                      TOTAL RPA FORCE (eV/Angst)
  -----------------------------------------------------------------------------------
       0.17542    -0.22348      0.17542        -0.292069      7.581315    -0.292069
      1.12850      1.31044      1.12850        0.304683    -7.605527      0.304683
  -----------------------------------------------------------------------------------
    total drift:                                0.012614     -0.024212      0.012614
   
   
      1      -6.4074      -6.8617      -6.7178      0.6832      -6.7168      0.6789      2.0000      -1.1944      0.0058
SUGGESTED UPDATED POSCAR (direct coordinates)  step
      2      5.5804      5.0902      5.2064      0.7629      5.2073      0.7591      2.0000      0.0001      0.0018
-----------------------------------------------------------------------------------
      3      5.5804      5.0894      5.2058      0.7629      5.2067      0.7591      2.0000      0.0001      0.0018
  -0.00958461  -0.00958461  0.13485779        0.04179056  0.04179056  0.00283088
      4      5.5804      5.0893      5.2057      0.7629      5.2066      0.7591      2.0000      0.0001      0.0018
  0.25787833  0.25787833  0.22191754        -0.04337198  -0.04337198  0.00431513
      5      8.1035      8.4039      8.3336      0.7660      8.3332      0.7632      0.0000      -0.0190      0.0031
{{NB|warning|Currently RPA forces for metallic systems are not supported.}}
      6      8.1035      8.4026      8.3326      0.7660      8.3322      0.7632      0.0000      -0.0192      0.0034
      7      8.1035      8.4023      8.3324      0.7660      8.3320      0.7632      0.0000      -0.0192      0.0035
      8      8.9494      9.4257      9.3101      0.7574      9.3089      0.7524      0.0000      -0.0410      0.0145
 
Here column four is obtained by a linearization of the self-energy around the energies from previous step and has the same meaning as the forth column in {{TAG|ALGO}}=''QPGW0'' calculations, while column six is obtained from the roots of following equation
 
<math>
\langle \phi^{(0)}_{n{\bf q}}| T+V_{ext}+V_h+\Sigma(\omega) | \phi^{(0)}_{n{\bf q}}\rangle -\omega =0
</math>
 
These roots represent the poles of the Green's function in the spectral representation.
</span>
</span>
 
<span id="EVGW0R">
<span id="QPGWR">
== Low scaling, partially self-consistent GW calculations: EVGW<sub>0</sub>R==
 
{{NB|mind|available as of vasp 6.4.0}}
== Low scaling, fully self-consistent quasi-particle calculations: QPGWR ==
The low-scaling analogue of EVGW<sub>0</sub> is selected with {{TAGBL|ALGO}}=EVGW0R.
Similarly, low scaling self-consistent quasi-particle calculations can be chosen where the screened potential is updated as well
Following {{TAGBL|INCAR}} file selects this algorithm:
 
  {{TAGBL|System}} = SiC
  {{TAGBL|System}} = SiC
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|LOPTICS}} = .TRUE. ; {{TAGBL|LPEAD}} = .TRUE.   
  {{TAGBL|LOPTICS}} = .TRUE.   
  {{TAGBL|NELM}} = number of iterations wanted
  {{TAGBL|ALGO}} = EVGW0R
  {{TAGBL|ALGO}} = QPGWR ! update W during self-consistency cycle as well
  {{TAGBL|NELMGW}} = ! number of iterations in G
  {{TAGBL|NOMEGA}} = 12 ! small number of frequencies necessary
  {{TAGBL|NOMEGA}} = 12 ! small number of frequencies necessary
 
After each iteration, a similar block of data as for {{TAG|ALGO}}=G0W0R calculations is written to {{FILE|OUTCAR}} showing the {{TAG|NBANDSGW}} updated quasi-particle energies (poles) of the Green's function.  
Here the same caveats can be expected as for {{TAG|ALGO}}=''EVGW'' and ''QPGW''. As for {{TAG|ALGO}}=''EVGW'' and ''QPGW'', we suggest to leave out the {{TAG|LOPTICS}} and {{TAG|LPEAD}} line for metals.  Additional information about this method is found [[The GW approximation of Hedin's equations#GWLimitations|here]].
</span>
</span>
<span id="scGW0R">
<span id="scGW0R">
 
== Partially self-consistent GW calculations: GW<sub>0</sub>R ==
== Partially self-consistent GW caluclations: GW0R or scGW0R ==
The space-time implementation allows for true self-consistent GW calculations. That is, the solution of the Dyson equation for the Green's function can be obtained with a modest computational effort. The main procedure of a self-consistent GW calculation consists of four main steps
The space-time implementation allows for true self-consistent GW calculations. That is, the solution of the Dyson equation for the Green's function can be obtained with a modest computational effort. The main procedure of a self-consistent GW calculation consists of four main steps
   
   
Line 372: Line 348:


This procedure can be selected with the following {{TAG|INCAR}} settings
This procedure can be selected with the following {{TAG|INCAR}} settings
  {{TAGBL|System}} = SiC
  {{TAGBL|System}} = SiC
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|LOPTICS}} = .TRUE. ; {{TAGBL|LPEAD}} = .TRUE.   
  {{TAGBL|LOPTICS}} = .TRUE. ; {{TAGBL|LPEAD}} = .TRUE.   
  {{TAGBL|NELM}} = number of iterations wanted
  {{TAGBL|NELMGW}} = number of iterations wanted ! NELM in 6.2 and older
  {{TAGBL|ALGO}} = GW0R ! ALGO = scGW0R has the same effect here, that is self-consistency in G, no update in W
  {{TAGBL|ALGO}} = GW0R ! ALGO = scGW0R has the same effect here, that is self-consistency in G, no update in W
 
The number of self-consistency steps can be set with the {{TAG|NELMGW}} tag.
The number of self-consistency steps can be set with the {{TAG|NELM}} tag and usually 4 cycles suffice to reach self-consistency.  
 
After each cycle VASP writes the following lines in to the {{TAG|OUTCAR}} file  
Due to efficiency, VASP performs each step in the Hartree-Fock basis. This is the reason why there are two sets of QP-energies found after the first iteration (one for the QP-energies in the KS-basis and one for the QP energies in the HF basis)
After the second iteration, only the QP energies obtained in the HF basis are printed, and a similar output as follows is found in the {{TAG|OUTCAR}} file  


  QP shifts evaluated in KS or natural orbital/ Bruckner basis
  QP shifts evaluated in HF basis
  k-point  1 :      0.0000    0.0000    0.0000
  k-point  1 :      0.0000    0.0000    0.0000
  band No.  KS-energies  sigma(KS)    QP-e(linear)    Z        QP-e(zeros)    Z        occupation    Imag(E_QP)    QP_DIFF
  band No.  KS-energies  sigma(KS)    QP-e(linear)    Z        QP-e(zeros)    Z        occupation    Imag(E_QP)    QP_DIFF TAG
   
   
       1      -6.4074     -6.9582     -6.7744       0.6664     -6.7723       0.6584       2.0000      -0.7917       0.5691
       1      -7.1626     -8.6510     -8.2275       0.7154     -8.2173       0.7017       2.0000      -1.3177       0.0000  2
       2       5.5804      5.0717      5.1897       0.7680      5.1910       0.7629       2.0000      -0.0026       0.0062
       2     -2.0899      -3.4157      -3.0348       0.7127      -3.0269       0.7008       2.0000      -0.5614       0.0000  2
       3       5.5804      5.0710      5.1891       0.7680      5.1905       0.7629       2.0000      -0.0026      0.0062
       3     -2.0899      -3.4157      -3.0348       0.7127      -3.0269       0.7008       2.0000      -0.5614      -0.0000  2
       4       5.5804      5.0709      5.1891       0.7680      5.1904       0.7629       2.0000      -0.0026       0.0062
       4     -2.0899      -3.4157      -3.0348       0.7127      -3.0269       0.7008       2.0000      -0.5614       0.0000  2
       5      8.1035      8.3674      8.3042       0.7605      8.3038       0.7572       0.0000       0.0036       0.0129
       5      0.4604      -0.8170      -0.4857       0.7407      -0.4768       0.7266       2.0000     -0.1945       0.0000  2
       6      8.1035      8.3663      8.3033       0.7605      8.3029       0.7572       0.0000       0.0036      0.0129
       6      0.4604      -0.8170      -0.4857       0.7407      -0.4768       0.7266       2.0000     -0.1945      -0.0000  2
       7      8.1035      8.3661      8.3032       0.7605      8.3028       0.7572       0.0000       0.0036       0.0129
       7      0.4604      -0.8170      -0.4857       0.7407      -0.4768       0.7266       2.0000     -0.1945       0.0000  2
       8      8.9494       9.3762       9.2698       0.7508       9.2689       0.7465       0.0000      -0.0237       0.0076
       8      5.1013       4.0069       4.2594       0.7693       4.2645       0.7598       2.0000      -0.0602       0.0000  2
 
Here the meaning of each column is the same as for the other low-scaling GW algorithms.
Here the meaning of each column is the same as for QPGW0R.  
</span>
</span>


<span id="scGWR">
<span id="scGWR">
 
== Fully self-consistent GW caluclations: GWR ==
== Fully self-consistent GW caluclations: GWR or scGWR ==
If the screened potential should be updated during the self-consistency circle {{cite|grumet:prb:2018}} the following {{TAG|INCAR}} file can be used
If the screened potential should be updated during the self-consistency circle<ref name="grumet"/> the following {{TAG|INCAR}} file can be used
 
  {{TAGBL|System}} = SiC
  {{TAGBL|System}} = SiC
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|ISMEAR}} = 0 ; {{TAGBL|SIGMA}} = 0.05
  {{TAGBL|LOPTICS}} = .TRUE. ; {{TAGBL|LPEAD}} = .TRUE.   
  {{TAGBL|LOPTICS}} = .TRUE. ; {{TAGBL|LPEAD}} = .TRUE.   
  {{TAGBL|NELM}} = number of iterations wanted
  {{TAGBL|NELMGW}} = number of iterations wanted ! use NELM in VASP.6.2 and older
  {{TAGBL|ALGO}} = GWR ! ALGO = scGWR has the same effect here, that is self-consistency in G and W
  {{TAGBL|ALGO}} = GWR ! ALGO = scGWR has the same effect here, that is self-consistency in G and W
 
The output is similar to partially self-consistent GW calculations, with the difference that ''KS-energies'' are replaced by the QP energies from previous iteration.
</span>
</span>


=== Caveats ===  
=== Caveats ===  
Using this option, similar caveats can be expected as for {{TAG|ALGO}}=''EVGW'' and ''QPGW'' calculations and we recommend to leave out the {{TAG|LOPTICS}} and {{TAG|LPEAD}} line for metals.  
Using this option, similar caveats can be expected as for {{TAG|ALGO}}=''EVGW'' and ''QPGW'' calculations and we recommend to leave out the {{TAG|LOPTICS}} and {{TAG|LPEAD}} line for metals.  
{{:Memory requirements of low-scaling GW and RPA algorithms}}


== Related Tags and Sections ==
The cubic scaling space-time GW algorithm requires considerably more memory than the corresponding quartic-scaling implementations, two Green's functions <math>G({\bf r,r'},i\tau_n)</math> have to be stored in real-space. To reduce the memory overhead, VASP exploits Fast Fourier Transformations (FFT) to avoid storage of the matrices on the (larger) real space grid, on the one hand. The precision of the FFT can be selected with {{TAG|PRECFOCK}}, where usually the values ''Fast'' sufficient.
 
On the other hand, the code avoids storage of redundant information, i.e., both the Green's function and polarizability matrices are distributed as well as the individual imaginary grid points. The distribution of the imaginary grid points can be set by hand with the {{TAG|NTAUPAR}} and {{TAG|NOMEGAPAR}} tags, which splits the imaginary grid points {{TAG|NOMEGA}} into {{TAG|NTAUPAR}} time and {{TAG|NOMEGAPAR}} groups. For this purpose both tags have to be divisors of {{TAG|NOMEGA}}.
 
The default values are usually reasonable choices provided the tag {{TAG|MAXMEM}} is set correctly and we strongly recommend to set {{TAG|MAXMEM}} instead of {{TAG|NTAUPAR}}.
{{NB|important|As of version 6.2, {{TAGBL|MAXMEM}} is estimated automatically (if not set) from the "MemAvailable" entry of the Linux kernel in "/proc/meminfo".}}
 
The required storage for a low-scaling RPA or GW calculation depends mostly on {{TAG|NTAUPAR}}, the number of MPI groups that share same imaginary time points. A rough estimate for the required bytes is given by
 
(NGX*NGY*NGZ)*(NGX_S*NGY_S*NGZ_S) / ( NCPU  / {{TAGBL|NTAUPAR}} ) * 16
 
where "NCPU" is the number of MPI ranks used for the job,"NGX,NGY,NGZ" denotes the number of FFT grid points for the exact exchange and  "NGX_S,NGY_S,NGZ_S" the number of FFT grid points for the supercell. Note, both grids are written to the {{TAGBL|OUTCAR}} file after the lines
 
FFT grid for exact exchange (Hartree Fock)
FFT grid for supercell:
 
The smaller {{TAG|NTAUPAR}} is set, the less memory per node the job requires to finish successfully.
 
The approximate memory requirement is calculated in advance and printed to screen and {{TAGBL|OUTCAR}} as follows:
 
min. memory requirement per mpi rank 1234 MB, per node 9872 MB
 
= Related tags and articles =


* {{TAG|ALGO}} for response functions and ''GW'' calculations
* {{TAG|ALGO}} for response functions and ''GW'' calculations
Line 430: Line 424:
* {{TAG|ODDONLYGW}} and {{TAG|EVENONLYGW}}, reducing the ''k''-grid for the response functions
* {{TAG|ODDONLYGW}} and {{TAG|EVENONLYGW}}, reducing the ''k''-grid for the response functions
* {{TAG|LSELFENERGY}}, the frequency dependent self energy
* {{TAG|LSELFENERGY}}, the frequency dependent self energy
* {{TAG|LWAVE}}, selfconsistent ''GW''
* {{TAG|LWAVE}}, self-consistent ''GW''
* {{TAG|NOMEGAPAR}}, frequency grid parallelization
* {{TAG|NOMEGAPAR}}, frequency grid parallelization
* {{TAG|NTAUPAR}}, time grid parallelization
* {{TAG|NTAUPAR}}, time grid parallelization
* {{TAG|NATURALO}}, natural orbitals
* {{TAG|NATURALO}}, natural orbitals
* {{TAG|LALL_IN_ONE}}, all-in-one ''GW'' mode
* {{TAG|IALL_IN_ONE}}, all-in-one ''GW'' mode
* {{TAG|NBANDSEXACT}}, number of KS bands in all-in-one mode
* {{TAG|NBANDS_WAVE}}, number of bands written to {{FILE|WAVECAR}} in all-in-one mode
* {{TAG|LSINGLES}}, singles contribution to correlation energy
{{sc|GW calculations|Examples|Examples that use this tag}}
{{sc|GW calculations|Examples|Examples that use this tag}}


== References ==
= References =
<references>
 
<ref name="shishkin-PRB74">[http://link.aps.org/doi/10.1103/PhysRevB.74.035101 M. Shishkin and G. Kresse, Phys. Rev. B 74, 035101 (2006).]</ref>
 
<ref name="shishkin-PRB75">[http://link.aps.org/doi/10.1103/PhysRevB.75.235102 M. Shishkin and G. Kresse, Phys. Rev. B 75, 235102 (2007).]</ref>
[[Category:Many-body perturbation theory]][[Category:GW]][[Category:Howto]][[Category:Low-scaling GW and RPA]]
<ref name="shishkin:prl:07">[http://link.aps.org/doi/10.1103/PhysRevLett.99.246403 M. Shishkin, M. Marsman, and G. Kresse, Phys. Rev. Lett. 99, 246403 (2007).]</ref>
<ref name="fuchs-PRB76">[http://link.aps.org/doi/10.1103/PhysRevB.76.115109 F. Fuchs, J. Furthmüller, F. Bechstedt, M. Shishkin, and G. Kresse, Phys. Rev. B 76, 115109 (2007).]</ref>
<ref name="liu">[http://journals.aps.org/prb/abstract/10.1103/PhysRevB.94.165109 P. Liu, M. Kaltak, J. Klimes and G. Kresse, Phys. Rev. B 94, 165109 (2016).]</ref>
<ref name="rojas">[https://journals.aps.org/prl/abstract/10.1103/PhysRevLett.74.1827 H. N. Rojas, R. W. Godby, R. J. Needs, Phys. Rev. Lett. 74, 1827 (1995)]</ref>
<ref name="HybertsenLouie">[https://journals.aps.org/prb/abstract/10.1103/PhysRevB.34.5390 M. S. Hybertsen, S. G. Louie Phys. Ref. B 34, 5390 (1986)]</ref>
<ref name="bruneval:prb:06">[http://link.aps.org/doi/PhysRevB.74.45102 F. Bruneval, N. Vast, and L. Reining, Phys. Rev. B 74, 45102 (2006).]</ref>
<ref name="grumet">[https://journals.aps.org/prb/abstract/10.1103/PhysRevB.98.155143 M. Grumet, P. Liu, M. Kaltak, J. Klimeš and Georg Kresse, Phys. Ref. B 98, 155143 (2018). ]</ref>
<ref name="ramberger">[https://doi.org/10.1063/1.5128415 B. Ramberger, Z. Surkuma, T. Schäfer, G. Kresse, J. Chem. Phys. 151, 214106 (2019). ]</ref>
</references>
----
[[Category:Many-Body Perturbation Theory]][[Category:GW]][[Category:Howto]][[Category:VASP6]][[Category:Low-scaling GW and RPA]]

Latest revision as of 14:21, 18 October 2024

The GW approximation is an approximation to the self-energy. GW calculations are available as of VASP.5.X. For details on the implementation and use of the GW routines, we recommend the papers by Shishkin et al. [1][2][3] and Fuchs et al.[4]

Single step procedure: GW in one go

As of VASP.6.3 all GW approximations can be run in one single run by selecting the corresponding ALGO tag and omitting NBANDS), for instance like so

System = SiC
ALGO = EVGW0, QPGW0, EVGW, QPGW, GW0R or GWR # use an algorithgm described below
NELMGW = 1,2,.. # number of self-consistency cycles
ISMEAR = 0 ; SIGMA = 0.05  ! small sigma is required to avoid partial occupancies
LOPTICS = .TRUE.  # for insulators, omit for metals

Note, NBANDS must not be present in the INCAR to select this procedure.

Important: In older versions a two step procedure is required, where the first step is always a DFT calculation and the second step the actual GW calculation.

The two-step procedure is described below.

Caveats

The single-step GW procedure performs a DFT step internally with an exact diagonalization of the Kohn-Sham Hamiltonian using the maximum available NBANDS supported for the chosen ENCUT value. Consequently, a large number of unoccupied bands is initialized with random plane-wave coefficients. In rare cases, this yields two linearly dependent column vectors in the Hamiltonian and results in LAPACK errors like "ZPOTRF fails". These errors can be prevented using the two-step GW procedure as described below. Furthermore, one can "ramp up" NBANDS to the maximum value by repeatedly restarting the DFT calculation from a pre-converged WAVECAR with fewer bands.

First step: DFT calculation

GW calculations always require a one-electron basis set. Usually this set is obtained from a standard DFT calculation and written into the WAVECAR file and can be calculated for instance the following INCAR file:

System = SiC
NBANDS = 512
ISMEAR = 0 ; SIGMA = 0.05  ! small sigma is required to avoid partial occupancies
LOPTICS = .TRUE.

Note, that a significant number of empty bands is required for GW calculations, so that it might be better to perform the calculations in two steps: first a standard ground-state calculation with few unoccupied orbitals only,

System = SiC ground-state occupied orbitals
ISMEAR = 0 ; SIGMA = 0.05  ! small sigma is required to avoid partial occupancies
EDIFF = 1E-8               ! required tight tolerance for ground-state orbitals

and, second, a calculation of a large number of unoccupied orbitals

System  = SiC unoccupied orbitals
ALGO = Exact               ! use exact diagonalization of the Hamiltonian
NELM = 1                   ! since we are already converged stop after one step
NBANDS = 512               ! maybe even larger                
ISMEAR = 0 ; SIGMA = 0.05  ! small sigma is required to avoid partial occupancies
LOPTICS = .TRUE.

Furthermore, note that the flag LOPTICS=.TRUE. is required to write the file WAVEDER, which contains the derivative of the orbitals with respect to k. This derivative is used to construct the head and wings of the dielectric matrix employing k·p perturbation theory and is important to accelerate k-point convergence for insulators and semiconductors.

Warning: For metals, in general, we recommend omitting the LOPTICS tag and removing the WAVEDER file from the directory.

Optional: Use Hybrid functionals

Optionally, one can start a GW calculation from a hybrid functional, such as HSE. For hybrid functionals, the two step procedure will accordingly involve the following INCAR files. In the first step, converged HSE03 orbitals are determined (see here for a selection of available hybrid functionals):

System  = SiC ground-state occupied orbitals
ISMEAR = 0 ; SIGMA = 0.05
ALGO = Damped ; TIME = 0.5  ! or ALGO = Conjugate
LHFCALC = .TRUE. ; AEXX = 0.25 ; HFSCREEN = 0.3 
EDIFF = 1E-6      ! required tight tolerance for ground-state orbitals

Secondly, determine the HSE03 orbitals for unoccupied states:

System  = SiC unoccupied orbitals
NBANDS = 512      ! maybe even larger
ALGO = Exact
NELM = 1          ! since we are already converged stop after one step
ISMEAR = 0 ; SIGMA = 0.05
LHFCALC = .TRUE. ; AEXX = 0.25 ; HFSCREEN = 0.3 
LOPTICS = .TRUE. # for insulators

Second step: GW calculation

The actual GW calculation is done in a second step. Here different GW flavors are possible and are selected with the ALGO tag.

Note that as of VASP.6 the GW ALGO tags have been renamed, see here for VASP.5.X tags.

Single shot quasiparticle energies: G0W0

This is the simplest GW calculation and computationally the most efficient one. A single-shot calculation is often referred to as G0W0 and calculates the quasiparticle energies from a single GW iteration by neglecting all off-diagonal matrix elements of the self-energy and employing a Taylor expansion of the self-energy around the DFT energies . The corresponding equation becomes

with the renormalization factor

In VASP, G0W0 calculations are selected using an INCAR file such as

System  = SiC
NBANDS = 512
ISMEAR = 0 ; SIGMA = 0.05
NELMGW = 1 ! use NELM for VASP.6.2 and older 
ALGO = EVGW0 ! use "GW0" for VASP.5.X
NOMEGA = 50
Mind: Convergence with respect to the number of empty bands NBANDS and with respect to the number of frequencies NOMEGA must be checked carefully.

To avoid complicated inter-nested tests, we recommend calculating all orbitals that the plane-wave basis set allows to calculate (except for simple tests). For further reading, please consult the section on ENCUTGW.

After a successful G0W0 run, VASP will write the quasiparticle energies into the OUTCAR file for a set of NBANDSGW bands for every k-point in the Brillouin zone. Look for lines similar to

QP shifts <psi_nk| G(iteration)W_0 |psi_nk>: iteration 1
for sc-GW calculations column KS-energies equals QP-energies in previous step 
and V_xc(KS)=  KS-energies - (<T + V_ion + V_H > + <T+V_H+V_ion>^1  + <V_x>^1)

k-point   1 :       0.0000    0.0000    0.0000
 band No.  KS-energies  QP-energies   sigma(KS)   V_xc(KS)     V^pw_x(r,r')   Z            occupation Imag(sigma)

     1      -7.1627      -8.3040     -14.5626     -12.7276     -21.6682       0.6219       2.0000       1.2037
     2      -2.0901      -3.4347     -15.7660     -14.2799     -21.7439       0.9048       2.0000       0.6914
     3      -2.0901      -3.4347     -15.7660     -14.2799     -21.7439       0.9048       2.0000       0.6914
     4      -2.0901      -3.4347     -15.7660     -14.2799     -21.7439       0.9048       2.0000       0.6914
     5       0.4603      -0.4663     -13.7603     -12.5200     -18.1532       0.7471       2.0000       0.2167
     6       0.4603      -0.4663     -13.7603     -12.5200     -18.1532       0.7471       2.0000       0.2167

The first column is the band index and the third column denotes the quasiparticle energies . Column two, four, five and seven refer to the DFT energies , diagonal matrix elements of the self-energy , the exchange-correlation potential and the renormalization factor defined above, respectively.

Partially self-consistent calculations: EVGW0

In most cases, the best results (i.e., closest to experiment) are obtained by iterating only via the spectral representation

but keeping and the orbitals fixed to the initial DFT level. This method goes back to Hybertsen and Louie [5] and can be achieved in two ways.

If the spectral method is not selected (LSPECTRAL=.FALSE., requiring much more compute time), the quasiparticle (QP) shifts are iterated automatically four times, and one finds four sets of QP shifts in the OUTCAR file. The first one corresponds to the G0W0 case. The INCAR file is simply:

System = SiC
NBANDS = 512
ISMEAR = 0 ; SIGMA = 0.05
ALGO = EVGW0 ! use "GW0" in VASP.5.X
LSPECTRAL =.FALSE.
Tip: In self-consistent GW calculations, convergence with the number of updated bands NBANDSGW must be checked carefully.

For technical reasons, it is not possible to iterate in this manner if LSPECTRAL=.TRUE. is set in the INCAR file (this is the default). In this case, an iteration number must be supplied in the INCAR file using the NELMGW tag. Usually, three to four iterations are sufficient to obtain accurate QP shifts.

System = SiC
NBANDS = 512
ISMEAR = 0 ; SIGMA = 0.05
ALGO = EVGW0 ! use "GW0" in VASP.5.X
NELMGW = 4 ! use NELM in VASP.6.2 and older

The results are found again in the OUTCAR file

QP shifts <psi_nk| G(iteration)W_0 |psi_nk>: iteration 4

k-point   1 :       0.0000    0.0000    0.0000
 band No. old QP-enery  QP-energies   sigma(KS)   T+V_ion+V_H  V^pw_x(r,r')   Z            occupation Imag(sigma)

     1      -8.6924      -8.7107     -14.2871       5.5647     -21.6681       0.6076       2.0000       1.1648
     2      -3.4692      -3.4806     -15.6742      12.1894     -21.7437       0.7304       2.0000       0.6351
     3      -3.4692      -3.4806     -15.6742      12.1894     -21.7437       0.7304       2.0000       0.6351
     4      -3.4692      -3.4806     -15.6742      12.1894     -21.7437       0.7304       2.0000       0.6351
     5      -0.6957      -0.7006     -13.6827      12.9802     -18.1531       0.7264       2.0000       0.2769
     6      -0.6957      -0.7006     -13.6827      12.9802     -18.1531       0.7264       2.0000       0.2769
     7      -0.6957      -0.7006     -13.6827      12.9802     -18.1531       0.7264       2.0000       0.2769

In contrast to single shot GW calculations, the second column represent now the QP-energies from the previous iteration.

Partially self-consistent quasiparticle calculations: QPGW0

If non diagonal components of the self-energy (in the orbital basis) should be included use ALGO=QPGW0. The following setting can be used:

System = SiC
NBANDS = 512
ISMEAR = 0 ; SIGMA = 0.05
ALGO = QPGW0 ! or "scGW0" for VASP.5.2.11 and older 
LOPTICS = .TRUE. ; LPEAD = .TRUE. ! ommit this lines for metals
NELMGW = 4 ! use NELM for VASP.6.2 and older

In this case, the orbitals are updated as well by constructing a hermitian (energy independent) approximation to the self-energy [3]. The "static" COHSEX approximation can be selected by setting NOMEGA = 1 [6]. To improve convergence to the ground-state, the charge density (and the charge density only) is mixed using a Kerker type mixing in VASP.5.3.2 and more recent versions (see IMIX). The mixing parameters AMIX, BMIX, AMIX_MAG, BMIX_MAG, AMIN can be adjusted, if convergence problems are encountered.

We strongly urge the user to monitor convergence by inspecting the lines

charge density residual

in the OUTCAR files.

Alternatively, the mixing may be switched off by setting IMIX=0 and controlling the step width for the orbitals using the parameter TIME (which defaults to 0.4). This selects a fairly sophisticated damped MD algorithm that is also used for DFT methods when ALGO=Damped. This method is generally more reliable for metals and materials with strong charge sloshing.

After every iteration, VASP writes the following lines into the OUTCAR file

QP shifts <psi_nk| G(iteration)W_0 |psi_nk>: iteration 1
    GWSYM:  cpu time   15.8978: real time   15.9528

k-point   1 :       0.0000    0.0000    0.0000
 band No. DFT-energies  QP-energies  QP-e(diag)   sigma(DFT)    Z            occupation

     1      -7.1626      -8.4217      -8.3038      -8.9978       0.6219       2.0000
     2      -2.0899      -3.4394      -3.4347      -3.5765       0.9047       2.0000
     3      -2.0899      -3.4394      -3.4347      -3.5765       0.9047       2.0000
     4      -2.0899      -3.4394      -3.4347      -3.5765       0.9047       2.0000
     5       0.4604      -0.4787      -0.4663      -0.7800       0.7471       2.0000
     6       0.4604      -0.4787      -0.4663      -0.7800       0.7471       2.0000
     7       0.4604      -0.4787      -0.4663      -0.7800       0.7471       2.0000
     8       5.1013       4.1883       4.2149       3.9518       0.7711       2.0000

For the first iteration, here, the fourth column should be identical to the third column of the G0W0 results discussed above. The third column reports the quasiparticle energies obtained from including the off-diagonal matrix elements in the eigenvalue equation.

Caveats

The QPGW0 (or scGW0 in VASP.5.2.11 and older) must be used with great caution, particularly in combination with symmetry. Symmetry is handled in a rather sophisticated manner. Specifically, only the minimal number of required combinations of q and k points is considered. In this case, symmetry must be applied to restore the full star of q. This is done by determining degenerate eigenvalue/eigenvector pairs and restoring their symmetry according to their irreducible representation. Although the procedure is generally relatively reliable, it fails to work properly if the degenerate states do not possess eigenvalues that are sufficiently close due to insufficient convergence in the preceding DFT calculations. That is because states are treated as degenerate if, and only if, their eigenenergies are within 0.01 eV.

For large supercells with low symmetry, we strongly recommend switching off symmetry.

Self-consistent EVGW and QPGW calculations

Self-consistent QPGW calculations are only supported in a QP picture. As for QPGW0, it is possible to update the eigenvalues only (ALGO=EVGW or GW for VASP.5.X), or the eigenvalues and one-electron orbitals (ALGO=QPGW or scGW in VASP.5.2.11 and older). In all cases, a QP picture is maintained, i.e., satellite peaks (shake ups and shake downs) can not be accounted for in the self-consistency cycle. Self-consistent QPGW calculations can be performed by simply repeatedly calling VASP using:

System = SiC
NBANDS = 512
ISMEAR = 0 ; SIGMA = 0.05
ALGO = EVGW    ! "GW" in VASP.5.X, eigenvalues only  or alternatively
ALGO = QPGW    ! "scGW" in VASP.5.2.11 and older, eigenvalues and one electron orbitals

For QPGW0 or QPGW, nondiagonal terms in the Hamiltonian are accounted for, e.g. the linearized QP equation is diagonalized, and the one-electron orbitals are updated [3]. Alternatively (and preferably), the user can specify an electronic iteration counter using NELMGW (NELM in VASP.6.2 and older):

System = SiC
NBANDS = 512
ISMEAR = 0 ; SIGMA = 0.05
NELMGW = 3   ! use NELM in VASP.6.2 and older
ALGO = EVGW  ! "GW" in VASP.5.X 
# or  
ALGO = QPGW  ! "scGW" in VASP.5.2.11 and older

In this case, the one-electron energies (=QP energies) are updated 3 times (starting from the DFT eigenvalues) in both G and W. For ALGO=QPGW (or ALGO=scGW in VASP.5.2.11 and older), the one electron energies and one electron orbitals are updated 3 times [3]. As for ALGO = QPGW0 (or scGW0 in vasp.5.2.11 and older), the "static" COHSEX approximation can be selected by setting NOMEGA=1 [6].

To improve convergence to the ground-state, the charge density is mixed using a Kerker type mixing starting with VASP.5.3.2 (see IMIX). The mixing parameters AMIX, BMIX, AMIX_MAG, BMIX_MAG, AMIN can be adjusted, if convergence problems are encountered. Alternatively, the mixing may be switched off by setting IMIX=0 and controlling the step width for the orbitals using the parameter TIME (which defaults to 0.4). This selects a fairly sophisticated damped MD algorithm that is also used for DFT methods when ALGO=Damped. This method is generally more reliable for metals and materials with strong charge sloshing.

Additional information about this method is found here.

Caveats

Fully self-consistent QPGW calculations with an update of the orbitals in and [3] require significant care and are prone to diverge (QPGW0 calculations are usually less critical). As discussed, above, one can select this mode using:

System = SiC
NBANDS = 512
ISMEAR = 0 ; SIGMA = 0.05
ALGO = QPGW  ! or "scGW" in VASP.5.2.11 and older, eigenvalues and one-electron orbitals
NELMGW = number of steps ! use NELM for VASP.6.2 and older

However, one caveat applies to this case: when the orbitals are updated, the derivatives of the orbitals with respect to (stored in the WAVEDER file) will become incompatible with the orbitals. This can cause severe problems and convergence to the incorrect solution.

Warning: For metals, in general, we recommend omitting the LOPTICS tag and removing the WAVEDER file from the directory.

For insulators, VASP (version 5.3.2 or higher) can update the WAVEDER file in each electronic iteration if the finite difference method is used to calculate the first derivative of the orbitals with respect to :

System = SiC
NBANDS = 512
ISMEAR = 0 ; SIGMA = 0.05
ALGO = QPGW ! "scGW" in VASP.5.2.11 and older, eigenvalues and one-electron orbitals
NELMGW  = 10 ! use NELM in VASP.6.2 and older
LOPTICS = .TRUE. ; LPEAD = .TRUE.

The combination LOPTICS=.TRUE.; LPEAD=.TRUE. is required since is not available for GW like methods. LPEAD=.TRUE. circumvents this problem by calculating the derivatives of the orbitals using numerical differentiation on the finite k-point grid (this option is presently limited to insulators).

Vertex corrections are presently not documented. This is a feature still under construction, and we recommend collaborating with the Vienna group if you desperately need that feature.

Low scaling GW algorithms

The GW implementations in VASP described in the papers of Shishkin et al.[1] [2] avoids storage of the Green's function as well as Fourier transformations between time and frequency domain entirely. That is, all calculations are performed solely on the real frequency axis using Kramers-Kronig transformations for convolutions in the equation of and in reciprocal space.

As of VASP.6 a new cubic scaling GW algorithm [7] (called space-time implementation in the following) can be selected. This approach follows the idea of Rojas et al. [8] and performs the GW self-consistency cycle on imaginary time and imaginary frequency axes .

Tip: Using the low-scaling GW algorithm also calculates the total energy in the Random Phase approximation (RPA), which is described in a separate article.

Low scaling, single shot GW calculations: G0W0R

The low-scaling analogue of G0W0 is selected with ALGO=G0W0R. In contrast to the single-shot GW calculations on the real-axes, here the self-energy is determined on the imaginary frequency axis. To this end, the overall scaling is reduced by one order of magnitude and is cubic with respect to the system size, because a small value for NOMEGA can be used (usually <20).

This algorithm evaluates:

  • Single-shot GW quasiparticle energies (from an analytical continuation of the self-energy to the real axis)[7]
  • Natural orbitals from the first order change of the density matrix (i.e. ), see the NATURALO tag for more information [9].
Mind: This selection ignores NELMGW.

Following INCAR file selects the low-scaling GW algorithm:

System = SiC
ISMEAR = 0 ; SIGMA = 0.05
LOPTICS = .TRUE.  
ALGO = G0W0R
NOMEGA = 12 ! small number of frequencies necessary

Search the OUTCAR file for the following lines

  QP shifts evaluated in KS or natural orbital/ Bruckner basis
  k-point   1 :       0.0000    0.0000    0.0000
  band No.  KS-energies   sigma(KS)    QP-e(linear)    Z         QP-e(zeros)     Z        occupation    Imag(E_QP)    QP_DIFF TAG
 
       1      -7.1627      -8.6732      -8.2451       0.7166      -8.2346       0.7026       2.0000      -1.3101       0.0000   2
       2      -2.0901      -3.4155      -3.0350       0.7129      -3.0272       0.7011       2.0000      -0.5582      -0.0000   2
       3      -2.0901      -3.4155      -3.0350       0.7129      -3.0272       0.7011       2.0000      -0.5582       0.0000   2
       4      -2.0901      -3.4155      -3.0350       0.7129      -3.0272       0.7011       2.0000      -0.5582      -0.0000   2
       5       0.4603      -0.8219      -0.4904       0.7414      -0.4814       0.7273       2.0000      -0.1902       0.0000   2
       6       0.4603      -0.8219      -0.4904       0.7414      -0.4814       0.7273       2.0000      -0.1902      -0.0000   2

Here column four is obtained by a linearization of the self-energy around the Kohn-Sham energies (second column) and can be compared to the third column of single-shot GW calculations on the real axis. Column six represents another set of QP-energies that is obtained from the roots of the following equation

These roots represent the poles of the Green's function in the spectral representation.

Output description

The meaning of each column is explained briefly in the following.

  • band No. the band index of KS orbital at given k-point
  • KS-energies eigenenergies corresponding to band index
  • sigma(KS) diagonal matrix elements of self-energy evaluated at KS energies
  • QP-e(linear) quasiparticle energies obtained from linearizing frequency dependence of diagonal self-energy around KS energies
  • Z renormalization factor obtained from five-point stencil for derivative of self-energy w.r.t. frequency
  • QP-e(zeros) quasiparticle energies obtained from full frequency dependence of self-energy, i.e. real part of complex pole of Green's function
  • Z renormalization factor obtained from central difference for derivative of self-energy w.r.t. frequency
  • occupation occupation number for band at given k-point
  • Imag(E_QP) imaginary part of complex pole , i.e. measure for inverse lifetime of quasi-particle
  • QP_DIFF difference of QP energies (of linearized self-energy) obtained from Eq. 77 of Liu et. al.[7] and M. Grumets thesis[10].

Optional: RPA Forces

Optionally, RPA forces can be calculated by adding following line to the INCAR:

 LRPAFORCE = .TRUE. 

After the QP-energies, VASP performs a linear-response calculation that is required for the RPA forces.[11] Following data block in the OUTCAR file can be found after a successful run:

POSITION                                       TOTAL RPA FORCE (eV/Angst)
-----------------------------------------------------------------------------------
     0.17542     -0.22348      0.17542        -0.292069      7.581315     -0.292069
     1.12850      1.31044      1.12850         0.304683     -7.605527      0.304683
-----------------------------------------------------------------------------------
   total drift:                                0.012614     -0.024212      0.012614

SUGGESTED UPDATED POSCAR (direct coordinates)  step
-----------------------------------------------------------------------------------
 -0.00958461  -0.00958461   0.13485779         0.04179056   0.04179056   0.00283088
  0.25787833   0.25787833   0.22191754        -0.04337198  -0.04337198   0.00431513
Warning: Currently RPA forces for metallic systems are not supported.

Low scaling, partially self-consistent GW calculations: EVGW0R

Mind: available as of vasp 6.4.0

The low-scaling analogue of EVGW0 is selected with ALGO=EVGW0R. Following INCAR file selects this algorithm:

System = SiC
ISMEAR = 0 ; SIGMA = 0.05
LOPTICS = .TRUE.  
ALGO = EVGW0R 
NELMGW = 4  ! number of iterations in G
NOMEGA = 12 ! small number of frequencies necessary

After each iteration, a similar block of data as for ALGO=G0W0R calculations is written to OUTCAR showing the NBANDSGW updated quasi-particle energies (poles) of the Green's function.

Partially self-consistent GW calculations: GW0R

The space-time implementation allows for true self-consistent GW calculations. That is, the solution of the Dyson equation for the Green's function can be obtained with a modest computational effort. The main procedure of a self-consistent GW calculation consists of four main steps

  • Obtain Green's function
  • Compute irreducible polarizability
  • Determine screened potential
  • Calculate GW self-energy

This procedure can be selected with the following INCAR settings

System = SiC
ISMEAR = 0 ; SIGMA = 0.05
LOPTICS = .TRUE. ; LPEAD = .TRUE.  
NELMGW = number of iterations wanted ! NELM in 6.2 and older
ALGO = GW0R ! ALGO = scGW0R has the same effect here, that is self-consistency in G, no update in W

The number of self-consistency steps can be set with the NELMGW tag.

Due to efficiency, VASP performs each step in the Hartree-Fock basis. This is the reason why there are two sets of QP-energies found after the first iteration (one for the QP-energies in the KS-basis and one for the QP energies in the HF basis) After the second iteration, only the QP energies obtained in the HF basis are printed, and a similar output as follows is found in the OUTCAR file

QP shifts evaluated in HF basis
k-point   1 :       0.0000    0.0000    0.0000
band No.  KS-energies   sigma(KS)    QP-e(linear)    Z         QP-e(zeros)     Z        occupation    Imag(E_QP)    QP_DIFF TAG

     1      -7.1626      -8.6510      -8.2275       0.7154      -8.2173       0.7017       2.0000      -1.3177       0.0000   2
     2      -2.0899      -3.4157      -3.0348       0.7127      -3.0269       0.7008       2.0000      -0.5614       0.0000   2
     3      -2.0899      -3.4157      -3.0348       0.7127      -3.0269       0.7008       2.0000      -0.5614      -0.0000   2
     4      -2.0899      -3.4157      -3.0348       0.7127      -3.0269       0.7008       2.0000      -0.5614       0.0000   2
     5       0.4604      -0.8170      -0.4857       0.7407      -0.4768       0.7266       2.0000      -0.1945       0.0000   2
     6       0.4604      -0.8170      -0.4857       0.7407      -0.4768       0.7266       2.0000      -0.1945      -0.0000   2
     7       0.4604      -0.8170      -0.4857       0.7407      -0.4768       0.7266       2.0000      -0.1945       0.0000   2
     8       5.1013       4.0069       4.2594       0.7693       4.2645       0.7598       2.0000      -0.0602       0.0000   2

Here the meaning of each column is the same as for the other low-scaling GW algorithms.

Fully self-consistent GW caluclations: GWR

If the screened potential should be updated during the self-consistency circle [12] the following INCAR file can be used

System = SiC
ISMEAR = 0 ; SIGMA = 0.05
LOPTICS = .TRUE. ; LPEAD = .TRUE.  
NELMGW = number of iterations wanted ! use NELM in VASP.6.2 and older
ALGO = GWR ! ALGO = scGWR has the same effect here, that is self-consistency in G and W

The output is similar to partially self-consistent GW calculations, with the difference that KS-energies are replaced by the QP energies from previous iteration.

Caveats

Using this option, similar caveats can be expected as for ALGO=EVGW and QPGW calculations and we recommend to leave out the LOPTICS and LPEAD line for metals.

The cubic scaling space-time GW algorithm requires considerably more memory than the corresponding quartic-scaling implementations, two Green's functions have to be stored in real-space. To reduce the memory overhead, VASP exploits Fast Fourier Transformations (FFT) to avoid storage of the matrices on the (larger) real space grid, on the one hand. The precision of the FFT can be selected with PRECFOCK, where usually the values Fast sufficient.

On the other hand, the code avoids storage of redundant information, i.e., both the Green's function and polarizability matrices are distributed as well as the individual imaginary grid points. The distribution of the imaginary grid points can be set by hand with the NTAUPAR and NOMEGAPAR tags, which splits the imaginary grid points NOMEGA into NTAUPAR time and NOMEGAPAR groups. For this purpose both tags have to be divisors of NOMEGA.

The default values are usually reasonable choices provided the tag MAXMEM is set correctly and we strongly recommend to set MAXMEM instead of NTAUPAR.

Important: As of version 6.2, MAXMEM is estimated automatically (if not set) from the "MemAvailable" entry of the Linux kernel in "/proc/meminfo".

The required storage for a low-scaling RPA or GW calculation depends mostly on NTAUPAR, the number of MPI groups that share same imaginary time points. A rough estimate for the required bytes is given by

(NGX*NGY*NGZ)*(NGX_S*NGY_S*NGZ_S) / ( NCPU  / NTAUPAR ) * 16

where "NCPU" is the number of MPI ranks used for the job,"NGX,NGY,NGZ" denotes the number of FFT grid points for the exact exchange and "NGX_S,NGY_S,NGZ_S" the number of FFT grid points for the supercell. Note, both grids are written to the OUTCAR file after the lines

FFT grid for exact exchange (Hartree Fock)
FFT grid for supercell:

The smaller NTAUPAR is set, the less memory per node the job requires to finish successfully.

The approximate memory requirement is calculated in advance and printed to screen and OUTCAR as follows:

min. memory requirement per mpi rank 1234 MB, per node 9872 MB

Related tags and articles

Examples that use this tag

References