scfguess

scfguess

This option defines the initial guess of SCF calculations.

type

Define the type of initial guess. In most cases, atmden is recommended. mwfn, which reads a guess from a converged SCF, is also a good choice.
For target state optimization (TSO), symmetry-broken systems, or other special calculations, fragden can be used.

Value hcore Use the eigenvectors of the core matrix as the initial guess. Usually performs poorly.
atmden Use the superposition of converged densities of all atoms in the system as the initial guess. Recommended for most cases.
fragden Use the superposition of converged densities of user-assigned fragments as the initial guess. Useful for TSO or symmetry-broken systems.
mwfn Read the wave function from a MWFN file as the initial guess.
tso Use a reference state (assigned with frag) to perform TSO calculation (assigned with orb). Only for TSO calculations.
Default atmden
file

When the type is mwfn, Qbics will read the wave function using this mwfn file name.
When the type is tso, Qbics will save the reference wave function using this mwfn file name.

Value A file name
Default job name + .mwfn
frag

This defines atomic fragments for the initial guess. The format is:

frag num_electrons spin_multiplicity atom_range

There can be an arbitrary number of fragments, but all atoms must be included once and only once. They are only activated when type is fragden.

For example:

In this case, the molecule is decomposed into 3 fragments:

  1. Atoms 1–9, with charge 0 and spin multiplicity 1;
  2. Atoms 10–15 and 18, with charge 0 and spin multiplicity 3 (beta orbitals occupied first);
  3. Atoms 16 and 17, with charge -1 and spin multiplicity 3.

For this guess, Qbics will perform 3 SCF calculations for all fragments, then superpose them as the initial guess for the SCF of the whole molecule. This can be used for ordinary, symmetry-broken, or TSO SCF.

Hint

The total charge of fragments does not have to be the same as the total system.


Hint

Please refer to the keyword do_tso in scf for more details about TSO, when you want to use frag.


orb

This defines the orbitals for initial guess. The format is:

orb num_electrons spin_multiplicity  alpha_MO_indices : beta_MO_indices

There can be arbitrary number of orbital spaces, but all orbitals must be included once and only once. They are only activated when type is mwfn.

For example:

In this case, the orbitals will be read from x.mwfn, and three orbital spaces are defined:

  • Alpha orbitals 1,2,3,4,5,6 and beta orbitals 1,2,3,4,5,6, with 12 electrons and spin multiplicity 1.
  • Alpha orbital 7 and beta orbital 8, with 2 electrons and spin multiplicity 1.
  • Alpha orbital 8 and beta orbital 7, with 0 electrons and spin multiplicity 1 (since no electrons are assigned, the spin multiplicity can be arbitrary).

For this guess, Qbics will read orbitals from x.mwfn and assign occupation according to orb, then perform the subsequent ordinary or TSO SCF calculations.

Also, note that in this keyword, orbital order matters. For example,

In this case, the 7 alpha and 7 beta electrons will occupy orbitals 1,2,3,4,5,6,9.

Hint

Please refer to the keyword do_tso in scf for more details about TSO, when you want to use orb.