Skip to content

The Fejer-York TT Pipeline for RSD (Retained Structure Dynamics)

Latest

Choose a tag to compare

@quantumagi quantumagi released this 19 May 14:36

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.py is 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 --force

On 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 for M4, M6, M8, M10 and associated defects.
  • kappa.py — retained curvature normalization kappa_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 from omega0 and L_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 — symbolic Q_n Bessel-moment ladder.
  • sgamma.py — S_gamma normal-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 -> P19 and 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 --force

Outputs

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, and sympy as listed in requirements.txt

Install with:

python -m pip install -r requirements.txt

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