The Algorithmic and Mathematical Foundations of High-Dimensional Lattice Resonance, Modular Arithmetic, and Deterministic Information Stability

The Nexus Resonance Codex Central Math Vault (NRC) is the foundational mathematical library and algorithmic engine of the Nexus Resonance Codex ecosystem. It provides mathematically verified, type-hardened implementations of core NRC primitives—including TUPT (Trageser Universal Pattern Transform), QRT (Quantum Resonance Transform), MST (Multi-Scale Tensor Recurrence), and $\phi^\infty$ Shard Folding—anchored to the digital root 7 locus for guaranteed structural and numerical stability.

This repository serves as the single source of mathematical truth across all downstream applications, from cognitive AI attention mechanisms (Ai-Enhancements) and structural biophysics (Protein-Folding) to post-quantum lattice cryptography (Phi-Infinity-Lattice-Compression).

The Nexus Resonance Codex is founded on the synthesis of ancient geometric invariants and modern high-dimensional computational theory.

+-------------------------------------------------------------------------------+
|                       CENTRAL MATH VAULT (NRC) TOPOLOGY                       |
+-------------------------------------------------------------------------------+
|                                                                               |
|   Discrete Modular Domain                         Continuous Manifold Domain  |
|   +------------------------------------+          +-----------------------+   |
|   | TUPT Modular Gate                  |          | QRT Fractal Damping   |   |
|   | Xi(x) = x if x % 9 not in {0,3,6}  | <------> | psi(x) damping curve  |   |
|   +------------------------------------+          +-----------------------+   |
|                     |                                         |               |
|                     v                                         v               |
|   +------------------------------------+          +-----------------------+   |
|   | TTT-7 Stability Locus              |          | MST Hyperbolic Map    |   |
|   | dr(n) in {1, 2, 4, 5, 7, 8}        | <------> | x_{n+1} recurrence    |   |
|   +------------------------------------+          +-----------------------+   |
|                     |                                         |               |
|                     +--------------------+--------------------+               |
|                                          |                                    |
|                                          v                                    |
|                       +-------------------------------------+                 |
|                       |   phi^inf Spectral Shard Folding    |                 |
|                       |   s_k = x * phi^k + roll * phi^-k   |                 |
|                       +-------------------------------------+                 |
|                                                                               |
+-------------------------------------------------------------------------------+

In discrete high-dimensional state spaces, the residue set ${0, 3, 6}$ under modulo 9 exhibits chaotic numerical divergence. The TUPT exclusion gate eliminates chaotic attractors while preserving valid state density:

$$\Xi(x) = \begin{cases} 0 & \text{if } x \pmod 9 \in {0, 3, 6} \ x & \text{otherwise} \end{cases}$$

Digital root evaluation ensures that intermediate tensor values, loss terms, and parameters reside strictly within the resonant stability manifold:

$$\text{dr}(n) = (n - 1) \pmod 9 + 1$$

$$\text{Stability Condition: } \text{dr}(n) \in {1, 2, 4, 5, 7, 8}$$

QRT replaces standard stochastic Gaussian noise with deterministic fractal regularization, minimizing entropy without introducing uncontrolled variance:

$$\psi(x) = \sin(\phi\sqrt{2} \cdot \theta_{QRT} \cdot x) \cdot e^{-x^2 / \phi} + \cos\left(\frac{\pi}{\phi} \cdot x\right)$$

where $\phi = \frac{1+\sqrt{5}}{2} \approx 1.618033988749895$ and $\theta_{QRT} \approx 51.853^\circ$.

MST recurrence models and controls dynamic trajectories in non-linear systems (such as protein backbone conformation and deep recurrent activations):

$$x_{n+1} = \lfloor 1000 \cdot \sinh(x_n) \rfloor + \ln(x_n^2 + 1) + \phi^{x_n} \pmod{24389}$$

where the modulus $24389 = 29^3$ corresponds to the discrete 3-state lattice boundary.

Continuous high-dimensional vectors are projected onto self-similar spiral manifolds:

$$s_k = x \cdot \phi^k + \text{roll}(x, k) \cdot \phi^{-k}$$

As $k \to \infty$, information density converges to the golden attractor limit, supporting $O(1)$ coordinate retrieval across $O(\phi^n)$ sequence context.

