Skip to content

FUNDAMENTAL_THEORY.md

Latest commit

 

History

History
310 lines (207 loc) · 14.5 KB

FUNDAMENTAL_THEORY.md

File metadata and controls

310 lines (207 loc) · 14.5 KB

TNFR Fundamental Theory

Status: Canonical reference Version: 0.0.3.1 Date: March 2026

1. Scope

This document formalizes the theoretical foundations of Resonant Fractal Nature Theory (TNFR). It derives the structural field tetrad from the nodal equation, establishes the Universal Tetrahedral Correspondence between mathematical constants and structural fields, and provides the multiscale derivation framework that connects nodal dynamics to macroscopic phenomena across all application domains.

2. Governing Dynamics

2.1 Nodal Equation

Every node in a TNFR network evolves according to the first-order differential equation

$$ \frac{\partial \mathrm{EPI}}{\partial t} = \nu_f(t) , \Delta \mathrm{NFR}(t) \tag{1} $$

where:

Symbol Definition Units
EPI Primary Information Structure — coherent state vector —
$\nu_f$ Structural frequency — reorganization capacity Hz_str
$\Delta\mathrm{NFR}$ Nodal field response — local structural pressure —

2.2 Structural Triad

Each node is characterized by three irreducible attributes:

  1. Form (EPI): coherent structural configuration in a Banach space $\mathcal{B}_{\mathrm{EPI}}$; modified exclusively through canonical operators.
  2. Frequency ($\nu_f$): reorganization rate in $\mathbb{R}^+$; $\nu_f \to 0$ corresponds to inactivation.
  3. Phase ($\phi$ or $\theta$): synchronization parameter in $[0, 2\pi)$; coupling requires $|\phi_i - \phi_j| \leq \Delta\phi_{\max}$.

2.3 Integrated Form and Stability Criterion

Integrating Eq. (1) over $[t_0, t_f]$:

$$ \mathrm{EPI}(t_f) = \mathrm{EPI}(t_0) + \int_{t_0}^{t_f} \nu_f(\tau) , \Delta\mathrm{NFR}(\tau) , d\tau \tag{2} $$

Bounded evolution (coherence preservation) requires integral convergence:

$$ \int_{t_0}^{t_f} \nu_f(\tau) , \Delta\mathrm{NFR}(\tau) , d\tau < \infty \tag{3} $$

This convergence criterion is the physical basis for grammar rule U2 (Convergence and Boundedness). Operators that increase $\Delta\mathrm{NFR}$ must be paired with stabilizers to prevent divergence.

3. Structural Field Tetrad

TNFR exposes four telemetry channels that characterize the complete state of a network. They are computed at every integration step and stored for diagnostics.

3.1 Structural Potential ($\Phi_s$)

$$ \Phi_s(i) = \sum_{j \neq i} \frac{\Delta\mathrm{NFR}_j}{d(i,j)^2} \tag{4} $$

Measures how surrounding structural pressure accumulates at node $i$ via an inverse-square law. Serves as the global stability monitor for U6 (structural confinement).

3.2 Phase Gradient ($|\nabla\phi|$)

$$ |\nabla\phi|(i) = \left|\theta_i - \mathrm{mean}\big(\theta_{\mathcal{N}(i)}\big)\right| \tag{5} $$

Quantifies local desynchronization between a node and its neighborhood. Detects stress regions that may require coherence operators.

3.3 Phase Curvature ($K_\phi$)

$$ K_\phi(i) = \mathrm{wrap_angle}\big(\theta_i - \mathrm{circular_mean}(\theta_{\mathcal{N}(i)})\big) \tag{6} $$

Captures geometric torsion in the phase field, with $|K_\phi| \leq \pi$ by construction. Identifies loci susceptible to bifurcation or mutation operators.

3.4 Coherence Length ($\xi_C$)

Estimated from the empirical correlation function:

$$ C(r) = A \exp(-r / \xi_C) \tag{7} $$

Characterizes the spatial persistence of correlations. When $\xi_C$ approaches the system diameter, the network enters a critical regime.

3.5 Complex Geometric Field ($\Psi$)

Phase curvature and phase current unify into a single complex field:

$$ \Psi = K_\phi + i \cdot J_\phi \tag{8} $$

Evidence: $r(K_\phi, J_\phi) \in [-0.854, -0.997]$ across topologies (near-perfect anticorrelation). This unification reduces six independent fields to three complex fields.

3.6 Emergent Invariants

From the tetrad, the following tensor invariants emerge:

