GW

References: Wilhelm2021, Graml2024

Parameters needed to set up a GW calculation for electronic level energies \(\varepsilon_{n\mathbf{k}}^{G_0W_0}\) of molecules and the band structure of materials: \(\varepsilon_{n\mathbf{k}}^{G_0W_0}= \varepsilon_{n\mathbf{k}}^\text{DFT}+\Sigma_{n\mathbf{k}} -v^\text{xc}_{n\mathbf{k}}\). For the GW algorithm for molecules, see [Wilhelm2021]. For 2D materials, see [Graml2024]. [Edit on GitHub]

Mentions: ⭐Band structure from GW, ⭐GW + Bethe-Salpeter equation, ⭐Real-Time Bethe-Salpeter Propagation

Keywords

Keyword descriptions

SECTION_PARAMETERS

Type: logical
Default: F
Lone keyword: T

Description: Controls the activation of the GW calculation. [Edit on GitHub]

ANALYTIC_CONTINUATION

Type: enum
Default: NEVANLINNA
Usage: ANALYTIC_CONTINUATION PADE

Description: Method for the analytic continuation of the self-energy Σ(iω) to real frequencies. NEVANLINNA only uses functions with a positive spectral function on the real-frequency axis. It comes with an error estimate for the analytic continuation: in the file bandstructure_SCF_and_G0W0, GW levels with unstable analytic continuation are marked with *, and GW levels with multiple solutions of the quasiparticle equation are marked with m. PADE fits a Padé approximant to Σ(iω) below FREQ_MAX_FIT. [Edit on GitHub]

Valid values:

  • NEVANLINNA Nevanlinna interpolant with error estimate.

  • PADE Padé approximant.

References: Fei2021

Mentions: ⭐Band structure from GW

APPROX_KP_EXTRAPOL

Type: logical
Default: F
Lone keyword: T
Usage: APPROX_KP_EXTRAPOL

Description: If true, use only a 4x4 kpoint mesh for frequency points \(\omega_j, j \ge 2\) (instead of a 4x4 and 6x6 k-point mesh). The k-point extrapolation of \(W_{PQ}(i\omega_j,\mathbf{q})\) is done approximately from \(W_{PQ}(i\omega_1,\mathbf{q})\). [Edit on GitHub]

CUTOFF_RADIUS_RI

Type: real
Default: 3.00000000E+000 [angstrom]
Usage: CUTOFF_RADIUS_RI 3.0

Description: The cutoff radius (in Angstrom) for the truncated Coulomb operator. The larger the cutoff radius, the faster converges the resolution of the identity (RI) with respect to the RI basis set size. Larger cutoff radius means higher computational cost. [Edit on GitHub]

Mentions: ⭐GW + Bethe-Salpeter equation

EPS_FILTER

Type: real
Default: 1.00000000E-008
Usage: EPS_FILTER 1.0E-6

Description: Threshold for sparse operations on spatially local matrices, including DBCSR matrix multiplication. EPS_FILTER usually controls the accuracy and runtime of low-scaling GW: a smaller value increases numerical precision and computational cost. [Edit on GitHub]

Mentions: ⭐GW + Bethe-Salpeter equation

FREQ_MAX_FIT

Type: real
Default: 1.00000000E+001 [eV]
Usage: FREQ_MAX_FIT 20.0

Description: For analytic continuation, a fit on Σ(iω) is performed. This fit is then evaluated at a real frequency, Σ(ω), which is used in the quasiparticle equation \(\varepsilon_{n\mathbf{k}}^{G_0W_0}= \varepsilon_{n\mathbf{k}}^\text{DFT}+\Sigma_{n\mathbf{k}} -v^\text{xc}_{n\mathbf{k}}\). The keyword FREQ_MAX_FIT determines fitting range for the self-energy Σ(iω) on imaginary axis: i*[0, ω_max] for empty orbitals/bands, i*[-ω_max,0] for occ orbitals. A smaller ω_max might lead to better numerical stability (i.e., if you observe clearly wrong GW eigenvalues/bands around HOMO/LUMO, decreasing ω_max might fix this issue). A small benchmark of ω_max is contained in Fig. 5 of J. Wilhelm et al., JCTC 12, 3623-3635 (2016). Note that we used ω_max = 1 Ha = 27.211 eV in the benchmark M. Azizi et al., PRB 109, 245101 (2024). With ANALYTIC_CONTINUATION NEVANLINNA, only used for the Padé fallback of levels without Nevanlinna interpolant. [Edit on GitHub]

