5.11.6 CDFT-CI Job Control and Examples

CDFTCI
       Initiates a constrained DFT-configuration interaction calculation
TYPE:
       LOGICAL
DEFAULT:
       FALSE
OPTIONS:
       TRUE Perform a CDFT-CI Calculation FALSE No CDFT-CI
RECOMMENDATION:
       Set to TRUE if a CDFT-CI calculation is desired.

CDFTCI_PRINT
       Controls level of output from CDFT-CI procedure to Q-Chem output file.
TYPE:
       INTEGER
DEFAULT:
       0
OPTIONS:
       0 Only print energies and coefficients of CDFT-CI final states 1 Level 0 plus CDFT-CI overlap, Hamiltonian, and population matrices 2 Level 1 plus eigenvectors and eigenvalues of the CDFT-CI population matrix 3 Level 2 plus promolecule orbital coefficients and energies
RECOMMENDATION:
       Level 3 is primarily for program debugging; levels 1 and 2 may be useful for analyzing the coupling elements

CDFT_LAMBDA_MODE
       Allows CDFT potentials to be specified directly, instead of being determined as Lagrange multipliers.
TYPE:
       BOOLEAN
DEFAULT:
       FALSE
OPTIONS:
       FALSE Standard CDFT calculations are used. TRUE Instead of specifying target charge and spin constraints, use the values from the input deck as the value of the Becke weight potential
RECOMMENDATION:
       Should usually be set to FALSE. Setting to TRUE can be useful to scan over different strengths of charge or spin localization, as convergence properties are improved compared to regular CDFT(-CI) calculations.

CDFTCI_SKIP_PROMOLECULES
       Skips promolecule calculations and allows fractional charge and spin constraints to be specified directly.
TYPE:
       BOOLEAN
DEFAULT:
       FALSE
OPTIONS:
       FALSE Standard CDFT-CI calculation is performed. TRUE Use the given charge/spin constraints directly, with no promolecule calculations.
RECOMMENDATION:
       Setting to TRUE can be useful for scanning over constraint values.

CDFTCI_SVD_THRESH
       By default, a symmetric orthogonalization is performed on the CDFT-CI matrix before diagonalization. If the CDFT-CI overlap matrix is nearly singular (i.e., some of the diabatic states are nearly degenerate), then this orthogonalization can lead to numerical instability. When computing ${𝐒}^{-1/2}$, eigenvalues smaller than ${10}^{-\mathrm{CDFTCI}\mathrm{\_}\mathrm{SVD}\mathrm{\_}\mathrm{THRESH}}$ are discarded.
TYPE:
       INTEGER
DEFAULT:
       4
OPTIONS:
       $n$ for a threshold of ${10}^{-n}$.
RECOMMENDATION:
       Can be decreased if numerical instabilities are encountered in the final diagonalization.

CDFTCI_STOP
       The CDFT-CI procedure involves performing independent SCF calculations on distinct constrained states. It sometimes occurs that the same convergence parameters are not successful for all of the states of interest, so that a CDFT-CI calculation might converge one of these diabatic states but not the next. This variable allows a user to stop a CDFT-CI calculation after a certain number of states have been converged, with the ability to restart later on the next state, with different convergence options.
TYPE:
       INTEGER
DEFAULT:
       0
OPTIONS:
       $n$ Stop after converging state $n$ (the first state is state $1$) $0$ Do not stop early
RECOMMENDATION:
       Use this setting if some diabatic states converge but others do not.

CDFTCI_RESTART
       To be used in conjunction with CDFTCI_STOP, this variable causes CDFT-CI to read already-converged states from disk and begin SCF convergence on later states. Note that the same $cdft section must be used for the stopped calculation and the restarted calculation.
TYPE:
       INTEGER
DEFAULT:
       0
OPTIONS:
       $n$ Start calculations on state $n+1$
RECOMMENDATION:
       Use this setting in conjunction with CDFTCI_STOP.