tnfr 4.1.0__py3-none-any.whl → 4.5.0__py3-none-any.whl

tnfr/sense.py

@@ -4,7 +4,7 @@ import math
 from collections import Counter
 
 from .constants import DEFAULTS, ALIAS_SI, ALIAS_EPI
-from .helpers import _get_attr, clamp01, register_callback
+from .helpers import _get_attr, clamp01, register_callback, ensure_history, last_glifo
 
 # -------------------------
 # Canon: orden circular de glifos y ángulos
@@ -60,23 +60,14 @@ def _weight(G, n, mode: str) -> float:
     return 1.0
 
 
-def _last_glifo(nd: Dict[str, Any]) -> str | None:
-    hist = nd.get("hist_glifos")
-    if not hist:
-        return None
-    try:
-        return list(hist)[-1]
-    except Exception:
-        return None
-
-
+    
 # -------------------------
 # σ por nodo y σ global
 # -------------------------
 
 def sigma_vector_node(G, n, weight_mode: str | None = None) -> Dict[str, float] | None:
     nd = G.nodes[n]
-    g = _last_glifo(nd)
+    g = last_glifo(nd)
     if g is None:
         return None
     w = _weight(G, n, weight_mode or G.graph.get("SIGMA", DEFAULTS["SIGMA"]).get("weight", "Si"))
@@ -120,17 +111,11 @@ def sigma_vector_global(G, weight_mode: str | None = None) -> Dict[str, float]:
 # Historia / series
 # -------------------------
 
-def _ensure_history(G):
-    if "history" not in G.graph:
-        G.graph["history"] = {}
-    return G.graph["history"]
-
-
 def push_sigma_snapshot(G, t: float | None = None) -> None:
     cfg = G.graph.get("SIGMA", DEFAULTS["SIGMA"])
     if not cfg.get("enabled", True):
         return
-    hist = _ensure_history(G)
+    hist = ensure_history(G)
     key = cfg.get("history_key", "sigma_global")
 
     # Global
@@ -153,7 +138,7 @@ def push_sigma_snapshot(G, t: float | None = None) -> None:
     # Conteo de glifos por paso (útil para rosa glífica)
     counts = Counter()
     for n in G.nodes():
-        g = _last_glifo(G.nodes[n])
+        g = last_glifo(G.nodes[n])
         if g:
             counts[g] += 1
     hist.setdefault("sigma_counts", []).append({"t": sv["t"], **counts})
@@ -163,7 +148,7 @@ def push_sigma_snapshot(G, t: float | None = None) -> None:
         per = hist.setdefault("sigma_per_node", {})
         for n in G.nodes():
             nd = G.nodes[n]
-            g = _last_glifo(nd)
+            g = last_glifo(nd)
             if not g:
                 continue
             a = glyph_angle(g)

tnfr/structural.py

