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.
|