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


Manual (2026-Nov-03)

High-resolution nc-AFM with a CO-terminated tip shows the bonds of a molecule, and the brightness of a bond follows its bond order. runEDDB computes such images from the electron density with a simple, well-tested model, and splits every image into the share of the localized (EDLB) and the delocalized (EDDB) electrons. The same machinery gives constant-height STM images of the orbitals in a bias window. Both come as 2D maps and as one number per bond.

1. What do you want to see?

You wantRun
an nc-AFM image and its EDLB / EDDB sharesrunEDDB -i mol.fchk --export-map afm,afm-edlb,afm-eddb
the AFM brightness of every bond, next to its length and bond orderrunEDDB -i mol.fchk --table afm
the same with the tip closer to the moleculerunEDDB -i mol.fchk --table afm --map-plane fit,3.0
a fullerene or another cagerunEDDB -i c60.fchk --table afm --map-plane radial
an STM image of the occupied orbitals within 2 eV of the HOMOrunEDDB -i mol.fchk --export-map stm,stm-edlb,stm-eddb
an STM image of the empty orbitals (LUMO side)runEDDB -i mol.fchk --export-map stm --stm-bias 2
a first look from a geometry alonerunEDDB -i @coronene --table afm --map-plane fit,2.5

The coronene examples below use a B3LYP/def2-TZVPP single point (coronene.fchk); each run takes 2–3 s on 16 cores. runEDDB --examples afm lists more, runEDDB --help afm every option.

2. The nc-AFM image

At the small tip heights of bond-resolved imaging the frequency shift is dominated by the Pauli repulsion between the tip and the sample electrons. runEDDB uses the model of Moll et al.: the repulsion is a power of the sample density, V = Aρα (A = 692 eV, α = 0.78 with ρ in e/Å3, their fit for a CO tip), and the image is its curvature ∂2V/∂z2 in eV/Å2, which the frequency shift is proportional to. The tip scans one plane, by default 3.5 Å above the best-fit plane of the heavy atoms.

The image splits into the shares of the localized and the delocalized electrons, VX = VρX/ρ, which add up to the total at every point. The remainder, total − EDLB − EDDB, belongs to the core and Rydberg density outside the analysis block; as a curvature it can have either sign.

terminal
$ runEDDB -i coronene.fchk --export-map afm,afm-edlb,afm-eddb --map-step 0.05 --cube-margin 2
$ python3 ~/runEDDB/scripts/map2png.py coronene.AFM.map.dat coronene.AFM_EDLB_G.map.dat \
          coronene.AFM_EDDB_G.map.dat --clip 5.5
nc-AFM model image of coronene with its EDLB and EDDB shares
Coronene, tip 3.5 Å above the molecule: the model image (left), its localized share (EDLB, middle) and its delocalized share (EDDB, right), eV/Å2. The bright rim of the total image comes from the localized electrons of the six outer bonds; the delocalized share is brightest on the central ring.

3. The contrast of every bond

--table afm prints the image value above the midpoint of every bond with a Wiberg bond order of at least 0.3, next to its length and bond order: the per-bond form of the bond-order discrimination of Gross et al. The four C–C bond classes of coronene:

terminal
$ runEDDB -i coronene.fchk --table afm
     Bond            R (A)        WBO       total      EDLB_G      EDDB_G
   ───────────   ─────────── ─────────── ═══════════ ─────────── ───────────
     1 C  -  2 C     1.37223     0.78971     2.51580     0.72721     1.34274
     1 C  - 18 C     1.42413     0.62802     2.07798     0.57653     1.32444
     3 C  - 20 C     1.42147     0.63496     1.94154     0.40824     1.61112
    19 C  - 20 C     1.42751     0.61849     1.91103     0.29241     1.87243
  tip one plane, h =  3.50 A; V = A rho^0.780, A = 692.0 eV (Moll 2012)
Bond classtotalEDLB shareEDDB share
outer rim, C1–C2 (1.372 Å)2.520.731.34
rim to the quaternary carbon, C1–C182.080.581.32
spoke, C3–C201.940.411.61
central ring, C19–C201.910.291.87

The brightness falls from the short rim bond to the central ring, as the bond order does. In coronene the difference between the classes is drawn by the localized share (0.73 → 0.29), while the delocalized share grows in the opposite direction, towards the aromatic core: knowing the density, the delocalization is what the AFM image does not emphasise. Which share carries the contrast depends on the molecule (in benzo[k]fluoranthene and hexabenzocoronene it is mainly the EDDB share), so check it with the table for every system before drawing conclusions. The table also lists the C–H bonds; under -a or -s the shares are those of the selected NOBDs.

Validation against the bond-order contrast of Gross et al.