@@ -0,0 +1,201 @@
+from __future__ import annotations
+"""API de operadores estructurales y secuencias TNFR.
+
+Este módulo ofrece:
+    - Factoría `create_nfr` para inicializar redes/nodos TNFR.
+    - Clases de operador (`Operador` y derivados) con interfaz común.
+    - Registro de operadores `OPERADORES`.
+    - Utilidades `validate_sequence` y `run_sequence` para ejecutar
+      secuencias canónicas de operadores.
+"""
+from typing import Iterable, Tuple, List
+import networkx as nx
+
+from .dynamics import (
+    set_delta_nfr_hook,
+    update_epi_via_nodal_equation,
+    dnfr_epi_vf_mixed,
+)
+from .operators import aplicar_glifo
+from .constants import ALIAS_EPI, ALIAS_VF, ALIAS_THETA
+
+
+# ---------------------------------------------------------------------------
+# 1) Factoría NFR
+# ---------------------------------------------------------------------------
+
+def create_nfr(
+    name: str,
+    *,
+    epi: float = 0.0,
+    vf: float = 1.0,
+    theta: float = 0.0,
+    graph: nx.Graph | None = None,
+    dnfr_hook=dnfr_epi_vf_mixed,
+) -> Tuple[nx.Graph, str]:
+    """Crea una red (graph) con un nodo NFR inicializado.
+
+    Devuelve la tupla ``(G, name)`` para conveniencia.
+    """
+    G = graph or nx.Graph()
+    G.add_node(
+        name,
+        **{
+            ALIAS_EPI[0]: float(epi),
+            ALIAS_VF[0]: float(vf),
+            ALIAS_THETA[0]: float(theta),
+        }
+    )
+    set_delta_nfr_hook(G, dnfr_hook)
+    return G, name
+
+
+# ---------------------------------------------------------------------------
+# 2) Operadores estructurales como API de primer orden
+# ---------------------------------------------------------------------------
+
+
+class Operador:
+    """Base para operadores TNFR.
+
+    Cada operador define ``name`` (identificador ASCII) y ``glyph`` (glifo
+    canónico). La llamada ejecuta el glifo correspondiente sobre el nodo.
+    """
+
+    name = "operador"
+    glyph = None  # tipo: str
+
+    def __call__(self, G: nx.Graph, node, **kw) -> None:
+        if self.glyph is None:
+            raise NotImplementedError("Operador sin glifo asignado")
+        aplicar_glifo(G, node, self.glyph, **kw)
+
+
+# Derivados concretos -------------------------------------------------------
+class Emision(Operador):
+    name = "emision"
+    glyph = "A’L"
+
+
+class Recepcion(Operador):
+    name = "recepcion"
+    glyph = "E’N"
+
+
+class Coherencia(Operador):
+    name = "coherencia"
+    glyph = "I’L"
+
+
+class Disonancia(Operador):
+    name = "disonancia"
+    glyph = "O’Z"
+
+
+class Acoplamiento(Operador):
+    name = "acoplamiento"
+    glyph = "U’M"
+
+
+class Resonancia(Operador):
+    name = "resonancia"
+    glyph = "R’A"
+
+
+class Silencio(Operador):
+    name = "silencio"
+    glyph = "SH’A"
+
+
+class Expansion(Operador):
+    name = "expansion"
+    glyph = "VA’L"
+
+
+class Contraccion(Operador):
+    name = "contraccion"
+    glyph = "NU’L"
+
+
+class Autoorganizacion(Operador):
+    name = "autoorganizacion"
+    glyph = "T’HOL"
+
+
+class Mutacion(Operador):
+    name = "mutacion"
+    glyph = "Z’HIR"
+
+
+class Transicion(Operador):
+    name = "transicion"
+    glyph = "NA’V"
+
+
+class Recursividad(Operador):
+    name = "recursividad"
+    glyph = "RE’MESH"
+
+
+OPERADORES = {
+    op().name: op
+    for op in [
+        Emision,
+        Recepcion,
+        Coherencia,
+        Disonancia,
+        Acoplamiento,
+        Resonancia,
+        Silencio,
+        Expansion,
+        Contraccion,
+        Autoorganizacion,
+        Mutacion,
+        Transicion,
+        Recursividad,
+    ]
+}
+
+
+# ---------------------------------------------------------------------------
+# 3) Motor de secuencias + validador sintáctico
+# ---------------------------------------------------------------------------
+
+
+_INICIO_VALIDOS = {"emision", "recursividad"}
+_TRAMO_INTERMEDIO = {"disonancia", "acoplamiento", "resonancia"}
+_CIERRE_VALIDO = {"silencio", "transicion", "recursividad"}
+
+
+def validate_sequence(nombres: List[str]) -> Tuple[bool, str]:
+    """Valida reglas mínimas de la sintaxis TNFR."""
+    if not nombres:
+        return False, "secuencia vacía"
+    if nombres[0] not in _INICIO_VALIDOS:
+        return False, "debe iniciar en emisión o recursividad"
+    try:
+        i_rec = nombres.index("recepcion")
+        i_coh = nombres.index("coherencia", i_rec + 1)
+    except ValueError:
+        return False, "falta tramo entrada→coherencia"
+    if not any(n in _TRAMO_INTERMEDIO for n in nombres[i_coh + 1 :]):
+        return False, "falta tramo de tensión/acoplamiento/resonancia"
+    if not any(n in _CIERRE_VALIDO for n in nombres[-2:]):
+        return False, "falta cierre (silencio/transición/recursividad)"
+    return True, "ok"
+
+
+def run_sequence(G: nx.Graph, node, ops: Iterable[Operador]) -> None:
+    """Ejecuta una secuencia validada de operadores sobre el nodo dado."""
+    ops_list = list(ops)
+    nombres = [op.name for op in ops_list]
+    ok, msg = validate_sequence(nombres)
+    if not ok:
+        raise ValueError(f"Secuencia no válida: {msg}")
+    for op in ops_list:
+        op(G, node)
+        compute = G.graph.get("compute_delta_nfr")
+        if callable(compute):
+            compute(G)
+        update_epi_via_nodal_equation(G)
+

tnfr/trace.py

@@ -3,7 +3,7 @@ from typing import Any, Dict, List, Optional
 from collections import Counter
 
 from .constants import DEFAULTS
