Geometry optimization

We use DFTK and the GeometryOptimization package to find the minimal-energy bond length of the $H_2$ molecule. First we set up an appropriate DFTKCalculator (see AtomsCalculators integration), for which we use the LDA model just like in the Tutorial for silicon in combination with a pseudodojo pseudopotential (see Pseudopotentials).

using DFTK
using PseudoPotentialData

pseudopotentials = PseudoFamily("dojo.nc.sr.pbe.v0_4_1.standard.upf")
calc = DFTKCalculator(;
    model_kwargs = (; functionals=LDA(), pseudopotentials),  # model_DFT keyword arguments
    basis_kwargs = (; kgrid=[1, 1, 1], Ecut=10)  # PlaneWaveBasis keyword arguments
)
DFTKCalculator(functionals=Xc(lda_x, lda_c_pw), pseudopotentials=PseudoFamily("dojo.nc.sr.pbe.v0_4_1.standard.upf"), Ecut=10, kgrid=[1, 1, 1])

Next we set up an initial hydrogen molecule within a box of vacuum. We use the parameters of the equivalent tutorial from ABINIT and DFTK's AtomsBase integration to setup the hydrogen molecule. We employ a simulation box of 10 bohr times 10 bohr times 10 bohr and a pseudodojo pseudopotential.

using LinearAlgebra
using Unitful
using UnitfulAtomic

r0 = 1.4   # Initial bond length in Bohr
a  = 10.0  # Box size in Bohr

cell_vectors = [[a, 0, 0]u"bohr", [0, a, 0]u"bohr", [0, 0, a]u"bohr"]
h2_crude = periodic_system([:H => [0, 0, 0.]u"bohr",
                            :H => [r0, 0, 0]u"bohr"],
                           cell_vectors)
FlexibleSystem(H₂, periodicity = TTT):
    cell_vectors      : [      10        0        0;
                                0       10        0;
                                0        0       10]u"a₀"

    Atom(H,  [       0,        0,        0]u"a₀")
    Atom(H,  [     1.4,        0,        0]u"a₀")

Finally we call minimize_energy! to start the geometry optimisation. We use verbosity=2 to get some insight into the minimisation. With verbosity=1 only a summarising table would be printed and with verbosity=0 (default) the minimisation would be quiet.

using GeometryOptimization
results = minimize_energy!(h2_crude, calc; tol_forces=2e-6, verbosity=2)
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.110673449221                   -0.83   0.80    7.0   26.1ms
  2   -1.117194106175       -2.19       -1.92   0.80    1.0   19.8ms
  3   -1.117250081261       -4.25       -2.74   0.80    1.0   19.9ms
  4   -1.117251128223       -5.98       -3.56   0.80    1.0   20.3ms
  5   -1.117251189418       -7.21       -4.19   0.80    2.0    121ms
  6   -1.117251190130       -9.15       -5.17   0.80    1.0   21.2ms
  7   -1.117251190142      -10.92       -5.75   0.80    1.0   21.5ms
  8   -1.117251190143      -11.97       -6.17   0.80    1.0   22.0ms
  9   -1.117251190143      -12.83       -6.88   0.80    1.0   22.1ms
 10   -1.117251190143      -14.35       -7.55   0.80    1.0   22.2ms
 11   -1.117251190143      -14.40       -8.55   0.80    1.0   22.3ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.117251190143                   -8.75   0.80    1.0    1.24s
  2   -1.117251190143   +  -15.05       -9.76   0.80    1.0   19.8ms

Geometry optimisation convergence (in atomic units)
┌─────┬─────────────────┬───────────┬─────────────┬────────┐
│   n           Energy  log10(ΔE)   max(Force)   Δtime │
├─────┼─────────────────┼───────────┼─────────────┼────────┤
│   0 │ -1.117251190143 │           │   0.0269318 │  3.63s │
└─────┴─────────────────┴───────────┴─────────────┴────────┘

n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.117517989235                   -2.46   0.80    1.0   13.3ms
  2   -1.117520586001       -5.59       -3.49   0.80    1.0   19.7ms
  3   -1.117520613027       -7.57       -4.23   0.80    1.0   19.9ms
  4   -1.117520613449       -9.37       -5.18   0.80    1.0   20.3ms
  5   -1.117520613464      -10.82       -5.97   0.80    1.0   20.6ms
  6   -1.117520613465      -12.18       -6.45   0.80    2.0   38.2ms
  7   -1.117520613465      -13.37       -7.29   0.80    1.0   22.1ms
  8   -1.117520613465   +  -15.05       -8.37   0.80    1.0   22.2ms
  9   -1.117520613465      -15.05       -8.70   0.80    1.0   30.0ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118247264598                   -1.69   0.80    1.0   18.2ms
  2   -1.118339043932       -4.04       -2.70   0.80    1.0   24.8ms
  3   -1.118340011112       -6.01       -3.44   0.80    1.0   33.5ms
  4   -1.118340028552       -7.76       -4.36   0.80    1.0   20.3ms
  5   -1.118340029137       -9.23       -5.12   0.80    1.0   20.9ms
  6   -1.118340029164      -10.57       -5.62   0.80    1.0   21.1ms
  7   -1.118340029165      -11.73       -6.68   0.80    1.0   21.6ms
  8   -1.118340029165      -13.57       -7.58   0.80    1.0   27.0ms
  9   -1.118340029165   +  -14.81       -8.12   0.80    1.0   22.3ms
 10   -1.118340029165      -15.35       -8.55   0.80    1.0   22.1ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118340029165                   -9.05   0.80    1.0   13.2ms
  2   -1.118340029165      -14.35      -10.36   0.80    1.0   19.6ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118340029165                  -11.05   0.80    1.0   13.3ms
  2   -1.118340029165   +    -Inf      -11.42   0.80    1.0   19.8ms

