Skip to content

2.5 Complete silicon SCF calculation

The inputs on this page are educational templates that have not been executed for this course. Use an authorized installation, verify version-specific options and establish your own convergence.

2.5.1 Fix the cell convention

Use diamond Si with two atoms and conventional cubic \(a=5.43\) Å, a teaching starting geometry rather than predicted equilibrium. Direct vectors are \((0,a/2,a/2),(a/2,0,a/2),(a/2,a/2,0)\) and primitive volume is \(a^3/4\). Fractional positions are \((0,0,0),(1/4,1/4,1/4)\).

Save this complete file as qe-si/01-scf/si.scf.in. Install the actual UPF first. The 50/400 Ry cutoff pair is an illustrative starting choice; use larger settings if recommended, then test convergence.

&CONTROL
  calculation = 'scf',
  restart_mode = 'from_scratch',
  prefix = 'si',
  pseudo_dir = '../pseudo/',
  outdir = './tmp/',
  tprnfor = .true.,
  tstress = .true.,
/
&SYSTEM
  ibrav = 0,
  nat = 2,
  ntyp = 1,
  ecutwfc = 50.0,
  ecutrho = 400.0,
  occupations = 'fixed',
/
&ELECTRONS
  conv_thr = 1.0d-8,
  electron_maxstep = 100,
  mixing_beta = 0.3,
/
ATOMIC_SPECIES
Si  28.0855  Si_PBE_USER.UPF
ATOMIC_POSITIONS crystal
Si  0.0000000000  0.0000000000  0.0000000000
Si  0.2500000000  0.2500000000  0.2500000000
CELL_PARAMETERS angstrom
0.0000000000  2.7150000000  2.7150000000
2.7150000000  0.0000000000  2.7150000000
2.7150000000  2.7150000000  0.0000000000
K_POINTS automatic
6 6 6 0 0 0

Run from the intended directory where local execution is allowed:

cd qe-si/01-scf
mkdir -p tmp
pw.x -in si.scf.in > si.scf.out 2>&1

On a cluster, use its allocated-node submission procedure. prefix='si' and outdir='./tmp/' define saved data. pseudo_dir='../pseudo/' is relative to this working directory, not automatically to wherever an input happens to be stored.

2.5.2 Read scientifically, not just the last energy

  1. Check version, functional, UPF identity, electron count, cell/volume and two atoms before energy.
  2. Check actual cutoffs, FFT grids and k treatment; symmetry often reduces explicit points.
  3. Follow estimated SCF error. An occasional rise is not automatic failure; persistent oscillation needs diagnosis.
  4. Identify explicit convergence and final relevant total energy. The ! line helps locate energy but cannot alone prove success.
  5. Inspect requested forces/stress, completion, process exit and later errors.

Fixed-geometry success is not structural optimization and not basis/mesh convergence. A program finishing, an SCF converging and a numerically stable property are three separate claims. The initial fixed occupation choice suits this nonmagnetic semiconductor teaching branch, not every material.

2.5.3 Units and checks

Total energy is Ry: \(1\ \mathrm{Ry}\approx13.605693\ \mathrm{eV}\), while \(1\ \mathrm{bohr}\approx0.529177\ \mathrm{Å}\). Convert the reported volume consistently rather than mixing bohr³ with ų. Absolute pseudopotential energies cannot be compared blindly with all-electron numbers. Energy differences require consistent composition and method or a well-defined reaction/reference cycle.

2.5.4 Exercise and reading

Compute the vector determinant and compare converted output volume; verify nearest-neighbor distance \(a\sqrt{3}/4\). Label program, electronic and numerical convergence evidence separately. Save full input/log, potential provenance and unit-aware extracted values; without execution, leave output fields blank.

Official PW reference; input organization; PARADIM university tutorials; CBPF silicon walkthrough.


Previous:Engine, workspace and input grammar · Next:Converge the quantity you intend to publish