tnfr 4.5.1__py3-none-any.whl → 4.5.2__py3-none-any.whl

tnfr/scenarios.py

@@ -1,34 +0,0 @@
-from __future__ import annotations
-from typing import Any
-import random
-import networkx as nx
-
-from .constants import inject_defaults, DEFAULTS
-
-
-def build_graph(n: int = 24, topology: str = "ring", seed: int | None = 1):
-    rng = random.Random(seed)
-    if topology == "ring":
-        G = nx.cycle_graph(n)
-    elif topology == "complete":
-        G = nx.complete_graph(n)
-    elif topology == "erdos":
-        G = nx.gnp_random_graph(n, 3.0 / n, seed=seed)
-    else:
-        G = nx.path_graph(n)
-
-    # Valores canónicos para inicialización
-    inject_defaults(G, DEFAULTS)
-    vf_min = float(G.graph.get("VF_MIN", DEFAULTS["VF_MIN"]))
-    vf_max = float(G.graph.get("VF_MAX", DEFAULTS["VF_MAX"]))
-    th_min = float(G.graph.get("INIT_THETA_MIN", DEFAULTS.get("INIT_THETA_MIN", -3.1416)))
-    th_max = float(G.graph.get("INIT_THETA_MAX", DEFAULTS.get("INIT_THETA_MAX", 3.1416)))
-
-    for i in G.nodes():
-        nd = G.nodes[i]
-        nd.setdefault("EPI", rng.uniform(0.1, 0.3))
-        nd.setdefault("νf", rng.uniform(vf_min, vf_max))
-        nd.setdefault("θ", rng.uniform(th_min, th_max))
-        nd.setdefault("Si", rng.uniform(0.4, 0.7))
-
-    return G

tnfr-4.5.1.dist-info/METADATA