On naphthalene, anthracene, phenanthrene, pyrene, triphenylene, coronene, hexa-peri-hexabenzocoronene and C60 (B3LYP/def2-TZVPP, validation of 2026-09-20) the per-bond contrast correlates with the Wiberg bond order at r = 0.94–0.98 and with the Pauling bond order from the bond length at r = 0.74–0.96. In hexabenzocoronene the five C–C classes are ordered monotonically from the peripheral benzo bonds (1.387 Å, brightest) to the inter-ring bonds (1.461 Å), ratio 1.31; in C60 the 6:6 bonds are brighter than the 6:5 bonds by a factor 1.20 (--map-plane radial).

4. Tip height and model parameters

OptionEffect
--map-plane fit,htip height h above the best-fit plane (3.5 Å; the atomic-resolution window of Moll et al. is 3.0–4.5 Å). A closer tip sharpens the image and increases the values.
--map-plane "ring N,h", "atoms i,j,k,h"the plane of a NICS ring or of three atoms
--map-plane radial[,h]for cages: every bond gets its own outward normal from the centre of the molecule (--table afm, --table stm)
--map-slab h1,h2[,n]average n planes between h1 and h2 instead of one plane (the AFM and STM images use one plane by default)
--map-step, --cube-marginlattice step (0.25 Å) and how far the lattice reaches beyond the atoms
--afm-prefactor A, --afm-alpha Bthe parameters of V = AρB (692 eV, 0.78), e.g. for another tip
--afm-tip SIGMA[,s|pz]research variant: V integrated over a Gaussian tip orbital of width SIGMA (Å), s or pz. The fitted A and α already contain the CO tip, so this is for exploring the tip dependence of the contrast, not a better default.

5. STM images

For an s-wave tip the tunnelling current at the tip position is proportional to the local density of the sample states between the Fermi level and the bias (Tersoff–Hamann). For a free molecule this is the density of the molecular orbitals inside a bias window, with the HOMO–LUMO gap as the zero of the scale:

terminal
$ runEDDB -i coronene.fchk --export-map stm,stm-edlb,stm-eddb --table stm --map-step 0.05 --cube-margin 2
  bias -2.00 V; 6 occupied MOs, eps -7.75 .. -5.75 eV (HOMO)
$ runEDDB -i coronene.fchk --export-map stm --stm-bias 2 --out-prefix cor_p2 --map-step 0.05 --cube-margin 2
$ python3 ~/runEDDB/scripts/map2png.py coronene.STM.map.dat coronene.STM_EDLB_G.map.dat \
          coronene.STM_EDDB_G.map.dat cor_p2.STM.map.dat --clip 5.5 --fchk coronene.fchk
STM images of coronene at -2 V and +2 V
Coronene, constant-height STM at 3.5 Å: the occupied window at −2 V (total, EDLB and EDDB shares) and the empty window at +2 V (right), e/bohr3.

Sweeping the bias reads the orbital spectrum down from the frontier. In coronene the per-bond STM density correlates with the AFM contrast at r = 0.88 at −0.5 V (the HOMO pair only), and at 0.98 at −2 V (6 MOs) and −5 V (18 MOs). In molecules whose frontier orbitals paint a different pattern (benzo[k]fluoranthene) the agreement appears only at a much deeper window.

6. Which wavefunction

7. What the model leaves out

Both images are those of the free molecule with a rigid tip. The model has no van der Waals or electrostatic background, no relaxation of the CO tip and no substrate, so it reproduces the contrast within a molecule and not absolute frequency shifts or currents. The apparent shortening of high-order bonds in experimental images comes from the tilting of the CO tip and is outside the model.

8. Methods and references

MethodReference
High-resolution nc-AFM with a CO tipL. Gross, F. Mohn, N. Moll, P. Liljeroth, G. Meyer, Science 325 (2009) 1110, doi:10.1126/science.1176210
Pauli-repulsion model of the image, V = AραN. Moll, L. Gross, F. Mohn, A. Curioni, G. Meyer, New J. Phys. 14 (2012) 083023, doi:10.1088/1367-2630/14/8/083023
Bond-order discrimination (--table afm)L. Gross, F. Mohn, N. Moll, B. Schuler, A. Criado, E. Guitián, D. Peña, A. Gourdon, G. Meyer, Science 337 (2012) 1326, doi:10.1126/science.1225621
STM image, Tersoff–Hamann approximationJ. Tersoff, D.R. Hamann, Phys. Rev. B 31 (1985) 805, doi:10.1103/PhysRevB.31.805
EDDB / EDLB partitionD.W. Szczepanik, Comput. Theor. Chem. 1080 (2016) 33, doi:10.1016/j.comptc.2016.02.003
← Maps & files  |  Next: GFN2-xTB →

HOME      PROJECTS      PUBLICATIONS      runEDDB      X

About EDDB       Download       Tutorials       Manual