Required input sections

There are four required input sections for eT:

  • system

  • method

  • do

  • geometry

system

In the system section of the input the name, charge, and multiplicity of the system is given. Furthermore, the use of cartesian Gaussians may be specified in this section.

Required keywords

name: [string]

Default: none

Specifies the name of the calculation, which is printed in the output file.

Optional keywords

charge: [integer]

Default: \(0\)

Specifies the charge of the system.

multiplicity: [integer]

Default: \(1\)

Specifies the spin multiplicity of the system.

cartesian gaussians

Enforce cartesian Gaussians basis functions for all atoms. Default for Pople basis sets.

pure gaussians

Enforce spherical Gaussian basis functions for all atoms. Default for all basis sets except Pople basis sets.

print orbitals

Print orbital coefficients to *mo_information.out files when the orbital coefficients change, e.g. when frozen hf or MLCC are used.

Examples

A minimal example of the system section, includes only the name of the calculation. This can be any string, e.g.,

system
   name: water
end system

The charge and multiplicity is given in the example below. Additionally, cartesian Gaussians are enabled.

system
   name: water
   charge: 0
   multiplicity: 1
   cartesian gaussians
end system

method

In the method section, the wavefunction method is specified. In the case of a post-HF calculation, both the reference wavefunction method and the post-HF method must be specified.

Hartree-Fock methods

At the Hartree-Fock level of theory the following keywords may be specified:

  • hf for restricted Hartree-Fock (RHF)

  • mlhf for multilevel Hartree-Fock

  • uhf for unrestricted Hartree-Fock

  • rohf for restricted open-shell Hartree-Fock

  • cuhf for constrained unrestricted Hartree-Fock

  • qed-hf for quantum electrodynamics Hartree-Fock (QED-HF)

In coupled cluster calculations, either RHF or MLHF must be specified, in addition to the coupled cluster method.

Coupled cluster methods

The available coupled cluster methods are:

  • ccs

  • cc2

  • lowmem-cc2

  • ccsd

  • ccsd(t)

  • cc3

  • mlcc2

  • mlccsd

  • fci

Other methods

  • mp2

Examples

For a Hartree-Fock calculation, specify the type of wavefunction (hf, mlhf, or uhf) in the method section.

method
   hf
end method

To perform a coupled cluster calculation, both the coupled cluster method and the type of reference wavefunction must be specified.

method
   hf
   ccsd
end method

do

The do section is where the type of calculation is specified. It will determine the \(e^T\) engine used in the calculation.

Note

Only one of the keywords below has to be specified. For example for the calculation of excited states only the keyword excited state is required even though the ground state equations have to be solved as well to obtain excited states.

Keywords

cholesky eri

Keyword to run a Cholesky decomposition of the two-electron integrals. Note that this is done automatically for any coupled cluster calculation, the keyword should only be given if only Cholesky decomposition is to be performed.

ground state

Keyword to run a ground state calculation at the level of theory given in the method section. Enables the ground state or reference engine.

ground state geoopt

Keyword to run a Hartree-Fock ground state geometry optimization. Enables the ground state geometry optimization engine.

mean value

Keyword to calculate coupled cluster expectation values. Enables the mean value engine, which determines the coupled cluster ground state amplitudes and multipliers, and calculates the requested expectation value. Which mean value(s) to calculate are specified in the cc mean value section.

Note

For Hartree-Fock calculations, one must write ground state in do and specify the mean value(s) to calculate in the hf mean value section.

excited state

Keyword to run a coupled cluster excited state calculation. Enables the excited state engine, which calculates the ground and excited state amplitudes.

Note

The cc es solver section is required for excited state calculations.

response

Keyword to enable the coupled cluster response engine. Implemented features are EOM transition moments and polarizabilities for CCS, CC2, CCSD and CC3, and LR transition moments and polarizabilities for CCS. The response engine drives the calculation of ground state amplitudes and multipliers, excited state vectors (left and right eigenvectors of the Jacobian matrix) and the requested property.

Note

