This post comes out of my great appreciation for just how well Yoshio Nishimoto’s DFTB (density functional-based tight binding method) implementation in GAMESS-US runs, both as an additional functionality in an already considerable program and in comparison to a few other programs I’ve worked with to do the same.

Also, the use of unmodified Slater-Koster files in the GAMESS-US implementation is a nice touch.

This all begins at the dftb.org website with the downloading of available Slater-Koster parameter files for available sets of elements. Note that your favorite elements might not yet have parameters – or parameters within any given parameter set – for immediate use. Until others publish new parameter sets and post them somewhere – and if you’re an academic – you might consider giving Stefan Grimme’s XTB serious consideration.

Additionally! A recent find while looking for new parameter sets was the KIST Integrated Force Field Platform (kiff.vfab.org), providing the complete set of DFTB parameters and up-to-date ReaxFF parameters as well.

## Basic Input Format

A few key points (highlighted in the generic pointer input file) below:

! $scf soscf=.t. fdiff=.f. shift=.f. extrap=.f. damp=.t. diis=.f. $end

$system modio=31 $end

$basis gbasis=dftb $end

! $dftb ndftb=2 dampxh=.t. dampex=4.0 itypmx=0 etemp=300 $end

$dftb ndftb=3 dampxh=.t. dampex=4.0 disp=skhp etemp=300

disppr(1)=0.31,0.386,0.386,0.000,0.000,0.000,0.000,3.5,3.5,3.5,

3.5,3.5,3.5,0.80,0.69,1.382,1.382,1.382,1.064,1.064,1.064,3.8,3.8,

3.8,3.8,3.8,3.8,2.50 $end

$dftb hubder(1)=-0.1857,-0.1492 $end

$dftbsk

C C "/path/to/skfiles/3ob-3-1/C-C.skf"

C Si "/path/to/skfiles/3ob-3-1/C-Si.skf"

C H "/path/to/skfiles/3ob-3-1/C-H.skf"

Si C "/path/to/skfiles/3ob-3-1/Si-C.skf"

Si Si "/path/to/skfiles/3ob-3-1/Si-Si.skf"

Si H "/path/to/skfiles/3ob-3-1/Si-H.skf"

H C "/path/to/skfiles/3ob-3-1/H-C.skf"

H Si "/path/to/skfiles/3ob-3-1/H-Si.skf"

H H "/path/to/skfiles/3ob-3-1/H-H.skf"

$end $data

C1

C 6.0 -2.775607 0.000000 0.000000

...

H 1.0 -2.809590 0.000420 50.594100

$end

1. There have been many improvements to the DFTB code. The myweb.liu.edu/~nmatsuna/gamess manual (among others hosted *not* on the official GAMESS-US website) is among the first that *always* come up when searching out GAMESS-US keywords – and it’s several years out of date (esp. for DFTB keywords). The 2019.1 manual has a significantly expanded **$DFTB** section, including calls for including dispersion corrections from the original **$DFT** block.

2. No **$SCF** – as the manual states, converger specifications are pre-defined in the **ITYPMX** keyword, with additional keywords in the **$DFTB** block (esp. **ETEMP**) available to aid in problematic convergence.

3. One big **$DFTBSK** – as addressed on Jan Jensen’s initial post about running DFTB in GAMESS-US, GAMESS-US will only read atom pairs needed for the atoms listed in the **$DATA** section. You are fine to simply make an all-encompassing **$DFTBSK** block for all pairs in a parameter folder and write that to the input file.

4. **DISPPR** for **SKHP** – a mild manual issue. For the “Slater–Kirkwood + bond number polarizability dependence” dispersion correction, the current manual states that “For **DISP**=**SKHP**, a set for a species has 14 parameters. The first six are the polarizabilities depending on the number of bonds, and the next six are cutoff length, and the last is atomic charge.” You’ll note that 6 + 6 + 1 adds up to 13. The 14 numbers needed for each element in this keyword begins with the covalent atomic radius for the element. In the absence of a list for those values, Table S1.1 (freely available) from “DFTB Parameters for the Periodic Table: Part 1, Electronic Structure” is an excellent resource. I did not bother to address the “different covalent radii values for different hybridizations” issue and have seen little on the topic related to DFTB calculations. For the other 13 numbers, the DFTB+ manual contains a set in Appendix E and reproduced below, with notes to consider other publications for more and different versions of the same elements (and note the NOTES column in the Appendix E table for P and S). Local copy of the manual – 2019Aug24_DFTBplus_manual.pdf