@@ -1,221 +0,0 @@
-Metadata-Version: 2.4
-Name: tnfr
-Version: 4.5.1
-Summary: modular structural-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,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
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Intended Audience :: Science/Research
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Classifier: Topic :: Scientific/Engineering :: Information Analysis
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE.md
-Requires-Dist: networkx>=2.6
-Dynamic: license-file
-
-# tnfr · Python package
-
-> Engine for **modeling, simulation, and measurement** of multiscale structural coherence through **structural operators** (emission, reception, coherence, dissonance, coupling, resonance, silence, expansion, contraction, self‑organization, mutation, transition, recursivity).
-
----
-
-## What is `tnfr`?
-
-`tnfr` is a Python library to **operate with form**: build nodes, couple them into networks, and **modulate their coherence** over time using structural operators. It does not describe “things”; it **activates processes**. Its theoretical basis is the Resonant Fractal Nature Theory (TNFR), which understands reality as **networks of coherence** that persist because they **resonate**.
-
-In practical terms, `tnfr` lets you:
-
-* Model **Resonant Fractal Nodes (NFR)** with parameters for **frequency** (νf), **phase** (θ), and **form** (EPI).
-* Apply **structural operators** to start, stabilize, propagate, or reconfigure coherence.
-* **Simulate** nodal dynamics with discrete/continuous integrators.
-* **Measure** global coherence C(t), nodal gradient ΔNFR, and the **Sense Index** (Si).
-* **Visualize** states and trajectories (coupling matrices, C(t) curves, graphs).
-
-> **Nodal equation (operational core)**
->
-> $\frac{\partial \mathrm{EPI}}{\partial t} = \nu_f\,\cdot\,\Delta\mathrm{NFR}(t)$
->
-> A form emerges and persists when **internal reorganization** (ΔNFR) **resonates** with the node’s **frequency** (νf).
-
----
-
-## Installation
-
-```bash
-pip install tnfr
-```
-
-Requires **Python ≥ 3.9**.
-
----
-
-## Why TNFR (in 60 seconds)
-
-* **From objects to coherences:** you model **processes** that hold, not fixed entities.
-* **Operators instead of rules:** you compose **structural operators** (e.g., *emission*, *coherence*, *dissonance*) to **build trajectories**.
-* **Operational fractality:** the same pattern works for **ideas, teams, tissues, narratives**; the scales change, **the logic doesn’t**.
-
----
-
-## Getting started (minimal recipe)
-
-> *The high‑level API centers on three things: nodes, operators, simulation.*
-
-```python
-# 1) Nodes and network
-import tnfr as T
-
-# A minimal set of nodes with initial frequency (νf)
-A = T.Node(label="seed", nu_f=0.8)
-B = T.Node(label="context", nu_f=0.6)
-net = T.Network([A, B], edges=[(A, B, 0.7)])  # coupling 0..1
-
-# 2) Sequence of structural operators
-ops = [
-    T.ops.Emission(strength=0.4),      # start pattern
-    T.ops.Coupling(weight=0.7),        # synchronize nodes
-    T.ops.Coherence(),                 # stabilize form
-]
-
-# 3) Simulation and metrics
-traj = T.sim.run(net, ops, steps=200, dt=0.05)
-print("C(t) =", T.metrics.coherence(traj)[-1])
-print("Si   =", T.metrics.sense_index(traj))
-
-# 4) Quick visualization
-T.viz.plot_coherence(traj)     # C(t) curve
-T.viz.plot_network(net)        # graph/couplings
-```
-
-> **Note:** Specific class/function names may vary across minor versions. Check `help(T.ops)` and `help(T.sim)` for your installed API.
-
----
-
-## Key concepts (operational summary)
-
-* **Node (NFR):** a unit that persists because it **resonates**. Parameterized by **νf** (frequency), **θ** (phase), and **EPI** (coherent form).
-* **Structural operators:** functions that reorganize the network. We use **functional** names (not phonemes):
-
-  * **Emission** (start), **Reception** (open), **Coherence** (stabilize), **Dissonance** (creative tension), **Coupling** (synchrony), **Resonance** (propagate), **Silence** (latency), **Expansion**, **Contraction**, **Self‑organization**, **Mutation**, **Transition**, **Recursivity**.
-* **Magnitudes:**
-
-  * **C(t):** global coherence.
-  * **ΔNFR:** nodal gradient (need for reorganization).
-  * **νf:** structural frequency (Hz\_str).
-  * **Si:** sense index (ability to generate stable shared coherence).
-
----
-
-## Typical workflow
-
-1. **Model** your system as a network: nodes (agents, ideas, tissues, modules) and couplings.
-2. **Select** a **trajectory of operators** aligned with your goal (e.g., *start → couple → stabilize*).
-3. **Simulate** the dynamics: number of steps, step size, tolerances.
-4. **Measure**: C(t), ΔNFR, Si; identify bifurcations and collapses.
-5. **Iterate** with controlled **dissonance** to open mutations without losing form.
-
----
-
-## High‑level API (orientation map)
-
-> The typical module layout in `tnfr` is:
-
-* `tnfr.core`: `Node`, `Network`, `EPI`, `State`
-* `tnfr.ops`: structural operators (Emission, Reception, Coherence, Dissonance, ...)
-* `tnfr.sim`: integrators (`run`, `step`, `integrate`), dt control and thresholds
-* `tnfr.metrics`: `coherence`, `gradient`, `sense_index`, `phase_sync`
-* `tnfr.viz`: plotting utilities (`plot_coherence`, `plot_network`, `plot_phase`)
-
-Usage examples:
-
-```python
-from tnfr import core, ops, sim, metrics
-
-net = core.Network.from_edges([
-    ("n1", "n2", 0.6),
-    ("n2", "n3", 0.8),
-])
-
-sequence = [ops.Emission(0.3), ops.Coupling(0.5), ops.Coherence()]
-traj = sim.run(net, sequence, steps=500)
-
-print(metrics.coherence(traj))
-```
-
----
-
-## Parametric modeling
-
-```python
-import tnfr as T
-
-net = T.Network.uniform(n=25, nu_f=0.4, coupling=0.3)
-plan = (
-    T.ops.Emission(0.2)
-  >> T.ops.Expansion(0.4)
-  >> T.ops.Coupling(0.6)
-  >> T.ops.Coherence()
-)
-traj = T.sim.run(net, plan, steps=800)
-T.viz.plot_phase(traj)
-```
-
----
-
-## Main metrics
-
-* `coherence(traj) → C(t)`: global stability; higher values indicate sustained form.
-* `gradient(state) → ΔNFR`: local demand for reorganization (high = risk of collapse/bifurcation).
-* `sense_index(traj) → Si`: proxy for **structural sense** (capacity to generate shared coherence) combining **νf**, phase, and topology.
-
----
-
-## Best practices
-
-* **Short sequences** and frequent C(t) checks avoid unnecessary collapses.
-* Use **dissonance** as a tool: introduce it to open possibilities, but **seal** with coherence.
-* **Scale first, detail later:** tune coarse couplings before micro‑parameters.
-
----
-
-## Project status
-
-* **pre‑1.0 API**: signatures may be refined; concepts and magnitudes are stable.
-* **Pure‑Python** core with minimal dependencies (optional: `numpy`, `matplotlib`, `networkx`).
-
----
-
-## Contributing
-
-Suggestions, issues, and PRs are welcome. Guidelines:
-
-1. Prioritize **operational clarity** (names, docstrings, examples).
-2. Add **tests** and **notebooks** that show the structural effect of each PR.
-3. Keep **semantic neutrality**: operators act on form, not on contents.
-
----
-
-## License
-
-MIT 
-
----
-
-## References & notes
-
-* Theoretical foundations: TNFR operational manual.
-* Operational definitions: nodal equation, dimensions (frequency, phase, form), and structural operators.
-
-> If you use `tnfr` in research or projects, please cite the TNFR conceptual framework and link to the PyPI package.

tnfr-4.5.1.dist-info/RECORD

@@ -1,28 +0,0 @@
-tnfr/__init__.py,sha256=2j-PNqXRQxiMOsq6qEZ33XZ59vuqrvLXq7g4GCxAwDw,2790
-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=7bdxYCXVDwHeSeeyI9IalogMuxaZYy2MafDs9rWEyQY,5979
-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.1.dist-info/licenses/LICENSE.md,sha256=SRvvhXLrKtseuK6DARbuJffuXOXqAyk3wvF2n0t1SWA,1109
-tnfr-4.5.1.dist-info/METADATA,sha256=EQzW2AFCOyt8eVHWaqk5ka1MIzHCUn1IRRg8x1czxbA,8119
-tnfr-4.5.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-tnfr-4.5.1.dist-info/entry_points.txt,sha256=j4-QRHqeT2WnchHe_mvK7npGTLjlyfLpvRONFe9Z4MU,39
-tnfr-4.5.1.dist-info/top_level.txt,sha256=Q2HJnvc5Rt2VHwVvyBTnNPT4SfmJWnCj7XUxxEvQa7c,5
-tnfr-4.5.1.dist-info/RECORD,,