Read Checkpoint File Gaussian

For example, these commands specify a name for the checkpoint file, and an alternate name and directory location for the read-write file, and cause only the checkpoint file to be saved at the conclusion of the Gaussian job:%RWF=/chem/scratch2/water Files to be deleted go here.%NoSave%Chk=water Files to be saved go here. For those who don’t want to read the entire document, I’ll give a sneak peek at the essential point here; the rest of the document will be a description of how to create formatted checkpoint files and how to use them. GaussView gets results from Gaussian via formatted checkpoint files and log files (i.e. Gaussian output files).

DESCRIPTION

This keyword controls the initial guess for the Hartree-Fock wavefunction. Guess is not meaningful without an option. By default, a Harris guess is used (see below).

ALGORITHM-RELATED OPTIONS

Harris
Diagonalize the Harris functional [Harris85] for the initial guess. This is the default for all HF and DFT calculations.

Huckel
Requests that a Huckel guess be generated. This is the default for CNDO, INDO, MNDO and MINDO3. The Huckel guess should be considered for PM6 calculations involving many second-row atoms.

RdScale
Read in the scale factor on atomic hardnesses used in iterative extended Huckel. The default is 7.0 times the QEq value.

OldHuckel
Use the old Huckel guess (pre-Gaussian 03) instead of CNDO or the updated Huckel.

INDO
Use the Gaussian 98 default guess: INDO for first-row systems, CNDO for second-row, and Huckel for third-row and beyond.

Read Checkpoint File Gaussian Software

AM1
Do an AM1 calculation for the initial guess (currently only works with sparse matrix code). Guess=(AM1,Always) causes later steps in a geometry optimization to generate a new guess at each point and compare the energies with the density from the old point and the new guess and take the best one.

Core
Requests that the core Hamiltonian be diagonalized to form the initial guess. This is the default for AM1, PM3, PM3MM, PM6 and PDDG.

ORBITAL-RELATED OPTIONS

Permute
Read in a permutation of orbitals in the initial guess. The numbers of the generated guess orbitals are given in the order in which they should be used in the SCF. Ranges (e.g. 7-12) can be used, and all orbitals not listed are put in after the listed orbitals in their original order. Separate permutation lists for α and β orbitals must be specified (each list separated by a blank line) for open shell systems.

Alter
Indicates that the orbitals selected for occupation in the Hartree-Fock wavefunction should not be those of lowest energy. Normally, the occupied orbitals are selected as those with lowest eigenvalues for the one-electron Hamiltonian used in the initial guess programs. The alteration sections consist of a set of transpositions indicating that one of these occupied orbitals is to be replaced by one of the other (virtual) orbitals. Each such transposition is on a separate line and has two integers N1 and N2 (free format, separated by spaces or a comma as usual) indicating that orbital N1 is to be swapped with orbital N2. The list of orbital transpositions is terminated by the blank line at the end of the input section.
For UHF calculations, two such orbital alteration sections are required, the first specifying transpositions of α orbitals, and the second specifying transpositions of β orbitals. Both sections are always required. Thus, even if only α transpositions are needed, the β section is required even though it is empty (and vice-versa). The second blank line to indicate an empty β section must be included.

Mix
Requests that the HOMO and LUMO be mixed so as to destroy α-β and spatial symmetries. This is useful in producing UHF wavefunctions for singlet states. Mixing orbitals is only done by default when generating a complex initial guess. NoMix says to not mix orbitals.

DensityMix[=N]
Whether to mix occupied and virtual orbital contributions in forming the initial guess density. N defaults to -3 (use Huckel eigenvalues to decide which orbitals to mix).

Biorthogonalize
For an unrestricted guess, biorthogonalize the α and β MOs to maximally pair electrons of opposite spin. Done automatically when a UHF wavefunction is read-in as a guess for ROHF. This option is also useful in the combination of Guess=(BiOrth,Read,Only,Save) to replace the canonical UHF orbitals with ones which have alpha and beta orbitals matched up as much as possible, for viewing in GaussView or other visualization packages.

PROCEDURAL OPTIONS

