nextuppreviouscontents
MOLCAS manual:

Next: 4.2 Program-based tutorials Up: 4. Tutorials Previous: 4. Tutorials

Subsections


4.1 Problem-based tutorials

4.1.1 Computing the electronic energy at fixed nuclear geometry

The MOLCAS 7.4 suite of quantum chemical programs is modular in design. The desired calculation is achieved by executing a list of MOLCAS program modules in succession, occasionally manipulating the program information files. If the information files from a previous calculation are saved then a subsequent calculation need not recompute them. This is dependent on the correct information being preserved in the information files for the subsequent calculations. Each module has keywords to specify thefunctions to be carried out and many modules rely on the specification of keywords in previous modules.

In the present examples the calculations will be designed by preparing a single file in which the input for the different programs is presented sequentially. Our initial problem will be to compute an electronic energy at a fixed geometry of the nuclei, and this will be done using different methods and thus different program modules.

First, the proper MOLCAS environment has to be set up. The following variables must be properly defined, for instance:



export   MOLCAS=/home/molcas/molcas.7.4\

export   Project=CH4
export   WorkDir=/home/user/tmp

If not defined, MOLCAS gives them the default values. The MOLCAS variable will be set up as the latest implemented version of the code. Once in the MOLCAS home directory the variable is set up directly. Project and WorkDir have the default values None and $PWD, respectively. It is very important that the molcas driver, called by command molcas and built during the installation of the code, is included in the $PATH.

We prepare our first run: the calculation of the SCF energy of the methane (CH4) molecule. Three programs should be used: GATEWAY to specify information about the system, SEWARD to compute and store the one- and two-electron integrals, and SCF to obtain the Hartree-Fock SCF wave function and energy. Three inputs should be prepared. The GATEWAY input will contain the nuclear geometry in cartesian coordinates and the label for the one-electron basis set, here, for instance, an STO-3G minimal basis set. We shall use here the keyword coord, which allows to automatically create a GATEWAY input from a standard file containing the cartesian coordinates in Angstrom (as generated by many programs like MOLCAS GV or MOLDEN). No symmetry is being considered so far, therefore we introduce the keyword nosym to force the program not to look for any symmetry in the molecule. In this case the input for SEWARD is void. In a closed-shell case like this one the SCF input can be left empty. All the input files used here can be found at $MOLCAS/doc/examples/tutorials, like the file SCF.energy.CH4 described below.



*SCF   energy   for   CH4   at   a   fixed   nuclear   geometry.
*File:   SCF.energy.CH4
*
   &GATEWAY
Title   =   CH4   molecule
coord   =   CH4.xyz
basis   =   STO-3G
group   =   C1

   &SEWARD

   &SCF
Title   =   CH4   molecule

where the content of the CH4.xyz file is:



5
Angstrom
  0.000000   0.000000   0.000000
  0.000000   0.000000   1.050000
  1.037090   0.000000   -0.366667
  -0.542115   -0.938971   -0.383333
  -0.565685   0.979796   -0.400000

Now, to run MOLCAS we simply type:



molcas   SCF.energy.CH4.input   >   SCF.energy.CH4.out   2   >   SCF.energy.CH4.err

or,

molcas   -f   SCF.energy.CH4.input

