Status: Technical reference Version: 0.0.3.3 Date: March 2026
This document derives five physical regimes as limiting cases of the nodal equation . Each regime is specified by measurable conditions on the structural field tetrad (, , , ), the observable mappings between TNFR quantities and classical/quantum variables, and the validation artifacts linking theory to reproducible simulations.
| Regime | Implementation | External reference | Test coverage | Status |
|---|---|---|---|---|
| Classical mechanics | classical_mechanics.py | Kepler orbit (analytical) | test_classical_mechanics.py | Verified |
| Inertial | classical_mechanics.py | Two-train analytical | Embedded in example | Verified |
| Quantum | quantum_mechanics.py | Particle-in-box () | None | Partial |
| Uncertainty/interference | Example only | Fourier bound | None | Partial |
| Thermodynamics | Example only | Newton cooling law | None | Demonstration |
Under these constraints the nodal equation reduces to a form algebraically identical to Newton's second law.
| Classical quantity | Symbol | TNFR quantity | Access |
|---|---|---|---|
| Position | Spatial component of EPI | ClassicalMechanicsMapper.position | |
| Velocity | Flow component | Same accessor | |
| Mass | Telemetry | ||
| Force | Structural units | ||
| Potential | compute_structural_potential() | ||
| Action | Phase accumulation | Diagnostics |
Starting from the nodal equation:
Substituting yields under the inertial reading; departures introduce corrections proportional to .
Regime refinement. The bare nodal equation is first order in time, so taken literally (EPI as a position-like coordinate, as force) it yields the overdamped drift law — velocity proportional to force, with acting as a mobility, not an inverse mass. The genuine inertial Newtonian regime (, second order) demonstrated below — Keplerian orbits and the symplectic integrators of §2.5 — is realized through the second-order emergent symplectic substrate (Hamiltonian flow), not through the first-order nodal equation alone. Both regimes are empirically grounded but structurally distinct; see ../AGENTS.md §"Smooth-Trajectory Correspondence" and §"Emergent Symplectic Substrate".
| Classical force | TNFR mechanism | Telemetry observable |
|---|---|---|
| Gravity | Phase-coherence gradient | along trajectories |
| Friction | Coherence stabilizer (IL operator) | Reduction of high-frequency |
| Harmonic restoring | Phase-gradient confinement | $ |
Symplectic integrators (Verlet/Yoshida 4th-order) in src/tnfr/dynamics/symplectic.py preserve structural invariants analogously to Liouville's theorem.
Workflow:
Kepler benchmark (examples/02_physics_regimes/12_classical_mechanics_demo.py): single node in coherence-gradient potential approximating an ellipse with eccentricity . Artifacts include trajectory overlays, phase-space loops, and conservation plots (energy/angular momentum drift target ).
Practical checklist:
With zero , the structural state is frozen and nodes translate uniformly. This is the TNFR analog of Newton's first law: no reorganization pressure implies no change in the structural trajectory.
Two-train benchmark (examples/02_physics_regimes/15_train_crossing_demo.py):
| Parameter | Train A | Train B |
|---|---|---|
| Initial position | km | km |
| Velocity | km/h | km/h |
| Operators | [AL, IL, SHA] | [AL, IL, SHA] |
Analytical prediction:
Numerical runs match within integration tolerance (); larger deviations indicate unintended structural forces.
High phase gradient (), boundary reflections, or proximity to phase singularities (vortices). The classical approximation breaks down; discrete resonant modes emerge.
| Quantum quantity | Symbol | TNFR analogue | Notes |
|---|---|---|---|
| Wavefunction | Complex field | Curvature + current components | |
| Energy | Structural frequency | Domain-specific proportionality | |
| Potential | Identical boundary conditions | ||
| Quantum number | Winding number | ||
| Collapse | — | Decoherence via IL/SHA | Grammar U2 enforcement |
Quantized spectra arise from the boundary conditions and resonant mode selection described above, without invoking additional axioms beyond the nodal equation. Superposition of EPI states is the default behavior of linear wave dynamics; "collapse" is the decoherence process where environmental coupling selects eigenstates (grammar rule U2).
One-dimensional cavity benchmark (examples/02_physics_regimes/13_quantum_mechanics_demo.py): define cavity length , initialize with random and phase profile (), integrate until converges. Expected outcome: discrete proportional to (linear dispersion) or (other media).
For wave packets occupying time window with structural frequency spread :
where depends on the analysis window (Gaussian packets yield ). This emerges from the Fourier relationship between form (EPI) and frequency (): localizing a pattern in structural space increases its frequency spread, and conversely.
The double-slit experiment maps to two emission nodes executing [AL, RA] into a propagation medium. Receiving nodes integrate and report per-pixel telemetry:
Interference is described entirely through phase-coupled dynamics. No wave/particle duality narrative is invoked; only structural metrics.
examples/02_physics_regimes/14_uncertainty_and_interference.py generates: scatter of vs. with constant-product reference line, 2D detector intensity maps, and fringe-spacing line profiles.
Note: The example demonstrates qualitative uncertainty behavior (constant product) but does not validate the product against a specific analytical bound. The double-slit section is incomplete. No dedicated test module exists.
Note: This section describes a demonstration-level correspondence. The example
17_thermodynamics_demo.pyimplements a Kuramoto model where "temperature" is defined as , but does not extract a time constant or validate quantitatively against Newton's law of cooling. No dedicated test module exists. Promotion to verified status requires: (a) extraction of decay constant from simulation, (b) quantitative comparison with the analytical form , and (c) a dedicated test file.
| Thermodynamic quantity | TNFR interpretation | Symbol |
|---|---|---|
| Heat () | Incoherent phase noise | |
| Temperature () | Local phase-gradient variance | $\mathrm{Var}( |
| Entropy () | Structural decoherence | |
| Equilibrium | Phase synchronization |
If node A and node C satisfy , and node B satisfies the same relation with C, then automatically respects the bound. Coupling operators (UM, RA) enforce this check before activation per grammar rule U3.
Structural current is conserved up to explicit operator work:
In closed experiments, the sum over remains constant. This accounts for how resonance-preserving work (coherent) and decohering work (incoherent) partition the same nodal update.
Without stabilizers (IL, THOL), random perturbations drive the network toward larger and reduced coherence. Operators lacking closure steps predictably lose , producing the familiar time arrow without additional hypotheses.
Coffee-cup cooling benchmark: 2D lattice with a high-, random-phase central patch (sample) surrounded by an aligned-phase, low- outer ring (bath). Dynamics follow the coupled-oscillator form:
The phase-gradient mismatch decays exponentially:
obtaining a form analogous to Newton's law of cooling from nodal dynamics.
The five regimes form a coherent hierarchy indexed by the degree of structural dissonance:
| Regime | | | Primary telemetry | Governing reduction | |--------|---------------------|----------------|-------------------|-------------------| | Inertial | | | (momentum) | Constant velocity | | Classical mechanics | Low | | , | | | Thermodynamic | Distributed | Moderate | , | Cooling laws | | Quantum | High | | , winding number | Discrete eigenvalues | | Uncertainty | High + localized | Broadband | product | Fourier bound |
All regimes emerge from the same nodal equation as limiting cases under different parameter conditions. The correspondences to established physics are structural analogies that demonstrate the internal consistency of the TNFR formalism, not derivations of those physical theories from first principles.
| Component | Location |
|---|---|
| Classical mechanics mapper | src/tnfr/physics/classical_mechanics.py |
| Quantum mechanics module | src/tnfr/physics/quantum_mechanics.py |
| Symplectic integrators | src/tnfr/dynamics/symplectic.py |
| Structural field computation | src/tnfr/physics/fields.py |
| Kepler benchmark | examples/02_physics_regimes/12_classical_mechanics_demo.py |
| Quantum cavity benchmark | examples/02_physics_regimes/13_quantum_mechanics_demo.py |
| Uncertainty/interference | examples/02_physics_regimes/14_uncertainty_and_interference.py |
| Two-train kinematics | examples/02_physics_regimes/15_train_crossing_demo.py |
Originally
docs/TNFR_CLASSICAL_MAPPING.md. Consolidated here as the canonical mapping reference.
Scope: Applies to low-dissonance, high-coherence regimes where TNFR reproduces Newtonian behavior (see src/tnfr/dynamics/nbody.py).
| TNFR Quantity | Definition (TNFR) | Classical Analog | Notes |
|---|---|---|---|
| EPI | Coherent form (spatial + kinematic state) | Generalized coordinates , velocities | Structural Triad |
| νf | Reorganization rate (Hz_str) | Inertial mass via | High νf → low inertia |
| ΔNFR | Structural pressure | Generalized force | Hamiltonian-derived |
| Φ_s | Inverse-square ΔNFR accumulation | Potential energy | U6 confinement ↔ potential wells |
| |∇φ| | Local desynchronization | Stress/strain rate, tidal gradients | Shear force analog |
| K_φ | Phase torsion | Curvature-induced forces (centripetal) | Geometric confinement |
| ξ_C | Correlation decay scale | Interaction range / mean free path | Large ξ_C → long-range forces |
| Ψ = K_φ + i·J_φ | Complex geometric field | Complexified action density | Hamilton-Jacobi analog |
| Operator sequences | Canonical transformations | Work/impulse protocols | Grammar U1-U6 ↔ mechanical admissibility |
Structural Triad ↔ Phase Space:
Field Tetrad ↔ Energetics:
| Example | Concept from this document |
|---|---|
| 11_classical_limit_comparison.py | TNFR vs classical N-body comparison |
| 12_classical_mechanics_demo.py | Keplerian orbits from symplectic integrator |
| 13_quantum_mechanics_demo.py | Emergent quantization from resonant standing waves |
| 14_uncertainty_and_interference.py | Structural uncertainty (ΔForm·Δνf ≥ K), double slit |
| 15_train_crossing_demo.py | Free-particle classical kinematics |
src/tnfr/physics/classical_mechanics.py — Classical limit (Keplerian orbits, Newton's laws)src/tnfr/physics/quantum_mechanics.py — Quantum regime (quantization, superposition)