Element Polarisability (6 #'s) ---- [Å3]Cutoff (6 #'s) -- [Å]Chrg O 0.560 0.560 0.000 0.000 0.000 0.0003.8 3.8 3.8 3.8 3.8 3.8 3.15 N 1.030 1.030 1.090 1.090 1.090 1.0903.8 3.8 3.8 3.8 3.8 3.8 2.82 C 1.382 1.382 1.382 1.064 1.064 1.0643.8 3.8 3.8 3.8 3.8 3.8 2.50 H 0.386 0.386 0.000 0.000 0.000 0.0003.5 3.5 3.5 3.5 3.5 3.5 0.80 P 1.600 1.600 1.600 1.600 1.600 1.6004.7 4.7 4.7 4.7 4.7 4.7 4.50 S 3.000 3.000 3.000 3.000 3.000 3.0004.7 4.7 4.7 4.7 4.7 4.7 4.80

5. **HUBDER** – If you don’t specify Hubbard Derivatives in your input file, GAMESS-US will include them from internal values. Values appear to be the set from the 3ob-3-1 parameter set and are available in the set’s README file (reproduced from that file below for available elements).

List of all atomic Hubbard derivatives (atomic units): Br = -0.0573 C = -0.1492 Ca = -0.0340 Cl = -0.0697 F = -0.1623 H = -0.1857 I = -0.0433 K = -0.0339 Mg = -0.02 N = -0.1535 Na = -0.0454 O = -0.1575 P = -0.14 S = -0.11 Zn = -0.03

6. **HUBDER** order – the order for these numbers is as per the FIRST appearance of the element in the **$DATA** block. This is ieasy to see if you don’t specity the **HUBDER** values in the input file and simply let GAMESS-US write out the “HUBBARD DERIVATIVES” block in your DFTB3 run.

7. **$DFT** Dispersion – according to the manual, you can now use more the traditional dispersion corrections in **$DFTB** calculations. In the **$DFTB** block, use **DISP=DFT,** then modify your **$DFT** section as you otherwise would.

8. DFTB Block Summary in the output file – below for a DFTB3 run of a CH-containing molecule using the 3ob-3-1 SK parameters:

********************************************************** ** DENSITY-FUNCTIONAL TIGHT-BINDING (DFTB) CALCULATION ** ********************************************************** WRITTEN BY YOSHIO NISHIMOTO (NAGOYA UNIVERSITY) NUMBER OF SPECIES: 2 SPECIES 1 : H WITH S ORBITAL SPECIES 2 : C WITH S+P ORBITALS $DFTB OPTIONS ------------- NDFTB = 3 SCC = T DFTB3 = T SRSCC = F DAMPXH = T DAMPEX = 4.00 DISP =NONE ITYPMX = 0 ETEMP = 0.00 MODESD = 0 MODGAM = 8 PRTORB = F --- SCC CALCULATION --- INCLUDE 3RD ORDER CORRECTION SETTING HUBBARD DERIVATIVES FOR DFTB3 H : -0.14920 (USER DEFINED) C : -0.18570 (USER DEFINED) USE X-H DAMPING: 4.00000 BROYDEN'S CHARGE MIXING 4 SLATER-KOSTER FILES WILL BE READ START READING SLATER-KOSTER FILES 1 1 (H - H ) = /home/ec2-user/3ob-3-1/H-H.skf 1 2 (H - C ) = /home/ec2-user/3ob-3-1/H-C.skf 2 1 (C - H ) = /home/ec2-user/3ob-3-1/C-H.skf 2 2 (C - C ) = /home/ec2-user/3ob-3-1/C-C.skf

## DFTB2

Starting with the less keyword-involved run, below is a completely generic DFTB2 input file with no funny business in the **$DFTB** block to aid in convergence (my first test would be to change **ETEMP** to something higher, which has often done the trick when a run won’t complete its first SCF cycle in 200 steps).

$contrl runtyp=optimize icharg=0 maxit=200 $end $system mwords=100 $end $system modio=31 $end $basis gbasis=dftb $end $dftb ndftb=2 dampxh=.t. dampex=4.0 itypmx=0 etemp=0 $end $data C1 C 6.0 -2.775607 0.000000 0.000000 … H 1.0 -2.809590 0.000420 50.594100 $end $dftbsk C C "/path/to/dftb/params/pbc-0-3/C-C.skf" C H "/path/to/dftb/params/pbc-0-3/C-H.skf" H C "/path/to/dftb/params/pbc-0-3/H-C.skf" H H "/path/to/dftb/params/pbc-0-3/H-H.skf" $end

## DFTB3

A more involved DFTB3 input file, including (1) the **SKHP** dispersion-correction and carriage returns to show that all 14 numbers are there – in order of appearance – for the atoms in **$DATA**, (2) the **$SCF** block as a comment that is ignored by DFTB calculations, (3) a reordering of all keywords above the **$DATA** block (because why not?), (4) the **HUBDER** values in order of appearance in the **$DATA** block, and (5) the Si-containing pairs in the **$DFTBSK** block just to show that their presence isn’t an issue for the run.

! $scf soscf=.t. fdiff=.f. shift=.f. extrap=.f. damp=.t. diis=.f. $end $system modio=31 $end $basis gbasis=dftb $end $dftb ndftb=3 dampxh=.t. dampex=4.0 disp=skhp etemp=300 disppr(1)= 0.31,0.386,0.386,0.000,0.000,0.000,0.000,3.5,3.5,3.5,3.5,3.5,3.5,0.80, 0.69,1.382,1.382,1.382,1.064,1.064,1.064,3.8,3.8,3.8,3.8,3.8,3.8,2.50 $end $dftb hubder(1)=-0.1857,-0.1492 $end $dftbsk C C "/path/to/skfiles/3ob-3-1/C-C.skf" C Si "/path/to/skfiles/3ob-3-1/C-Si.skf" C H "/path/to/skfiles/3ob-3-1/C-H.skf" Si C "/path/to/skfiles/3ob-3-1/Si-C.skf" Si Si "/path/to/skfiles/3ob-3-1/Si-Si.skf" Si H "/path/to/skfiles/3ob-3-1/Si-H.skf" H C "/path/to/skfiles/3ob-3-1/H-C.skf" H Si "/path/to/skfiles/3ob-3-1/H-Si.skf" H H "/path/to/skfiles/3ob-3-1/H-H.skf" $end $data C1 H 1.0 -2.775607 0.000000 0.000000 C 6.0 -3.775607 0.000000 0.000000 .... H 1.0 -2.809590 0.000420 50.594100 $end

And, just to keep you from bouncing between tabs, the $DFTB section from the 2019.1 version of the manual (obviously check there at some point for changes and improvements).

$DFTB group (relevant for GBASIS=DFTB) Density-functional tight-binding (DFTB) is turned on by selecting GBASIS=DFTB in $BASIS. $DFTB controls optional parameters for a DFTB calculation. DFTB is formulated in a two-center approximation utilizing implicitly a minimal pseudoatomic orbital basis set with corresponding, pretabulated one- and two-center integrals. Because of this, many properties (for instances, multipoles higher than dipoles) and many options are ignored or not available in the current implementations of DFTB. DFTB also uses an independent SCF driver (SCF in DFTB is also called SCC, see below), so most SCF options are not available for DFTB. Only SCFTYP=RHF and UHF are implemented. SCFTYP=ROHF is available, only when all SPNCST values are zero. DFTB does not explicitly use symmetry (C1 throughout) since integrals are never computed during the calculations. Slater-Koster tables are only defined for spherical functions (5d) so DFTB sets ISPHER=1. Most $GUESS options do not work for DFTB (DFTB does not use initial orbitals in the usual sense). Other than the default (METHOD=HUCKEL, which is ignored), only METHOD=MOREAD works (note that SCC-DFTB can use initial charges on atoms, derived from the orbitals). RUNTYP=OPTIMIZE, HESSIAN and RAMAN are available for full (non-FMO) DFTB and FMO-DFTB. Excited state calculations for full DFTB may be performed through the standard (linear- response) time-dependent formalism (only closed shell). PCM can be used for both ground and excited state calculations, and energy and gradient can be evaluated. In DFTB calculation, the atom type is determined by its name, not its nuclear charge as elsewhere in GAMESS. The nuclear charge (the second column in $DATA) is used only in population analysis, but not in SCF. DFTB uses a notion of "species", which means an atomic type. The species are numbered according to the order in which atoms appear in $DATA. For instances, in water there are two species, O and H. An atomic type of each species needs MAXANG, which for most but not all atoms is set automatically. NDFTB order of the Taylor expansion of the total energy around a reference density in the DFTB model. = 1 NCC-DFTB, also called DFTB1. NCC stands for non-charge-consistent, i.e., no explicity charge-charge interaction term is included in the energy calculation. = 2 SCC-DFTB, also called DFTB2. SCC means a self-charge-consistent approach, and SCC implies that SCF iterations are carried out that converge monopolar charges towards self-consistency. = 3 DFTB3, including 3rd order correction using Hubbard derivatives (HUBDER). In order to reproduce the published DFTB3 approach, it is necessary to also specify DAMPXH=.TRUE. to add other terms. Gaus, M. et al. J. Chem. Theory Comput. 2011, 7, 931-948 is referred to as Gaus2011 below. Default: 2. DAMPXH = a flag to include the damping function for X-H atomic pair in DFTB3. See also DAMPEX, and eq 21 in Gaus2011. The damping function is used when at least one atom in a pair is "H". "HYDROGEN" and any other name will turn off the damping. Default: .FALSE. DAMPEX = an exponent used in the damping function for X-H atomic pairs. The default value is 4.0 (taken from the 3OB parameter set). SRSCC = a flag to perform shell-resolved SCC calculation. If set to .FALSE., the code uses the Hubbard value for an s orbital for p and d orbitals, ignoring their Hubbard values defined in Slater- Koster tables. Using .TRUE. enables the use of proper Hubbard values for p and d orbitals, implemented only for DFTB1 and DFTB2. Default: .FALSE. ITYPMX Convergence method of SCC calculations. = -1 Use standard GAMESS convergence methods. SOSCF and DIIS are supported, but DEM is not. = 0 Broyden's method. Interpolation is applied for atomic (or shell-resolved when SRSCC=.TRUE.) charges, but not Hamiltonian matrix. = 1 (reserved) = 2 DIIS for charges. Default: 0. ETEMP = electronic temperature in Kelvin. Non-zero values of ETEMP help SCF convergence of nearly-degenerate systems by smearing occupation numbers around the Fermi-level. Only the Fermi-Dirac distribution function is available as a smearing function. The default value is 0 Kelvin, meaning the smearing function is not used. ETEMP is implemented only for SCFTYP=RHF and when FMO is not used. DISP dispersion model for DFTB. = NONE no Dispersion correction. = UFF UFF-type dispersion correction. Parameters for atomic numbers up to 54 are available internally or can be supplied in DISPPR for any atom. Built-in parameters are taken from Rappe et al. J. Am. Chem. Soc. 1992, 114, 10024. = SK The Slater-Kirkwood type dispersion correction omitting the change polarizability depending on the number of bonds. No default values of DISPPR are available. Some are listed in the manual of the DFTB+ program. = SKHP The Slater--Kirkwood type dispersion with the dependence of polarizabilities on the number of bonds. = DFT Use so-called DFT-D. See $DFT for further details. DISP=GRIMME is a synonym. DISPPR an array of parameters used for dispersion correction, listed in sets for each species. For DISP=UFF, DISPPR(1) and DISPPR(2) define the non-bonded distance (Angs.) and energy (kcal/mol) for the first species, respectively, and so on. For DISP=SK, a set for a species has 3 parameters, the polarizability (Angstrom^3), cutoff length (Angstrom), and atomic charge. For DISP=SKHP, a set for a species has 14 parameters. The first six are the polarizabilities depending on the number of bonds, and the next six are cutoff length, and the last is atomic charge. Default: see DISP. HUBDER an array of Hubbard derivatives for each species (1 per species) used only for DFTB3 calculations. Default values are set for the elements included in the 3OB parameters (Br, C, Ca, Cl, F, H, I, K, Mg, N, Na, O, P, S, Zn). MAXANG array of maximum angular momentum of each species, which determines the number of basis functions. DFTB uses only valence orbitals and electrons! Most elements have proper default values, but for some atomic types (i.e., species) you need to manually define the values. QREF array of the number of reference electrons of each species. QREF is usually automatically taken from Slater-Koster parameters, so this option is seldom used. SPNCST an array of spin constants used in unrestricted (UHF) DFTB calculation. Provide 6 spin constants, W_{ss}, W_{sp}, W_{pp}, W_{sd}, W_{pd}, & W_{dd}, for each species in a continuous array. Constants for some elements can be found in the manual of the DFTB+ program. PARAM specifies the directory from which DFTB parameters are taken. If you wish to mix parameters from different directories, this option cannot be used. Specifying PARAM means no $DFTBSK; otherwise, $DFTBSK is read. Nota bene-bene: the actual path for parameters includes $DFTBPAR, defined in rungms. All directory names used in PARAM should be ** UPPER CASE **, as 3OB-3-1 in ~/gamess/dftb/param/3OB-3-1 where $DFTBPAR=~/gamess/auxdata/DFTB PARAM=3OB-3-1 The length of PARAM is maximum 8 characters! Each parameter file name has a limit of 150 characters. GAMESS includes 3OB-3-1 and MATSCI03 (properly called matsci-0-3), which you may specify in PARAM. 3ob-3-1 should be used with DFTB3 (biochemistry+water). matsci-0-3 should be used with DFTB2 (iorganics). You can find more parameter sets at dftb.org. Before using DFTB parameters, ~/gamess/dftb/README.dftb should be consulted regarding lisense and citations. Default: "", meaning that $DFTBSK is read. ISPDMP An array of integer specifying species X to which the X--H damping function (DAMPXH) is applied. By default, with DAMPXH=.TRUE., ISPDMP for all elements is 1 (apply). Setting 1 for H does not do anything. * * * The following options are FMO-DFTB specific (Nishimoto, Y. et al. J. Chem. Theory Comput. 2014, 10, 4801-4812.). FMO-DFTB has many limitations and some FMO options are not supported (for instance, multilayer FMO etc). Only single layer, restricted closed-shell FMO2/3-DFTB1/2/3 are implemented at present. SRSCC, ETEMP etc are not available. The analytic gradient is available for FMO-DFTB, requiring solving SCZV as in other FMO methods. MODESD = controls the behavior of ES-DIM (electrostatic dimer) approximation (bit additive). 1 Calculate interfragment repulsive energy for ES dimers (almost never used). 2 Add up all ES-DIM energies. This means that individual ES dimer energies are not calculated, but only their total lump sum, computed with the dynamic load balancing. 4 Lump ES-DIM routine with static load balancing. The bits of 2 or 4 are mutually exclusive. Default: 0 (i.e., individual ES dimer energies). MODGAM = controls the calculation of gamma values (interatomic 1/R-like function) in FMO-DFTB2 and FMO-DFTB3 (bit additive). 0 Calculate gamma values on the fly. 1 Calculate once and prestore gamma values in triangular matrix. 2 Calculate once and prestore gamma values in square matrix. 4 With the bits of 1 or 2, the calculation of gamma values is parallelized with GDDI. The bits of 1 or 2 are mutually exclusive. These options are faster but takes more memory. 8 Using this option omits computing ESP in dimer and trimer calculations by accumulating contributions of each fragment and subtracting double-counting contributions. Default: 8 * * * The following options are relevant to second- and third-order derivative calculations (RUNTYP=HESSIAN and RAMAN). CPCONV = Convergence criterion during coupled-pertrubed DFTB iterations, similar to CONV in $SCF. In DFTB, the program uses Mulliken charges for testing the convergence, but not density matrix itself. By default, CPCONV=1.0D-06. MXCPIT = Maximum number of coupled-perturbed DFTB iterations. By default, MXCPIT=50. DEGTHR = An array of two degeneracy thresholds. If the difference of two eigenvalues are less than the threshold, two orbitals are seen as degenerated. The first threshold is employed in solving coupled-perturbed equations, while the second threshold is in computing third-order derivatives analytically. By default, these are set to 1.0D-12 and 1.0D-08, whieh are usually reasonable. ARAMAN = A flag to compute third-order derivatives (static hyperpolarizability and polarizability derivative) analytically, in addition to Hessian. If this option is activated, users do not have to give $HESSIAN and $DIPDR in the input, and non-resonance Raman spectra can be simulated by a single run. This option requires that RUNTYP must be RAMAN. By default, ARAMAN=.FALSE. * * * The following optinos are relevant to long-ranged corrected DFTB. The formulation is based on Lutsker, V. et al. 2015, 143, 184107. With LC-DFTB, using ITYPMX=-1 options is highly recommended. LCDFTB = A flag to activate long-range correctios EMU = A parameter for long-range corrections. The meaning is very similar to MU in $DFT. By default, EMU=0.0, and this corresponds to regular DFTB. ICUT = A parameter applied in the screening using the Schwarz inequiality. The meaning is similar to ICUT in $CONTRL. By default, the screening is not employed, but this is usually as fast as ICUT=9, depending on the performance of the math library.