TORUS Theory extends standard gauge theory by embedding every field and interaction inside a 14-dimensional (\chi)-(\beta) harmonic lattice; the resulting closure matrix forces each recursion loop to return to unity, simultaneously resolving black-hole entropy, measurement paradoxes, and the unification of all four fundamental forces. From this single topological move flow predictive links between quantum amplitudes, gravitational curvature, large-scale cosmology, and observer-state dynamics—yielding testable signatures in gravitational-wave spectra, particle-decay branching ratios, and recursive-intelligence architectures.

All filenames are ASCII-safe “slugs”: spaces → underscores, Unicode letters spelled out (e.g., \chi → Chi).

Raw structured-light data are archived on Zenodo

Only the lightweight .h5 bundles are pulled automatically at run-time;
the multi-GB TIFF stacks remain on Zenodo to keep this repo lean.

The following canonical documents are available in DOCX, TEX, and PDF formats:

• TORUS Book (DOCX)
• TORUS Book (TEX)
• TORUS Book (PDF)

• Dimensional Constants Interrelation in TORUS Theory (0D–13D) – Formal Derivation and Closure (PDF,DOCX,TEX)
• Gravitational-Wave-Detector Validation – Executive Summary (v1.0) (PDF,DOCX,TEX)
• Hyper-Recursive Algebra in TORUS Theory (PDF,DOCX,TEX)
• Resolving the Black Hole Entropy and Information Paradox via TORUS Structured Recursion (PDF,DOCX,TEX)
• Topology of the Torus‑of‑Tori, chi-beta‑Function, and the Projection‑Angle Theorem (PDF,DOCX,TEX)

• Ladder fit data (CODATA): data/ladder/ladder_fit_multiCODATA.csv
• RMS fit results: data/ladder/ladder_fit_rms_multi.txt

• Universal Recursion - A 12 Sigma Cross-Domain Validation (Phase A) (PDF,DOCX,TEX)
• Universal Recursion - A 14 Sigma Cross-Domain Validation (Phase B) (PDF,DOCX,TEX) See notebooks/validation/ladder/ for precision re-test of Stationary-Action ladder with CODATA 2022.

• OSQN Drift in a Quartz-Oscillator Loop Lab Worksheet (PDF,DOCX,TEX)

git clone https://github.com/GenghisDarb/TORUS-Theory.git
cd TORUS-Theory
# optional: run the audit script to verify structure
bash scripts/audit_structure.sh   # (coming soon)
pip install -r requirements.txt   # now includes mpmath, scipy, etc.

# one-time dev install
pip install -e .

# run SimLab locally
docker run -it --rm ghcr.io/genghisdarb/torus-simlab:latest torus-cli --help

• Side-Band Primer
• Synthetic Benchmark (PairCorr_SideBand_Benchmark.ipynb)
• Real-Data Template (PairCorr_Fourier_SideBand.ipynb)
• Noise-Sweep ROC (Noise_Sweep_ROC.ipynb)

Phase B

• B1 – Constant Ladder Precision Re-Test
• B2 – Seed-Constant Multi-Probe
• B4 – Talbot Side-Band Multiframe

A new suite of validation notebooks has been added to resolve the Bicycle Balance Mystery:

• recursive_controller_validation.ipynb: Monte-Carlo recursive controller lean/steer test.
• constant_ladder_residuals.ipynb: Linearized stability and eigen-plot placeholder.
• audio_fft.ipynb: Audio harmonics χ analysis.
• shannon_bound_compression.ipynb: Recursive Shannon-bound compression test.
• timing_stats.ipynb: Stack timing analysis.

All are located in notebooks/bicycle/. See that folder's README for details.

Note: If you have a publication draft (e.g., docs/papers/bicycle_balance_TORUS.pdf), link it here for reference.

Processed interferometer outputs and provenance live in data/interferometer/upstream/solutions/ – see its README for details.

MIT License Maintainer: Bradley Peter (Genghis Darb) bradleypeter1984@gmail.com

This step requires FINESSE and PyKat. To install PyKat after setting up FINESSE:

pip install pykat
python scripts/regenerate_torus_solutions.py

If PyKat is not installed, the script will skip lattice regeneration and exit gracefully.

Explore the Documentation Index for a sitemap of all key files and sections in the repository.

Currently pinned to CPython ≤ 3.12 because SciPy wheels for 3.13+ are not yet available (2025-07). Remove upper bound once released.