┌─────┬─────────────────┬───────────┬─────────────┬────────┐
│   n           Energy  log10(ΔE)   max(Force)   Δtime │
├─────┼─────────────────┼───────────┼─────────────┼────────┤
│   1 │ -1.118340029165 │           │  0.00297055 │  884ms │
└─────┴─────────────────┴───────────┴─────────────┴────────┘

n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118346721507                   -3.09   0.80    1.0   15.7ms
  2   -1.118346864758       -6.84       -4.11   0.80    1.0   19.7ms
  3   -1.118346866235       -8.83       -4.86   0.80    1.0   28.0ms
  4   -1.118346866261      -10.59       -5.78   0.80    1.0   20.6ms
  5   -1.118346866262      -12.08       -6.55   0.80    1.0   20.8ms
  6   -1.118346866262      -13.46       -7.04   0.80    1.0   21.1ms
  7   -1.118346866262      -14.37       -8.13   0.80    1.0   21.9ms
  8   -1.118346866262      -14.81       -8.95   0.80    1.0   21.6ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118354724004                   -2.61   0.80    1.0   13.4ms
  2   -1.118356087056       -5.87       -3.62   0.80    1.0   19.9ms
  3   -1.118356101131       -7.85       -4.37   0.80    1.0   20.2ms
  4   -1.118356101377       -9.61       -5.29   0.80    1.0   20.4ms
  5   -1.118356101385      -11.10       -6.06   0.80    1.0   20.7ms
  6   -1.118356101386      -12.45       -6.55   0.80    1.0   26.6ms
  7   -1.118356101386      -13.60       -7.65   0.80    1.0   21.6ms
  8   -1.118356101386   +  -14.95       -8.45   0.80    1.0   21.6ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118356101386                   -9.24   0.80    1.0   13.1ms
  2   -1.118356101386   +  -14.75       -9.82   0.80    1.0   19.8ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118356101386                  -10.62   0.80    1.0   13.2ms
  2   -1.118356101386      -13.83      -11.46   0.80    1.0   19.7ms

┌─────┬─────────────────┬───────────┬─────────────┬────────┐
│   n           Energy  log10(ΔE)   max(Force)   Δtime │
├─────┼─────────────────┼───────────┼─────────────┼────────┤
│   2 │ -1.118356101386 │     -4.79 │  4.47268e-5 │  599ms │
└─────┴─────────────────┴───────────┴─────────────┴────────┘

n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118356102848                   -4.94   0.80    1.0   13.2ms
  2   -1.118356102877      -10.54       -5.96   0.80    1.0   19.6ms
  3   -1.118356102877      -12.52       -6.70   0.80    1.0   28.9ms
  4   -1.118356102877      -14.48       -7.62   0.80    1.0   20.6ms
  5   -1.118356102877   +  -14.70       -8.39   0.80    1.0   20.9ms
  6   -1.118356102877      -15.05       -8.89   0.80    1.0   21.1ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118356104771                   -4.40   0.80    1.0   13.1ms
  2   -1.118356105116       -9.46       -5.42   0.80    1.0   29.4ms
  3   -1.118356105120      -11.45       -6.17   0.80    1.0   20.0ms
  4   -1.118356105120      -13.19       -7.09   0.80    1.0   20.4ms
  5   -1.118356105120   +  -15.18       -7.86   0.80    1.0   20.6ms
  6   -1.118356105120      -14.42       -8.35   0.80    1.0   20.9ms
  7   -1.118356105120   +  -14.75       -9.45   0.80    1.0   21.9ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118356105120                  -10.08   0.80    1.0   13.2ms
  2   -1.118356105120      -14.42      -11.02   0.80    1.0   19.8ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118356105120                  -11.67   0.80    1.0   13.1ms
  2   -1.118356105120   +  -14.27      -12.44   0.80    1.0   19.5ms

┌─────┬─────────────────┬───────────┬─────────────┬────────┐
│   n           Energy  log10(ΔE)   max(Force)   Δtime │
├─────┼─────────────────┼───────────┼─────────────┼────────┤
│   3 │ -1.118356105120 │     -8.43 │  1.04953e-8 │  535ms │
└─────┴─────────────────┴───────────┴─────────────┴────────┘

Structure after optimisation (note that the atom has wrapped around)

results.system
FlexibleSystem(H₂, periodicity = TTT):
    cell_vectors      : [      10        0        0;
                                0       10        0;
                                0        0       10]u"a₀"

    Atom(H,  [-0.0431829, 1.13527e-17, -4.52074e-18]u"a₀")
    Atom(H,  [ 1.44318, -1.76752e-17, 1.55381e-17]u"a₀")

Compute final bond length:

rmin = norm(position(results.system[1]) - position(results.system[2]))
println("Optimal bond length: ", rmin)
Optimal bond length: 1.4863658667129995 a₀

Our results (1.486 Bohr) agrees with the equivalent tutorial from ABINIT.

Cell optimisations

Recent versions of GeometryOptimization support cell shape optimisations as well by passing variablecell=true to minimize_energy!. See the GeometryOptimization documentation for an example.