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