Search the Site Index:





SCF

Updated on 28 Feb 2026

This keyword controls the functioning of the SCF procedure. Options are used to specify the desired behavior, alternate algorithms, and so on.

The regular SCF procedure uses a combination of EDIIS [Kudin02] and CDIIS, with no damping or Fermi broadening. In Gaussian, SCF=(Tight,XQC) is the default for methods for which QC is available (see the Availability tab) and SCF=Tight otherwise.

The ZQC option is often helpful with difficult conversion cases. For difficult-to-converge ROHF wavefunctions, for which quadratic convergence cannot be used, add Use=L506 to the route section.

See reference [Schlegel91a] for a discussion of SCF convergence and stability.

Algorithm Selection Options

DIIS

DIIS calls for and NoDIIS prohibits use of Pulay’s Direct Inversion in the Iterative Subspace (DIIS) extrapolation method [Pulay82].

CDIIS

Use only CDIIS. CDIIS implies Damp as well.

Fermi

Requests temperature broadening during early iterations [Rabuck99], combined with CDIIS and damping. NoFermi suppresses Fermi broadening and is the default. By default, Fermi also implies Damp and also includes level shifting.

Damp

Turn on dynamic damping of early SCF iterations. NoDamp is the default. However, damping is enabled if SCF=Fermi or SCF=CDIIS is requested. Note that damping and EDIIS do not work well together.

NDamp=N

Allow dynamic damping for up to N SCF iterations (the default is 10).

QC

Calls for the use of a quadratically convergent SCF procedure [Bacskay81] (QC). This involves starting with linear searches (when far from convergence) and then switching to Newton-Raphson steps when closer to convergence. This method is slower than regular SCF with DIIS extrapolation but is more reliable. SCF=QC is not available for restricted open shell (RO) calculations, PBC, CAS methods, GVB or NEO.

XQC

Perform the regular SCF procedure. If this does not converge, then switch to QC. It is the default for RHF and UHF when QC is allowed. NoXQC forces the regular SCF algorithm, and the calculation will fail if the SCF does not converge.

YQC

An algorithm designed for difficult SCF convergence cases involving very large molecules. It starts with the linear searches as in QC, but then switches to regular SCF instead of the Newton-Raphson part of QC.

ZQC

Starts with a regular SCF. If that does not converge, it switches to YQC.

MaxConventionalCycles=N

Sets the limit on conventional SCF cycles during SCF=XQC and SCF=YQC to N. The default is 48.

PseudoDiagonalization=N

Use pseudo-diagonalization in Link 502 whenever possible, with full diagonalization only at the early cycles, at the end, and every Nth cycle in between. PDiag is a synonym for this option. This is the default for semi-empirical methods (the default is N=30).

FullDiagonalization

Forces full diagonalization in Link 502. This is the default for HF and DFT. FDiag is a synonym for this option.

SD

Does steepest descent SCF

SSD

Does scaled steepest descent SCF.

SaveKPoint

Save k-point information at the conclusion of the SCF. NoSaveKPoint says not to save this data, and it is the default except for numerical frequency calculations for which SaveKPoint is the default.

DM

Calls for use of the direct minimization SCF program [Seeger76]. It is usually inferior to SCF=QC and retained for backwards compatibility and as a last resort. Available only for RHF closed shell and UHF open shell calculations.

VShift[=N]

Shift orbital energies by N*0.001 (i.e., N milliHartrees); N defaults to 100. This option disables automatic archiving. N=-1 disables level shifting; NoVShift is equivalent to this setting.

MaxCycle=N

Changes the maximum number of SCF cycles permitted to N; the default is 64 (or 512 for SCF=DM and SCF=QC).

FullLinear

Specifies that L508 (SCF=QC, SD, or SSD) should do full linear searches at each iteration. By default, a full minimization is done only if the initial microiteration caused the energy to go up.

FinalIteration

FinalIteration performs and NoFinalIteration prevents a final non-extrapolated, non-incremental iteration after an SCF using DIIS or a direct SCF has converged. The default is NoFinalIteration.

IncFock

Forces use of incremental Fock matrix formation. This is the default for direct SCF. NoIncFock prevents the use of incremental Fock matrix formation, and it is the default for conventional SCF.

Pass

For in-core calculations, saves the integrals on disk as well, to avoid recomputing them in Link 1002. Only useful for frequency jobs in conjunction with SCF=InCore. NoPass forces integrals to be recomputed during each in-core phase.

TightLinEq

Use tight convergence in linear equation solution throughout SCF=QC. By default, the convergence criterion is tightened up as the rotation gradient is reduced.

