Szczepanik Research Group
Department of Theoretical Chemistry
Faculty of Chemistry, Jagiellonian University
Gronostajowa 2, 30-387 Krakow, Poland
Tel: (+48) 12 686 23 90
E-mail: dariusz.szczepanik@uj.edu.pl
HOME PROJECTS PUBLICATIONS runEDDB X
About EDDB Download Tutorials Manual
Give runEDDB a bare geometry (an X-ray structure, an MD snapshot, a hand-built model or a built-in molecule) and it computes the electronic structure itself with the semi-empirical GFN2-xTB method, then runs the whole analysis on it: EDDB, tables, maps, even NICS and ring currents. No other program is needed and a molecule of a hundred atoms takes about a second. This page describes the engine, how close its results come to DFT, its settings, and the magnetic response it provides.
Any geometry file (.xyz .mol .sdf .mol2 .pdb) or -i @NAME selects this lane; the file
formats, charge and multiplicity are described on the Input files page. Under
-v the stage lists its settings:
$ runEDDB -i @benzene -v
▶ Modelling one-electron density at the GFN2-xTB/vSTO-nG level...
Hamiltonian model: GFN2-xTB
Dispersion correction: DFT-D4
Initial guess: SAD
Algorithm: SCC
Maximum SCC iterations (MAXITER): 1500
Convergence criterion (CONV): 1.00E-04 (max|dq|)
Anisotropic electrostatics (AES): Enabled
Spin polarization (SP): Disabled
Fermi smearing (ETEMP): Enabled (300 K)
Effective core potential: Yes (12 core electrons)
Number of basis functions: 30 (vSTO-nG)
Total energy: -15.87828 Eh (6 SCC iterations)
Electron population (Tr[D*S]): 30.00000-b nao equals -b nvb.The π delocalization of conjugated molecules comes out close to B3LYP. The same geometries through both
lanes (B3LYP/def2-TZVPP wavefunctions; -a, CDI from -p along each ring):
| Molecule | EDDBπ xTB | EDDBπ B3LYP | CDI xTB | CDI B3LYP |
|---|---|---|---|---|
| benzene | 5.349 | 5.293 | 0.889 | 0.880 |
| naphthalene | 7.728 | 7.529 | 0.402 | 0.406 |
| anthracene (outer / central ring) | 11.030 | 10.578 | 0.325 / 0.414 | 0.318 / 0.419 |
| pyrene (the two ring types) | 13.093 | 12.928 | 0.338 / 0.404 | 0.332 / 0.402 |
| coronene (outer / central ring) | 18.198 | 18.162 | 0.390 / 0.415 | 0.392 / 0.411 |
| pyridine | 5.285 | 5.235 | 0.818 | 0.799 |
| pyrrole | 3.743 | 3.673 | 0.593 | 0.583 |
| thiophene | 2.915 | 2.991 | 0.402 | 0.436 |
| borazine | 3.804 | 3.379 | 0.254 | 0.194 |
For hydrocarbons and azines the π populations agree within 4 % and the CDIs within 0.02, including the
ring-by-ring pattern of fused systems. Polar π systems are less reliable: borazine is too delocalized by a third,
thiophene slightly too little. The total EDDB (without -a) agrees within 6 %. Range-separated
functionals localize the π electrons more than B3LYP, so against them the xTB values are higher. Use the lane
for a survey (which atoms and rings take part, which pathways are worth a closer look) and confirm the numbers
that matter with a DFT wavefunction through one of the other input lanes.
| Option | Effect |
|---|---|
--xtb-etemp K (300) | electronic temperature of the Fermi smearing; 0 = integer occupations
(strict Aufbau). The analysis density is always refilled with integer occupations. |
--xtb-conv X (1e-4) | convergence threshold on the largest change of the atomic charges |
--xtb-maxiter N (1500) | maximum number of SCC iterations |
--xtb-noaes | switch off the anisotropic electrostatics: faster, but not EDDB grade |
--xtb-frac-occ | experimental diagnostic: keep the smeared fractional occupations in the analysis density (a deliberately non-idempotent density for testing the post-HF path, not for EDDB values) |
The SCC runs once; if it does not converge the program stops and says what to change:
ERROR: GFN2-xTB did not converge / failed (error code -6).
To force convergence, adjust one or more GFN2-xTB controls and re-run:
--xtb-etemp 1000 raise the electronic (Fermi smearing) temperature
--xtb-maxiter 3000 allow more SCC iterations
--xtb-conv 1e-3 loosen the SCC convergence thresholdThe charge and multiplicity come from the file or from --xyz-charge / --xyz-mult
(Input files). A multiplicity above 1 runs the spin-polarized variant spGFN2-xTB
(unrestricted); --xtb-nospin gives the restricted open-shell solution instead.
$ runEDDB -i @benzene --xyz-charge 1 --xyz-mult 2 -v # benzene radical cation Hamiltonian model: spGFN2-xTB Spin polarization (SP): Enabled $ runEDDB -i @benzene --xyz-charge 1 --xyz-mult 2 --xtb-nospin
--export-fchk xtb,
spin density; --table no, 〈S2〉), and take a suspected diradical to broken-symmetry
DFT.| Option | File |
|---|---|
--export-fchk xtb | mol.XTB.fchk: orbitals, orbital energies, density and spin density, for
viewers and as an SCF starting guess of a DFT job |
--export-json xtb | mol.XTB.json (+ .meta.json): the same in the ORCA JSON
convention, with real occupations and orbital energies |
--export-cube xtb[LIST] | cubes of the listed molecular orbitals (mol.XTB_orb001.cube, ...) |
The files describe the minimal basis with an effective core: right for viewing and as a guess, not an all-electron wavefunction. More on the formats: Maps & files.
Any --nics* option on a geometry computes the magnetic response from the xTB orbitals, with the
full EDLB / EDDB partition, ring and bond currents, MO sets and maps (see NMR &
currents for the commands). GFN2-xTB has no exact exchange, so its response to a magnetic field is
uncoupled: a sum over states of the tight-binding orbitals, evaluated in the ipsocentric CTOCD-DZ gauge.
This is London's tight-binding ring-current theory with all valence electrons. The minimal basis carries the
π → π* excitations that make the ring current, but not the circulation around the nuclei, so nuclear
shieldings are not computed and a --nics* probe is required.
The uncoupled current is too small. Benzene, the same geometry, ring current (nA/T) and NICS(1)zz (ppm):
| Lane | Icyc total | Icyc EDDB | NICS(1)zz |
|---|---|---|---|
| xTB, uncoupled (default) | 6.30 | 6.35 | −17.3 |
| xTB, uncoupled, EDDB × 1.6 | – | 10.16 | – |
xTB, --xtb-coupled | 9.04 | 8.81 | −24.6 |
| B3LYP/def2-TZVPP, NMR=CSGT | 11.97 | 9.98 | −29.7 |
--xtb-coupled [a_x]): adds the exchange coupling that a hybrid functional has,
in the zero-differential-overlap form of the simplified Tamm–Dancoff approach (Ohno–Klopman kernel from the
GFN2 hardnesses), scaled by one number ax (0.20, the B3LYP exchange fraction, which is also the
best fit). Over the 16 neutral six-membered rings of the set the unscaled current is within 7 % and
NICS(1)zz within 3 ppm of B3LYP; for benzene itself 12 % and 5 ppm (table above). It is the
physical model and shows where the remaining deficit sits; for screening the factor 1.6 is the better single
number. -v prints the iterations, the spectral radius of the coupling and the amplification;
--xtb-uncoupled restores the default.-v): the translational sum rule, 1 for a complete basis, is printed as a
tensor and, in mol.NMR_DIAG.txt, for every probe (s = trans / Larmor) and as basis-corrected loop
currents (I/s(z), I/S_par). For benzene szz(EDDB) = 0.56 at NICS(1)zz (B3LYP/def2-TZVPP: 0.98) and
I/S_par = 12.1 nA/T. Treat the corrected columns as heuristics.NICS(1)zz is the NICS index to read from this lane. Its sign and the order of the rings within a
molecule are right, but the raw values are about 40 % too small. Multiplied by 1.6 (the factor of the current)
they come within 3 ppm of B3LYP for benzenoid rings and pyridine; --xtb-coupled gives a similar accuracy
without a factor. Other rings are less reliable: the five-membered ring of azulene is 7–12 ppm too weak, pyrrole
(a π-donor ring, below) a third. Same geometries, ppm:
| Ring | xTB | xTB × 1.6 | --xtb-coupled | B3LYP/def2-TZVPP, CSGT |
|---|---|---|---|---|
| benzene | −17.3 | −27.8 | −24.6 | −29.7 |
| naphthalene | −17.8 | −28.5 | −27.0 | −30.5 |
| anthracene, central / outer ring | −20.2 / −17.0 | −32.3 / −27.1 | −32.4 / −28.6 | −35.3 / −28.8 |
| pyrene, the two ring types | −21.0 / −11.0 | −33.6 / −17.6 | −32.9 / −18.8 | −36.7 / −19.2 |
| pyridine | −16.4 | −26.2 | −23.5 | −29.0 |
| thiophene | −21.3 | −34.1 | −27.8 | −30.0 |
| pyrrole (π-donor N–H) | −13.2 | −21.1 | −16.8 | −31.6 |
| azulene, five / seven-membered ring | −18.5 / −11.2 | −29.7 / −18.0 | −34.6 / −17.4 | −41.7 / −13.6 |
| biphenylene, four-membered ring | +38.4 | +61.4 | +77.7 | +56.7 |
--xtb-coupled), NICS scans and the currents. Never read NICS(0), NICS(0)zz, isotropic NICS or
nuclear shieldings from this lane: their in-plane σ terms near the nuclei are not described by the minimal basis.
Never compare rings of different size by NICS (use the current).
[pi-donor N-H/O] in the table. Sign and trend only.The SCC and the whole analysis take well under a second for the built-in kekulene (72 atoms),
[12]cycloparaphenylene (120 atoms) and superazanaphthalene (128 atoms). More threads (-n) pay off only
for several hundred atoms. The NICS response, the current maps and the ICSS maps cost more than the SCC; see
NMR & currents.
xtb program
(benzene 0.0006 Eh, coronene 0.010 Eh, against xtb 6.7.1), and there are no
geometry optimizations: for energies and structures use xtb itself.| Method | Reference |
|---|---|
| GFN2-xTB | C. Bannwarth, S. Ehlert, S. Grimme, J. Chem. Theory Comput. 15 (2019) 1652, doi:10.1021/acs.jctc.8b01176 |
| DFT-D4 dispersion | E. Caldeweyher, S. Ehlert, A. Hansen, H. Neugebauer, S. Spicher, C. Bannwarth, S. Grimme, J. Chem. Phys. 150 (2019) 154122, doi:10.1063/1.5090222 |
| Spin-polarized GFN2-xTB (multiplicity > 1) | H. Neugebauer, B. Bädorf, S. Ehlert, A. Hansen, S. Grimme, J. Comput. Chem. 44 (2023) 2120, doi:10.1002/jcc.27185 |
| CTOCD-DZ (ipsocentric) response | P. Lazzeretti, M. Malagoli, R. Zanasi, Chem. Phys. Lett. 220 (1994) 299, doi:10.1016/0009-2614(94)00158-8 |
sTDA exchange kernel (--xtb-coupled) | S. Grimme, J. Chem. Phys. 138 (2013) 244104, doi:10.1063/1.4811331 |
sTDA-xTB (--xtb-coupled) | S. Grimme, C. Bannwarth, J. Chem. Phys. 145 (2016) 054103, doi:10.1063/1.4959605 |