# 6.10.8 Job Control Options

(May 16, 2021)

There are a large number of options for the coupled-cluster singles and doubles methods. They are documented in Appendix C, and, as the reader will find upon following this link, it is an extensive list indeed. Fortunately, many of them are not necessary for routine jobs. Most of the options for non-routine jobs concern altering the default iterative procedure, which is most often necessary for optimized orbital calculations (OD, QCCD), as well as the active space and EOM methods discussed later in Section 6.12. The more common options relating to convergence control are discussed there, in Section 6.12.6. Below we list the options that one should be aware of for routine calculations.

For memory options and parallel execution, see Section 6.16.

CC_CONVERGENCE
Overall convergence criterion for the coupled-cluster codes. This is designed to ensure at least $n$ significant digits in the calculated energy, and automatically sets the other convergence-related variables (CC_E_CONV, CC_T_CONV, CC_THETA_CONV, CC_THETA_GRAD_CONV) [$10^{-n}$].
TYPE:
INTEGER
DEFAULT:
OPTIONS:
$n$ Corresponding to $10^{-n}$ convergence criterion. Amplitude convergence is set automatically to match energy convergence.
RECOMMENDATION:
Use the default

Note:  For single point calculations, CC_E_CONV = 6 and CC_T_CONV = 4. Tighter amplitude convergence (CC_T_CONV = 5) is used for gradients and EOM calculations.

CC_DOV_THRESH
Specifies minimum allowed values for the coupled-cluster energy denominators. Smaller values are replaced by this constant during early iterations only, so the final results are unaffected, but initial convergence is improved when the HOMO-LUMO gap is small or when non-conventional references are used.
TYPE:
INTEGER
DEFAULT:
0
OPTIONS:
$abcde$ Integer code is mapped to $ab\times 10^{-de}$, e.g., $2501$ corresponds to 0.025, $99001$ corresponds to 0.99, etc.
RECOMMENDATION:
Increase to 0.25, 0.5 or 0.75 for non convergent coupled-cluster calculations.

Note:  Works only for CCMAN jobs, not enabled in CCMAN2.

CC_SCALE_AMP
If not 0, scales down the step for updating coupled-cluster amplitudes in cases of problematic convergence.
TYPE:
INTEGER
DEFAULT:
0 no scaling
OPTIONS:
$abcd$ Integer code is mapped to $abcd\times 10^{-2}$, e.g., $90$ corresponds to 0.9
RECOMMENDATION:
Use 0.9 or 0.8 for non convergent coupled-cluster calculations.

Note:  Now available for both CCMAN and CCMAN2.

CC_MAX_ITER
Maximum number of iterations to optimize the coupled-cluster energy.
TYPE:
INTEGER
DEFAULT:
200
OPTIONS:
$n$ up to $n$ iterations to achieve convergence.
RECOMMENDATION:
None

CC_PRINT
Controls the output from post-MP2 coupled-cluster module of Q-Chem
TYPE:
INTEGER
DEFAULT:
1
OPTIONS:
$0-7$ higher values can lead to deforestation…
RECOMMENDATION:
Increase if you need more output and don’t like trees

CHOLESKY_TOL
Tolerance of Cholesky decomposition of two-electron integrals
TYPE:
INTEGER
DEFAULT:
3
OPTIONS:
$n$ Corresponds to a tolerance of $10^{-n}$
RECOMMENDATION:
2 - qualitative calculations, 3 - appropriate for most cases, 4 - quantitative (error in total energy typically less than 1 $\mu$hartree)

CC_DIRECT_RI
Controls use of RI and Cholesky integrals in conventional (undecomposed) form
TYPE:
LOGICAL
DEFAULT:
FALSE
OPTIONS:
FALSE use all integrals in decomposed format TRUE transform all RI or Cholesky integral back to conventional format
RECOMMENDATION:
By default all integrals are used in decomposed format allowing significant reduction of memory use. If all integrals are transformed back (TRUE option) no memory reduction is achieved and decomposition error is introduced, however, the integral transformation is performed significantly faster and conventional CC/EOM algorithms are used.