Skip to content

feat(folds): validate P2Fold on Bermagui and document gauss4 - #349

Merged
lachlangrose merged 4 commits into
masterfrom
p2-phase4-validation
Oct 20, 2026
Merged

lachlangrose merged 4 commits into
masterfrom
p2-phase4-validation

Conversation

@lachlangrose

@lachlangrose lachlangrose commented Oct 20, 2026 •

Copy link
Copy Markdown
Member

Validates the library P2Fold path on Bermagui S2 and S0 after the Phase 0 weight, NaN-row, CG convergence and update fixes, and the Phase 1-3 class, factory wiring and golden coverage.

Both decision gates pass using fewer P2 unknowns, fixed seeds, explicit buffer 0 and identical upstream DFI frames / fitted fold geometry:

Target DFI median / unknowns P2Fold gauss4 median / unknowns P2 share above 30 degrees
S2 6.15 deg / 12,992 4.69 deg / 9,711 0.0%
S0 20.63 deg / 112,560 11.14 deg / 85,673 19.4%

The comparison also covers the requested full-resolution runs and both sampling rules. Unregularised centroid is unstable (about 60 degrees median). The largest gauss4 S0 run has 765,347 unknowns, 8.69 degrees median error, 16.1% above 30 degrees, 92.5 seconds solve time and 6.6 GiB peak RSS. The metric measures axial agreement with the fold event, not independent geological accuracy.

Adds reproducible comparison/summary scripts, a bundled synthetic example, usage docs, and the corrected handoff/work plans. Detailed generated outputs are retained locally. Corrects the mesh-size API/log wording: nelements is currently a grid-cell budget rather than a literal tet count. The report explains why the historical all-P2 upstream-chain numbers are not a direct before/after comparison.

Validation: all ten candidate CG solves converged with finite inner probes; 172 interpolation tests passed (9 skipped, 2 expected failures); 9 gate/integration tests passed; the bundled example ran successfully. Sphinx HTML built with gallery execution disabled, with 286 warnings elsewhere in the documentation; the new page and example link were inspected.

Release follow-up: existing release-please PRs are scoped to the intended packages, but root dependency ranges currently exclude the pending loop-common/loop-interpolation 0.1.0 releases. Align requirements and lockfile before publishing the root release. Post-merge release checks and Phase 5 remain pending.

Validation summary and limitations

@lachlangrose
lachlangrose merged commit 4bf2de1 into master Oct 20, 2026
35 checks passed
@lachlangrose
lachlangrose deleted the p2-phase4-validation branch October 20, 2026 03:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant