# END Theory 2.0 public-data companion validation

This package reproduces the numerical results, tables, and figures in the companion paper **END Theory 2.0: Public-Data Validation of the Experimental Analysis Contracts** (version 1.0, 8 August 2026).

## Scientific scope

The program tests four analysis contracts described in END Theory 2.0:

1. GWOSC/GW150914: inter-detector timing and frequency-subband consistency.
2. CERN/ATLAS Open Data: four-lepton reconstruction and a frozen binned Poisson scalar-template fit.
3. XENONnT: a nominal-yield, released-template reproduction of the public spin-independent light-WIMP limit.
4. DUNE: three-flavour matter-Hamiltonian integrity and a release-based appearance forecast.

These checks validate the stated analysis machinery. They do **not** establish an empirical validation of END Theory itself. The source theory does not freeze an experiment-specific value of `A_alpha`, `C/Lambda^2`, an END dark-particle mass/cross section, or `H_END_nu`; therefore no END-specific likelihood ratio can be evaluated without adding assumptions.

The ATLAS release is explicitly educational and not suited for scientific publication. Its use here is limited to a software and likelihood standard-candle check. The DUNE calculation is a forecast using released TDR-approximation files, not a fit to DUNE collision or oscillation data.

## Included contents

- `run_validation.py` - deterministic analysis program.
- `data/` - the exact public input subset used by the program.
- `results/` - reference JSON, CSV, and PNG outputs.
- `SOURCE_MANIFEST.csv` - source identifiers, retrieval locations, and scope.
- `SHA256SUMS.txt` - SHA-256 digests for all packaged files except itself.
- `requirements.txt` - tested Python dependencies.

## Exact reproduction

Tested with CPython 3.12.13 on Linux. From the package root:

```bash
python3 -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r requirements.txt
sha256sum -c SHA256SUMS.txt
python run_validation.py --data-root data --output-dir results_reproduced
```

The analysis uses random seed `20260808`. Compare the recreated CSV/JSON outputs with `results/`. PNG metadata can differ across rendering environments; the underlying CSV/JSON values are the normative outputs.

## Pass/fail criteria frozen before interpretation

- GWOSC: recovered H1-relative delay must lie inside the published GW150914 interval; the subband log-frequency slope is reported with its standard error and no cosmological propagation bound is claimed.
- CERN: the selected-mass pipeline must complete, the fixed 125 GeV template yield must be finite, and a 10-event injected component must lie inside its recovered 68% ensemble interval. The local `Z` is diagnostic only.
- XENONnT: for 5-12 GeV, the simplified asymptotic reproduction must remain within +/-30% of the official released curve, matching the upstream package's documented approximation scale. The 3-4 GeV points are outside the declared nominal-yield scope.
- DUNE: evolution must be unitary to better than `1e-12`; probabilities must remain physical. `H_END_nu` is fixed to zero, so this is an implementation/forecast check only.

## Data provenance and use

Primary identifiers and URLs are recorded in `SOURCE_MANIFEST.csv`. The exact packaged inputs are checksum locked in `SHA256SUMS.txt`. Upstream terms, attribution requests, and scientific caveats remain applicable. In particular, cite the XENONnT paper and Zenodo release when using its templates, and preserve the ATLAS educational-use warning.

## Output interpretation

The decision field in `results/validation_results.json` is the compact machine-readable conclusion:

```json
{
  "analysis_pipeline_validated": true,
  "end_theory_empirically_validated": false
}
```

