5.13 Methods Based on “Constrained” DFT

5.13.1 Job Control

A CDFT calculation is requested by setting CDFT = TRUE in the $rem section, as as by specifying a $cdft input section as described above. Additional job control variables are described below.

CDFT
       Initiates a constrained DFT calculation
TYPE:
       LOGICAL
DEFAULT:
       FALSE
OPTIONS:
       TRUE Perform a Constrained DFT Calculation FALSE No Density Constraint
RECOMMENDATION:
       Set to TRUE if a Constrained DFT calculation is desired.

CDFT_POSTDIIS
       Controls whether the constraint is enforced after DIIS extrapolation.
TYPE:
       LOGICAL
DEFAULT:
       TRUE
OPTIONS:
       TRUE Enforce constraint after DIIS FALSE Do not enforce constraint after DIIS
RECOMMENDATION:
       Use the default unless convergence problems arise, in which case it may be beneficial to experiment with setting CDFT_POSTDIIS to FALSE. With this option set to TRUE, energies should be variational after the first iteration.

CDFT_PREDIIS
       Controls whether the constraint is enforced before DIIS extrapolation.
TYPE:
       LOGICAL
DEFAULT:
       FALSE
OPTIONS:
       TRUE Enforce constraint before DIIS FALSE Do not enforce constraint before DIIS
RECOMMENDATION:
       Use the default unless convergence problems arise, in which case it may be beneficial to experiment with setting CDFT_PREDIIS to TRUE. Note that it is possible to enforce the constraint both before and after DIIS by setting both CDFT_PREDIIS and CDFT_POSTDIIS to TRUE.

CDFT_THRESH
       Threshold that determines how tightly the constraint must be satisfied.
TYPE:
       INTEGER
DEFAULT:
       5
OPTIONS:
       N Constraint is satisfied to within 10-N.
RECOMMENDATION:
       Use the default unless problems occur.

CDFT_CRASHONFAIL
       Whether the calculation should crash or not if the constraint iterations do not converge.
TYPE:
       LOGICAL
DEFAULT:
       TRUE
OPTIONS:
       TRUE Crash if constraint iterations do not converge. FALSE Do not crash.
RECOMMENDATION:
       Use the default.

CDFT_BECKE_POP
       Whether the calculation should print the Becke atomic charges at convergence
TYPE:
       LOGICAL
DEFAULT:
       TRUE
OPTIONS:
       TRUE Print Populations FALSE Do not print them
RECOMMENDATION:
       Use the default. Note that the Mulliken populations printed at the end of an SCF run will not typically add up to the prescribed constraint value. Only the Becke populations are guaranteed to satisfy the user-specified constraints.