Only
Guess=Only functions as a calculation type keyword and requests that the calculation terminate once the initial guess is computed and printed. Note that the amount of orbital information that is printed is controlled by the Pop keyword. Guess=Only may not be used with the MOPAC-based semi-empirical methods (INDO, CNDO, MNDO, MINDO3).
This option is useful in preliminary runs to check if configuration alteration is necessary. For example, Guess=Only may be specified with CASSCF in order to obtain information on the number of CI configurations in the CAS active space (as well as the initial orbitals).
Guess(Only,Read) may also be used to produce population and other post-calculation analyses from the data in a checkpoint file. For example, these options alone will produce a population analysis using the wavefunction in the checkpoint file. Guess(Only,Read) Prop will cause electrostatic properties to be calculated using the wavefunction in the checkpoint file.

Read Checkpoint File Gaussian System

Always
Requests that a new initial guess be generated at each point of an optimization. By default, the SCF results from the last point are used for the guess at the next point.

Fragment=N
Generate a guess built from fragment guesses or SCF solutions. The guess is saved on the checkpoint file by default. This option is usually combined with Guess=Only to generate a guess from fragment guess orbitals (otherwise a full SCF calculation is performed for each fragment). Assignment of atoms to fragments and fragment charges and multiplicities are specified as described in the Molecule Specifications section, except that a negative spin multiplicity means that the unpaired orbitals for the fragment are to become β spin orbitals in the combined set.

Local
Requests that orbitals be localized using the Boys method [Boys60]. Occupied and virtual orbitals are localized separately, and the irreducible representations (after possible merging using LowSymm or NoSymm) are not mixed. Localized orbital analysis of a converged SCF wavefunction may then be done using a second job step, which includes Guess(Read,Local,Only) and Pop=Full in its route section.

Sparse
Perform a sparse SE calculation for the initial guess. This option may be useful for very, very large HF or DFT calculations using the sparse matrix facility.

Extra
Do an extra, new initial guess when reading orbitals from the RWF (i.e., during geometry optimizations). By default, this is done if the default Harris guess is allowed, no alteration of configuration was requested, and the optimization did not take a small step as flagged by variable 4 in ILSW. Use NoExtra to disable this feature.

Fock
Reuse Fock matrices rather than orbitals when reading from previous results from the read-write or checkpoint files. This is the default for periodic boundary conditions calculations if Guess=Alter is not specified. NoFock disables this behavior, and it is the default for non-PBC calculations.

GUESS READING/SAVING OPTIONS

Read
Requests that the initial guess be read from the checkpoint file (Guess=Read is often specified along with Geom=Checkpoint). This option may be combined with Alter, in which case the orbitals are read from the checkpoint file, projected onto the current basis set, and then the specified alterations are made. Checkpoint is a synonym for Read. The TCheck option says to attempt to read a guess from the checkpoint file, but to generate a new one if necessary.

Alpha
Use alpha orbitals for both alpha and beta guess during Guess=Read.

Translate
Translate requests that the coordinates of the atoms used to produce a guess, which is read in, be translated to the current atomic coordinates. This is the default. It may fail in unusual cases, such as when a wavefunction is used as a guess for a system with a different stoichiometry, in which case Guess=NoTranslate should be specified.

Cards
Specifies that after the initial guess is generated, some or all of the orbitals will be replaced with ones read from the input stream. This option can be used to read a complete initial guess from the input stream by replacing every orbital. The replacement orbitals are placed in the input section following the guess alteration commands, if any. For UHF, there are separate α and β replacement orbital input sections.
The replacement orbitals input section (the α replacement orbitals section for UHF) begins with a line specifying the Fortran format with which to read the replacement orbital input, enclosed in parentheses. For example: (4E20.8). The remainder of the section contains one or more instances of the following:
IVecOrbital to replace (0=end, -1=replace all orbitals in order).
(A(I,IVec),I=1,N)New orbital in the format specified in the first line.
The format for the line containing IVec is Fortran I5. The β orbital replacement section for UHF calculations differs only in that it omits the initial format specification line. See the examples section for sample replacement orbital input.

