Known Issues#

Caveats#

nan in GW output#

nan values in the sigc output indicate that the quasi-particle equation (QPE) solver was unable to find a stable solution. This issue is occasionally encountered for unoccupied states far above the Fermi level (typically beyond 20 eV).

When such cases occur only sporadically and not at consecutive k-points, they usually have little effect on the visual appearance of a plotted band structure, and may be ignored for plotting purposes. To improve convergence, try a different QPE solver or adjust the solver controls; see runtime options option_qpe_solver, qpe_solver_thres, qpe_solver_n_iter_max, qpe_solver_damp_factor, and use_qpe_adaptive_damp.

If nan values occur in larger contiguous regions, the GW calculation should be examined more carefully. This may indicate that the calculation has become unreliable, for example because the filtering threshold is too large or because the analytic continuation produces multiple nearby solutions.

FHI-aims inputs for high-symmetry rotated cells#

We have encountered a case where FHI-aims input generated from a high-symmetry but rotated primitive cell led to a discrepancy between LibRPA calculations with symmetry enabled and disabled. In that case, the underlying FHI-aims eigenvalue output also differed between the standard and rotated cells.

When investigating EXX or GW symmetry discrepancies with FHI-aims input, be careful with high-symmetry rotated cells and compare against LibRPA results obtained without symmetry. A relevant issue can be found in FHI-aims’ issue tracker (unpublic).

Planned Improvements#