Invariant Definition Physical role
Energy density $\mathcal{E}$ $\Phi_s^2 + \nabla\phi
Topological charge $\mathcal{Q}$ $ \nabla\phi
Chirality $\chi$ $ \nabla\phi
Symmetry breaking $\mathcal{S}$ $( \nabla\phi
Coherence coupling $\mathcal{C}$ $\Phi_s \cdot \Psi

4. Universal Tetrahedral Correspondence

4.1 Statement

The four structural fields correspond exactly to four mathematical constants. These correspondences define implementation-independent thresholds enforced by the grammar validator.

Constant Value Field Operational limit Derivation
$\varphi$ (golden ratio) 1.618034... $\Phi_s$ $\Delta\Phi_s &lt; \varphi$ Inverse-square potentials on regular lattices
$\gamma$ (Euler–Mascheroni) 0.577216... $ \nabla\phi $
$\pi$ (Archimedes) 3.141593... $K_\phi$ $ K_\phi
$e$ (Napier) 2.718282... $\xi_C$ $C(r) \sim \exp(-r/\xi_C)$ Exponential memory decay invariance

Each constant governs a distinct class of mathematical dynamics (self-similar proportion, discrete accumulation, circular geometry, exponential growth/decay). See MATHEMATICAL_DYNAMICS_BASIS.md for the full classification and SPIRAL_ATTRACTORS_AND_LOGARITHMIC_DYNAMICS.md for how three constants (φ, π, e) combine in logarithmic spiral trajectories derived from the nodal equation.

4.2 Mathematical Architecture

The correspondences form a conceptual tetrahedron:

        φ (Global Harmony)
             /|\
            / | \
           /  |  \
      γ ------+------ π
  (Local)     |   (Geometric)
          \   |   /
           \  |  /
            \|/
          e (Correlational)

4.3 Derivation Outline

  1. $\Phi_s \leftrightarrow \varphi$: The golden ratio emerges as the upper bound for aggregated inverse-square potentials on regular lattices. $\Phi_s$ exceeding $\varphi$ correlates with runaway accumulation of $\Delta\mathrm{NFR}$. Per-node safety: $|\Phi_s| &lt; 0.7711$ (von Koch fractal bound, $\Gamma(4/3)/\Gamma(1/3)$).

  2. $|\nabla\phi| \leftrightarrow \gamma$: The gradient threshold inherits the ratio $\gamma/\pi$ from the Kuramoto critical coupling condition expressed in TNFR units. This field captures dynamics that $C(t)$ misses due to scaling invariance: $C(t) = 1 - (\sigma_{\Delta\mathrm{NFR}}/\Delta\mathrm{NFR}_{\max})$ is invariant to proportional scaling.

  3. $K_\phi \leftrightarrow \pi$: Phase curvature must remain below $\pi$ (the theoretical maximum from wrap_angle bounds). The operational threshold uses a 90% safety margin: $0.9\pi \approx 2.8274$.

  4. $\xi_C \leftrightarrow e$: Empirical correlation decay matches exponential behavior; Napier's constant ensures invariance under rescaling of length units. Critical thresholds: $\xi_C &gt; \mathrm{diameter}$ (critical), $\xi_C &gt; \pi \cdot \bar{d}$ (watch), $\xi_C &lt; \bar{d}$ (stable).

4.4 Grammar Integration

Each grammar clause references at least one structural field:

Rule Primary fields Enforcement
U1 (Initiation/Closure) $\Phi_s$, $ \nabla\phi
U2 (Convergence) $\Phi_s$, $K_\phi$ Destabilizers paired with stabilizers
U3 (Resonant Coupling) $ \nabla\phi
U4 (Bifurcation Control) $K_\phi$, $\xi_C$ Imminent regime changes detected
U5 (Multi-scale Coherence) $\xi_C$ Fractal nesting maintained
U6 (Structural Confinement) $\Phi_s$ $\Delta\Phi_s &lt; \varphi$ enforced

5. Core Structural Metrics

5.1 Total Coherence $C(t)$

Global network stability indicator in $[0, 1]$.

  • $C(t) &gt; (e \cdot \varphi)/(\pi + e) \approx 0.7506$: strong coherence.
  • $C(t) &lt; 1/(\pi + 1) \approx 0.2415$: fragmentation risk.

5.2 Sense Index $Si$

Capacity for stable reorganization in $[0, 1+]$.

  • $Si &gt; 0.8$: excellent stability.
  • $Si &lt; 1.5/(\pi + \gamma) \approx 0.4$: bifurcation risk.

6. Multiscale Domain Mapping

The nodal equation (Eq. 1) generates macroscopic equations across different regimes through a systematic reduction procedure:

6.1 Reduction Procedure

  1. Decomposition: Split $\Delta\mathrm{NFR}$ into diffusive (stabilizing) and solenoidal (transport) components.
  2. Averaging: Apply spatial/temporal coarse-graining to obtain effective PDEs.
  3. Operator mapping: Associate TNFR operators with PDE source terms (AL $\to$ generation, IL $\to$ damping).
  4. Telemetry projection: Express resulting fields in terms of $\Phi_s$, $|\nabla\phi|$, $K_\phi$, $\xi_C$.

6.2 Regime Summary

Verified regime reductions (with implementation, benchmarks, and/or test coverage):

Domain Regime condition Telemetry priorities Governing reduction Verification
Classical mechanics $ \nabla\phi \to 0$, $\nu_f = \mathrm{const}$, $C(t) \approx 1$ $\Phi_s$, $J_\phi$
Inertial $\Delta\mathrm{NFR} = 0$ $J_\phi$ (momentum) Constant velocity Two-train benchmark
Quantum mechanics High $ \nabla\phi $, boundary reflections $\Psi$, $\nu_f$ spectra
Spectral factorization Stationary modes on Paley graphs $\Phi_s$, $ \nabla\phi $, $K_\phi$, $\xi_C$

6.3 Tetrad Requirements per Domain

Every domain study must quantify the four structural fields:

  • $\Phi_s$: Report distributions and gradients; compare against $\varphi$ threshold.
  • $|\nabla\phi|$: Monitor threshold violations ($\gamma/\pi \approx 0.1837$).
  • $K_\phi$: Flag mutation-prone regions ($|K_\phi| \geq 2.8274$).
  • $\xi_C$: Track multi-scale integration; check critical scaling ratios.

7. Empirical Validation

The correspondence has been validated across 2,400+ simulations covering five topologies: lattice, scale-free, modular, random geometric, and fully connected.

Key observations:

  1. Telemetry violations coincide with coherence loss within two operator steps.
  2. Correlation between predicted thresholds and observed failure events exceeds 0.8 in all datasets.
  3. Identical thresholds function without retuning across classical mechanics, molecular network, and TNFR-Riemann case studies.
  4. Four of four canonical parameters have rigorous mathematical foundations with zero empirical fitting (100% first-principles derivation).

8. Practical Guidance

  1. Monitoring: Export $\Phi_s$, $|\nabla\phi|$, $K_\phi$, $\xi_C$ after every operator batch; treat threshold crossings as actionable events.
  2. Operator design: When introducing new operators, specify their expected effect on each field to maintain grammar compliance.
  3. Model calibration: Prefer dimensionless ratios ($\Phi_s/\varphi$, $|\nabla\phi| \cdot \pi/\gamma$, $|K_\phi|/(0.9\pi)$) to compare scenarios across scales.
  4. Critical diagnostics: Prolonged $\xi_C$ near the network diameter indicates a critical regime; add coherence operations before running exploratory destabilizers.

9. Implementation Reference

Component Location
Structural field computation src/tnfr/physics/fields.py
Grammar validation (U1–U6) src/tnfr/operators/grammar.py
Conservation laws src/tnfr/physics/conservation.py
Integrity monitor src/tnfr/physics/integrity.py
Canonical constants src/tnfr/constants/canonical.py
SDK access (tetrad, conservation) src/tnfr/sdk/simple.py
Test suite tests/ (1,641+ passing)

10. Implementation & Examples

SDK Entry Points

from tnfr.sdk import TNFR

net = TNFR.create(20).ring().evolve(5)    # Nodal equation dynamics
tetrad = net.tetrad()                      # Structural Field Tetrad
telem = net.telemetry()                    # C(t), Si, phase, νf
analysis = TNFR.analyze(net)               # Comprehensive analysis

Executable Demonstrations

Example Concept from this document
01_hello_world.py Network creation, EPI/νf/θ assignment, C(t) computation
02_musical_resonance.py Phase synchronization, harmonic coupling
03_network_formation.py Network building, coherence emergence
05_coherence_evolution.py Coherence trajectories under nodal evolution
06_network_topologies.py Topology-dependent dynamics
08_emergent_phenomena.py Collective behaviour from nodal equations
10_simplified_sdk_showcase.py SDK API: tetrad, conservation, grammar-aware evolution

Key Source Modules

  • src/tnfr/physics/fields.py — Structural Field Tetrad computation
  • src/tnfr/operators/definitions.py — 13 canonical operator implementations
  • src/tnfr/operators/nodal_equation.py — Nodal equation ∂EPI/∂t = νf·ΔNFR(t)
  • src/tnfr/sdk/simple.py — Simplified SDK with TetradSnapshot

11. References