This file is designed to be machine independent with a structure that makes it easy for post-processors to extract required data and ignore the remainder. The latter fact is important for extensibility as future additions will not interfere with applications designed for previous revisions. Typically a job is run specifying a .chk file, which is the binary file containing results from a calculation which are potentially useful in later calculations or for post-processing, and then after Gaussian 09 has completed, the formchk utility is run to generate the text .fchk file from the binary .chk file. There is also a utility, unfchk, to reverse the process. For backwards compatibility, running formchk without any options produces a subset of the full information. This document describes the results of running formchk -3 chkfile fchkfile, which produces a version 3 formatted checkpoint file (the current and most full-featured version).
Here is a description of the data in Fortran formatted form, although there is no particular reason to use Fortran as opposed to other languages to read the data.
The first two lines in the file contain strings describing the job:
Initial 72 characters of the title section | Complete route and title appear later. | |
Type, Method, Basis | Format: A10,A30,A30 |
Type is one of the following keywords:
SP | Single point | |
FOPT | Full optimization to a minimum | |
POPT | Partial optimization to a minimum | |
FTS | Full optimization to a transition state | |
PTS | Partial optimization to a transition state | |
FSADDLE | Full optimization to a saddle point of order 2 or higher | |
PSADDLE | Partial optimization to a saddle point of order 2 or higher | |
FORCE | Energy+gradient calculation | |
FREQ | Vibrational frequency (2nd derivative) calculation | |
SCAN | Potential surface scan | |
GUESS=ONLY | Generate molecular orbitals only, also used with localized orbital generation | |
LST | Linear synchronous transit | |
STABILITY | Test of SCF/KS stability | |
REARCHIVE/MS-RESTART | Generate archive information from checkpoint file | |
MIXED | Mixed method model chemistry (CBS-x, G1, G2, etc.), with method and basis set implied by model |
Method is the method of computing the energy (AM1, RHF, CASSCF, MP4, etc.), and Basis is the basis set.
All other data contained in the file is located in a labeled line/section set up in one of the following forms:
Scalar values appear on the same line as their data label. This line consists of a string describing the data item, a flag indicating the data type, and finally the value:
Integer scalars: Name,I,IValue, using format A40,3X,A1,5X,I12.
Real scalars: Name,R,Value, using format A40,3X,A1,5X,E22.15.
Character string scalars: Name,C,Value, using format A40,3X,A1,5X,A12.
Logical scalars: Name,L,Value, using format A40,3X,A1,5X,L1.
Vector and array data sections begin with a line naming the data and giving the type and number of values, followed by the data on one or more succeeding lines (as needed):
Integer arrays: Name,I,Num, using format A40,3X,A1,3X,’N=’,I12. The N= indicates that this is an array, and the string is followed by the number of values. The array elements then follow starting on the next line in format 6I12.
Real arrays: Name,R,Num, using format A40,3X,A1,3X,’N=’,I12, where the N= string again indicates an array and is followed by the number of elements. The elements themselves follow on succeeding lines in format 5E16.8. Note that the Real format has been chosen to ensure that at least one space is present between elements, to facilitate reading the data in C.
Character string arrays (first type): Name,C,Num, using format A40,3X,A1,3X,’N=’,I12, where the N= string indicates an array and is followed by the number of elements. The elements themselves follow on succeeding lines in format 5A12.
Character string arrays (second type): Name,H,Num, using format A40,3X,A1,3X,’N=’,I12, where the N= string indicates an array and is followed by the number of elements. The elements themselves follow on succeeding lines in format 9A8.
Logical arrays: Name,H,Num, using format A40,3X,A1,3X,’N=’,I12, where the N= string indicates an array and is followed by the number of elements. The elements themselves follow on succeeding lines in format 72L1.
All quantities are in atomic units and in the standard orientation, if that was determined by the Gaussian run. Standard orientation is seldom an interesting visual perspective, but it is the natural orientation for the vector fields. The field names are fairly verbose to make them informative and should not be an impediment as only the interface program needs to use them. An example program, demofc, is distributed with Gaussian and demonstrates how to extract a named field.
The basis set information is provided in a reasonably general way which does not assume the specific structure of Gaussian’s Common /B/, which is rather obscure and reflects history more than clarity. The basis set data will include scalars giving the number of shells (NShell), largest degree of contraction, highest angular momentum present, and number of primitive shells (NPrim). There will then be arrays containing:
Other data, such as basis function indexing arrays, are easily derived from the above. The order of basis functions within shells is the usual Gaussian order:
S,X,Y,Z,XX,YY,ZZ,XY,XZ,YZ,XXX,YYY,ZZZ,XYY,XXY,XXZ,XZZ,YZZ,YYZ,XYZ
or
3ZZ-RR,XZ,YZ,XX-YY,XY,ZZZ-ZRR,XZZ-XRR,YZZ-YRR,XXZ-YYZ,XYZ,XXX-XYY,XXY-YYY
The following items are among those currently defined:
Which energy should be used by default?
The Total Energy field has the energy at whatever level of theory the user requested. This is so other programs don’t have to figure out where the energy is from the Method string. In particular, we can add new methods and you won’t have to change logic to find the energy you’ll normally want.
Why does the field descriptor include the data type information?
The purpose of including the data type for each field is to facilitate skipping that field if it’s not of interest, as illustrated in the demo program below.
How are ECP atomic charges handled?
The “Nuclear charges” will differ from the atomic numbers if ECPs are in use.
Which density fields will be present?
The total density will always be present; the spin density will be stored only for open-shell systems. By default this will be the SCF density. If a post-SCF density is desired, include the Density keyword in the Gaussian input.
When will force constants be present?
The force constants may be present and zero for cases for which only first derivatives were actually computed, or when they were computed at the first point of a geometry optimization but not at later points. They should only be used for vibrational analysis if the job type is Freq.
Why is there no mapping array between shells and primitives?
It was pointed out that the mapping from shells to primitives is not made explicit, so that the primitive data is stored separately for every atom, even if some have the same basis set. The information that atoms have the same basis set is discarded early in Gaussian, and time did not permit writing code to regenerate this information while writing the file. The basis set is only of interest if the orbitals or density is also used. Since the latter are quadratic in the size of the molecule, the potential savings for large molecules from removing redundant primitives seemed modest.
Here is an example formatted checkpoint file for an MP2/STO-3G calculation on triplet methylene:
Triplet Methylene SP UMP2-FC STO-3G Number of atoms I 3 IOpCl I 1 IROHF I 0 Charge I 0 Multiplicity I 3 Number of electrons I 8 Number of alpha electrons I 5 Number of beta electrons I 3 Number of basis functions I 7 Number of independent functions I 7 Number of point charges in /Mol/ I 0 Number of translation vectors I 0 Number of residues I 0 Number of secondary structures I 0 Number of symbols in /Mol/ I 0 Info1-9 I N= 9 8 8 0 0 0 111 1 2 1 Num ILSW I 100 ILSW I N= 100 1 0 0 0 2 0 0 0 0 0 0 -1 0 0 0 0 0 0 0 0 2 0 0 0 1 0 0 0 0 0 0 0 100000 0 -1 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 1 0 0 0 0 0 4 40 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 Num RLSW I 40 RLSW R N= 40 1.00000000E+00 1.00000000E+00 1.00000000E+00 1.00000000E+00 1.00000000E+00 0.00000000E+00 0.00000000E+00 1.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 1.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 1.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 1.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 1.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 1.00000000E+00 1.00000000E+00 Number of contracted shells I 4 Highest angular momentum I 1 Largest degree of contraction I 3 Number of primitive shells I 12 Pure/Cartesian d shells I 0 Pure/Cartesian f shells I 0 Virial Ratio R 1.995814616819217E+00 SCF Energy R -3.843551207731927E+01 MP2 Energy R -3.845916855965901E+01 Total Energy R -3.845916855965901E+01 PUHF Energy R -3.843794045556613E+01 PMP2-0 Energy R -3.846088420969759E+01 Post-SCF wavefunction norm R 1.004516257004766E+00 S**2 R 2.014461674556861E+00 S**2 after annihilation R 2.000077930794892E+00 S**2 corrected to first order R 2.005942183926543E+00 RMS Density R 1.581648813313776E-09 Atomic numbers I N= 3 6 1 1 Nuclear charges R N= 3 6.00000000E+00 1.00000000E+00 1.00000000E+00 Current cartesian coordinates R N= 9 -6.16297582E-33 0.00000000E+00 2.55113028E-01 0.00000000E+00 1.76747490E+00 -7.65339084E-01 -2.16453248E-16 -1.76747490E+00 -7.65339084E-01 Atom Types C N= 3 Int Atom Types I N= 3 0 0 0 Force Field I 0 MM charges R N= 3 0.00000000E+00 0.00000000E+00 0.00000000E+00 Integer atomic weights I N= 3 12 1 1 Real atomic weights R N= 3 1.20000000E+01 1.00782504E+00 1.00782504E+00 Atom fragment info I N= 3 0 0 0 Atom residue num I N= 3 0 0 0 Nuclear spins I N= 3 0 1 1 Nuclear ZEff R N= 3 -3.60000000E+00 -1.00000000E+00 -1.00000000E+00 Nuclear QMom R N= 3 0.00000000E+00 0.00000000E+00 0.00000000E+00 Nuclear GFac R N= 3 0.00000000E+00 2.79284600E+00 2.79284600E+00 MicOpt I N= 3 -1 -1 -1 Constraint Structure R N= 9 -2.35838313E-33 0.00000000E+00 2.55113028E-01 -3.41380879E-32 1.76747490E+00 -7.65339084E-01 -2.16453248E-16 -1.76747490E+00 -7.65339084E-01 ONIOM Charges I N= 16 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 ONIOM Multiplicities I N= 16 3 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 Atom Layers I N= 3 1 1 1 Atom Modifiers I N= 3 0 0 0 Atom Modified Types C N= 3 Int Atom Modified Types I N= 3 0 0 0 Link Atoms I N= 3 0 0 0 Atom Modified MM Charges R N= 3 0.00000000E+00 0.00000000E+00 0.00000000E+00 Link Distances R N= 12 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 MxBond I 2 NBond I N= 3 2 1 1 IBond I N= 6 2 3 1 0 1 0 RBond R N= 6 1.00000000E+00 1.00000000E+00 1.00000000E+00 0.00000000E+00 1.00000000E+00 0.00000000E+00 Shell types I N= 4 0 -1 0 0 Number of primitives per shell I N= 4 3 3 3 3 Shell to atom map I N= 4 1 1 2 3 Primitive exponents R N= 12 7.16168373E+01 1.30450963E+01 3.53051216E+00 2.94124936E+00 6.83483096E-01 2.22289916E-01 3.42525091E+00 6.23913730E-01 1.68855404E-01 3.42525091E+00 6.23913730E-01 1.68855404E-01 Contraction coefficients R N= 12 1.54328967E-01 5.35328142E-01 4.44634542E-01 -9.99672292E-02 3.99512826E-01 7.00115469E-01 1.54328967E-01 5.35328142E-01 4.44634542E-01 1.54328967E-01 5.35328142E-01 4.44634542E-01 P(S=P) Contraction coefficients R N= 12 0.00000000E+00 0.00000000E+00 0.00000000E+00 1.55916275E-01 6.07683719E-01 3.91957393E-01 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 Coordinates of each shell R N= 12 -2.35838313E-33 0.00000000E+00 2.55113028E-01 -2.35838313E-33 0.00000000E+00 2.55113028E-01 -3.41380879E-32 1.76747490E+00 -7.65339084E-01 -2.16453248E-16 -1.76747490E+00 -7.65339084E-01 Alpha Orbital Energies R N= 7 -1.09934649E+01 -8.99280967E-01 -5.45391261E-01 -4.22615172E-01 -3.66596942E-01 6.71551044E-01 7.55382975E-01 Beta Orbital Energies R N= 7 -1.09350319E+01 -7.15686644E-01 -5.03082985E-01 3.05387126E-01 3.76749183E-01 7.45159737E-01 8.42123674E-01 Alpha MO coefficients R N= 49 9.92143921E-01 3.41561086E-02 0.00000000E+00 0.00000000E+00 -3.96834245E-03 -7.70608078E-03 -7.70608078E-03 -2.45353746E-01 7.88800679E-01 0.00000000E+00 0.00000000E+00 -1.51998297E-02 2.07368129E-01 2.07368129E-01 0.00000000E+00 0.00000000E+00 0.00000000E+00 5.81713695E-01 0.00000000E+00 4.03972000E-01 -4.03972000E-01 -7.91331978E-02 4.18822356E-01 0.00000000E+00 0.00000000E+00 8.40280330E-01 -2.41428132E-01 -2.41428132E-01 0.00000000E+00 0.00000000E+00 1.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 -1.73156512E-01 1.11677115E+00 0.00000000E+00 0.00000000E+00 -7.07495939E-01 -9.12363520E-01 -9.12363520E-01 0.00000000E+00 0.00000000E+00 0.00000000E+00 1.14003960E+00 0.00000000E+00 -8.92668310E-01 8.92668310E-01 Beta MO coefficients R N= 49 9.93625814E-01 2.80174965E-02 0.00000000E+00 0.00000000E+00 -3.90152527E-03 -6.44780850E-03 -6.44780850E-03 -1.95727052E-01 5.46887218E-01 0.00000000E+00 0.00000000E+00 -1.74242092E-01 3.44389565E-01 3.44389565E-01 0.00000000E+00 0.00000000E+00 0.00000000E+00 4.87826885E-01 0.00000000E+00 4.74684290E-01 -4.74684290E-01 -1.54812376E-01 7.12820567E-01 0.00000000E+00 0.00000000E+00 7.39978976E-01 -2.53618910E-01 -2.53618910E-01 0.00000000E+00 0.00000000E+00 1.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 -1.76706118E-01 1.11264520E+00 0.00000000E+00 0.00000000E+00 -7.93047228E-01 -8.66479868E-01 -8.66479868E-01 0.00000000E+00 0.00000000E+00 0.00000000E+00 1.18326077E+00 0.00000000E+00 -8.57160962E-01 8.57160962E-01 Total SCF Density R N= 28 2.07641142E+00 -2.71991893E-01 1.09865593E+00 6.74377463E-34 -4.51874795E-33 1.00000000E+00 0.00000000E+00 0.00000000E+00 -4.00593428E-32 5.76365893E-01 -3.64746665E-02 2.44402925E-01 -1.67021577E-32 3.77373431E-49 7.36693344E-01 -1.13232171E-01 2.50355011E-01 -3.08148791E-33 4.66559803E-01 -2.65970693E-01 6.08512766E-01 -1.13232171E-01 2.50355011E-01 1.23259516E-32 -4.66559803E-01 -2.65970693E-01 -1.68524337E-01 6.08512766E-01 Spin SCF Density R N= 28 2.52087462E-02 -1.13588463E-01 4.98914708E-01 1.79211577E-33 -8.04643841E-33 1.00000000E+00 0.00000000E+00 0.00000000E+00 -3.38963670E-32 1.00415753E-01 -9.69291361E-02 4.35203093E-01 -1.55789358E-32 3.77373431E-49 6.75942287E-01 3.43939549E-02 -1.25968187E-01 3.08148791E-33 3.43228637E-03 -1.46006689E-01 -7.94290766E-02 3.43939549E-02 -1.25968187E-01 6.16297582E-33 -3.43228637E-03 -1.46006689E-01 4.48345193E-02 -7.94290766E-02 Cartesian Gradient R N= 9 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 Grdnt Energy R 0.000000000000000E+00 Grdnt NVar I 2 Grdnt IGetFC I 0 Internal Forces R N= 2 0.00000000E+00 0.00000000E+00 Internal Force Constants R N= 3 0.00000000E+00 0.00000000E+00 0.00000000E+00 Mulliken Charges R N= 3 -9.27503627E-02 4.63751814E-02 4.63751814E-02 Full Title C N= 2 Triplet Methylene Route C N= 3 #t mp2/sto-3g test geom=modela External E-field R N= 35 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00 0.00000000E+00
Last update: 23 April 2014