TNFR Python Engine

Reference implementation of Resonant Fractal Nature Theory

Physics-grounded structural modeling with reproducible telemetry

TNFR Python Engine is the canonical repository for Resonant Fractal Nature Theory (TNFR). The branch stores the executable nodal equation, the 13 canonical operators, and the structural field tetrad so that the sequences described in AGENTS.md, UNIFIED_GRAMMAR_RULES.md, and the theory notebooks can be executed without speculative additions.

Current reference snapshot — November 2025

AGENTS guide (v0.0.2) captures the TNFR Development Doctrine, canonical invariants, and agent workflow.
Glossary updates keep the terminology aligned with unified grammar constraints and avoid ambiguous metaphors.
Geocentric Vortex Cosmology notes document the structural constraints used by the celestial demonstrations and link back to the nodal derivations.
Physics module README and the benchmark guide describe the structural field tetrad pipeline plus the σ-critical validation track introduced in 2025-11.

Core formalism

Every TNFR node evolves according to the nodal equation. EPI structures are only modified through operator sequences, and telemetry always exposes C(t), Si, νf, φ, and ΔNFR so experiments remain reproducible.

∂EPI/∂t = νf · ΔNFR(t)

The structural field tetrad adds four complementary monitors:

Φ_s — structural potential confinement (U6)
|∇φ| — local phase gradient and stress proxy
K_φ + i·J_φ — complex geometric field Ψ capturing curvature and transport
ξ_C — coherence length that estimates correlation decay

Canonical structures

Structural triad

Form (EPI), structural frequency νf, and phase φ/θ define the state of each node. νf → 0 deactivates the node while ΔNFR = 0 indicates equilibrium.

Operator grammar

The 13 operators (AL through REMESH) are validated against U1–U6. Destabilizers must be paired with stabilizers, and resonant coupling enforces |φᵢ - φⱼ| ≤ Δφ_max.

Structural field tetrad

Φ_s, |∇φ|, Ψ, and ξ_C became canonical in November 2025 and provide quantitative bounds for stability, bifurcations, and correlation scales.

Resonant coupling

Coupling and resonance operators propagate patterns only when phases are compatible. The implementation records phase telemetry per edge to support audits.

Self-optimizing engine

The self-optimization module evaluates Ψ, chirality χ, and symmetry-breaking scores to pick operator sequences that reduce ΔNFR without violating grammar.

TNFR-Riemann program

The σ-critical benchmark (H^{(k)}(σ) = L_k + V_σ) tracks eigenvalue transitions approaching σ = 1/2 with telemetry exported via benchmarks/riemann_program.py.

Reference navigation

AGENTS guide — theoretical commitments, operating doctrine, and agent playbook.
Unified grammar rules — derivations of U1–U6 from the nodal equation.
Structural field tetrad — definitions, thresholds, and experiments confirming Φ_s, |∇φ|, Ψ, and ξ_C.
Troubleshooting reference — diagnostics for phase drift, bifurcations, and telemetry validation.
Scalability notes — guidance for large topologies and GPU-backed computation.

Applications & validation

Sigma-critical benchmark: benchmarks/riemann_program.py reproduces the TNFR-Riemann study with full telemetry export.
Structural field telemetry: src/tnfr/physics/fields.py computes Φ_s, |∇φ|, Ψ, and ξ_C for every example and includes safety checks promoted to canonical status.
Celestial and vortex demos: examples/20_celestial_cycles_demo.py through examples/26_analemma_simulation.py use the constraints summarized in THE_GEOCENTRIC_VORTEX_COSMOLOGY.md.
Coherence tracking: examples/05_coherence_evolution.py and examples/10_simplified_sdk_showcase.py illustrate how C(t) and Si respond to operator sequences.

Work directly with the reference implementation

Review the source, run the tests, and use the SDK to model coherent structures.

View on GitHub Install from PyPI

TNFR Python Engine

Implementación de referencia de la Teoría de la Naturaleza Fractal Resonante

Modelado estructural fundamentado en física con telemetría reproducible

TNFR Python Engine es el repositorio canónico de la TNFR. El proyecto conserva la ecuación nodal ejecutable, los 13 operadores canónicos y la tétrada de campos estructurales para que las secuencias descritas en AGENTS.md, UNIFIED_GRAMMAR_RULES.md y las notas teóricas se puedan ejecutar sin añadir suposiciones externas.

