GeinDFT
Home › Troubleshooting

Troubleshooting

The problems that come up in practice, what causes them, and what to do.

The SCF will not converge

CheckWhat to do
The geometryLook at the structure. Two atoms almost on top of one another, or a distorted ring, will prevent convergence long before any numerical setting does.
The multiplicityA closed-shell molecule run as a triplet, or an odd number of electrons with multiplicity one, cannot converge.
A level shiftTry 0.2 to 0.4 hartree on the SCF tab. This is the usual remedy for a system with a small gap.
DampingHelps when the first iterations swing wildly.
A smaller basis firstConverge with def2-SVP, then use that density as the starting point for the larger basis.

The Run button is disabled

The reason is shown next to it. The usual causes are no structure loaded, a charge and multiplicity that cannot both be true, an element the basis set does not cover, and a dispersion correction that does not apply to the chosen functional.

A structure opens flat, or with no hydrogens

That is a two-dimensional drawing rather than a geometry. GeinDFT builds a three-dimensional structure automatically and says so above the viewer. If the file really was meant to be flat, use Undo, or the --no-3d option on the command line.

Another program will not open a result file

Give it the right file. The .out is a log and cannot be parsed by other chemistry programs. Use the Molden file for orbitals, a cube for a field, and an XYZ or SDF for a structure.

A job is refused because of memory

The estimate is made before the job starts. Reduce the basis set, reduce the grid, or raise the memory limit on the Resources tab if the machine really has more than the limit allows.

The viewer is blank or will not start

The viewer needs a graphics driver with OpenGL 3.3. Updating the display driver resolves nearly every case. The calculation itself does not use the graphics card, so a machine with no usable driver can still run calculations from the command line.

Results differ slightly from another program

Compare like with like: the same functional, basis set, integration grid and convergence thresholds. Differences at the fifth or sixth decimal of a total energy are almost always the integration grid. See Accuracy and validation.