TORUS Theory

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 dynamicsyielding testable signatures in gravitational-wave spectra, particle-decay branching ratios, and recursive-intelligence architectures.

---

Folder layout

| Path | Contents | |------|-----------| | docs/book-docx-fixed/ | Canonical DOCX: all edits here; legacy docs/book/ retained for historical diff only | | docs/book/frontmatter/ | 00_Preface.docx, Table_of_Contents.docx | | docs/book/chapters/ | 15 chapter DOCX files (01_ 15_) | | docs/book/appendices/ | Appendices AE (A_ E_) | | docs/papers/ | Stand-alone research papers & monographs | | docs/validation/ | Phase-A/B cross-domain validation .tex + detector executive summary | | docs/experiments/ | Bench protocols & lab worksheets | | .github/workflows/ | CI: slug-rule & structure audit (WIP) |

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

Data availability

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.

---

Canonical Documents

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

Book

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

Supplements

• Dimensional Constants Interrelation in TORUS Theory (0D13D) 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 TorusofTori, chi-betaFunction, and the ProjectionAngle Theorem (PDF,DOCX,TEX)

Validation Data

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

Validation

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

Experiments

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

---

Getting started

```bash 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. ```

Installation

```bash

one-time dev install

pip install -e . ```

---

Quick start

```bash

run SimLab locally

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

---

Validation Suite

• Side-Band Primer
• Synthetic Benchmark (PairCorrSideBandBenchmark.ipynb)
• Real-Data Template (PairCorrFourierSideBand.ipynb)
• Noise-Sweep ROC (NoiseSweepROC.ipynb)

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

---

Bicycle Balance Mystery Resolution

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

• recursivecontrollervalidation.ipynb: Monte-Carlo recursive controller lean/steer test.
• constantladderresiduals.ipynb: Linearized stability and eigen-plot placeholder.
• audio_fft.ipynb: Audio harmonics analysis.
• shannonboundcompression.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.

---

Data

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

---

License & Contact

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

---

Optional Advanced Test: Regenerate TORUS-Modified Interferometer Lattices

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

bash pip install pykat python scripts/regenerate_torus_solutions.py

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

---

Documentation Index

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.