Hands-on, runnable tutorials for OpenQP
(Open Quantum Platform). Every tutorial shows the calculation in both the
concise .oqp input-file style and the compact Python API.
📖 Read the tutorials book: https://open-quantum-platform.github.io/openqp-tutorials/
This repository is a MkDocs site (same look and feel as
the OpenQP manual). Each
tutorial lives in docs/<topic>/ with an index.md walkthrough and an inputs/
folder of ready-to-run decks.
pip install openqp # the QM engine + `openqp` CLI
pip install openmm # optional MM backend (needed for the QM/MM tutorials)openqp docs/mrsf-tddft/inputs/h2o_mrsf.oqp # input-file style
python docs/mrsf-tddft/inputs/h2o_mrsf.py # Python-API styleThe decks are written in OpenQP's concise .oqp format: a route line naming
the physical model, a driver naming the calculation, and — only where the
defaults are not what you want — exact section calls such as scf(conv=1e-10).
The older sectioned .inp format is still read by openqp; it is documented in
the manual.
Electronic structure — Hartree-Fock & DFT · MP2 · TDDFT/TDHF · Spin-flip TDDFT · MRSF-TDDFT · UMRSF-TDDFT Excited states & dynamics — Spin-orbit coupling · Conical intersections · SOC-NAMD-QMMM Geometry & properties — Optimization & TS · Hessians/frequencies/IR/Raman · NMR shielding · Population, moments & MRSF analysis Environment — PCM/ddX solvation · ESPF QM/MM embedding SCF & basis — SCF convergence & guesses · Effective core potentials
pip install -r docs/requirements.txt
mkdocs serve # live preview at http://127.0.0.1:8000A tutorial is docs/<topic>/index.md (motivation → theory → annotated input →
Python → run → interpret) plus an inputs/ folder of small, fast decks. Add it to
the nav in mkdocs.yml. Link to the
manual for reference depth
rather than duplicating it.
Released under the same license as OpenQP (GPLv3).