VTLinEq

Use even tighter convergence in the linear equation solutions (microiterations) throughout the QCSCF. The default is to tighten convergence as the rotation gradient is reduced. VTL is a synonym for VTLinEq.

Skip

Do not perform an SCF calculation.

Average=(N,M)

Performs an average of the N highest electrons in M orbitals. The orbitals involved are selected in the same way as for CASSCF(N,M).

Variational

Controls whether the SCF is variational or just self-consistent (NoVariational). The default is Variational, except for special cases such as SCRF external iterations or NBO deletions.

Integral Storage Options

Direct

Requests a direct SCF calculation, in which the two-electron integrals are recomputed as needed. This is the default SCF procedure in Gaussian. This is possible for all available methods, except for MCSCF second derivatives and anything using complex orbitals.

InCore

Insists that the SCF be performed storing the full integral list in memory. This is done automatically in a direct SCF calculation if sufficient memory is available. SCF=InCore is available to force in-core storage or abort the job if not enough is available. NoInCore prohibits the use of the in-core procedure, for both the SCF and CPHF.

Conventional

The two-electron integrals are stored on disk and read-in each SCF iteration. NoDirect is a synonym for Conventional.

Options Related to Convergence and Cutoffs

PtDensity=N

Specifies N points per Angstrom^2 (N>0) or -N tesserae (N<0). The default is 5.

Conver=N

Sets the SCF convergence criterion to 10-N. SCF convergence requires both <10-N RMS change in the density matrix and <10-(N-2) maximum change in the density matrix. Note that the energy change is not used to test convergence; however, an SCF 10-N RMS density matrix change typically corresponds to a 10-2N change in energy in atomic units. For GVB and CASSCF calculations, SCF convergence is determined not by change in the density matrix, but rather in terms of the orbital change and energy change, respectively.

VarAcc

Use modest integral accuracy early in direct SCF, switching to full accuracy later on. This is the default for direct SCF, and it can be turned off via NoVarAcc. VarInt is a synonym for VarAcc, and NoVarInt is a synonym for NoVarAcc.

Tight

Use normal, tight convergence in the SCF. This is the default. Synonymous with TightIntegrals.

Big

Turns off optional O(N3) steps to speed up very large calculations (>5000 basis functions).

MaxNR=N

Sets the maximum rotation gradient for a Newton-Raphson step in SCF=QC and SCF=YQC to 10-N. Below this threshold the program switches to the QC SCF procedure (if using SCF=QC), or to the regular SCF procedure (if using SCF=YQC). Above this, scaled steepest descent is used; above 100 times this, steepest descent is used. The default value for N is 2.

Symmetry-Related Options

IDSymm

Symmetrize the density matrix at the first iteration to match the symmetry of the molecule (“initial density symmetrize”). NoIDSymm is the default.

DSymm

Symmetrize the density matrix at every SCF iteration to match the symmetry of the molecule (“density symmetrize”). NoDSymm is the default. DSymm implies IDSymm.

NoSymm

Requests that all orbital symmetry constraints be lifted. It is synonymous with Guess=NoSymm and Symm=NoSCF.

Symm

Retain all symmetry constraints: make the number of occupied orbitals of each symmetry type (abelian irreducible representation) match that of the initial guess. Use this option to retain a specific state of the wavefunction throughout the calculation. It is the default only for GVB calculations.

IntRep

Calls for the SCF procedure to account for integral symmetry by replicating the integrals using the symmetry operations. Allows use of a short integral list even if the wavefunction does not have the full molecular symmetry. Available for L502 (the default for RHF, ROHF and UHF) and L508 (SCF=QC).

FockSymm

Calls for the SCF procedure to account for integral symmetry (use of the petite integral list) by symmetrizing the Fock matrices. This is the default. FSymm is a synonym for FockSymm.

Restart-Related Options

Save

Save the wavefunction on the checkpoint file every iteration, so the SCF can be restarted. This is the default for direct SCF. NoSave suppresses saving the wavefunction.

Restart

Restart the SCF from the checkpoint file. SCF=DM cannot be restarted. SCF=Restart skips steps which are not necessary when restarting an SCF calculation, but which are necessary when reading in a guess from a calculation with a different basis set or at a different geometry. In contrast, if you want to start a new SCF using the restart information from a calculation with a different geometry and/or a different basis set, use Guess=Restart.

The QC-based options (i.e., QC, XQC, YQC and ZQC) are not available for restricted open shell (RO) calculations, PBC, CAS methods, GVB or NEO.

SideMenu

SideMenu