Repository navigation
RSD Paper I / Paper II Support Scripts
This package is a dependency-ordered, executable support bundle for the numerical and export layers used by the Paper I / Paper II development path.
Paper I : https://doi.org/10.5281/zenodo.20066463
Paper II: https://doi.org/10.5281/zenodo.19862180
It is designed around three rules:
run.pyis the only dependency gatekeeper. Scripts receive upstream values through declared command-line inputs rather than reading upstream JSON files directly.- Formula-bearing scripts carry standardized headers and formula-local provenance comments so explicit constants and ratios are documented where they enter the computation.
- Outputs are written as JSON ledgers under
outputs/, with high-precision numeric strings rather than binary float state.
The package is not intended to replace the papers. It executable-codifies the formulas, certificates, and export computations that the papers theoremize.
Quick start
python -m pip install -r requirements.txt
python run.py m_e.py --force
python run.py a_e.py --forceOn Windows, run_all.cmd runs the main support targets in dependency order.
Runner contract
Use:
python run.py <script_name.py> [--force]run.py declares each target, its produced JSON fields, and the upstream fields required to run it. If a required value is produced by another script, run.py runs that producer first unless a cached JSON output already exists. --force reruns the requested target while still reusing existing dependency outputs when available.
Scripts should not silently import target quantities or circular dependencies. Values used in formulas should arrive through the runner’s declared CLI mapping and be recorded in the script output JSON.
Header standard
Every Python script uses the same top-level documentation layout:
ETHOS
WHAT THIS CERTIFIES
THEORY PROVENANCE
INPUTS
DERIVATION
OUTPUT
RUN CONTRACT
WARNING CONDITIONS
The headers are intentionally local. They avoid paper section-number references and instead document the formula role, provenance status, and run contract directly in the script. Formula-local RSD-SOURCE comments remain beside the highest-risk expressions.
Main target scripts
Core Paper-I/Paper-II scalar chain
m.py— first odd branch with the required dyadic richness condition.edge_parity.py— mid-edge parity quotient and Fejér lock ratio.xq.py— Fejér quarter-lock root and derivatives.h4.py— exact spherical harmonic moments.cq.py— York-quartic constant certificate.chitt.py— TT response scale from the York constant.m4.py— unified Bessel–Laplace moment ladder forM4,M6,M8,M10and associated defects.kappa.py— retained curvature normalizationkappa_infty.j2.py,zparity.py,num_orbits.py,zdir.py,a1g_xi_tt.py,gamma.py— mid-edge amplitude factors and product assembly.omega0.py— carrier-local retained TT clock scalar and alpha slot.l_e.py— scalar-volume electron packet length.m_e.py— SI electron mass bridge fromomega0andL_e.
Electron anomaly and normal-form support
pion_split.py— charged/neutral retained pion split ratio.a_e.py— paired retained/released electron anomaly readout.moments_symbol.py— symbolicQ_nBessel-moment ladder.sgamma.py—S_gammanormal-form ladder and normalized coefficients.
Spectrum and export support
lepton_ratios.py— lepton and hadron ratio support ledger.particle_masses.py— absolute mass propagation from the electron bridge and internal ratios.spectrum_table.py— generated spectrum table support output.uv_scales.py— UV/clock scale exports.gravity_norm.py— neutral self-resolution normalization.weak_masses.py— weak-facing mass support output.scalar_hole.py— scalar-hole support output.support_stencil.py—S32 -> P19and stencil-weight certificate.born_hellinger.py— Hellinger tangent normalization certificate.
Supporting utilities
alpha.py— legacy/full Fejér–York alpha assembly with uncertainty propagation.dL2.py— quadratic lock correction used by the legacy alpha assembly.hypothesis.py— protocol/window helper.utils.py— shared script helpers.run_utils.py— runner-side parsing helpers.
Typical commands
# Electron mass bridge
python run.py m_e.py --force
# Electron anomaly
python run.py a_e.py --force
# Pion split
python run.py pion_split.py --force
# Normal-form ladder
python run.py sgamma.py --force
# UV scale exports
python run.py uv_scales.py --force
# Full generated spectrum table
python run.py spectrum_table.py --forceOutputs
Every script writes a JSON file of the form:
outputs/<script_stem>.json
The JSON ledgers record inputs, intermediates, outputs, status, and metadata where applicable. The zip intentionally ships without cached JSON outputs except outputs/.gitkeep.
Current source files
a1g_xi_tt.py
a_e.py
alpha.py
born_hellinger.py
chitt.py
cq.py
dL2.py
edge_parity.py
gamma.py
gravity_norm.py
h4.py
hypothesis.py
j2.py
kappa.py
l_e.py
lepton_ratios.py
m.py
m4.py
m_e.py
moments_symbol.py
num_orbits.py
omega0.py
particle_masses.py
pion_split.py
scalar_hole.py
sgamma.py
spectrum_table.py
support_stencil.py
utils.py
uv_scales.py
weak_masses.py
xq.py
zdir.py
zparity.py
Requirements
- Python 3.11 recommended
mpmath,numpy, andsympyas listed inrequirements.txt
Install with:
python -m pip install -r requirements.txtNotes on audit posture
The package has been pruned to remove legacy audit-only scripts and repo-level duplicate audit documents. The README is the only repo-level guide; detailed provenance belongs in the standardized script headers and inline formula comments.
The strongest support spine is:
omega0.py -> l_e.py -> m_e.py
pion_split.py -> a_e.py
moments_symbol.py -> sgamma.py
uv_scales.py / gravity_norm.py / support_stencil.py / born_hellinger.py
Formula-led spectrum support scripts remain explicitly documented in their headers so their theorem status is visible where formulas enter.
License
See LICENSE.