Emily Boudreaux
e7e53ce682
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.
59 lines
2.6 KiB
Markdown
59 lines
2.6 KiB
Markdown
# 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](MeanField_research_handoff_2026-09-20.md).
|
|
The matching [LaTeX source](MeanField_research_handoff_2026-09-20.tex) is authoritative;
|
|
the [PDF](MeanField_research_handoff_2026-09-20.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:
|
|
|
|
```sh
|
|
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:
|
|
|
|
```sh
|
|
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](branch_consolidation.md) 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](../working/README.md) 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:
|
|
|
|
```sh
|
|
python3 reports/verify_archive.py
|
|
```
|
|
|
|
Supply `--repository /path/to/MeanField` when checking a relocated archive.
|