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.110508558379                   -0.82   0.80    8.0   25.6ms
  2   -1.117198859769       -2.17       -1.85   0.80    1.0   18.1ms
  3   -1.117250423655       -4.29       -2.70   0.80    1.0   18.4ms
  4   -1.117251154209       -6.14       -3.49   0.80    1.0   18.5ms
  5   -1.117251187456       -7.48       -3.99   0.80    1.0   19.0ms
  6   -1.117251190011       -8.59       -4.86   0.80    1.0   19.2ms
  7   -1.117251190137       -9.90       -5.50   0.80    1.0   19.7ms
  8   -1.117251190143      -11.25       -6.21   0.80    2.0   77.3ms
  9   -1.117251190143      -13.31       -6.60   0.80    1.0   20.4ms
 10   -1.117251190143      -13.97       -7.49   0.80    1.0   20.5ms
 11   -1.117251190143      -14.24       -8.09   0.80    1.0   20.5ms
 12   -1.117251190143   +  -14.40       -8.75   0.80    1.0   20.4ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.117251190143                   -9.41   0.80    1.0    826ms
  2   -1.117251190143   +  -15.05      -10.47   0.80    1.0   18.0ms

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

n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.117517996496                   -2.46   0.80    1.0   11.5ms
  2   -1.117520586041       -5.59       -3.49   0.80    1.0   18.3ms
  3   -1.117520612997       -7.57       -4.23   0.80    1.0   18.3ms
  4   -1.117520613449       -9.34       -5.15   0.80    1.0   18.6ms
  5   -1.117520613464      -10.81       -5.94   0.80    1.0   18.9ms
  6   -1.117520613465      -12.18       -6.45   0.80    1.0   19.4ms
  7   -1.117520613465      -13.39       -7.50   0.80    1.0   35.8ms
  8   -1.117520613465      -14.95       -8.27   0.80    1.0   19.9ms
  9   -1.117520613465   +  -15.18       -8.64   0.80    1.0   20.2ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118247264621                   -1.69   0.80    1.0   11.4ms
  2   -1.118339043934       -4.04       -2.70   0.80    1.0   17.8ms
  3   -1.118340011113       -6.01       -3.44   0.80    1.0   31.2ms
  4   -1.118340028553       -7.76       -4.36   0.80    1.0   19.1ms
  5   -1.118340029138       -9.23       -5.12   0.80    1.0   19.1ms
  6   -1.118340029165      -10.57       -5.62   0.80    1.0   19.4ms
  7   -1.118340029166      -11.73       -6.68   0.80    1.0   19.9ms
  8   -1.118340029166      -13.53       -7.58   0.80    1.0   27.0ms
  9   -1.118340029166   +  -15.05       -8.12   0.80    1.0   20.4ms
 10   -1.118340029166      -15.05       -8.55   0.80    1.0   20.3ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118340029166                   -9.04   0.80    1.0   11.3ms
  2   -1.118340029166   +  -15.65      -10.35   0.80    1.0   25.6ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118340029166                  -11.06   0.80    1.0   11.6ms
  2   -1.118340029166      -15.65      -11.43   0.80    1.0   18.3ms

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

n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118346721507                   -3.09   0.80    1.0   11.4ms
  2   -1.118346864758       -6.84       -4.11   0.80    1.0   28.6ms
  3   -1.118346866236       -8.83       -4.86   0.80    1.0   18.3ms
  4   -1.118346866261      -10.59       -5.78   0.80    1.0   18.6ms
  5   -1.118346866262      -12.08       -6.55   0.80    1.0   19.1ms
  6   -1.118346866262      -13.46       -7.04   0.80    1.0   19.2ms
  7   -1.118346866262      -14.40       -8.13   0.80    1.0   26.6ms
  8   -1.118346866262   +  -14.45       -8.95   0.80    1.0   19.7ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118354724004                   -2.61   0.80    1.0   11.2ms
  2   -1.118356087056       -5.87       -3.62   0.80    1.0   17.6ms
  3   -1.118356101131       -7.85       -4.37   0.80    1.0   18.0ms
  4   -1.118356101377       -9.61       -5.29   0.80    1.0   24.9ms
  5   -1.118356101385      -11.10       -6.06   0.80    1.0   18.9ms
  6   -1.118356101386      -12.45       -6.55   0.80    1.0   19.0ms
  7   -1.118356101386      -13.63       -7.65   0.80    1.0   19.6ms
  8   -1.118356101386      -15.65       -8.45   0.80    1.0   19.7ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118356101386                   -9.24   0.80    1.0   11.3ms
  2   -1.118356101386   +  -15.35       -9.82   0.80    1.0   18.1ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118356101386                  -10.62   0.80    1.0   11.2ms
  2   -1.118356101386   +  -15.05      -11.46   0.80    1.0   18.1ms

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

n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118356102848                   -4.94   0.80    1.0   11.3ms
  2   -1.118356102877      -10.54       -5.96   0.80    1.0   17.7ms
  3   -1.118356102877      -12.52       -6.70   0.80    1.0   18.0ms
  4   -1.118356102877      -14.15       -7.62   0.80    1.0   18.5ms
  5   -1.118356102877      -15.05       -8.39   0.80    1.0   28.9ms
  6   -1.118356102877   +  -14.57       -8.89   0.80    1.0   19.4ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118356104771                   -4.40   0.80    1.0   11.2ms
  2   -1.118356105116       -9.46       -5.42   0.80    1.0   17.9ms
  3   -1.118356105120      -11.45       -6.17   0.80    1.0   18.4ms
  4   -1.118356105120      -13.23       -7.09   0.80    1.0   27.2ms
  5   -1.118356105120      -14.88       -7.86   0.80    1.0   19.6ms
  6   -1.118356105120   +    -Inf       -8.35   0.80    1.0   19.9ms
  7   -1.118356105120   +    -Inf       -9.45   0.80    1.0   20.3ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118356105120                  -10.08   0.80    1.0   18.0ms
  2   -1.118356105120   +  -14.45      -11.02   0.80    1.0   18.8ms
n     Energy            log10(ΔE)   log10(Δρ)   α      Diag   Δtime
---   ---------------   ---------   ---------   ----   ----   ------
  1   -1.118356105120                  -11.67   0.80    1.0   11.4ms
  2   -1.118356105120   +  -14.57      -12.44   0.80    1.0   18.1ms

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

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, -3.74004e-12, 1.00504e-11]u"a₀")
    Atom(H,  [ 1.44318, -3.50367e-12, 9.40637e-12]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.486365867816353 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.