Instantánea de referencia — noviembre de 2025

Guía de agentes (v0.0.2) recoge la Doctrina de Desarrollo TNFR, los invariantes canónicos y el flujo de trabajo para agentes.
Actualizaciones del glosario mantienen la terminología alineada con la gramática unificada y evitan metáforas ambiguas.
Notas de cosmología del vórtice geocéntrico documentan las restricciones estructurales empleadas por las demostraciones celestes y remiten a las derivaciones nodales.
README del módulo de física y la guía de benchmarks describen la canalización de la tétrada y el recorrido σ-crítico incorporado en 2025-11.

Formalismo central

Cada nodo TNFR evoluciona mediante la ecuación nodal. Las estructuras EPI solo cambian mediante secuencias de operadores y la telemetría siempre expone C(t), Si, νf, φ y ΔNFR para mantener la reproducibilidad.

∂EPI/∂t = νf · ΔNFR(t)

La tétrada de campos estructurales añade cuatro monitores complementarios:

Φ_s — confinamiento del potencial estructural (U6)
|∇φ| — gradiente de fase local y proxy de esfuerzo
K_φ + i·J_φ — campo geométrico complejo Ψ que captura curvatura y transporte
ξ_C — longitud de coherencia que estima la atenuación de correlaciones

Estructuras canónicas

Tríada estructural

La forma (EPI), la frecuencia estructural νf y la fase φ/θ definen el estado de cada nodo. νf → 0 lo desactiva mientras que ΔNFR = 0 indica equilibrio.

Gramática de operadores

Los 13 operadores (AL hasta REMESH) se validan frente a U1–U6. Los desestabilizadores deben acompañarse de estabilizadores y el acoplamiento resonante respeta |φᵢ - φⱼ| ≤ Δφ_max.

Tétrada de campos

Φ_s, |∇φ|, Ψ y ξ_C alcanzaron estatus canónico en noviembre de 2025 y entregan cotas cuantitativas para estabilidad, bifurcaciones y escalas de correlación.

Acoplamiento resonante

Los operadores de acoplamiento y resonancia solo propagan patrones cuando las fases son compatibles. La implementación registra la telemetría de fase por arista para facilitar auditorías.

Motor de auto-optimización

El motor de auto-optimización evalúa Ψ, la quiralidad χ y los indicadores de ruptura de simetría para elegir secuencias que reduzcan ΔNFR sin violar la gramática.

Programa TNFR-Riemann

El benchmark σ-crítico (H^{(k)}(σ) = L_k + V_σ) sigue las transiciones de autovalores que convergen a σ = 1/2 con telemetría exportada por benchmarks/riemann_program.py.

Navegación de referencia

Guía de agentes — compromisos teóricos, doctrina operativa y manual para agentes.
Gramática unificada — derivaciones de U1–U6 a partir de la ecuación nodal.
Tétrada de campos — definiciones, umbrales y experimentos que validan Φ_s, |∇φ|, Ψ y ξ_C.
Guía de diagnóstico — procedimientos para deriva de fase, bifurcaciones y verificación de telemetría.
Notas de escalabilidad — recomendaciones para topologías grandes y cómputo con GPU.

Aplicaciones y validación

Benchmark σ-crítico: benchmarks/riemann_program.py reproduce el estudio TNFR-Riemann con exportación completa de telemetría.
Telemetría de campos: src/tnfr/physics/fields.py calcula Φ_s, |∇φ|, Ψ y ξ_C para todos los ejemplos e incluye verificaciones promovidas a canónicas.
Demos celestes y de vórtices: examples/20_celestial_cycles_demo.py a examples/26_analemma_simulation.py emplean las restricciones descritas en THE_GEOCENTRIC_VORTEX_COSMOLOGY.md.
Seguimiento de coherencia: examples/05_coherence_evolution.py y examples/10_simplified_sdk_showcase.py muestran cómo reaccionan C(t) y Si ante cada secuencia.

Trabaje directamente con la implementación de referencia

Revise el código fuente, ejecute las pruebas y utilice el SDK para modelar estructuras coherentes.

Ver en GitHub Instalar desde PyPI