-from .helpers import register_callback
+from .helpers import register_callback, ensure_history, last_glifo
 
 try:
     from .gamma import kuramoto_R_psi
@@ -30,22 +30,6 @@ DEFAULTS.setdefault("TRACE", {
 # Helpers
 # -------------------------
 
-def _ensure_history(G):
-    if "history" not in G.graph:
-        G.graph["history"] = {}
-    return G.graph["history"]
-
-
-def _last_glifo(nd: Dict[str, Any]) -> str | None:
-    h = nd.get("hist_glifos")
-    if not h:
-        return None
-    try:
-        return list(h)[-1]
-    except Exception:
-        return None
-
-
 # -------------------------
 # Snapshots
 # -------------------------
@@ -55,7 +39,7 @@ def _trace_before(G, *args, **kwargs):
         return
     cfg = G.graph.get("TRACE", DEFAULTS["TRACE"])
     capture: List[str] = list(cfg.get("capture", []))
-    hist = _ensure_history(G)
+    hist = ensure_history(G)
     key = cfg.get("history_key", "trace_meta")
 
     meta: Dict[str, Any] = {"t": float(G.graph.get("_t", 0.0)), "phase": "before"}
@@ -103,7 +87,7 @@ def _trace_after(G, *args, **kwargs):
         return
     cfg = G.graph.get("TRACE", DEFAULTS["TRACE"])
     capture: List[str] = list(cfg.get("capture", []))
-    hist = _ensure_history(G)
+    hist = ensure_history(G)
     key = cfg.get("history_key", "trace_meta")
 
     meta: Dict[str, Any] = {"t": float(G.graph.get("_t", 0.0)), "phase": "after"}
@@ -119,7 +103,7 @@ def _trace_after(G, *args, **kwargs):
     if "glifo_counts" in capture:
         cnt = Counter()
         for n in G.nodes():
-            g = _last_glifo(G.nodes[n])
+            g = last_glifo(G.nodes[n])
             if g:
                 cnt[g] += 1
         meta["glifos"] = dict(cnt)

tnfr/types.py

@@ -9,9 +9,10 @@ class NodeState:
     vf: float = 1.0   # νf
     theta: float = 0.0  # θ
     Si: float = 0.5
+    epi_kind: str = ""
     extra: Dict[str, Any] = field(default_factory=dict)
 
     def to_attrs(self) -> Dict[str, Any]:
-        d = {"EPI": self.EPI, "νf": self.vf, "θ": self.theta, "Si": self.Si}
+        d = {"EPI": self.EPI, "νf": self.vf, "θ": self.theta, "Si": self.Si, "EPI_kind": self.epi_kind}
         d.update(self.extra)
         return d

tnfr/validators.py

@@ -0,0 +1,38 @@
+"""Validadores de invariantes TNFR."""
+
+from __future__ import annotations
+from typing import Iterable
+
+from .constants import ALIAS_EPI, DEFAULTS
+from .helpers import _get_attr
+from .sense import sigma_vector_global, GLYPHS_CANONICAL
+from .helpers import last_glifo
+
+
+def _validate_epi(G) -> None:
+    emin = float(G.graph.get("EPI_MIN", DEFAULTS.get("EPI_MIN", -1.0)))
+    emax = float(G.graph.get("EPI_MAX", DEFAULTS.get("EPI_MAX", 1.0)))
+    for n in G.nodes():
+        x = float(_get_attr(G.nodes[n], ALIAS_EPI, 0.0))
+        if not (emin - 1e-9 <= x <= emax + 1e-9):
+            raise ValueError(f"EPI fuera de rango en nodo {n}: {x}")
+
+
+def _validate_sigma(G) -> None:
+    sv = sigma_vector_global(G)
+    if sv.get("mag", 0.0) > 1.0 + 1e-9:
+        raise ValueError("Norma de σ excede 1")
+
+
+def _validate_glifos(G) -> None:
+    for n in G.nodes():
+        g = last_glifo(G.nodes[n])
+        if g and g not in GLYPHS_CANONICAL:
+            raise ValueError(f"Glifo inválido {g} en nodo {n}")
+
+
+def run_validators(G) -> None:
+    """Ejecuta todos los validadores de invariantes sobre ``G``."""
+    _validate_epi(G)
+    _validate_sigma(G)
+    _validate_glifos(G)

{tnfr-4.1.0.dist-info → tnfr-4.5.0.dist-info}/METADATA

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: tnfr
-Version: 4.1.0
-Summary: TNFR canónica: dinámica glífica modular sobre redes.
+Version: 4.5.0
+Summary: Canonical TNFR: modular glyph-based dynamics on networks.
 Author: fmg
 License: MIT
 Project-URL: Homepage, https://pypi.org/project/tnfr/
 Project-URL: Repository, https://github.com/fermga/Teoria-de-la-naturaleza-fractal-resonante-TNFR-
-Keywords: TNFR,fractal resonante,resonancia,glifos,networkx,dinámica,coherencia,EPI,Kuramoto
+Keywords: TNFR,resonant fractal,resonance,glyphs,networkx,dynamics,coherence,EPI,Kuramoto
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.9
@@ -25,7 +25,13 @@ License-File: LICENSE.md
 Requires-Dist: networkx>=2.6
 Dynamic: license-file
 
-# General Project Structure
+# TNFR Python Project
+
+Reference implementation of the Resonant Fractal Nature Theory (TNFR).
+It models glyph-driven dynamics on NetworkX graphs, providing a modular
+engine to simulate coherent reorganization processes.
+
+## General Project Structure
 
 * **Package entry point.** `__init__.py` registers modules under short names to avoid circular imports and exposes the public API: `preparar_red`, `step`, `run`, and observation utilities.
 

tnfr-4.5.0.dist-info/RECORD

@@ -0,0 +1,28 @@
+tnfr/__init__.py,sha256=c3fypVJdVZeV-AEZEPsr4NZZRwH9reGEBwoNnT9dP88,2788
+tnfr/cli.py,sha256=7OR3dlWUVjEKVH_itH-zYq8WQculXwSdCDDvmQH15kY,14372
+tnfr/config.py,sha256=bFc5AnLVoF0oUrSedAi5WpD6oCvn4hhLHO7WGgslg2M,1303
+tnfr/constants.py,sha256=XoUlTuUaQgQ6BbHzKSIHijqRMf9Gb3Avjo7_CLicgps,11570
+tnfr/dynamics.py,sha256=An0MlAJVhCy5uCQsl3c_PZKdAKBZojgRCnTAQzfaahg,32799
+tnfr/gamma.py,sha256=U1yXbv4ef9VSwXirjRlcwdNr78Ah5LstAsg5WIkRQxY,4083
+tnfr/grammar.py,sha256=vz5F0P3IfvA6HassRcoD327hBP5vCUw-xPSTsPmqwhQ,5363
+tnfr/helpers.py,sha256=KT9_CAz3Z-WRKdARyGnsQ16m-p2z-l1-Y6UhVyY8tcU,8323
+tnfr/main.py,sha256=XqjI1YEdF-OqRzTMa5dYIxCig4qyAR-l1FPcyxpC8WY,1926
+tnfr/metrics.py,sha256=MTp0YifWdycW-jUFWhvxbJx-labWUR0thTnS0sxifrg,20259
+tnfr/node.py,sha256=A3nlaW_lwG0Q1dj6HPmyjfccWfZt4rwnzqPxTglu-Sk,6184
+tnfr/observers.py,sha256=PTw3hxk7KD-Yx_CvCIU09icuhyYD6uNU6SvF80UvP-Y,5354
+tnfr/ontosim.py,sha256=9GfEtiLIdJOPJUTufcq_MssAA9J8AfChHU6HKb3DIJY,5628
+tnfr/operators.py,sha256=TSY2LNIC-um3iSwniYiyu6oumnDwiES2zwb2B7ZbEZE,20536
+tnfr/presets.py,sha256=qFuDxlexc_kw--3VRaOx3cfyL6vPEOX_UVsJd2DNWAE,998
+tnfr/program.py,sha256=eim7D8zsbbkGDWbODag-0VKG44jEYioX4Sl6KRwgVtw,6038
+tnfr/scenarios.py,sha256=QkUdCHp5R5T44fgfGppJ8dHzZa6avdNTNsYJbya_7XM,1165
+tnfr/sense.py,sha256=9ABkqHjwu5pxoakddZwANpp9xy_NNo4frm9NGTg1GXQ,6482
+tnfr/structural.py,sha256=hE5_l7cuiPad9AuFVrFtnkJ8A8eL_e69gUN5VknkQiI,5155
+tnfr/trace.py,sha256=e_xdOOMZ5rqXOcdw99h8X1RnVuf_s9AeTzncqS551hE,4735
+tnfr/types.py,sha256=CnSwzzh9d0WgqB128y71iNWiiAA7Sf-eJ_v1xHMAwLo,507
+tnfr/validators.py,sha256=tCsz9A8OvEKiBZX9wvvri_C894XXdWfkbEZ6qqpcdNg,1169
+tnfr-4.5.0.dist-info/licenses/LICENSE.md,sha256=SRvvhXLrKtseuK6DARbuJffuXOXqAyk3wvF2n0t1SWA,1109
+tnfr-4.5.0.dist-info/METADATA,sha256=k7dlvh_IujIeTJfUfQXvCV9h6RbbtQvIbsJ3ylKUHTo,6301
+tnfr-4.5.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+tnfr-4.5.0.dist-info/entry_points.txt,sha256=j4-QRHqeT2WnchHe_mvK7npGTLjlyfLpvRONFe9Z4MU,39
+tnfr-4.5.0.dist-info/top_level.txt,sha256=Q2HJnvc5Rt2VHwVvyBTnNPT4SfmJWnCj7XUxxEvQa7c,5
+tnfr-4.5.0.dist-info/RECORD,,

tnfr-4.1.0.dist-info/RECORD

@@ -1,24 +0,0 @@
-tnfr/__init__.py,sha256=93fkcY9lteZyKkZuWJAB-hvDEE2q0ZYgk16qCBXe50A,1988
-tnfr/cli.py,sha256=PVU95Iik_3bn-4UrLr8H7HHGme1X0qYnTuVv_AOp9FA,7484
-tnfr/constants.py,sha256=EPFW7howB2IsyeGRc8hyzO3s6sgRkM78lWB7S3BJXq4,9147
-tnfr/dynamics.py,sha256=SIf6cTj6_Wd6DRKJRYjE-iBuaxfDRpHu-j14wzlB-J0,25598
-tnfr/gamma.py,sha256=Ccsr2yKA7f8VlVqKgckQpGAEISlBw8i3FBeNPxfS-AQ,3048
-tnfr/grammar.py,sha256=vz5F0P3IfvA6HassRcoD327hBP5vCUw-xPSTsPmqwhQ,5363
-tnfr/helpers.py,sha256=CPEBkmFY6S4DKBf91EqW5vW_jTokOzg3HojCx28KxTU,7327
-tnfr/main.py,sha256=XqjI1YEdF-OqRzTMa5dYIxCig4qyAR-l1FPcyxpC8WY,1926
-tnfr/metrics.py,sha256=XusywHo1-GgLqYy1Jz43Xc4zRsggrn_DwoaFWfAy82M,6640
-tnfr/observers.py,sha256=PTw3hxk7KD-Yx_CvCIU09icuhyYD6uNU6SvF80UvP-Y,5354
-tnfr/ontosim.py,sha256=9GfEtiLIdJOPJUTufcq_MssAA9J8AfChHU6HKb3DIJY,5628
-tnfr/operators.py,sha256=QYsGf9R3lr8WdR0kanLqGYqZ-Lw-RWzjqKKTczgtyEw,13741
-tnfr/presets.py,sha256=rN6kDnI59DfYCL0YuYQr0yEu8jZaCFezGBnIWn6HFn8,737
-tnfr/program.py,sha256=eim7D8zsbbkGDWbODag-0VKG44jEYioX4Sl6KRwgVtw,6038
-tnfr/scenarios.py,sha256=FgsXzA6ENRkalENnG5ZuBNFguEGaKZTM6y0quW5fJI4,808
-tnfr/sense.py,sha256=1yVlphcs4o_uOQ51MDqW9dphydMiDNKv1Z1EdgbJgpU,6778
-tnfr/trace.py,sha256=bY0GU5I5yvHKSDOUQ0m5ICaXScYHzCM5xOWqTO68VO0,5026
-tnfr/types.py,sha256=xyFHp0PptEqPNUekAFH6DcAnyMx4bCQutMyFUXMd2sA,457
-tnfr-4.1.0.dist-info/licenses/LICENSE.md,sha256=SRvvhXLrKtseuK6DARbuJffuXOXqAyk3wvF2n0t1SWA,1109
-tnfr-4.1.0.dist-info/METADATA,sha256=cuR46do-ZJA5_OiZy4MNCwwbsEAi6DYD0HcRVTTYIz8,6075
-tnfr-4.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-tnfr-4.1.0.dist-info/entry_points.txt,sha256=j4-QRHqeT2WnchHe_mvK7npGTLjlyfLpvRONFe9Z4MU,39
-tnfr-4.1.0.dist-info/top_level.txt,sha256=Q2HJnvc5Rt2VHwVvyBTnNPT4SfmJWnCj7XUxxEvQa7c,5
-tnfr-4.1.0.dist-info/RECORD,,