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:
NEVANLINNANevanlinna interpolant with error estimate.PADEPadé 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]