Input
Read a line from the input file containing the name of a checkpoint file. This option also accepts several keywords: generate says to generate a guess as usual, and read and chk are equivalent to Guess=Read (using the checkpoint file specified to %Chk as usual). Enclose the path to the checkpoint file in quotes if it contains internal spaces.
This option is useful for ONIOM jobs where the SCF is hard to converge for some of the calculations at the initial geometry, using a procedure like the following:

  • Use ONIOM=OnlyInput to print out input files for the individual calculations.

  • Converge the SCF for the problem step separately using Stable=Opt SCF=QC.

  • After verifying that the correct state has been found, run an ONIOM calculation with Guess=Input to retrieve the correct initial guesses for the individual states. In the ONIOM input file, you will then have a line for the guess for each calculation (i.e., 3 lines for a 2-layer MO:MO), where each line can be a checkpoint file name or read (for Guess=Read from the regular checkpoint file) or generate (generate a new initial guess), as appropriate. For example, if only the high level calculation on the model system was problematic, the input would be:

Save
Save the generated initial guess back into the checkpoint file at the conclusion of a Guess=Only run. This option is useful for saving localized orbitals.

NaturalOrbitals
Include natural orbitals in the checkpoint file. This must be accomplished via a separate job step specifying this option as well as Only and Save. See the discussion of the Population keyword for details.

Print
Print the initial guess.

SYMMETRY-RELATED OPTIONS

LowSymm
Requests that irreducible representations of the molecular point group be combined in the symmetry information used in the N3 steps in the SCF, to allow lowered symmetry of the wavefunction. This enables the orbitals (and possibly but not necessarily the total wavefunction) to have lower symmetry than the full molecular point group. This option is available only for GVB calculations, where it is often necessary for calculations on symmetric systems (see the discussion of the GVB keyword below for an example using this option).
The option expects a single line of input (in the format 16I2) giving the numbers of the irreducible representations to combine, with the new groups separated by 0; the list itself must be terminated by a 9. The numbers correspond to the order in which the representations are listed by Link 301 in the output file (see the examples subsection below).
Since this input section is always exactly one line long, it is not terminated by a blank line. Note that irreducible representations are combined before orbital localization is done and that localized orbitals retain whatever symmetry is kept. Guess=NoSymm removes all orbital symmetry constraints without reading any input.

NoSymm
Requests that all orbital symmetry constraints be lifted. Synonymous with SCF=NoSymm and Symm=NoSCF.

ForceAbelianSymmetry
Force the initial guess orbitals to transform according to irreducible representations of the Abelian point group. NoForceAbelianSymmetry is the default.

VALID OPTION COMBINATIONS

Only reasonable combinations are valid. For example, Guess=(Always,Alter) and Guess=(Read,Alter) work as expected (in the former case, alterations are read once and the same interchanges are applied at each geometry). Conversely, Guess=(Always,Read) is contradictory and will lead to unpredictable results. Refer to the input sections order table at the beginning of this chapter to determine the ordering of the input sections for combinations of options like Guess=(Cards,Alter).

RESTRICTIONS

Guess=Only may not be used with the MOPAC-based semi-empirical methods: INDO, CNDO, MNDO, and MINDO3.

RELATED KEYWORDS

Geom, Pop

EXAMPLES

Transposing 2 Orbitals with Guess=Alter. This example finds the UHF/STO-3G structure of the 2A1 excited state of the amino radical. First, a Guess=Only calculation is run to determine whether any alter (reordering) instructions are needed to obtain the desired electronic state. The HF/STO-3G theoretical model is used by default:

Here is the orbital symmetry summary output from the job, which comes immediately before the population analysis in the output:

Since a doublet state is involved, α and β orbitals are given separately. From the orbital symmetries, the electron configuration in the initial guess is 2a12a12b22a11b1, yielding a 2B1 wavefunction. This is indeed the ground state of NH2. The expectation value of S2 for the unrestricted initial guess is printed, in this case, that corresponding to a pure doublet: 0.75.

Since we want to model the 2A1 excited state of the amino radical, we will need to alter this initial orbital configuration: a β electron must be moved from orbital 4 to orbital 5 (the electron configuration is then 2a12a12b22b11a1).

Guess=Alter may be used to accomplish this. Here is the input for the geometry optimization:

Note that an extra blank line—line 12—is necessary to indicate an empty α alteration section. The final two lines then constitute the β alteration section.

