next up previous contents
Next: 3.4 RASREAD Up: 3. Tutorials Previous: 3.2 SCF

Subsections



3.3 RASSCF -- A Multi Configurational Self-Consistent Field Program

\begin{wrapfigure}{l}{45mm}
\leavevmode
\flowchart{rasscf}\end{wrapfigure}

A multi configurational approach is implemented in MOLCAS by the program module RASSCF. Both Complete Active Space (CASSCF) and Restricted Active Space (RASSCF) Self Consistent Field calculations can be performed with the RASSCF program module [1]. An open shell Hartree-Fock calculation is not possible with the SCF but it can be performed using the RASSCF module. An input listing for a CASSCF calculation of water appears in Figure 3.3. RASSCF requires orbital information of the system which can be obtained in two ways. Firstly, the SCF orbitals (symbolic name SCFORB) from the SCF module can be used, usually from a calculation run immediately before the current RASSCF calculation. The LUMOrb keyword must then appear in the RASSCF input. The second alternative is from a previous RASSCF calculation using the RASSCF transfer file, symbolic name JOBIPH, requiring the JOBIph keyword be used. Another MOLCAS program module, RASREAD (see page [*]), can produce various orbitals from the RASSCF transfer file for input into other MOLCAS program modules or into RASSCF using the LUMOrb keyword.

Figure 3.3. Sample input requesting the RASSCF module to calculate the eight-electrons-in-six-orbitals CASSCF energy of the second excited triplet state in the second symmetry group of a water molecule in C$_{2v}$ symmetry.

 &RASSCF &END
Title
 The CASSCF energy of water is calculated using C2v symmetry. 2 3B2 state.
Inactive
 1 0 0 0
Ras2
 3 2 0 1
nActEl
 8  0  0
Symmetry
 2
Spin
 3
CIRoot
 1 2
 2
LevShift
 1.0
LumOrb
*JobIph
End of Input

The TITLe performs the same function as in the previous MOLCAS modules. The keyword INACtive specifies the number of doubly occupied orbitals in each symmetry that will not be included in the electron excitations and thus remain doubly occupied throughout the calculation. A diagram of the complete orbital space available in the RASSCF module is given in Figure 3.1.

Figure: RASSCF orbital space including keywords and electron occupancy ranges.
\begin{wrapfigure}{r}{60mm}
\leavevmode
\epsffile{rasscf.eps}
\end{wrapfigure}

In our calculation, we have placed the oxygen 1$s$ orbital into the inactive space using the INACtive keyword. The keyword FROZen can be used, for example, on heavy atoms to reduce the Basis Set Superposition Error (BSSE). The RAS2 keyword specifies the number of orbitals in each symmetry to be include in the electron excitations with all possible occupations allowable. Because the RAS1 and RAS3 spaces are zero (not specified in the input in Figure 3.3) the RASSCF calculation will produce a CASSCF wave function. The RAS2 space is chosen to use all the orbitals available in each symmetry (expect the oxygen 1$s$ orbital). The keyword NACTel specifies the number of active electrons (8), maximum number of holes in the Ras1 space (0) and the maximum number of electrons in the Ras3 space (0). Using the keywords RAS1 and/or RAS3 to specify orbitals and specifying none zero numbers of holes/electrons will produce a RASSCF wave function. We are, therefore, performing an 8-in-6 CASSCF calculation of water.


Table: Examples of types of wave functions obtainable using the RAS1 and RAS3 spaces in the RASSCF module.
  Number of holes   Number of electrons
Description in RAS1 orbitals RAS2 orbitals in RAS3 orbitals
SD-CI 2 0 2
SDT-CI 3 0 3
SDTQ-CI 4 0 4
Multi Reference SD-CI 2 $n$ 2
Multi Reference SD(T)-CI 3 $n$ 2

There are a number of wave function types that can be performed by manipulating the RAS1 and RAS3 spaces. Table 3.2 lists a number of types obtainable. The first three are Configuration Interaction (CI) wave functions of increasing magnitude culminating with a Single, Double, Triples and Quadruples (SDTQ) CI. These can become multi reference if the number of RAS2 orbitals is non-zero. The last type provides some inclusion of the triples excitation by allowing three holes in the RAS1 orbitals but save computation cost by only allowing double excitations in the RAS3 orbitals.