and the main output will be stored in file SCF.energy.CH4.out (or in the second case SCF.energy.CH4.log: and the default error file in SCF.energy.CH4.err. The most relevant information will be contained in the output file, where we shall analyze the SEWARD program information, describing the nuclear geometry, molecular symmetry, and the data regarding the one-electron basis sets and the calculation of one- and two-electron integrals, as described in section 4.2.2. Next, comes the output of program SCF with information of the electronic energy, wave function, and the Hartree-Fock (HF) molecular orbitals (see section 4.2.3). Files containing intermediate information, integrals, orbitals, etc, will be kept in the $WorkDir directory for further use. For instance files $Project.OneInt and $Project.OrdInt contains the one- and two-electron integrals stored in binary format. File $Project.ScfOrb keeps the HF molecular orbitals in ASCII format. Finally, $Project.RunFile is a communication file between programs. All those files can be later used for more advanced calculations in order to avoid repeating the already run calculations.

There are some graphical utilities that can be used for the analysis of the results. By default, MOLCAS generates files which can be read with the MOLDEN program. In particular we can find in $WorkDir the file CH4.scf.molden, where information about molecular geometry, molecular orbitals (use Density Mode in MOLDEN), etc, can be found (See also section [*]). However, MOLCAS has its own graphical tool, program GV, which is an openGL based viewer and allows to visualize molecular geometries, orbitals, densities, and density differences. For instance, to obtain a graphical display of the molecule from a standard coordinate file we type:



molcas   gv   CH4.xyz

while option gv -c should be used if reading from a SEWARD input. Once in the screen the molecule can be manipulated in many ways, fo example, changing its geometry, adding or deleting atoms, etc. You can also use it to build new molecules.

In order to obtain the information to display molecular orbitals and densities it is necessary to run a MOLCAS program named GRID_IT



*SCF   energy   for   CH4   at   a   fixed   nuclear   geometry   plus   a   grid   for   visualization.
*File:   SCF.energy_grid.CH4
*
   &GATEWAY
Title   =   CH4   molecule
coord   =   CH4.xyz
basis   =   STO-3G
Group   =   C1

   &SEWARD;   &SCF

   &GRID_IT
All;   Ascii

and run it:



molcas   SCF.energy_grid.CH4.input   >   SCF.energy_grid.CH4.out   2   >   SCF.energy_grid.CH4.err

GRID_IT can also be run separately if an orbital file is specified in the input and the $WorkDir directory is available. In the $WorkDir and $PWD directories a new file is generated, CH4.grid which contains the information required by the GRID_IT input. By typing:



molcas   gv   CH4.grid

a window will be opened displaying the molecule and its charge density. By proper selection with the mouse buttons, shape and size of several molecular orbitals can be selected. Typing molcas gv -? one can get a short help for the use of the program. More information can be found in sections [*] for GRID_IT and [*] GV programs.

As an alternative to run the projects we include here a short script to be placed in the directory $MOLCAS/doc/samples/problem_based_tutorials as the file project.sh. Just run project.sh $Project, where $Project is the MOLCAS input and you will get output and error files and a $WorkDir directory named $Project.work.



#!/bin/bash

cd   ../../..
export   MOLCAS=$PWD
export   MOLCASDISK=2000
export   MOLCASMEM=64
export   MOLCAS_PRINT=3

export   Project=$1
export   HomeDir=$MOLCAS/doc/samples/problem_based_tutorials
export   WorkDir=$HomeDir/$Project.work
mkdir   $WorkDir   2>/dev/null
cp   $HomeDir/*xyz   $WorkDir/
cd   $WorkDir
molcas   $HomeDir/$1   >$HomeDir/$Project.out   2>$HomeDir/$Project.err
exit

In order to run a Kohn-Sham density functional calculation, MOLCAS uses the same SCF module, therefore the only change needed is to specify in the SCF input the DFT option and the required functional, for instance here, B3LYP:



*DFT   energy   for   CH4   at   a   fixed   nuclear   geometry   plus   a   grid   for   visualization.
*File:   DFT.energy.CH4
*
   &GATEWAY
Title   =   CH4   molecule
coord   =   CH4.xyz
basis   =   STO-3G
group   =   C1

   &SEWARD

   &SCF
Title   =   CH4   molecule
KSDFT   =   B3LYP

   &GRID_IT
All

and the same graphical files can be found in $WorkDir and $PWD.

Our next step is to get the second-order Møller-Plesset perturbation (MP2) energy for methane at the same molecular geometry and using the same one-electron basis set. Program MBPT2 has to be invoked this time. We can take advantage of having previously computed the proper integrals with SEWARD and the reference closed-shell HF wave function with the SCF program. In such case we may keep the same definitions as before and simply prepare a file containing the MBPT2 input and run it using the molcas command. The proper intermediate file will be already in $WorkDir. If, on the contrary, one has to start from scratch, all required inputs should be placed sequentially, for instance, in the MP2.energy.CH4 file. If we decide to start the project from the beginning is convenient to remove the $WorkDir directory, unless we are certain about the files we are going to find there.



*MP2   energy   for   CH4   at   a   fixed   nuclear   geometry.
*File:   MP2.energy.CH4
*
   &GATEWAY
Title   =   CH4   molecule
coord   =   CH4.xyz
basis   =   STO-3G
group   =   C1

   &SEWARD
   &SCF
   &MBPT2
Title   =   CH4   molecule
Frozen   =   1

On top of the HF wave function, an MP2 calculation has been performed with the deepest orbital, carbon 1s, of the molecule frozen. Information about the output of the MBPT2 program can be found on section 4.2.13.

The SCF program works by default with closed-shell systems with an even number of electrons at the Restricted Hartee-Fock (RHF) level. We may instead want to use the Unrestricted Hartree Fock (UHF) method, by invoking the keyword UHF. This is possible for both even and odd electron systems. For instance in a system with odd number of electrons like the CH3 radical



4
Angstrom
  0.000000   0.000000   0.000000
  0.000000   0.000000   1.050000
  1.037090   0.000000   -0.366667
  -0.542115   -0.938971   -0.383333

the input to run an open-shell UHF calculation will be simply



*SCF/UHF   energy   for   CH3   at   a   fixed   nuclear   geometry
*File:   SCF.energy_UHF.CH3
*
   &GATEWAY
Title   =   CH3   molecule
coord   =   CH3.xyz
basis   =   STO-3G
group   =   C1
   &SEWARD
   &SCF
Title=   CH3   molecule
UHF

If we want to force a charged system, this must be indicated in the SCF input, for instance to compute the cation of the CH4 molecule at the UHF level:



*SCF/UHF   energy   for   CH4+   at   a   fixed   nuclear   geometry
*File:   SCF.energy_UHF.CH4plus
*
   &GATEWAY
Title   =   CH4+   molecule
coord   =   CH4.xyz
basis   =   STO-3G
group   =   c1

   &SEWARD

   &SCF
Title   =   CH4+   molecule
UHF
Charge   =   +1

The Kohn-Sham DFT calculation can be also run on the basis of the UHF algorithm



*DFT/UHF   energy   for   CH4+   at   a   fixed   nuclear   geometry
*File:   DFT.energy.CH4plus
*
   &GATEWAY
Title   =   CH4+   molecule
coord   =   CH4.xyz
basis   =   STO-3G
group   =   C1

   &SEWARD

   &SCF
Title   =   CH4+   molecule
KSDFT   =   B3LYP
UHF
Charge   =   +1

In the UHF (and UHF/DFT) method it is also possible to force particular $\alpha$ and $\beta$ orbital occupations. There are two ways to do it. First, with keyword ZSPIn in the SCF program, which represents the difference between the number of $\alpha$ and $\beta$ electrons. For instance, we can set the keyword to two and force the program to converge a situation with two more $\alpha$ than $\beta$ electrons.



*DFT/UHF   energy   for   different   electronic   occupation   in   CH4   at   a   fixed   nuclear
geometry
*File:   DFT.energy_zspin.CH4
*
   &GATEWAY
Title   =   CH4   molecule
coord   =   CH4.xyz
basis   =   STO-3G
group   =   c1
   &SEWARD

   &SCF
Title   =   CH4   molecule   zspin   2
UHF;   ZSPIN   =   2
KSDFT   =   B3LYP

In the output the final occupations are six $\alpha$ and four $\beta$ orbitals. Alternatively, instead of ZSPIn we may force from the beginning the occupation numbers with keyword Occupation, followed by one line containing the occupied $\alpha$ orbitals, six here, and another line with the $\beta$ orbitals, four here. Sometimes convergence can be improved with this option.

Different sets of methods use other MOLCAS modules. For instance, to perform a Complete Active Space (CAS) SCF calculation, the RASSCF program has to be used. This module requires starting trial orbitals, which can be obtained from a previous SCF calculation or automatically by SEWARD, which provides trial orbitals by using a model Fock operator. Recommended keywords are Nactel, defining the total number of active electrons, holes in Ras1, and particles in Ras3, respectively (the two last ones only for RASSCF-type calculations), Inactive, including the number of orbitals inactive (occupation always two) in the CASSCF reference, and Ras2, defining the number of active orbitals. By default the obtained wave function will correspond to the lowest state of the symmetry with spin multiplicity one. Most of the input can be avoided if one has prepared and linked an INPORB file with the different orbital types defined (for example with the programs GV).



*CASSCF   energy   for   CH4   at   a   fixed   nuclear   geometry
*File:   CASSCF.energy.CH4
*
   &GATEWAY
coord   =   CH4.xyz
basis   =   STO-3G
group   =   C1

   &SEWARD

   &RASSCF
   Title   =   CH4   molecule
   Spin   =   1;   Nactel   =   8   0   0;   Inactive   =   1;   Ras2   =   8

   &GRID_IT
All;   Ascii

In this case we are computing the lowest singlet state, the ground state here, considering that this is a closed-shell situation, with an active space of eight electrons in eight orbitals. The lowest orbital of the molecule (carbon 1s) has been left inactive. This is a CASSCF case in which all the valence orbitals and electrons (carbon 2s2p plus four hydrogen 1s) have been included in the active space.

Using the CASSCF wave function as a reference, we can perform a second-order perturbative, CASPT2, correction to the electronic energy by employing the CASPT2 program. If we maintain in the $WorkDir directory the files generated by the previous run (in particular the following files: integral files CH4.OneInt,CH4.OrdInt; CASSCF wave function information file CH4.JobIph, and communication file CH4.RunFile), it will not be necessary to run again programs SEWARD, and RASSCF. In that case it will be enough to prepare an input for the CASPT2 program and run it. Here, however, we include the full input file:



*CASPT2   energy   for   CH4   at   a   fixed   nuclear   geometry
*File:   CASPT2.energy.CH4
*
   &GATEWAY
coord   =   CH4.xyz;   basis   =   STO-3G;   group   =   C1

   &SEWARD

   &RASSCF
   LumOrb
   Title   =   CH4   molecule
   Spin   =   1;   Nactel   =   6   0   0;   Inactive   =   2;   Ras2   =   6

   &CASPT2
Title   =   CH4   molecule
Multistate   =   1   1

As an alternative to generate trial orbitals for the RASSCF program, we have added here an input for the SCF program. In most of cases the Hartree-Fock orbitals will be a better choice as starting orbitals. In that case, the RASSCF input has to include keyword LumOrb to read from any external source of orbitals other than those generated by the SEWARD program. We have also changed the input of the RASSCF program. Now the number of active orbitals is six, as well as the active electrons. We have excluded from the space the two lowest orbitals (Inactive 2) and also another orbital goes to the secondary space. If we had stayed with the previous (8,8) full valence space, considering that we are using a minimal basis set, the CASPT2 program would not have more electronic correlation energy to include. Regarding the input for the CASPT2 program we have frozen the lowest orbital (carbon 1s).

We may change the charge and multiplicity of our wave function by computing the CH4+ cation with the same methods. It is the RASSCF program which defines the character of the problem by specifying number of electrons, and spin and spatial symmetry. We have here one electron less and a doublet multiplicity.



*CASSCF   energy   for   CH4+   at   a   fixed   nuclear   geometry
*File:   CASSCF.energy.CH4plus
*
   &GATEWAY
Title   =   CH4+   molecule
coord   =   CH4.xyz;   basis   =   STO-3G;   Group   =   C1

   &SEWARD

   &RASSCF
   Title   =   CH4+   molecule
   Spin   =   2;   Nactel   =   5   0   0;   Inactive   =   2;   Ras2   =   6

No further modification is needed in the CASPT2 input:



*CASPT2   energy   for   CH4+   at   a   fixed   nuclear   geometry
*File:   CASPT2.energy.CH4plus
*
   &GATEWAY
coord   =   CH4.xyz;   basis   =   STO-3G;   group   =   C1

   &SEWARD

   &RASSCF
   Title   =   CH4+   molecule
   Spin   =   2;   Nactel   =   1   0   0;   Inactive   =   4;   Ras2   =   1

   &CASPT2
Title   =   CH4   molecule

A somewhat more sophisticated calculation can be performed at the Restricted Active Space (RAS) SCF level. In such case the level of excitation in the CI expansion can be controlled by restricting the number of holes and particles present in certain orbitals.



*RASSCF   energy   for   CH4   at   a   fixed   nuclear   geometry
*File:   RASSCF.energy.CH4
*
   &GATEWAY
coord   =   CH4.xyz;   basis   =   STO-3G;   group   =   C1

   &SEWARD

   &RASSCF
   Title   =   CH4   molecule
   Spin   =   1;   Nactel   =   8   1   1
   Inactive   =   1;   Ras1   =   1;   Ras2   =   6;   Ras3   =   1

In particular the previous calculation includes one orbital within the Ras1 space and one orbital within the Ras3 space. One hole (single excitation) at maximum is allowed from Ras1 to Ras2 or Ras3, while a maximum of one particle is allowed in Ras3, either coming from Ras1 or Ras2. Within Ras2 all type of orbital occupations are allowed. The RASSCF wave functions can, in principle, be used as reference for multiconfigurational perturbation theory (RASPT2) but this approach is still in the experimental stage.

MOLCAS also has the possibility of computing electronic energies at different CI levels by using the MRCI program. We have prepared here a Singles and Doubles CI (SDCI) calculation on the CH4 molecule. To set up the calculations, programs MOTRA, which transforms the integrals to molecular basis, and GUGA, which computes the coupling coefficients, have to be run before the MRCI program. In MOTRA we have specified the reference orbitals employed (those from an HF SCF calculation) and the frozen orbitals. In GUGA we describe the reference for the CI, with the number of correlated electrons, the spatial and spin symmetry, the inactive orbitals (always occupation two in the reference space), and the type of CI expansion.



*SDCI   energy   for   CH4   at   a   fixed   nuclear   geometry
*File:   SDCI.energy.CH4
*
   &GATEWAY
Title   =   CH4   molecule
coord   =   CH4.xyz;   basis   =   STO-3G;   group   =   c1

   &SEWARD

   &SCF
Title=   CH4   molecule

   &MOTRA
Lumorb
Title=   CH4   molecule
Frozen=   1

   &GUGA
Title=   CH4   molecule
Electrons   =   8
Spin   =   1
Inactive=   4
Active=   0
Ciall=   1

   &MRCI
Title=   CH4   molecule
SDCI

If we want to use reference orbitals from a previous CASSCF calculation, the RASSCF program will have to be run before the MOTRA module. Also, if the spatial or spin symmetry are changed for the CI calculation, the modifications will be introduced in the GUGA input. Many alternatives are possible in order to perform an MRCI calculation like next one, in which the reference space to perform the CI is multiconfigurational:



*MRCI   energy   for   CH4   at   a   fixed   nuclear   geometry
*File:   MRCI.energy.CH4
*
   &GATEWAY
Title   =   CH4   molecule
coord   =   CH4.xyz;   basis   =   STO-3G;   group   =   c1

   &SEWARD;   &SCF

   &RASSCF
LumOrb
Title=   CH4   molecule
Spin=   1;   Nactel=   6   0   0;   Inactive=   2;   Ras2=   6

   &MOTRA
Lumorb
Title=   CH4   molecule
Frozen=   1

   &GUGA
Title=   CH4   molecule
Electrons=   8
Spin=   1
Inactive=   2
Active=   3
Ciall=   1

   &MRCI
Title=   CH4   molecule
SDCI

The MRCI program allows also to get electronic energies using the ACPF method. Another MOLCAS program, CPF, offers the possibility to use the CPF, MCPF, and ACPF methods with a single reference function. The required input is quite similar than that for the MRCI program:



*CPF   energy   for   CH4   at   a   fixed   nuclear   geometry
*File:   CPF.energy.CH4
*
   &GATEWAY
Title=   CH4   molecule
coord   =   CH4.xyz;   basis   =   STO-3G;   group   =   c1

   &SEWARD;   &SCF
   &MOTRA
Lumorb
Title=   CH4   molecule
Frozen=   1

   &GUGA
Title=   CH4   molecule
Electrons=   8
Spin   =   1
Inactive   =   4
Active   =   0
Ciall=   1

   &CPF
Title=   CH4   molecule
CPF

Finally, MOLCAS can also perform closed- and open-shell coupled cluster calculations at the CCSD and CCSD(T) levels. They are controlled by the CCSDT program, whose main requirement is that the reference function has to be generated with RASSCF. The following input is required to obtain the CCSD(T) energy for the CH4 molecule:



*CCSDT   energy   for   CH4   at   a   fixed   nuclear   geometry
*File:   CCSDT.energy.CH4
*
   &GATEWAY
Title=   CH4   molecule
coord   =   CH4.xyz;   basis   =   STO-3G;   group   =   c1

   &SEWARD

   &RASSCF
   Title=   CH4   molecule
   Spin=   1;   Nactel=   0   0   0;   Inactive=   5;   Ras2=   0
   OutOrbitals
   Canonical

   &MOTRA
JobIph
Title=   CH4   molecule
Frozen=   1

   &CCSDT
Title=   CH4   molecule
CCT

As it is a closed-shell calculation, the RASSCF input is prepared to compute a simple RHF wave function (zero active electrons and orbitals), with keywords OutOrbitals Canonical. The MOTRA has to include the keyword JobIph to extract the wave function information from file JOBIPH (automatically generated by RASSCF). Finally, CCT in program CCSDT leads to the calculation of the CCSD(T) energy using the default algorithms.

The CCSDT program in MOLCAS is specially suited to compute open-shell cases. The input required to obtain the electronic energy of the CH4+ cation with the CCSD(T) method is:



*CCSDT   energy   for   CH4+   at   a   fixed   nuclear   geometry
*File:   CCSDT.energy.CH4plus
*
   &GATEWAY
Title=   CH4+   molecule
coord   =   CH4.xyz;   basis   =   STO-3G;   group   =   c1

   &SEWARD

   &RASSCF
Title=   CH4+   molecule
Spin=   2;   Nactel=   1   0   0;   Inactive=   4;   Ras2=   1
OutOrbitals
   Canonical

   &MOTRA
JobIph
Title=   CH4+   molecule
Frozen=   1

   &CCSDT
Title=   CH4+   molecule
CCT

where it is the RASSCF program which generated the proper Restricted Open-Shell (RO) HF reference. Different levels of spin adaptation are available.

We may want to introduce the effect of solvents into our calculation. MOLCAS includes two models: Kirkwood and PCM. To add solvent effect to a ground state at the HF, DFT, or CASSCF levels simply requires to include the RF-input within SEWARD, while the reaction field is computed self-consistently.



*DFT   energy   for   CH4   in   water   at   a   fixed   nuclear   geometry
*File:   DFT.energy_solvent.CH4
*
   &GATEWAY
Title=   CH4   molecule
coord   =   CH4.xyz;   basis   =   STO-3G;   group   =   c1

   &SEWARD
RF-input
   PCM-model;   solvent=   water
End   of   RF-input

   &SCF
Title=   CH4   molecule
KSDFT=   B3LYP

Other programs such as CASPT2, RASSI, and MOTRA require that the reaction field is included as a perturbation with keyword RFPErturbation. In the next example the correction is added at both the CASSCF and CASPT2 levels.



*CASPT2   energy   for   CH4   in   acetone   at   a   fixed   nuclear   geometry
*File:   CASPT2.energy_solvent.CH4
*
   &GATEWAY
Title=   CH4   molecule
coord   =   CH4.xyz;   basis   =   STO-3G;   group   =   c1

   &SEWARD
RF-input
   PCM-model;   solvent=   acetone;   AAre=   0.2
End   of   RF-input

   &RASSCF
Title=   CH4   molecule
Spin=   1;   Nactel=   6   0   0;   Inactive=   2;   Ras2=   6

   &CASPT2
Title=   CH4   molecule
Frozen=   1
Multistate=   1   1
RFPert

Notice that the tesserae of the average area in the PCM model (keyword Aare has been changed to the value required for acetone, while the default is 0.4 Å2 for water (see section [*]). More detailed examples can be found in section 5.6.

4.1.2 Optimizing geometries: minima, transition states, crossings, and minimum energy paths

We may want now to explore potential energy surfaces (PES) and optimize the molecular geometry for specific points in the PES. Different cases can be accomplished, like getting the optimal geometry in a minimum energy search , to obtain a transition state structure connecting different regions of the PES, to find the crossing between two PES in which the energy becomes degenerate, or mapping the minimum (steepest descendent) energy path (MEP) from a specific point if the PES downward to a minimum energy situation. All these searches can be performed fully optimizing all the degrees of freedom of the system or introducing certain restrictions. MOLCAS 7.4 can perform geometry optimizations at the SCF (RHF and UHF), DFT (RHF and UHF based), CASSCF (CASSCF and RASSCF), and CASPT2 and other correlated levels, although in the last case only numerical gradients are available, where in the other cases more efficient analytical gradients are used.

Geometry optimizations require many loops, in which the electronic energy is estimated at a specific level of calculation and the gradients of the energy (first derivatives) with respect to the geometric degrees of freedom (DOF) are computed. With this information at hand the program has to decide if we are already at the final required geometry (for instance if gradient is zero for all DOF we may have reached a minimum in the PES) or if we must change the geometry to try to get a better solution in a new iteration. The input file should therefore be built in a way that allows to loop over the different programs. The general input commands Do while and Enddo control the loop and the input is be inserted within them. We may want to add also instructions about the number of maximum iterations allowed and the type of output required (see section [*]). We shall use here commands Set output file, which prints outputs for all iterations and places them in the $WorkDir directory with the name Structure.$iteration.output, and Set maxiter 100, which sets maximum iterations to one hundred.

The selected example is the geometry optimization of the water molecule at the SCF RHF level of calculation:



*SCF   minimum   energy   optimization   for   H2O
*File:   SCF.minimum_optimization.H2O
*
   &GATEWAY
Title=   H2O   minimum   optimization
Basis   set
O.ANO-S...2s1p.
  0.000000   0.000000   0.000000   Angstrom
End   of   basis
Basis   set
H.ANO-S...1s.
H1   0.758602   0.000000   0.504284   Angstrom
H2   0.758602   0.000000   -0.504284   Angstrom
End   of   basis


>>>   Do   while
   &SEWARD   ;&SCF;   &SLAPAF
>>>   EndDo

The sequence of programs employed is GATEWAY (out of the loop), and then SEWARD, SCF, and SLAPAF. SEWARD is computes the integrals SCF program computes the RHF energy, and wave function. SLAPAF will control the calculation of gradientns and estimate if the calculation has already finished or need to proceed to a new nuclear geometry for the next iteration. Automatically a file named $Project.geo.molden will be generated in $WorkDir containing all the geometric steps contained in the optimization process. MOLDEN can read such file.

To move to another reference wave function means simply to change the initial programs. For instance, we can perform an UHF calculation of the H2O+ cation:



*UHF   minimum   energy   optimization   for   H2O+
*File:   UHF.minimum_optimization.H2Oplus
*
   &GATEWAY
Title=   H2O   minimum   optimization
Basis   set
O.ANO-S...2s1p.
  0.000000   0.000000   0.000000   Angstrom
End   of   basis
Basis   set
H.ANO-S...1s.
H1   0.758602   0.000000   0.504284   Angstrom
H2   0.758602   0.000000   -0.504284   Angstrom
End   of   basis
>>   Do   while

   &SEWARD
   &SCF;   Title="H2O   minimum   optimization";   UHF;   Charge=1
   &SLAPAF

>>   EndDo

The same procedure can be followed if we pretend to perform a DFT geometry optimization:



*DFT   minimum   energy   optimization   for   H2O
*File:   DFT.minimum_optimization.H2O
*
   &GATEWAY
Title=   H2O   minimum   optimization
Basis   set
O.ANO-S...2s1p.
  0.000000   0.000000   0.000000   Angstrom
End   of   basis
Basis   set
H.ANO-S...1s.
H1   0.758602   0.000000   0.504284   Angstrom
H2   0.758602   0.000000   -0.504284   Angstrom
End   of   basis

>>>   Set   maxiter   100
>>>   Do   while

   &SEWARD
   &SCF   ;   Title="H2O   minimum   optimization";   KSDFT=B3LYP
   &SLAPAF   &END

>>>   EndDo

Once we have found an energy minimum based on the calculation of gradients, we may ensure that this is really a minimum energy point, what can be only accomplished by computing second derivatives of the energy, that is, the Hessian. MOLCAS can compute analytical Hessians for SCF and single state CASSCF wave functions. For some other methods one can use numerical procedures to compute the Hessian. Once the Hessian is computed we have the vibrational frequencies and we can apply statistical mechanics to obtain thermodynamic properties. If we are in a true energy minimum, all frequencies will be real (instead of imaginary). Program MCKINLEY computes second derivatives of a predefined (SCF or CASSCF) wave function, while MCLR performs the vibrational and statistical analyses. MOLCAS simply requires an input for the MCKINLEY program to do all the job by using keywords Perturbation Hessian, while program MCLR will be called automatically and no input is required. We include here the full set of calculations, first, a geometry optimization, followed by the calculation of a Hessian.



*SCF   minimum   energy   optimization   plus   hessian   of   the   water   molecule
*File:   SCF.minimization_plus_hessian.H2O
*
   &GATEWAY
Title=   H2O   minimum   optimization
Basis   set
O.ANO-S...2s1p.
  0.000000   0.000000   0.000000   Angstrom
End   of   basis
Basis   set
H.ANO-S...1s.
H1   0.758602   0.000000   0.504284   Angstrom
H2   0.758602   0.000000   -0.504284   Angstrom
End   of   basis

>>>   Set   maxiter   100
>>>   Do   while

   &SEWARD
   &SCF;   Title="H2O   minimum   optimization"
   &SLAPAF   &END

>>>   EndDo

   &MCKINLEY

Notice that MCKINLEY input is placed after EndDo, therefore, out of the looping scheme. Once the geometry optimization has finished, the Hessian will be computed at the final obtained geometry and computation level. In general, any calculation performed using a $WorkDir directory where a previous geometry optimization of any type has taken place will use as geometry the last one obtained in the optimization, even if a SEWARD input is present. To avoid that, the only solution is to remove the communication file RUNFILE where the geometry is stored. Notice also that the frequencies are computed in a cartesian basis, and that three translational and three rotational frequencies (they should be very close to zero) are included in the output file (this is not the case when numerical gradients and Hessians are used). In particular, for water in its minimum energy structure we expect (3N-6) three real vibrational frequencies. By default in $WorkDir a file $Project.freq.molden is generated containing information about the vibrational frequencies, and modes, which can be visualized by MOLDEN.

We can introduce here a new level of theory, CASSCF, although this is especially suited for geometry optimizations of excited states (we shall consider excited states in the next chapter). A geometry optimization is performed, and to show more possibilities this time we shall impose the restriction that the HOH angle in water should be 120o at the final structure. That means that only the bond distances will be really optimized in this partial minimization. The restriction is indicated in SLAPAF opening the keyword Constraints, which ends with another keyword, End of Constraints. Inside we assign the name of some variables (one here) to the geometrical parameters we want to restrict (see nomenclature in section [*]), in internal or cartesian coordinates. Here we want that the angle H1-O-H2 becomes finally 120o, therefore we first assign as variable a the defined angle and after Value, variable a is determined as 120o. It is not required that the initial geometry is 120o, just that the final result for the calculation will become 120o.

Observe also that as the RASSCF program requires initial trial orbitals, we use those which were automatically generated from SEWARD. The defined CASSCF wave function includes here all valence orbitals and electrons.



*CASSCF   minimum   energy   optimization   of   the   water   molecule   with   geometrical   restrictions
*File:   CASSCF.minimum_optimization_restricted.H2O
   &Gateway
Title=   H2O   minimum   optimization
Basis   set
O.ANO-S-MB
  0.000000   0.000000   0.000000   Angstrom
End   of   basis
Basis   set
H.ANO-S-MB
H1   0.758602   0.000000   0.504284   Angstrom
H2   0.758602   0.000000   -0.504284   Angstrom
End   of   basis
Constraint
   a   =   Angle   H1   O   H2
   Value
   a   =   90.   degree
End   of   Constraints

>>>   Set   maxiter   100
>>>   Do   while

   &SEWARD
   &RASSCF;   nActEl=8   0   0;   Inactive=1;   Ras2=6
   &SLAPAF

>>>   EndDo

Other more flexible ways to impose geometric restrictions is to decide which internal coordinates should remain fixed and which should change. In the next example we force the bond lengths to remain fixed at their initial distance (here 0.91 Å), while the bond angle (initially 81$^\circ$) is optimized.



*DFT   minimum   energy   optimization   of   the   angle   in   the   water   molecule   at   fixed   bond   lengths
*File:   DFT.minimum_optimization_restricted.H2O
*
   &GATEWAY
Title=   H2O   minimum   optimization
Basis   set
O.ANO-S-MB
  0.000000   0.000000   0.000000   Angstrom
End   of   basis
Basis   set
H.ANO-S-MB
H1   0.758602   0.000000   0.504284   Angstrom
H2   0.758602   0.000000   -0.504284   Angstrom
End   of   basis

>>>   Set   maxiter   100
>>>   Do   while

   &SEWARD;   &SCF;   Title="H2O   restricted   minimum";   KSDFT=B3LYP
   &SLAPAF
Internal   Coordinates
   b1   =   Bond   O   H1
   b2   =   Bond   O   H2
   a1   =   Angle   H1   O   H2
   Vary
   a1
   Fix
   b1
   b2
End   of   Internal

>>>   EndDo

It the final output the bond lengths remain as initially while the angle is optimized to reach 112o.

Our next step is to compute a transition state, a structure connecting different regions of the potential energy hypersurface which is a maximum just for one degree of freedom. The most common saddle points have order one, that is, they are maxima for one of one displacement and minima for the others. The simplest way to search for a transition state in MOLCAS is to add keyword TS to the SLAPAF input. Keyword PRFC is suggested in order to verify the nature of the transition structure. Searching for transition states is, however, not an easy task. Here we illustrate it for water at the DFT level:



*DFT   transition   state   optimization   of   the   water   molecule
*File:   DFT.transition_state.H2O
*
   &Gateway
Title=   H2O   TS   optimization
Basis   set
O.ANO-S...3s2p.
  0.750000   0.000000   0.000000
End   of   basis
Basis   set
H.ANO-S...2s.
H1   1.350000   0.000000   1.550000
H2   1.350000   0.000000   -1.550000
End   of   basis

>>>   Set   maxiter   100
>>>   Do   while

   &SEWARD
   &SCF;   Title="H2O   TS   optimization";   KSDFT=B3LYP
   &SLAPAF   ;   ITER=20   ;   TS

>>>   EndDo

Notice that we have used the initial coordinates in Bohr, just to show that this is the default case. The optimal geometry for ground state water has C2v symmetry. A transition state has been found with a linear HOH angle of 180o. In many cases, as for example along the energy path for a chemical reaction, we may have a clue about the structure of the transition state, which typically represents an intermediate conformation between reactives and products. In that case we may try to orient the program leading it to the guessed solution. Keyword FindTS in SLAPAF has this goal. It has to be accompanied with a definition of constrained geometric definitions. SLAPAF will guide the optimization of the transition state towards a region in which the restriction is fulfilled. Once there, the restriction will be released and a free search of the transition state will be performed. This technique is frequently quite effective and makes it possible to find difficult transition states or reduce the number of required iterations. Here we show an example in which the initial geometry of water is clearly bent, and we impose the trial restriction that the angle for the transition state should be near 180o. The final transition state will, however, be obtained without any type of geometrical restriction.



*DFT   transition   state   optimization   of   the   water   molecule   with   geometrical   restrictions
*File:   DFT.transition_state_restricted.H2O
*
   &Gateway
Title=   H2O   TS   optimization
Basis   set
O.ANO-S-MB
  0.250000   0.000000   0.000000
End   of   basis
Basis   set
H.ANO-S-MB
H1   1.350000   0.000000   1.550000
H2   1.350000   0.000000   -1.550000
End   of   basis
   Constraints
   a   =   Angle   H1   O   H2
   Value
   a   =   180.0   degree
   End   of   Constraints

>>>   Set   maxiter   100
>>>   Do   while

   &SEWARD
   &SCF;   Title="H2O   TS   optimization";   KSDFT=B3LYP
   &SLAPAF   ;FindTS

>>>   EndDo

The CASPT2 geometry optimizations are somewhat different because ALASKA is not suited to compute CASPT2 analytical gradients. Therefore the ALASKA program is automatically substituted by program CASPT2_GRADIENT, which will take care of performing numerical gradients. From the user pointview the only requirent is to place the CASPT2 input after the RASSCF input. The CASSCF wave function has of course to be generated in each step before performing CASPT2. To compute a numerical gradient can be quite time consuming, although it is a task that can be nicely parallelized. In a double-sided gradient algorithm like here a total of 6N+1 CASPT2 calculations are performed each pass of the optimization, where N is the number of atoms.



*CASPT2   minimum   energy   optimization   for   water
*File:   CASPT2.minimum_optimization.H2O
*
   &GATEWAY
Title=   H2O   minimum   optimization
Basis   set
O.ANO-S...2s1p.
  0.000000   0.000000   0.000000   Angstrom
End   of   basis
Basis   set
H.ANO-S...1s.
H1   0.758602   0.000000   0.504284   Angstrom
H2   0.758602   0.000000   -0.504284   Angstrom
End   of   basis

>>>   Set   maxiter   100
>>>   Do   while

   &SEWARD
   &RASSCF;   Title="H2O   restricted   minimum";   nActEl=8   0   0;   Inactive=1;   Ras2=6
   &CASPT2;   Frozen=1
   &SLAPAF

>>>   EndDo

The use of spatial symmetry makes the calculations more efficient, although they may again complicate the preparation of input files. We can repeat the previous CASPT2 optimization by restricting the molecule to work in the C2v point group, which, by the way, is the proper symmetry for water in the ground state. The GATEWAY program (as no symmetry has been specified) will identify and work with the highest available point group, C2v. Here the molecule is placed with YZ as the molecular plane. By adding keyword Symmetry containing as elements of symmetry the YZ (symbol X) and YX (symbol Z), the poing group is totally defined and the molecule properly generated. From that point the calculations will be restricted to use symmetry restrictions. For instance, the molecular orbitals will be classified in the four elements of symmetry of the group, a1, b1, b2, and a2, and most of the programs will require to define the selection of the orbitals in the proper order. The order of the symmetry labels is determined by SEWARD and must be checked before proceeding, because from that point the elements of symmetry will be known by their order in SEWARD: a1, b1, b2, and a2, for instance, will be symmetries 1, 2, 3, and 4, respectively. SCF does not require to specify the class of orbitals and it can be used as a learning tool.



*CASPT2   minimum   energy   optimization   for   water   in   C2v
*File:   CASPT2.minimum_optimization_C2v.H2O
*
   &GATEWAY
Title=   H2O   caspt2   minimum   optimization
Symmetry=   X   Z
Basis   set
O.ANO-S...2s1p.
  0.000000   0.000000   0.000000   Angstrom
End   of   basis
Basis   set
H.ANO-S...1s.
H1   0.000000   0.758602   0.504284   Angstrom
End   of   basis

>>>   Set   maxiter   100
>>>   Do   while

   &SEWARD
   &RASSCF;   Title="H2O   caspt2   minimum   optimization";   nActEl=8   0   0;   Inactive=1   0   0   0;   Ras2=3   1   2   0
   &CASPT2;   Frozen=1   0   0   0
   &SLAPAF   &END

>>>   EndDo

Thanks to symmetry restrictions the number of iterations within CASPT2_GRADIENT has been reduced to nine instead of nineteen, because many of the deformations are redundant within the C2v symmetry. Also, symmetry considerations are important when defining geometrical restrictions (see sections [*] and 5.2).

4.1.3 Computing excited states

The calculation of electronic excited states is typically a multiconfigurational problem, and therefore it should preferably be treated with multiconfigurational methods such as CASSCF and CASPT2. We can start this section by computing the low-lying electronic states of the acrolein molecule (see figure above) at the CASSCF level and using a minimal basis set. The standard file with cartesian coordinates is:



   8
Angstrom
   O   -1.808864   -0.137998   0.000000
   C   1.769114   0.136549   0.000000
   C   0.588145   -0.434423   0.000000
   C   -0.695203   0.361447   0.000000
   H   -0.548852   1.455362   0.000000
   H   0.477859   -1.512556   0.000000
   H   2.688665   -0.434186   0.000000
   H   1.880903   1.213924   0.000000

We shall carry out State-Averaged (SA) CASSCF calculations, in which one single set of molecular orbitals is used to compute all the states of a given spatial and spin symmetry. The obtained density matrix is the average for all states included, although each state will have its own set of optimized CI coefficients. Different weights can be considered for each of the states, but this should not be used except in very special cases by experts. It is better to let the CASPT2 method to handle that. The use of a SA-CASSCF procedure has an great advantage. For example, all states in a SA-CASSCF calculation are orthogonal to each other, which is not necessarily true for state specific calculations. Here, we shall include five states of singlet character the calculation. As no symmetry is invoked all the states belong by default to the first symmetry, including the ground state.



*CASSCF   SA   calculation   on   five   singlet   excited   states   in   acrolein
*File:   CASSCF.excited.acrolein
*
   &GATEWAY
Title=   Acrolein   molecule
coord   =   acrolein.xyz;   basis   =   STO-3G;   group   =   c1

   &SEWARD;   &SCF

   &RASSCF
LumOrb
Title=   Acrolein   molecule
Spin=   1;   Nactel=   6   0   0;   Inactive=   12;   Ras2=   5
CiRoot=   5   5   1

   &GRID_IT
All;   Ascii

We have used as active all the $\pi$ and $\pi^*$ orbitals, two bonding and two antibonding $\pi$ orbitals with four electrons and in addition the oxygen lone pair (n). Keyword CiRoot informs the program that we want to compute a total of five states, the ground state and the lowest four excited states at the CASSCF level and that all of them should have the same weight in the average procedure. Once analyzed we find that the calculation has provided, in this order, the ground state, two $n\to\pi^*$ states, and two $\pi\to\pi^*$ states. It is convenient to add the GRID_IT input in order to be able to use the GV interface for the analysis of the orbitals and the occupations in the different electronic states. Such an analysis should always be made in order to understand the nature of the different excited states. In order to get a more detailed analysis of the nature of the obtained states it is also possible to obtain in a graphical way the charge density differences between to states, typically the difference between the ground and an excited state. The following example creates five different density files:



*CASSCF   SA   calculation   on   five   singlet   excited   states   in   acrolein
*File:   CASSCF.excited_grid.acrolein
*
   &GATEWAY
Title=   Acrolein   molecule
coord=   acrolein.xyz;   basis=   STO-3G;   group=   c1

   &SEWARD;   &SCF

   &RASSCF
LumOrb
Title=   Acrolein   molecule
Spin=   1;   Nactel=   6   0   0;   Inactive=   12;   Ras2=   5
CiRoot=   5   5   1
OutOrbital
Natural=   5

   &GRID_IT
FILEORB   =   $Project.RasOrb.1;   NAME   =   1
All

   &GRID_IT
FILEORB   =   $Project.RasOrb.2;   NAME   =   2
All

   &GRID_IT
FILEORB   =   $Project.RasOrb.3;   NAME   =   3
All

   &GRID_IT
FILEORB   =   $Project.RasOrb.4;   NAME   =   4
All

   &GRID_IT
FILEORB   =   $Project.RasOrb.5;   NAME   =   5
All

In GRID_IT input we have included all orbitals. It is, however, possible and in general recommended to restrict the calculation to certain sets of orbitals. How to do this is described in the input manual for GRID_IT. If we use now the GV program for instance with the command molcas gv $Project.grid -a -1.0 $Project.grid2 the graph will display the differential charge transfer from the ground to the first excited state, in which the charge will leave the oxygen lone pair toward the $\pi$ structure (-1.0 is the combination factor between both densities, that is, the difference).

CASSCF wave functions are typically good enough, but this is not the case for electronic energies, and the dynamic correlation effects have to be included, in particular here with the CASPT2 method. The proper input is prepared, again including SEWARD and RASSCF (unnecessary if they were computed previously), adding a CASPT2 input with the keyword MultiState set to 5 1 2 3 4 5. The CASPT2 will perform four consecutive single-state (SS) CASPT2 calculations using the SA-CASSCF roots computed by the RASSCF module. At the end, a multi-state CASPT2 calculation will be added in which the five SS-CASPT2 roots will be allowed to interact. The final MS-CASPT2 solutions, unlike the previous SS-CASPT2 states, will be orthogonal. The FROZen keyword is put here as a reminder. By default the program leaves the core orbitals frozen.



*CASPT2   calculation   on   five   singlet   excited   states   in   acrolein
*File:   CASPT2.excited.acrolein
*
   &GATEWAY
Title=   Acrolein   molecule
coord   =   acrolein.xyz;   basis   =   STO-3G;   group=   c1

   &SEWARD;   &SCF

   &RASSCF
Title=   Acrolein   molecule
Spin=   1;   Nactel=   6   0   0;   Inactive=   12;   Ras2=   5
CiRoot=   5   5   1

   &GRID_IT
All;   ASCII

   &CASPT2
Title=   Acrolein   molecule
Multistate=   5   1   2   3   4   5
Frozen=   4

Apart from energies and state properties it is quite often necessary to compute state interaction properties such as transition dipole moments, Einstein coefficients, and many other. This can be achieved with the RASSI module, a powerful program which can be used for many purposes (see section [*]). We can start by simply computing the basic interaction properties



*RASSI   calculation   on   five   singlet   excited   states   in   acrolein
*File:   RASSI.excited.acrolein
*
   &GATEWAY
Title=   Acrolein   molecule
coord   =   acrolein.xyz;   basis   =   STO-3G;   group   =   c1

   &SEWARD;   &SCF

   &RASSCF
LumOrb
Title=   Acrolein   molecule
Spin=   1;   Nactel=   6   0   0;   Inactive=   12;   Ras2=   5
CiRoot=   5   5   1

   &CASPT2
Title   =   caspt2
Frozen   =   4
MultiState=   5   1   2   3   4   5

>>LINK   -FORCE   $Project.JobMix   JOB001

   &RASSI
Nr   of   JobIph
   1   5
   1   2   3   4   5
EJob

Oscillator strengths for the computed transitions and Einstein coefficients are compiled at the end of the RASSI output file. To obtain these values, however, energy differences have been used which are obtained from the previous CASSCF calculation. Those energies are not accurate because they do not include dynamic correlation energy and it is better to substitute them by properly computed values, such those at the CASPT2 level. This is achieved with the keyword Ejob. More information is available in section 5.5.1.

Now a more complex case. We want to compute vertical singlet-triplet gaps from the singlet ground state of acrolein to different, up to five, triplet excited states. Also, interaction properties are requested. Considering that the spin multiplicity differs from the ground to the excited states, the spin Hamiltonian has to be added to our calculations and the RASSI program takes charge of that. It is required first, to add in the SEWARD input the keyword AMFI, which introduces the proper integrals required, and to the RASSI input the keyword SpinOrbit. Additionally, as we want to perform the calculation sequentially and RASSI will read from two different wave function calculations, we need to perform specific links to save the information. The link to the first CASPT2 calculation will saved in file $Project.JobMix.S the data from the CASPT2 result of the ground state, while the second link before the second CASPT2 run will do the same for the triplet states. Later, we link these files as JOB001 and JOB002 to become input files for RASSI. In the RASSI input NrofJobIph will be set to two, meaning two JobIph or JobMix files, the first containing one root (the ground state) and the second five roots (the triplet states). Finally, we have added EJob, which will read the CASPT2 (or MS-CASPT2) energies from the JobMix files to be incorporated to the RASSI results. The magnitude of properties computed with spin-orbit coupling (SOC) depends strongly on the energy gap, and this has to be computed at the highest possible level, such as CASPT2.



*CASPT2/RASSI   calculation   on   singlet-triplet   gaps   in   acrolein
*File:   CASPT2.S-T_gap.acrolein
*
   &GATEWAY
Title=   Acrolein   molecule
coord   =   acrolein.xyz;   basis   =   STO-3G;   group=   c1

   &SEWARD
AMFI

   &SCF

   &RASSCF
Title=   Acrolein   molecule
Spin=   1;   Nactel=   6   0   0;   Inactive=   12;   Ras2=   5
CiRoot=   1   1   1

>>LINK   -FORCE   $Project.JobMix.S   JOBMIX

   &CASPT2
Title=   acrolein
Frozen=   4
MultiState=   1   1

   &RASSCF
LumOrb
Title=   Acrolein   molecule
Spin=   3;   Nactel=   6   0   0;   Inactive=   12;   Ras2=   5
CiRoot=   5   5   1

>>LINK   -FORCE   $Project.JobMix.T   JOBMIX

   &CASPT2
Title=   acrolein
Frozen=   4
MultiState=   5   1   2   3   4   5

>>LINK   -FORCE   $Project.JobMix.S   JOB001
>>LINK   -FORCE   $Project.JobMix.T   JOB002

   &RASSI
Nr   of   JobIph=   2   1   5;   1;   1   2   3   4   5
Spin
EJob

As here with keyword AMFI, when using command Coord to build a SEWARD input and we want to introduce other keywords, it is enough if we place them after the line corresponding to Coord. Observe that the nature of the triplet states obtained is in sequence one $n\pi^*$, two $\pi\pi^*$, and two $n\pi^*$. The RASSI output is somewhat complex to analyze, but it makes tables summarizing oscillator strengths and Einstein coefficients, if those are the magnitudes of interest. Notice that a table is first done with the spin-free states, while the final table include the spin-orbit coupled eigenstates (in the CASPT2 energy order here), in which each former triplet state has three components.

In many cases working with symmetry will help us to perform calculations in quantum chemistry. As it is a more complex and delicate problem we direct the reader to the examples section in this manual. However, we include here two inputs that can help the beginners. They are based on trans-1,3-butadiene, a molecule with a C2h ground state. If we run the next input, the SEWARD and SCF outputs will help us to understand how orbitals are classified by symmetry, whereas reading the RASSCF output the structure of the active space and states will be clarified.



*CASSCF   SA   calculation   on   1Ag   excited   states   in   tButadiene
*File:   CASSCF.excited.tButadiene.1Ag
*
   &SEWARD
Title=   t-Butadiene   molecule
Symmetry=   Z   XYZ
Basis   set
C.STO-3G...
C1   -3.2886930   -1.1650250   0.0000000   Bohr
C2   -0.7508076   -1.1650250   0.0000000   Bohr
End   of   basis
Basis   set
H.STO-3G...
H1   -4.3067080   0.6343050   0.0000000   Bohr
H2   -4.3067080   -2.9643550   0.0000000   Bohr
H3   0.2672040   -2.9643550   0.0000000   Bohr
End   of   basis

   &SCF

   &RASSCF
LumOrb
Title=   tButadiene   molecule   (1Ag   states);   Symetry   order   (ag   bg   bu   au)
Spin=   1;   Symmetry=   1;   Nactel=   4   0   0;   Inactive=   7   0   6   0;   Ras2=   0   2   0   2
CiRoot=   4   4   1

   &GRID_IT
All;   Ascii

Using the next input will give information about states of a different symmetry. Just run it as a simple exercise.



*CASSCF   SA   calculation   on   1Bu   excited   states   in   tButadiene
*File:   CASSCF.excited.tButadiene.1Bu
*
   &SEWARD
Title=   t-Butadiene   molecule
Symmetry=   Z   XYZ
Basis   set
C.STO-3G...
C1   -3.2886930   -1.1650250   0.0000000   Bohr
C2   -0.7508076   -1.1650250   0.0000000   Bohr
End   of   basis
Basis   set
H.STO-3G...
H1   -4.3067080   0.6343050   0.0000000   Bohr
H2   -4.3067080   -2.9643550   0.0000000   Bohr
H3   0.2672040   -2.9643550   0.0000000   Bohr
End   of   basis

   &SCF

>LINK   FORCE   $Project.1Ag.JobIph   JOBIPH
>LINK   FORCE   $Project.1Ag.RasOrb   RASORB
   &RASSCF
LumOrb
Title=   tButadiene   molecule   (1Bu   states);   Symetry   order   (ag   bg   bu   au)
Spin=   1;   Symmetry=   1;   Nactel=   4   0   0;   Inactive=   7   0   6   0
Ras2=   0   2   0   2
CiRoot=   4   4   1

   &GRID_IT
Name=   $Project.1Ag.grid
All

>LINK   FORCE   $Project.1Bu.JobIph   JOBIPH
>LINK   FORCE   $Project.1Bu.RasOrb   RASORB

   &RASSCF
LumOrb
Title=   tButadiene   molecule   (1Bu   states);   Symetry   order   (ag   bg   bu   au)
Spin=   1;   Symmetry=   3;   Nactel=   4   0   0;   Inactive=   7   0   6   0;   Ras2=   0   2   0   2
CiRoot=   2   2   1

   &GRID_IT
Name=   $Project.1Bu.grid
All;   Ascii

>LINK   FORCE   $Project.1Ag.JobIph   JOB001
>LINK   FORCE   $Project.1Bu.JobIph   JOB002

   &RASSI
NrofJobIph=   2   4   2;   1   2   3   4;   1   2

Structure optimizations can be also performed at the CASSCF, RASSCF or CASPT2 levels. Here we shall optimize the second singlet state in the first (here the only) symmetry for acrolein at the SA-CASSCF level. It is strongly recommended to use the State-Average option and avoid single state CASSCF calculations for excited states. Those states are non-orthogonal with the ground state and are typically heavily contaminated. The usual set of input commands will be prepared, with few changes. In the RASSCF input two states will be simultaneously computed with equal weight (CiRoot 2 2 1), but, in order to get accurate gradients for a specific root (not an averaged one), we have to add Rlxroot and set it to two, which is, among the computed roots, that we want to optimize. The proper density matrix will be stored. The MCLR program optimizes, using a perturbative approach, the orbitals for the specific root (instead of using averaged orbitals), but the program is called automatically and no input is needed.



*CASSCF   excited   state   optimization   in   acrolein
*File:   CASSCF.excited_state_optimization.acrolein
*
   &GATEWAY
Title=   acrolein   minimum   optimization   in   excited   state   2
Basis   set
O.STO-3G...2s1p.
O1   1.608542   -0.142162   3.240198   Angstrom
End   of   basis
Basis   set
C.STO-3G...2s1p.
C1   -0.207776   0.181327   -0.039908   Angstrom
C2   0.089162   0.020199   1.386933   Angstrom
C3   1.314188   0.048017   1.889302   Angstrom
End   of   basis
Basis   set
H.STO-3G...1s.
H1   2.208371   0.215888   1.291927   Angstrom
H2   -0.746966   -0.173522   2.046958   Angstrom
H3   -1.234947   0.213968   -0.371097   Angstrom
H4   0.557285   0.525450   -0.720314   Angstrom
End   of   basis
>>>   Do   while

   &SEWARD

>>>   If   (   Iter   =   1   )   <<<

   &SCF
Title=   acrolein   minimum   optimization

>>>   EndIf   <<<

   &RASSCF
LumOrb
Title=   acrolein
Spin=   1;   nActEl=   4   0   0;   Inactive=   13;   Ras2=   4
CiRoot=   2   2   1
Rlxroot=   2

   &SLAPAF

>>>   EndDo

In case of performing a CASPT2 optimization for an excited state, still the SA-CASSCF approach can be used to generate the reference wave function, but keyword Rlxroot and the use of the MCLR program are not necessary, because CASPT2 takes care of selecting the proper root.

A very useful tool recently included in MOLCAS is the possibility to compute minimum energy paths (MEP), representing steepest descendent minimum energy reaction paths which are built through a series of geometry optimizations, each requiring the minimization of the potential energy on a hyperspherical cross section of the PES centered on a given reference geometry and characterized by a predefined radius. One usually starts the calculation from a high energy reference geometry, which may correspond to the Franck-Condon (FC) structure on an excited-state PES or to a transition structure (TS). Once the first lower energy optimized structure is converged, this is taken as the new hypersphere center, and the procedure is iterated until the bottom of the energy surface is reached. Notice that in the TS case a pair of steepest descent paths, connecting the TS to the reactant and product structures (following the forward and reverse orientation of the direction defined by the transition vector) provides the minimum energy path (MEP) for the reaction. As mass-weighted coordinates are used by default, the MEP coordinate corresponds to the so-called Intrinsic Reaction Coordinates (IRC). We shall compute here the MEP from the FC structure of acrolein along the PES of the second root in energy at the CASSCF level. It is important to remember that the CASSCF order may not be accurate and the states may reverse orders at higher levels such as CASPT2.



*CASSCF   excited   state   mep   points   in   acrolein
*File:   CASSCF.mep_excited_state.acrolein
*
   &GATEWAY
Title   =   acrolein   mep   calculation   root   2
Basis   set
O.STO-3G...2s1p.
   O1   1.367073   0.000000   3.083333   Angstrom
End   of   basis
Basis   set
C.STO-3G...2s1p.
   C1   0.000000   0.000000   0.000000   Angstrom
   C2   0.000000   0.000000   1.350000   Angstrom
   C3   1.367073   0.000000   1.833333   Angstrom
End   of   basis
Basis   set
H.STO-3G...1s.
   H1   2.051552   0.000000   0.986333   Angstrom
   H2   -0.684479   0.000000   2.197000   Angstrom
   H3   -1.026719   0.000000   -0.363000   Angstrom
   H4   0.513360   0.889165   -0.363000   Angstrom
End   of   basis

>>>   Set   maxiter   100
>>>   Do   while

   &SEWARD
>>>   If   (   Iter   =   1   )   <<<
   &SCF   ;   Title="Acrolein   mep   calculation   root   2"
>>>   EndIf   <<<

   &RASSCF   ;   Title="acrolein   mep   calculation   root   2";   Spin=1
   nActEl=4   0   0;   Inactive=13;   Ras2=4;   CiRoot=2   2   1;   Rlxroot=2
   &SLAPAF
   Constraint
   a   =   Sphere
   Value
   a   =   0.1
   End   of   Constraints
   MEP-search

>>>   EndDo

As observed, to prepare the input for the MEP is simple, just to add the keyword MEP-search and specify a hypersphere constraint to the SLAPAF input, and the remaining structure equals that of a geometry optimization. The calculations are time consuming, because each point of the MEP (four plus the initial one obtained here) is computed through a specific optimization. A file named $Project.mep.molden (read by MOLDEN ) will be generated in $WorkDir containing only those points belonging to the MEP.

We shall now show how to perform geometry optimizations under nongeometrical restrictions, in particular, how to compute hypersurface crossings, which are key structures in the photophysics of molecules. We shall get those points as minimum energy crossing points in which the energy of the highest of the two states considered is minimized under the restriction that the energy difference with the lowest state should equal certain value (typically zero). Such point can be named a minimum energy crossing point (MECP). If a further restriction is imposed, like the distance to a specific geometry, and several MECP as computed at varying distances, it is possible to obtain a crossing seam of points where the energy between the two states is degenerated. Those degeneracy points are funnels with the highest probability for the energy to hop between the surfaces in internal conversion or intersystem crossing photophysical processes. There are different possibilities. A crossing between states of the same spin multiplicity and spatial symmetry is named a conical intersection. Elements like the nonadiabatic coupling terms are required to obtain them strictly, and they are not computed presently by MOLCAS. If the crossing occurs between states of the same spin multiplicity and different spatial symmetry or between states of different spin multiplicity, the crossing is an hyperplane and its only requirement is the energetic degeneracy and the proper energy minimization.

Here we include an example with the crossing between the lowest singlet (ground) and triplet states of acrolein. Notice that two different states are computed, first by using RASSCF to get the wave function and then ALASKA to get the gradients of the energy. Nothing new on that, just the information needed in any geometry optimizations. The SLAPAF input requires to add as constraint an energy difference between both states equal to zero. A specific instruction is required after calculating the first state. We have to copy the communication file RUNFILE (at that point contains the information about the first state) to RUNFILE2 to provide later SLAPAF with proper information about both states:



*CASSCF   singlet-triplet   crossing   in   acrolein
*File:   CASSCF.S-T_crossing.acrolein
*
   &GATEWAY
Title=   Acrolein   molecule
Basis   set
O.sto-3g....
   O1   1.5686705444   -0.1354553340   3.1977912036   Angstrom
End   of   basis
Basis   set
C.sto-3g....
   C1   -0.1641585340   0.2420235062   -0.0459895824   Angstrom
   C2   0.1137722023   -0.1389623714   1.3481527296   Angstrom
   C3   1.3218729238   0.1965728073   1.9959513294   Angstrom
End   of   basis
Basis   set
H.sto-3g....
   H1   2.0526602523   0.7568282320   1.4351034056   Angstrom
   H2   -0.6138178851   -0.6941171027   1.9113821810   Angstrom
   H3   -0.8171509745   1.0643342316   -0.2648232855   Angstrom
   H4   0.1260134708   -0.4020589690   -0.8535699812   Angstrom
End   of   basis

>>>   Do   while

   &SEWARD

>>>   IF   (   ITER   =   1   )   <<<

   &SCF
Title
   Acrolein   S-T_crossing

>>>   ENDIF   <<<


   &RASSCF
LumOrb
Title=   Acrolein   molecule
Spin=   1;   Nactel=   4   0   0;   Inactive=   13;   Ras2=   4
CiRoot=   1   1;   1

   &ALASKA


>COPY   $WorkDir/$Project.RunFile   $WorkDir/RUNFILE2

   &RASSCF
LumOrb
Title=   Acrolein   molecule
Spin=   3;   Nactel=   4   0   0;   Inactive=   13;   Ras2=   4
CiRoot=   1   1;   1

   &ALASKA

   &SLAPAF
Constraints
   a   =   Ediff
   Value
   a   =   0.000
End   of   Constraints

>>>   EndDo

Solvent effects can be also applied to excited states, but first the reaction field in the ground (initial) state has to be computed. This is because solvation in electronic excited states is a non equilibrium situation in with the electronic polarization effects (fast part of the reaction field) have to treated apart (they supposedly change during the excitation process) from the orientational (slow part) effects. The slow fraction of the reaction field is maintained from the initial state and therefore a previous calculation is required. From the practical point of view the input is simple as illustrated in the next example. First, the proper reaction-field input is included in SEWARD, then a RASSCF and CASPT2 run of the ground state, with keyword RFPErt in CASPT2, and after that another SA-CASSCF calculation of five roots to get the wave function of the excited states. Keyword NONEequilibrium tells the program to extract the slow part of the reaction field from the previous calculation of the ground state (specifically from the JOBOLD file, which may be stored for other calculations) while the fast part is freshly computed. Also, as it is a SA-CASSCF calculation (if not, this is not required) keyword RFRoot is introduced to specify for which of the computed roots the reaction field is generated. We have selected here the fifth root because it has a very large dipole moment, which is also very different from the ground state dipole moment. If you compare the excitation energy obtained for the isolated and the solvated system, a the large red shift is obtained in the later.



*CASPT2   excited   state   in   water   for   acrolein
*File:   CASPT2.excited_solvent.acrolein
*
   &SEWARD
Title=   Acrolein   molecule
coord   =   acrolein.xyz;   basis   =   STO-3G;   group=   c1
RF-input
   PCM-model;   solvent=   water
End   of   RF-input

   &RASSCF
Title=   Acrolein   molecule
Spin=   1;   Nactel=   6   0   0;   Inactive=   12;   Ras2=   5
CiRoot=   1   1   1

   &CASPT2
Title=   Acrolein   molecule
Multistate=   1   1
RFPert

   &RASSCF
Title=   Acrolein   molecule
Spin=   1;   Nactel=   6   0   0;   Inactive=   12;   Ras2=   5
CiRoot=   5   5   1
RFRoot=   5
NONEquilibrium

   &CASPT2
Title=   Acrolein   molecule
Multistate=   1   5
RFPert

A number of simple examples as how to proceed with the most frequent quantum chemical problems computed with MOLCAShave been given above. Certainly there are many more possibilities in MOLCAS 7.4 such as calculation of 3D band systems in solids at a semiempirical level, obaining valence-bond structures, the use of QM/MM methods in combination with a external MM code, the introduction of external homogeneous or non homogeneous perturbations, generation of atomic basis sets, application of different localization schemes, analysis of first order polarizabilities, calculation of vibrational intensities, analysis, generation, and fitting of potentials, computation of vibro-rotational spectra for diatomic molecules, introduction of relativistic effects, etc. All those aspects are explained in the manual and are much more specific. Next section 4.2 details the basic structure of the inputs, program by program, while easy examples can also be found. Later, another chapter includes a number of extremely detailed examples with more elaborated quantum chemical examples, in which also scientific comments are included. Examples include calculations on high symmetry molecules, geometry optimizations and Hessians, computing reaction paths, high quality wave functions, excited states, solvent models, and computation of relativistic effects.


next up previous contents
Next: 4.2 Program-based tutorials Up: 4. Tutorials Previous: 4. Tutorials