NRC/
├── src/
│   ├── nrc_math/               # Core mathematical primitives library
│   │   ├── __init__.py         # Exported primitives and constants
│   │   ├── primitives.py       # TUPT, QRT, MST, Binet, and TTT-7 routines
│   │   └── py.typed            # PEP 561 static type marker
│   └── nrc/                    # High-dimensional lattice operations
│       └── core.py             # Manifold projection and tensor transforms
├── proofs/                     # Formal mathematical demonstration scripts
│   ├── proof_01_entropy_collapse.py
│   ├── proof_02_modular_exclusion.py
│   └── proof_03_qrt_resonance.py
├── docs/                       # Institutional documentation & MkDocs sources
│   ├── nrc-math.md             # Formal proofs and derivation notes
│   └── index.md                # Documentation index
├── tests/                      # Automated test suite
│   └── test_primitives.py      # Primitive verification and stability checks
├── pyproject.toml              # Build configuration and dependencies
└── uv.lock                     # Deterministic dependency lockfile

This project uses modern Python packaging via uv (or standard pip / venv):

# Clone the repository
git clone https://github.com/Nexus-Resonance-Codex/NRC.git
cd NRC

# Create and activate virtual environment with uv
uv venv
source .venv/bin/activate

# Install package in editable mode with development dependencies
uv pip install -e ".[dev]"

Alternatively, with standard pip:

python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

from nrc_math.primitives import binet_formula

# Discrete calculation
f_10 = binet_formula(10)
print(f"10th Fibonacci Number: {f_10}")  # Output: 55

# Continuous tensor projection
import numpy as np
coords = np.linspace(0.0, 5.0, 6)
projected = binet_formula(coords)
print(f"Continuous Projection: {projected}")

import numpy as np
from nrc_math.primitives import apply_exclusion_gate

# Create sample state array
states = np.array([0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11])

# Apply TUPT exclusion gate (zeroes out residues 0, 3, 6 modulo 9)
filtered = apply_exclusion_gate(states, modulus=9)
print(f"Filtered States: {filtered}")
# Output: [ 0.  1.  2.  0.  4.  5.  0.  7.  8.  0. 10. 11.]

from nrc_math.primitives import verify_root_7_stability

test_values = [16, 25, 34, 43, 52, 70]
for val in test_values:
    is_stable = verify_root_7_stability(val)
    print(f"Value: {val:2d} | TTT-7 Stability: {is_stable}")

from nrc_math.primitives import TUPTMixer

mixer = TUPTMixer(seed=42)
sequence = [mixer.next_residue() for _ in range(5)]
print(f"Residue Sequence: {sequence}")

Run the comprehensive unit test suite to verify mathematical invariants and numerical tolerances:

# Execute unit tests
pytest tests/ -v

# Run formal mathematical proof scripts
python proofs/proof_01_entropy_collapse.py
python proofs/proof_02_modular_exclusion.py
python proofs/proof_03_qrt_resonance.py

The Nexus Resonance Codex is dual-licensed:

• Open Source / Academic Research:

  • Codebase: GNU Affero General Public License v3.0 (AGPL-3.0)
  • Data & Weights: Creative Commons Attribution-NonCommercial-ShareAlike 4.0 (CC BY-NC-SA 4.0)
  • Patent Covenant: Tesla-Style Patent Pledge
  • Trademark: Trademark & Nomenclature Policy

• Enterprise & Commercial Deployment: Commercial organizations requiring proprietary, closed-source integration without AGPL-3.0 copyleft obligations must obtain an Enterprise License. See COMMERCIAL_USE.md or direct inquiries to:

  James Paul Trageser
  Founder and Chief Architect
  Email: NexusResonanceCodex@gmail.com

@software{trageser2026nrc_vault,
  author       = {James Paul Trageser},
  title        = {Nexus Resonance Codex (NRC): Central Math Vault and High-Dimensional Lattice Primitives},
  year         = {2026},
  publisher    = {GitHub},
  journal      = {GitHub Repository},
  howpublished = {\url{https://github.com/Nexus-Resonance-Codex/NRC}}
}

Copyright (c) 2026 Nexus Resonance Codex (NRC). All rights reserved.