The symmetry of the wave function is specified using the SYMMetry keyword. It specifies the number of the symmetry subgroup in the calculation. We have chosen the second symmetry species, b$_2$, for this calculation. We have also chosen the triplet state using the keyword SPIN. The keyword CIROot has been used to instruct RASSCF to find the second excited state in the given symmetry and spin. This is achieved by specifying the number of roots, 1, the dimension of the small CI matrix which must be as large as the highest required root and the number of the required root, 2 or second. Only for averaged calculations CIROot needs an additional line containing the weight of the selected roots.

A level shift was included using the LEVShift keyword to improve convergence of the calculation. In this case, the calculation does not converge without the use of the level shift. It is advisable to perform new calculations with a non-zero LEVShift value. Another possibility is to increase the maximum number of iterations for the macro and the super-CI Davidson procedures from the default values (20,20) using the keyword ITERations. The maximum values are (50,50).

Sometimes convergence problems might appear when the wave function is close to fulfill all the convergence criteria. An unfrequent but possible divergence might appear in a calculation starting from orbitals of an already converged wave function, or in cases where the convergence thresholds have been decreased below the default values. Option TIGHt may be useful in those cases. It contains the thresholds criteria for the Davidson diagonalization procedure. In situations such as those described above it is recommended to decrease the first parameter of TIGHt to a value lower than the default, for instance 1.0d-06. Finally, in environments with large memory capabilities, the MOLCAS option MOLCASRAMD (see user's guide) can reduce enormously the I/O times.

3.3.0.1 RASSCF Output

The RASSCF section of the MOLCAS output contains similar information to the SCF output. Naturally, the fact that we have requested an excited state is indicated in the output. In fact, both the lowest triplet state and the first excited state or second root are documented including energies. For both of these states the CI configurations with a coefficient greater than 0.05 are printed along with the partial electron distribution in the active space. Figure 3.3 shows the relevant output for the second root calculated. There are three configurations with a CI-coefficient larger than 0.05 and two with very much larger values. The number of the configuration is given in the first column and the CI-coefficient and weight are given in the last two columns. The electron occupation of the orbitals of the first symmetry for each configuration is given under the `111' using `2' for a fully occupied orbital and `u' for a singly occupied orbital containing an electron with an up spin. The down spin electrons are represented with a `d'. The occupation numbers of the active space for each symmetry is given below the contributing configurations. It is important to remember that the active orbitals are not ordered by any type of criterion within the active space.

Figure 3.3. RASSCF portion of output relating to CI configurations and electron occupation of natural orbitals.

      printout of CI-coefficients larger than   .05 for root   2
      energy=    -75.443990
      conf/sym  111 22 4     Coeff  Weight
             3  22u u0 2    .64031  .40999
             4  22u 0u 2    .07674  .00589
            13  2u0 2u 2   -.75133  .56450
            14  2u0 u2 2    .06193  .00384
            19  udu 2u 2    .06489  .00421

      Natural orbitals and occupation numbers for root  2
      sym 1:   1.986957   1.416217    .437262
      sym 2:   1.567238    .594658
      sym 4:   1.997668

The molecular orbitals are displayed in a similar fashion to the SCF section of the output except that the energies of the active orbitals are not defined and therefore are displayed as zero and the electron occupancies are those calculated by the RASSCF module. In a state average calculation (more than one root calculated), the MOs will be the natural orbitals corresponding to the state averaged density matrix and the occupation numbers will be the corresponding eigenvalues. Natural orbital occupation numbers for each state are printed as shown in Figure 3.3, but the MOs specific to a given state are not shown in the output. They are, however, available in the JOBIPH file. A number of molecular properties are also computed for the requested electronic state in a similar fashion to the SCF module.

The orbital file from a SCF calculation, SCFORB, or from a previous RASREAD calculation, RASORB, is symbolically linked to the INPORB for use by the RASSCF module. If the JOBIph keyword is specified in the RASSCF input, INPORB is ignored and the orbitals are taken from a JOBIPH-type file which must be linked with the name JOBOLD.


next up previous contents
Next: 3.4 RASREAD Up: 3. Tutorials Previous: 3.2 SCF
(C) Lund University, 2000

Back to Molcas home