How mattatzb/rhf-from-scratch works
This is an educational, from-scratch restricted Hartree–Fock (RHF) program for small molecules, with a two-electron full configuration interaction (FCI) extension and diatomic scan tools. The main workflow constructs molecular geometry, builds a Gaussian basis, evaluates integrals, and runs the RHF self-consistent-field loop to produce energies. Separate drivers scan geometries, optionally add FCI, or compare results with Psi4. Edges reflect calls visible in excerpts or capabilities documented in the README; unsampled internals are not assumed.
Main entry points: basis.py Basis builder · scf.py RHF SCF · run_ci.py RHF plus FCI driver · run_ci_scan.py FCI scan
Components 14
Molecular model
- Molecule geometry
mol.py - Basis builder
basis.py - Bundled basis sets
data
Electronic structure
- Gaussian integrals
integrals.py - RHF SCF
scf.py - Two-electron FCI
ci.py
Scan workflows
- RHF example
main.py - RHF diatomic scan
scan.py - RHF plus FCI driver
run_ci.py - FCI scan
run_ci_scan.py - Psi4 comparison scan
run_psi4_scan.py
Results and integrations
- Psi4
- Run records
runlog.py
Other components
- User
Connections 29
- User → RHF example: runs example
README.md - User → RHF diatomic scan: runs scan
README.md - User → RHF plus FCI driver: runs driver
README.md - User → FCI scan: runs scan
README.md - User → Psi4 comparison scan: runs comparison
README.md - RHF example → Molecule geometry: constructs
main.py - RHF example → Basis builder: builds basis
main.py - RHF example → RHF SCF: runs SCF
main.py - Basis builder → Molecule geometry: reads geometry
basis.py - Basis builder → Bundled basis sets: loads basis data
README.md - RHF SCF → Gaussian integrals: builds integrals
scf.py - RHF SCF → Molecule geometry: uses molecule
scf.py - RHF SCF → Basis builder: uses basis
scf.py - Gaussian integrals → Molecule geometry: uses nuclei
integrals.py - Gaussian integrals → Basis builder: integrates functions
integrals.py - RHF diatomic scan → Molecule geometry: constructs geometries
scan.py - RHF diatomic scan → Basis builder: builds basis
scan.py - RHF diatomic scan → RHF SCF: runs SCF
scan.py - RHF plus FCI driver → RHF diatomic scan: uses geometry helper
run_ci.py - RHF plus FCI driver → Basis builder: builds basis
run_ci.py - RHF plus FCI driver → RHF SCF: runs SCF
run_ci.py - RHF plus FCI driver → Gaussian integrals: builds ERIs
run_ci.py - RHF plus FCI driver → Two-electron FCI: builds CI energy
run_ci.py - FCI scan → RHF diatomic scan: uses geometry helper
run_ci_scan.py - FCI scan → Basis builder: builds basis
run_ci_scan.py - FCI scan → RHF SCF: runs SCF
run_ci_scan.py - FCI scan → Gaussian integrals: builds ERIs
run_ci_scan.py - FCI scan → Two-electron FCI: computes FCI
run_ci_scan.py - Psi4 comparison scan → Psi4: requests energies
run_psi4_scan.py