Files

Emily Boudreaux e7e53ce682 Consolidate numerical research and preserve a reproducible handoff

Document the baseline, hypotheses, measured results, failed approaches,
current policy defaults, and remaining rotating n=3 and virial limitations.
Include the authoritative LaTeX report, Pandoc-generated Markdown, compiled
PDF, source provenance, branch decisions, and consolidation validation.

Organize raw results and miscellaneous artifacts under working/ without
deleting them; version the directory guide, relocation hashes, archive
verifier, and report build/conversion checks. Keep build caches at their
original paths and clearly distinguish retained binaries from the validated
research build. Preserve experimental policies without promoting failed
trials to defaults.

2026-09-20 09:10:27 -04:00

README.md

MeanField research reports

The complete local delivery is identified by Git tag research-handoff-2026-09-20.

The comprehensive handoff is MeanField_research_handoff_2026-09-20.md. The matching LaTeX source is authoritative; the PDF is the print version. Markdown is generated directly from LaTeX by Pandoc, not maintained as a separate report. A small Pandoc filter removes repeated PDF table headings from Markdown and preserves section anchors; math uses explicit absolute-value and norm delimiters so table separators stay intact. The builder also checks that conversion retained table cells, equations, paths, figures, captions and working contents links.

From the repository root, run:

python3 reports/build_report.py

This requires Pandoc, latexmk, and a LaTeX installation with the packages named in the source preamble. To regenerate Markdown alone:

python3 reports/build_report.py --markdown-only

Build logs and LaTeX auxiliary files go to working/report_builds/research_handoff/. Selected scientific figures are versioned under figures/; their original paths and hashes are in archive/figure_sources.json.

Branch consolidation explains each retained, incorporated or intentionally excluded hypothesis.
archive/ preserves the pre-consolidation Git inventory, exact local edit, file relocation/hash manifest, and unsuccessful one-way gravity experiment.
sources/original_audits/ holds the original formulation, solver and preconditioner audits as unmodified reference copies.
prior/ preserves earlier project documentation and the optimization report.
validation/ records the consolidation checks, tested source and executable hashes, physical smoke results, and document conversion audit.
../experiments/ contains the original study reports, experiment recipes, diagnostics and evidence checkers.
The working-directory guide locates the complete raw evidence archive, which is local and not committed to Git.

The report distinguishes code correctness checks, artifact audits, algebraic convergence and physical validation. None should be read as a substitute for the others. In particular, the moderately rotating n=3 and ESTER-validation milestones remain open.

To verify the local raw archive against every recorded content hash, run:

python3 reports/verify_archive.py

Supply --repository /path/to/MeanField when checking a relocated archive.