1.5 Environment, GPW and the input tree
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 Choose one installation route
Prefer the center's tested CP2K module for cluster work. Personal learning can use an isolated Conda environment or distribution package; official guidance also lists containers, Spack and Homebrew. Do not mix a package MPI runtime with an unrelated launcher. Record versions rather than silently upgrading mid-study. Official distribution guide.
conda search -c conda-forge cp2k
# Replace VERSION with an available build for your platform.
conda create -n cp2k-course -c conda-forge cp2k=VERSION
conda activate cp2k-course
cp2k -h
cp2k --version
VERSION must be replaced with an available platform build. If your package supplies cp2k.psmp rather than cp2k, substitute it throughout; psmp commonly means MPI+OpenMP, but names vary. The first single-process test uses OMP_NUM_THREADS=1. Cluster commands come from the site. ARCHER2 CP2K usage.
mkdir -p cp2k-course/01-water
cd cp2k-course/01-water
export OMP_NUM_THREADS=1
command -v cp2k
cp2k --version > executable-version.txt
# Locate and copy these files from your verified installation first.
ls -l BASIS_MOLOPT GTH_POTENTIALS
sha256sum BASIS_MOLOPT GTH_POTENTIALS > data-files.sha256
Locate installed BASIS_MOLOPT and GTH_POTENTIALS through package/module documentation. Copy verified files locally or specify checked absolute paths. The first input assumes local copies. Do not download a random matching filename or mix unrecorded releases. Hashes identify actual content. CP2K is open-source, but software/data redistribution still follows applicable licenses.
1.5.2 GPW expands different objects in different ways
Atom-centered Gaussian functions describe molecular orbitals, while auxiliary real-space grids/plane-wave representation enable density/electrostatic operations. Grid cutoff and orbital basis size therefore control different errors: neither fixes inadequacy in the other. Quickstep methodology paper.
Our PBE, GTH-PBE potentials and compatible MOLOPT bases define one consistent model. H q1 and O q6 produce eight explicit valence electrons in water. Its absolute pseudopotential energy cannot validate itself by matching a ten-electron all-electron calculation; reference conventions differ.
1.5.3 Nesting is part of syntax
GLOBAL
FORCE_EVAL
DFT
QS
MGRID
POISSON
SCF
OT
XC
SUBSYS
CELL
COORD
KIND O
KIND H
MOTION (only when needed)
GEO_OPT or MD
PRINT
GLOBAL sets the task. FORCE_EVAL evaluates energy/forces, with DFT electronic controls and SUBSYS cell/atoms. MOTION is a top-level sibling of FORCE_EVAL, not inside it; SCF sits within DFT and GEO_OPT within MOTION. Indentation helps humans; matching &SECTION/&END SECTION defines actual structure. Use explicit closing names. Keywords are generally case-insensitive; Linux paths are not. EPCC/ARCHER2 input practical.
Coordinates here use Å, grid cutoffs explicit Ry, energy output usually hartree and force usually hartree/bohr. Read actual output headers. Most links fix CP2K 2025.2 for stable keyword context; match the manual to your executable when using it.
1.5.4 Exercise
Draw the input tree, locate data files, record their hashes and identify the eight-electron valence model. Explain why raising CUTOFF cannot repair a small orbital basis. No calculation is needed to establish this manifest and syntax map.
Previous:Course overview · Next:Complete isolated-water calculation