The cc response section is required for coupled cluster response calculations.

restart

Global restart keyword to activate restart where possible.

Note

eT will first check if restart is possible and use the default start guess if not.

time dependent state

Keyword to run coupled cluster time propagation. Enables the time-dependent engine.

Note

The cc td section is required for coupled cluster time propagation.

tdhf excited state

Keyword to run TDHF excitation energies (Tamm-Dancoff or RPA).

Note

The solver tdhf es section is required for TDHF excited state calculations.

tdhf response

Keyword to run TDHF response calculation (polarizabilities).

Example

To calculate the CCSD ground and four excited states, specify

do
   excited state
end do

together with

method
   hf
   ccsd
end method

and

solver cc es
   singlet states: 4
end solver cc es

geometry

The geometry must be given as xyz coordinates either with Angstrom or Bohr units. The default units are Angstrom. The basis set is also given in the geometry section.

Minimal example for the geometry section

geometry
   basis: aug-cc-pVDZ
   H          0.86681        0.60144        5.00000
   H         -0.86681        0.60144        5.00000
   O          0.00000       -0.07579        5.00000
end geometry

If other units than Angstrom are desired, this must be specified at the top of the geometry section with the units keyword. Possible values are Angstrom and Bohr.

geometry
   units: Bohr
   basis: aug-cc-pVDZ
   H          1.63803   1.13655   9.44863
   H         -1.63803   1.13655   9.44863
   O          0.00000  -0.14322   9.44863
end geometry

Different basis sets may be placed on the atoms using the basis keyword. An atom is given the last basis set specified above it, e.g. in the following example the oxygen has the d-aug-cc-pVDZ basis and the hydrogens have the aug-cc-pVDZ basis. See here for a list of included basis sets.

geometry
   basis: aug-cc-pVDZ
   H          0.86681        0.60144        5.00000
   H         -0.86681        0.60144        5.00000
   basis: d-aug-cc-pVDZ
   O          0.00000       -0.07579        5.00000
end geometry

Basis functions can be placed without the corresponding atom by using the keyword ghost. Every atom specified after the keyword will have zero charge, which corresponds to only placing the basis functions at the specified location. An H2 calculation run with the same basis functions as H2O can be done using this geometry:

geometry
   basis: aug-cc-pVDZ
   H          0.86681        0.60144        5.00000
   H         -0.86681        0.60144        5.00000
   ghost
   O          0.00000       -0.07579        5.00000
end geometry

In case of QM/MM calculations, the QM and MM portions have to be separated by a line containing --. The parameters for QM/MM calculations are placed after the XYZ coordinates. In case of electrostatic QM/MM embedding (see molecular mechanics section), the charge of each atom needs to be provided:

geometry
   basis: cc-pVDZ
    O      0.87273600      0.00000000     -1.24675400
    H      0.28827300      0.00000000     -2.01085300
    H      0.28827300      0.00000000     -0.48265500
    --
    O [IMol=   1]     -0.77880300      0.00000000      1.13268300      [q=-0.834]
    H [IMol=   1]     -0.66668200      0.76409900      1.70629100      [q=+0.417]
    H [IMol=   1]     -0.66668200     -0.76409900      1.70629000      [q=+0.417]
end geometry

In case of polarizable QM/FQ (see molecular mechanics section), the electronegativities (chi) and chemical hardnesses (eta) are needed for each atom:

geometry
   basis: cc-pVDZ
    O      0.87273600      0.00000000     -1.24675400
    H      0.28827300      0.00000000     -2.01085300
    H      0.28827300      0.00000000     -0.48265500
    --
    O [IMol=   1]     -0.77880300      0.00000000      1.13268300     [chi=0.11685879436,eta=0.58485173233]
    H [IMol=   1]     -0.66668200      0.76409900      1.70629100     [chi=0.00000000000,eta=0.62501048888]
    H [IMol=   1]     -0.66668200     -0.76409900      1.70629000     [chi=0.00000000000,eta=0.62501048888]
end geometry