Reproducibility#

All decisive calculations use exact rational arithmetic. No numerical tolerance, random point sample, or remote service is required.

One-command checks#

From the repository root:

make verify
make book

Or run each layer separately:

python3 artifacts/sympy/verify.py
python3 artifacts/sympy/verify_plane_attack.py
python3 artifacts/sympy/verify_resultant_route.py
python3 research/n2/certify_pseudoplane_poisson.py
python3 research/n2/search_resultant_poisson.py --poisson-degree 3
DOT_SAGE=/tmp/jacobian-sage sage artifacts/sage/verify.sage
DOT_SAGE=/tmp/jacobian-sage sage research/n2/low_degree_collision.sage
cd artifacts/magma
MAGMA_STARTUP_FILE=/dev/null /Applications/Magma/magma run_all.m

The DOT_SAGE and MAGMA_STARTUP_FILE settings only isolate user-specific cache/startup behavior. They do not change the coefficient field or algorithms.

What each implementation checks#

Artifact

Threefold map

Plane descent

Near-models

Resultant route

SymPy scripts

full

identities

yes

full identities/search

Sage scripts

full

degree-3 collision ideal

no

no

Magma suite

full

structural identities

yes

core identities

Jupyter notebook

full core

documentation

documentation

documentation

Jupyter Book#

Build the book with

jupyter-book build knowledge

and open knowledge/_build/html/index.html. The notebook is stored with exact outputs but book builds do not re-execute it by default, so documentation builds remain deterministic. Re-execute explicitly with:

jupyter nbconvert --to notebook --execute --inplace \
  knowledge/notebooks/sympy-verification.ipynb

Obsidian#

Open the knowledge/ directory as an Obsidian vault. It already contains a minimal .obsidian/ configuration. Ordinary relative Markdown links are used so the same source works in Obsidian, GitHub, and Jupyter Book.

Expected outputs#

The command-line certificates terminate on any failed assertion. Successful runs end with messages of the form:

PASS: all SymPy certificates verified exactly over Q.
PASS: all exact plane-attack certificates verified over Q.
PASS: all exact factorization/resultant route certificates verified over Q.
PASS: pseudo-plane Poisson identities and quadratic no-go certified over Q.
PASS: all SageMath certificates verified exactly over Q.
PASS: all Magma certificates completed.