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
CC_CONVERGENCE
Overall convergence criterion for the coupled-cluster codes. This is designed
to ensure at least 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) [].
TYPE:
INTEGER
DEFAULT:
6
Energies.
7
Gradients.
OPTIONS:
Corresponding to 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
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:
Integer code is mapped to , e.g.,
corresponds to 0.025, 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
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:
Integer code is mapped to , e.g.,
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
CC_MAX_ITER
Maximum number of iterations to optimize the coupled-cluster energy.
TYPE:
INTEGER
DEFAULT:
200
OPTIONS:
up to iterations to achieve convergence.
RECOMMENDATION:
None
CC_PRINT
CC_PRINT
Controls the output from post-MP2 coupled-cluster module of Q-Chem
TYPE:
INTEGER
DEFAULT:
1
OPTIONS:
higher values can lead to deforestation…
RECOMMENDATION:
Increase if you need more output and don’t like trees
CHOLESKY_TOL
CHOLESKY_TOL
Tolerance of Cholesky decomposition of two-electron integrals
TYPE:
INTEGER
DEFAULT:
3
OPTIONS:
Corresponds to a tolerance of
RECOMMENDATION:
2 - qualitative calculations, 3 - appropriate for most cases, 4 - quantitative
(error in total energy typically less than 1 hartree)
CC_DIRECT_RI
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.