HEDIN_SHIFT

Type: logical
Default: F
Lone keyword: T
Usage: HEDIN_SHIFT

Description: If true, use Hedin’s shift in G0W0, evGW and evGW0. Details see in Li et al. JCTC 18, 7570 (2022), Figure 1. G0W0 with Hedin’s shift should give similar GW eigenvalues as evGW0; at a lower computational cost. [Edit on GitHub]

KPOINTS_W

Type: integer[3]
Default: -1 -1 -1
Usage: KPOINTS_W N_x  N_y  N_z

Description: Monkhorst-Pack k-point mesh of size N_x, N_y, N_z for calculating \(W_{PQ}^\mathbf{R}=\int_\text{BZ}\frac{d\mathbf{k}}{\Omega_\text{BZ}}\, e^{-i\mathbf{k}\cdot\mathbf{R}}\,W_{PQ}(\mathbf{k})\). For non-periodic directions α, choose N_α = 1. Automatic choice of the k-point mesh for negative values, i.e. KPOINTS_W -1 -1 -1. K-point extrapolation of W is automatically switched on. [Edit on GitHub]

MEMORY_PER_PROC

Type: real
Default: -1.00000000E+000
Usage: MEMORY_PER_PROC 16

Description: Specify the available memory per MPI process (in GB). The default value -1 means that the available memory per MPI process is detected automatically from the free memory of the node divided by the number of MPI processes running on that node; this is the recommended setting. Note: This keyword is not used for GW calculations with RI-RS, where the available memory is always detected automatically. [Edit on GitHub]

Mentions: ⭐GW + Bethe-Salpeter equation

NUM_TIME_FREQ_POINTS

Type: integer
Default: 30
Usage: NUM_TIME_FREQ_POINTS 30

Description: Number of discrete points for the imaginary-time grid and the imaginary-frequency grid. The more points, the more precise is the calculation. Typically, 10 points are good for 0.1 eV precision of band structures and molecular energy levels, 20 points for 0.03 eV precision, and 30 points for 0.01 eV precision, see Table I in [Wilhelm2021]. GW computation time increases linearly with NUM_TIME_FREQ_POINTS. [Edit on GitHub]

Mentions: ⭐GW + Bethe-Salpeter equation

REGULARIZATION_MINIMAX

Type: real
Default: -1.00000000E+000
Usage: REGULARIZATION_MINIMAX 1.0E-4

Description: Parameter to regularize the Fourier transformation with minimax grids. In case the parameter 0.0 is chosen, no regularization is performed. [Edit on GitHub]

REGULARIZATION_RI

Type: real
Default: -1.00000000E+000
Usage: REGULARIZATION_RI 1.0E-4

Description: Regularization applied to the GW RI fitting matrix \(M_{PQ}\). A negative value selects the context-dependent default: zero for molecules, 1.0E-4 for periodic RI-RS GW and 1.0E-2 for other periodic systems. [Edit on GitHub]

RI_CUTOFF_ATTENUATION

Type: real
Default: 3.00000000E-001 [bohr^-1]
Usage: RI_CUTOFF_ATTENUATION 0.3

Description: Positive attenuation omega (in inverse bohr) of the erfc(omega*r)/r RI metric used by periodic full-k RI-RS GW. The default is 0.3 bohr^-1. Other GW implementations use the truncated Coulomb metric set by CUTOFF_RADIUS_RI. [Edit on GitHub]

SIZE_LATTICE_SUM

Type: integer
Default: 3
Usage: SIZE_LATTICE_SUM 4

Description: Parameter determines how many neighbor cells \(\mathbf{R}\) are used for computing \(V_{PQ}(\mathbf{k}) = \sum_{\mathbf{R}} e^{i\mathbf{k}\cdot\mathbf{R}}\,\langle P, \text{cell}{=}\mathbf{0}|1/r|Q,\text{cell}{=}\mathbf{R}\rangle\). Normally, parameter does not need to be touched. [Edit on GitHub]