The initial guess program prints a list of orbitals that were interchanged as a result of the Alter option:

The SCF calculation follows, and the energy and S2 eigenvalue for the UHF wavefunction are printed. The S2 value which results if contamination of the wavefunction from the next possible spin multiplicity (quartets for doublets, quintets for triplets, etc.) is removed is also printed:

Although this calculation does in fact converge correctly to 2A1 state, it sometimes happens that the order of orbital symmetries switches during the course of the SCF iterations. If the orbital symmetries of the final wavefunction are different from those in the initial guess (whether or not you are using Guess=Alter), we recommend using the direct minimization routine, specified with the SCF=QC or SCF=DM keywords, which usually holds symmetry from one iteration to the next.

Reordering Orbitals with Guess=Permute. This option is often is the easiest way to perform a complex modification of the initial guess, as in this example:

Here we have rearranged orbitals 61-68. Listing the final orbital (69) is not really necessary, but it helps to make the input easier to understand for humans.

Reading in Orbitals with Guess=Cards. Some or all of the orbitals may be replaced, after the initial guess is generated, using Guess=Cards. Here is some sample input for this option, which replaces orbitals 1 and 4 (note that the format for the third and following lines is specified in line 1):

Read Checkpoint File Gaussian

An orbital number of zero ends the replacement orbital input.

Antiferromagnetic coupling. Here is an example of a fragment guess job. The first step generates guesses for each one of the fragments, and then combines them together into a guess for the SCF on the full molecule. The second step reads in that guess for a subsequent calculation. The charge and multiplicity line has the overall molecular charge and multiplicity first, followed by those for each fragment.

This example is Fe2S2 + 4 S-R ligands, where R is a phenyl group. It is a singlet with an overall charge of -2. The guess does each bare sulfur as S(2-) closed-shell (fragments 2 and 4), the two irons as Fe(3+) sextets antiferromagnetically coupled (fragments 1 and 3, with 1 being alpha-spin and 3 beta-spin), and each of the S-R fragments (5-8) as closed-shell singlet anions.


Fragment Assignments

Last update: 16 September 2014

Gaussian input files have the file extension .gjf or .com.Jobs will read in data from a checkpoint (.chk) file, or write to new file.Logfiles (.log) contain all the information about the job, andwhether it failed or ran successfully.

Warning: A successful run does not mean correct run.Check your data! If it doesn’t make chemical sense, question it!

Water Example

Here is what a basic input for water would look like.

This input, with explanatory comments marked with ### is:

Calculate → Gaussian Calculation Set-Up

Job Type

  1. Energy: Calculates the energy and wavefunction at a single, fixedgeometry
  2. Optimization: Attempts to find the structure’s minimum energyconfiguration
  3. Frequency: Gives thermochemical properties of the structure
  4. Opt + Freq: Performs both optimization and frequency
  5. IRC: Asks to follow a reaction path by integrating the intrinsic reactioncoordinate
  6. Scan: Scans the potential energy surface by performing single-pointenergy calculations
  7. Stability: Checks stability by determining if imaginary (negative)frequencies exist (Yes? That’s bad, unless a transition state.)
  8. NMR: Predicts NMR shielding tensors

Method

  • Method: the “school of thought” for the wavefunction
  • Basis set: contains all the functions that represent the wavefunction
    • Higher-order basis sets are often more accurate, but at a higher computational/time cost
    • Diffuse functions (ex: +, ++) describe very electronegative atoms
    • Polarization functions (ex: d, p) allow for angular flexibility (i.e., reduces the strain from lots of electrons)
  • Charge: overall charge of the structure
  • Spin: pairing of the electrons
    • Singlet: All electrons paired
    • Multiplicity = Number of unpaired electrons + 1

Solvation

  • Implicit: Solvent is a polarizable continuum with dielectric constant,ε
    • Not terribly costly
    • Cannot model specific interactions, like hydrogen bonds
    • Magician waving a wand 0019 there’s some magic happening, but you can’t see it
  • Explicit: Want a solvent? Build it in. Put it there.
    • Expensive…
    • Can get stuff like hydrogen bonds
    • As magician’s apprentice, you see all the things going into the “magic”