4.2.25. GUGA¶
The GUGA program generates coupling coefficients used in the MRCI and the CPF programs in Direct CI calculations [71]. These coupling coefficients are evaluated by the Graphical Unitary Group Approach [72, 73, 74], for wavefunctions with at most two electrons excited from a set of reference configurations. The program was written by P. E. M. Siegbahn, Institute of Physics, Stockholm University, Sweden. Only the MRCI program can use several reference configurations. The reference configurations can be specified as a list, where the occupation numbers are given for each active orbital (see below) in each reference configuration, or as a Full CI the space defined by the active orbitals. In the GUGA, MRCI and CPF programs, the orbitals are classified as follows: Frozen, Inactive, Active, Secondary, and Deleted orbitals. Within each symmetry type, they follow this order. For the GUGA program, only the inactive and active orbitals are relevant.
Inactive: Inactive orbitals are doubly occupied in all reference configurations, but excitations out of this orbital space are allowed in the final CI wavefunction, i.e., they are correlated but have two electrons in all reference configurations. Since only single and double excitations are allowed, there can be no more than two holes in the active orbitals. Using keyword NoCorr (See input description) a subset of the inactive orbitals can be selected, and at most a single hole is then allowed in the selected set. This allows the core-polarization part of core-valence correlation, while preventing large but usually inaccurate double-excitation core correlation.
Active: Active orbitals are those which may have different occupation in different reference configurations. Using keyword OneOcc (See input description) a restriction may be imposed on some selection of active orbitals, so that the selected orbitals are always singly occupied. This may be useful for transition metal compounds or for deep inner holes.
4.2.25.1. Dependencies¶
The GUGA program does not depend on any other program for its execution.
4.2.25.2. Files¶
4.2.25.2.1. Input files¶
The GUGA program does not need any input files apart from the file of input keywords.
4.2.25.2.2. Output files¶
- CIGUGA
This file contains the coupling coefficients that are needed in subsequent CI calculations. For information about how these coefficients are structured you are referred to the source code [74]. The theoretical background for the coefficient can be found in Refs [72, 73, 74] and references therein.
4.2.25.3. Input¶
This section describes the input to the GUGA program in the Molcas program system, with the program name:
&GUGA
4.2.25.3.1. Keywords¶
Formally, there are no compulsory keyword. Obviously, some input must be given for a meaningful calculation.
- TITLe
The line following this keyword is treated as title line
- SPIN
The spin degeneracy number, i.e. 2S+1. The value is read from the line following the keyword, in free format. The default value is 1, meaning a singlet wave function.
- ELECtrons
The number of electrons to be correlated in the CI of CPF calculation. The value is read from the line following the keyword, in free format. Note that this number should include the nr of electrons in inactive orbitals. An alternative input specification is NACTEL. Default: Twice nr of inactive orbitals.
- NACTel
The number of electrons in active orbitals in the reference configurations. The value is read from the line following the keyword, in free format. Note that this number includes only the of electrons in active orbitals. An alternative input specification is ELECTRONS. Default: Zero.
- INACtive
The number of inactive orbitals, i.e. orbitals that have occupation numbers of 2 in all reference configurations. Specified for each of the symmetries. The values are read from the line following the keyword, in free format.
- ACTIve
The number of active orbitals, i.e. orbitals that have varying occupation numbers in the reference configurations. Specified for each of the symmetries. The values are read from the line following the keyword, in free format.
At least one of the Inactive or Active keywords must be present for a meaningful calculation. If one of them is left out, the default is 0 in all symmetries.
- ONEOcc
Specify a number of active orbitals per symmetry that are required to have occupation number one in all configurations. These orbitals are the first active orbitals. The input is read from the line after the keyword, in free format.
- NOCOrr
Specify the number of inactive orbitals per symmetry out of which at most one electron (total) is excited. These orbitals are the first inactive orbitals. The input is read from the line after the keyword, in free format.
- REFErence
Specify selected reference configurations. The additional input that is required usually spans more than one line. The first line after the keyword contains the number of reference configurations, and the total number of active orbitals, and these two numbers are read by free format. Thereafter the input has one line per reference configuration, specifying the occupation number for each of the active orbitals, read by 80I1 format. Note that Reference and CIall are mutually exclusive.
- CIALl
Use a Full CI within the subspace of the active orbitals as reference configurations. The symmetry of the wavefunction must be specified. The value is read from the line following the keyword, in free format. Note that CIall and Reference are mutually exclusive. One of these two alternatives must be chosen for a meaningful calculation.
- FIRSt
Perform a first order calculation, i.e. only single excitations from the reference space. No additional input is required.
- NONInteracting space
By default, those double excitations from inactive to virtual orbitals are excluded, where the inactive and virtual electrons would couple to a resulting triplet. With the NonInteracting Space option, such ‘non-interacting’ configurations are included as well.
Printlevel of the program. Default printlevel (0) produces very little output. Printlevel 5 gives some information that may be of interest. The value is read from the line following the keyword, in free format.
4.2.25.3.2. Input example¶
&GUGA
Title
Water molecule. 2OH correlated.
Electrons = 4
Spin = 1
Active = 2 2 0 0
Interacting space
Reference
3 4
2020 ; 0220 ; 2002