* Hydrogen molecule [#ga16bb23] In this tutorial, how to execute pw.x and how to converge computational parameters, such as kinetic energy cutoff and box size are described by taking hydrogen molecule (H2) as an example. How to optimize the molecular geometry is also described.~ In a standard plane-wave pseudopotential code, three-dimensional periodic boundary condition is employed, and an isolated molecule is modeled by placing it in a large box in such a way that the electrostatic interactions with neighboring images can be negligible. If the box is large enough, the Brillouin zone becomes small (as it scales as (2p/a)**3), thus the Brillouin zone is sampled only at the Gamma point [(0,0,0)]. In this case, the accuracy of the calculation is controlled by increasing the kinetic energy cutoff, which corresponds to increasing the real-space mesh (resolution of the wave function in real space) and by increasing the box size. The latter is to confirm that the interaction between image molecules is negligibly small and that the model mimics the molecule in its an isolated state. #Contents ** Preliminary [#ua6b3fe2] ** SCF calculation [#wcd8fa25] Let us begin with an SCF calculation of H2 having the experimental bond length of 0.74 Angstrom in a cubic box with the edges of 10 Angstrom. We use the SG15 optimized norm-conserving pseudopotentials with the cutoff energy of 30 Ry. The input file for this calculation is called "h2_scf.in" and is the following: &control calculation = 'scf' restart_mode = 'from_scratch', pseudo_dir = '/home/ikutaro/QE/pseudo/' outdir = './tmp/' prefix = 'h2' tprnfor = .true. forc_conv_thr = 1.d-4 / &system ibrav = 1 A = 10.d0 nat = 2 ntyp = 1 nbnd = 4 ecutwfc = 30.0 ecutrho = 120.0 / &electrons diagonalization = 'david' conv_thr = 1.0e-12 mixing_beta = 0.1 / ATOMIC_SPECIES H 0.0000 H_ONCV_PBE-1.0.upf ATOMIC_POSITIONS (angstrom) H 0.000000000000 0.000000000000 0.00000000000 H 0.000000000000 0.000000000000 0.74000000000 K_POINTS (gamma) Here the number of electron is 2 and thus the minimum number of bands is 1, but slightly large number of bands of 4 is used. Note "pseudo_dir" and "outdir" should be modified according to the environment. To perform the SCF calculation, we use pw.x. Here let us assume we are going to use pw.x in $HOME/QE/src/qe-6.6 and execute the following $ mpirun -np 2 $HOME/QE/src/qe-6.6/bin/pw.x < h2_scf.in > h2_scf.out or for the group's cluster execute $ qsub h2.sh where the job script "h2.sh" looks like #$ -S /bin/bash #$ -cwd #$ -q xe1.q #$ -pe x8 8 #$ -N H2 # module load intel/2020.2.254 module load intelmpi/2020.2.254 # INPUT_FILE='h2_scf.in' OUTPUT_FILE='h2_scf.out' # PW_DIR=/home/ikutaro/QE/src/qe-6.6/bin # MPI_COMMAND=mpirun PW_COMMAND=pw.x PW=$PW_DIR/$PW_COMMAND # I_MPI_PIN=1 I_MPI_FABRICS=shm:ofa OMP_NUM_THREADS=1 # cat $PE_HOSTFILE | awk '{ print $1":"$2/ENVIRON["OMP_NUM_THREADS"] }' > hostfile.$JOB_ID # $MPI_COMMAND $PW < $INPUT_FILE > $OUTPUT_FILE When the calculation starts, you can see the following header in the output file (h2_scf.out) as Program PWSCF v.6.6 starts on 20Jan2021 at 10:38:59 This program is part of the open-source Quantum ESPRESSO suite for quantum simulation of materials; please cite "P. Giannozzi et al., J. Phys.:Condens. Matter 21 395502 (2009); "P. Giannozzi et al., J. Phys.:Condens. Matter 29 465901 (2017); URL http://www.quantum-espresso.org", in publications or presentations arising from this work. More details at http://www.quantum-espresso.org/quote When the SCF convergence is archived, the following can be found in the output file (h2_scf.out). ! total energy = -2.31431570 Ry estimated scf accuracy < 5.3E-13 Ry The total energy is the sum of the following terms: one-electron contribution = -3.79278260 Ry hartree contribution = 2.01958267 Ry xc contribution = -1.37197485 Ry ewald contribution = 0.83085908 Ry convergence has been achieved in 15 iterations If "tprnfor = .true." the following lines can also be found Forces acting on atoms (cartesian axes, Ry/au): atom 1 type 1 force = 0.00000000 0.00000000 -0.03012711 atom 2 type 1 force = 0.00000000 0.00000000 0.03012711 Total force = 0.042606 Total SCF correction = 0.000000 Use the "less" or "more" command to see the file. ** Convergence study [#g0f7b800] *** Convergence wrt cutoff [#b2656295] To study the convergence of the total energy, we calculate the total energy as a function of kinetic energy cutoff ("ecutwfc") by fixing the molecular structure. Note that in the present case normconserving pseudopotential is used and ecutrho is fixed to 4 times larger than ecutwfc (ecutrho = 4 * ecutwfc). Use h2_scf_ecutwfc*.in. Results are as follows # ecutwfc (Ry) total energy (Ry) 30.0 -2.31431279 40.0 -2.32593152 50.0 -2.33045981 60.0 -2.33201780 70.0 -2.33257560 80.0 -2.33275476 90.0 -2.33280832 100.0 -2.33281717 #ref(http://www-cp.prec.eng.osaka-u.ac.jp/puki_state/graph/ftot_H2_ecut.png,center) *** Convergence wrt box size [#b3914639] Then let us calculate the total energy as a function of the cell edge. In this study, ecutwfc=60.0 Ry is used. Create your own input file by copying one of the input file from previous calculations. # a (Angstrom) total energy (Ry) 5.0 -2.33788501 10.0 -2.33201780 15.0 -2.33202479 20.0 -2.33202183 25.0 -2.33202063 30.0 -2.33202053 #ref(http://www-cp.prec.eng.osaka-u.ac.jp/puki_state/graph/ftot_H2_boxsize.png,center) ** Optimizing the bond length (1) [#cd8a50a0] Let us determine the bond length of H2. First, we calculate the total energy as a function of bond length. The input files are the same as the one for the SCF calculation, but the position of the second H atom. We set the z-coordinate of the second H atom ranging from 1.3 to 1.5 Bohr. Use h2_scf_ecutwfc60_d*.in. Here is the result with ecutwfc=60Ry : 1.30 -2.32657183 1.32 -2.32840377 1.34 -2.32984183 1.36 -2.33091143 1.38 -2.33163627 1.40 -2.33203866 1.42 -2.33213950 1.44 -2.33195843 1.46 -2.33151384 1.48 -2.33082299 1.50 -2.32990212 By fitting the total energy to 6th-order polynomial, the equilibrium bond length of 1.4169 Bohr is obtained. #ref(http://www-cp.prec.eng.osaka-u.ac.jp/puki_state/graph/ftot_H2_BL.png,center) ** Optimizing the bond length (2) [#tad1e55c] Alternatively, one can optimize the geometry (internal coordinate) by using the Hellmann-Feynman forces. The input file is as follows. Let's name it 'h2_relax.in.' Here we use the convergence threshold for the forces of 1.0 x 10-4 Ry/Bohr. &control calculation = 'relax' restart_mode = 'from_scratch', pseudo_dir = '/home/ikutaro/QE/pseudo/' outdir = './tmp/' prefix = 'h2' tprnfor = .true. forc_conv_thr = 1.d-4 / &system ibrav = 1 A = 10.d0 nat = 2 ntyp = 1 nbnd = 4 ecutwfc = 60.0 ecutrho = 240.0 ecutwfc = 30.0 ecutrho = 120.0 / &electrons diagonalization = 'david' conv_thr = 1.0e-12 mixing_beta = 0.1 / &ions ion_dynamics='bfgs' ion_dynamics = 'bfgs' / ATOMIC_SPECIES H 0.0000 H_ONCV_PBE-1.0.upf ATOMIC_POSITIONS (bohr) ATOMIC_POSITIONS (angstrom) H 0.000000000000 0.000000000000 0.00000000000 H 0.000000000000 0.000000000000 1.40000000000 H 0.000000000000 0.000000000000 0.74000000000 K_POINTS (gamma) The main differences from the SCF calculation are calculation = 'relax' and &ions ion_dynamics='bfgs' / Here we use the BFGS algorithm for the structural optimization. Note the namelist &ions should be given even though the default parameters are used. In such a case &ions / can be used. When the convergence for the structural relaxation is achieved, following message can be found in the output as: bfgs converged in 4 scf cycles and 3 bfgs steps (criteria: energy < 1.0E-04 Ry, force < 1.0E-04 Ry/Bohr) End of BFGS Geometry Optimization and the final coordinates follow as: Begin final coordinates ATOMIC_POSITIONS (angstrom) H 0.0000000000 0.0000000000 -0.0113658051 H 0.0000000000 0.0000000000 0.7513658051 End final coordinates The bond length of 1.4169 Bohr (0.750 Angstrom) obtained by the structural optimization by using the Hellmann-Feynman forces is in good agreement with that obtained by the manual structural optimization. *** Exercise [#r4176331] The bond length also depends on the computational parameters such as cutoff energy and box size. Calculate the bond length as a function of cutoff energy and estimate the converged bond length.