Skip to content

1.5 Engine, workspace and input grammar

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.

1.5.1 More than one executable

pw.x solves plane-wave Kohn–Sham SCF and performs ionic/cell relaxation. bands.x processes existing path eigenstates; dos.x integrates existing eigenvalues into total DOS; projwfc.x supplies more advanced atomic-like projection analysis. Postprocessors cannot repair an unconverged density. Use a tested institutional module/container or release-matched official installation instructions, recording compiler/MPI and running installation tests. Launchers and module names are site-specific. Official installation prerequisites.

The official input references consulted for these lessons identify QE 7.5; your installed release takes precedence. Keep stages and provenance separate:

qe-si/
  pseudo/              # UPF file and provenance
  01-scf/              # fixed-geometry SCF
  02-convergence/      # independent tests
  03-relax/            # ionic/cell optimization
  04-bands/            # its own SCF, then path eigenvalues
  05-dos/              # its own SCF, then uniform-grid eigenvalues
  records/             # versions, hashes and analysis notes

1.5.2 Pseudopotentials are part of the model

Download an actual trusted silicon UPF, such as a named SSSP release. Record source/version, original filename, checksum, functional, valence, relativistic treatment and suggested dual cutoffs. “Si PBE” alone is insufficient: different constructions and hardness remain possible. For this nonmagnetic example select four-valence-electron PBE Si, with suitable scalar-relativistic/nonrelativistic treatment.

Compound species need compatible functionals; a vetted collection may intentionally mix pseudopotential types. Do not casually force input_dft to conceal incompatible PBE/LDA data. Changing functional is a scientific model decision. Read license terms before redistribution and preserve dataset provenance. Official pseudopotential guidance; SSSP interactive collection; SSSP dataset.

After enabling your approved environment:

command -v pw.x
command -v bands.x
command -v dos.x
mkdir -p qe-si/{pseudo,01-scf,02-convergence,03-relax,04-bands,05-dos,records}
# Replace the source path with your verified downloaded UPF.
cp /path/to/your/downloaded-silicon-pbe.UPF qe-si/pseudo/Si_PBE_USER.UPF
sha256sum qe-si/pseudo/Si_PBE_USER.UPF > qe-si/records/pseudo.sha256

Si_PBE_USER.UPF is a local alias, not a guaranteed downloadable filename. Verify actual UPF content, not an HTML download error, retain the original name, and raise later cutoffs if the potential requires more. The setup commands have not been executed for this course.

1.5.3 Understand the grammar

Block/card Role
&CONTROL Task, file locations and output identity
&SYSTEM Cell/model size, electrons and basis
&ELECTRONS Electronic iterative solver
&IONS Ionic motion for applicable tasks
&CELL Variable-cell control
ATOMIC_SPECIES Species label, mass and real UPF filename
ATOMIC_POSITIONS crystal Dimensionless fractions of direct lattice vectors
CELL_PARAMETERS angstrom Direct lattice vectors in Å
K_POINTS automatic Mesh dimensions and shifts

Direct- and reciprocal-lattice fractional coordinates use different bases. Do not transfer a positional fraction to a k-path without conversion. Namelists start with ampersand names and terminate with /; plain quotes and correct card counts matter. PWscf input organization.

1.5.4 Checkpoint exercise

Prepare a one-page manifest before running. Explain why replacing a UPF is not equivalent to tightening conv_thr. Identify prefix and outdir: together they locate saved calculation data; redirected .out is only the text log. Describe which saved density each future bands/DOS stage will read. Keep the actual pseudopotential, version and licensing details rather than a vague download label.


Previous:Course overview · Next:Complete silicon SCF calculation