# DFD-QCD Lattice Supplement — Start Here

**The authoritative guide to this directory is [`README_SUPPLEMENT.md`](README_SUPPLEMENT.md)**
(Program II: the executed string-tension, glueball, and Nf=2 Wilson-HMC validation runs
supporting Appendices AQ and AS of the DFD v4.0 master manuscript).

## Program I provenance note

This supplement also archives the original Program I prototype code
(`src/su3_pure_gauge.py`, `src/make_plots.py`, `src/unquenched_hmc_scaffold.py`),
which executed 4^4 smoke tests at beta = 5.4/5.6/5.8. Those tiny-lattice runs were a
reproducibility and extraction-path smoke test only; they are superseded by the
Program II production runs in `results/` (16^4 and 20^4, beta = 5.8-6.2) described in
`README_SUPPLEMENT.md` and `RESULTS.md`. The Program I standalone paper and input
ledger are not part of this deposit.

## Reproducibility notes

- The analysis scripts (`src/analyze_potential.py`, `src/continuum_extrap.py`,
  `src/analyze_glueball.py`, `src/make_potential_plots.py`) expect the run-output
  directories (`results_prod/`, `results_glue/`, `results_hmc/`, `results_kscan/`)
  directly under the current working directory. In this archive they are nested
  under `results/` — either run the analysis scripts from inside `results/`
  (e.g. `cd results && python3 ../src/analyze_potential.py`) or move the
  `results_*` directories up one level first.
- `results/results_prod/continuum_extrap.json` is a **diagnostic** output: its
  `continuum_r0_sqrt_sigma` field (1.267, chi2/dof = 9.0) is the naive a^2
  extrapolation that the accompanying texts explicitly decline to claim
  (single volume, 120 configs, fit-window systematics). The reported headline
  results are the per-beta scale-free ratios; see `RESULTS.md` section 3.
