Skip to content

Commit 4047ca3

Browse files
Copilotfermga
andcommitted
Fix structural operators symbols to use standard Unicode characters
Co-authored-by: fermga <203334638+fermga@users.noreply.github.com>
1 parent 4e30ede commit 4047ca3

File tree

5 files changed

+118
-16
lines changed

5 files changed

+118
-16
lines changed

wiki/INDEX.md

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
# TNFR Wiki - Quick Reference
2+
3+
![Wiki Graphics Preview](wiki_graphics_preview.png)
4+
5+
## 📖 Wiki Pages
6+
7+
Start here: **[Home](Home.md)**
8+
9+
### Main Pages
10+
11+
| Page | Description | Content |
12+
|------|-------------|---------|
13+
| **[Home](Home.md)** | Main landing page | Overview, installation, quick example, navigation |
14+
| **[Getting Started](Getting-Started.md)** | First steps with TNFR | Installation, tutorials, workflow, troubleshooting |
15+
| **[Core Concepts](Core-Concepts.md)** | Theory and fundamentals | NFRs, nodal equation, operators, metrics, fractality |
16+
| **[Examples](Examples.md)** | Real-world applications | Biology, social, AI, distributed systems, finance, physics |
17+
18+
## 🎨 Visual Assets (5 Graphics)
19+
20+
All graphics are high-resolution (300 DPI) and located in the `images/` directory:
21+
22+
1. **network_resonance.png** - NFR nodes in a resonant network
23+
2. **structural_operators.png** - The 13 canonical operators
24+
3. **paradigm_comparison.png** - Traditional vs TNFR paradigms
25+
4. **coherence_metrics.png** - Metrics evolution over time (C(t), Si, ΔNFR, νf)
26+
5. **nodal_equation.png** - The canonical nodal equation explained
27+
28+
## 📊 Statistics
29+
30+
- **Total lines**: ~1,700 lines of markdown
31+
- **Total size**: ~1.8 MB (including graphics)
32+
- **Code examples**: 30+ executable Python examples
33+
- **Visualizations**: 5 custom-generated graphics
34+
- **Use cases**: 10+ domain-specific applications
35+
36+
## 🚀 Quick Start
37+
38+
```python
39+
from tnfr.sdk import TNFRNetwork
40+
41+
# Create, activate, and measure a network
42+
network = TNFRNetwork("hello_world")
43+
results = (network
44+
.add_nodes(10)
45+
.connect_nodes(0.3, "random")
46+
.apply_sequence("basic_activation", repeat=3)
47+
.measure())
48+
49+
print(results.summary())
50+
```
51+
52+
## 🔧 Regenerating Graphics
53+
54+
```bash
55+
cd wiki
56+
python generate_graphics.py
57+
```
58+
59+
## 📝 Using This Wiki
60+
61+
### For GitHub Wiki
62+
63+
1. Navigate to repository's Wiki tab
64+
2. Create pages: Home, Getting-Started, Core-Concepts, Examples
65+
3. Copy content from .md files
66+
4. Upload images where referenced
67+
68+
### For Documentation Site
69+
70+
Add to `mkdocs.yml`:
71+
72+
```yaml
73+
nav:
74+
- Wiki:
75+
- Home: wiki/Home.md
76+
- Getting Started: wiki/Getting-Started.md
77+
- Core Concepts: wiki/Core-Concepts.md
78+
- Examples: wiki/Examples.md
79+
```
80+
81+
### For Local Reading
82+
83+
View markdown files directly on GitHub or with any markdown viewer.
84+
85+
## 🎯 Design Principles
86+
87+
- ✅ **English only** per TNFR guidelines
88+
- ✅ **Visual-first** approach with lots of diagrams
89+
- ✅ **Paradigm-aligned** with strict TNFR concepts
90+
- ✅ **Beginner-friendly** progressive complexity
91+
- ✅ **Code-heavy** with executable examples
92+
- ✅ **Self-contained** pages work independently
93+
94+
## 🔗 External Resources
95+
96+
- **Full Documentation**: https://tnfr.netlify.app
97+
- **GitHub Repository**: https://github.com/fermga/TNFR-Python-Engine
98+
- **PyPI Package**: https://pypi.org/project/tnfr/
99+
100+
---
101+
102+
**Start exploring**: [→ Go to Home Page](Home.md)

wiki/generate_graphics.py

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -113,22 +113,22 @@ def create_structural_operators_diagram():
113113
axes = axes.flatten()
114114

115115
operators = [
116-
('Emission\n(AL)', '🎵', '#ff6b6b'),
117-
('Reception\n(EN)', '📡', '#4ecdc4'),
118-
('Coherence\n(IL)', '🔒', '#45b7d1'),
116+
('Emission\n(AL)', '', '#ff6b6b'),
117+
('Reception\n(EN)', '', '#4ecdc4'),
118+
('Coherence\n(IL)', '', '#45b7d1'),
119119
('Dissonance\n(OZ)', '⚡', '#f38181'),
120-
('Coupling\n(UM)', '🔗', '#aa96da'),
121-
('Resonance\n(RA)', '🌊', '#5c7cfa'),
122-
('Silence\n(SHA)', '🔇', '#95afc0'),
123-
('Expansion\n(VAL)', '📈', '#38ada9'),
124-
('Contraction\n(NUL)', '📉', '#ee5a6f'),
125-
('Self-org\n(THOL)', '🌱', '#26de81'),
126-
('Mutation\n(ZHIR)', '🧬', '#fd79a8'),
127-
('Transition\n(NAV)', '➡️', '#fdcb6e'),
128-
('Recursivity\n(REMESH)', '🔄', '#6c5ce7'),
120+
('Coupling\n(UM)', '', '#aa96da'),
121+
('Resonance\n(RA)', '', '#5c7cfa'),
122+
('Silence\n(SHA)', '', '#95afc0'),
123+
('Expansion\n(VAL)', '', '#38ada9'),
124+
('Contraction\n(NUL)', '', '#ee5a6f'),
125+
('Self-org\n(THOL)', '', '#26de81'),
126+
('Mutation\n(ZHIR)', '', '#fd79a8'),
127+
('Transition\n(NAV)', '', '#fdcb6e'),
128+
('Recursivity\n(REMESH)', '', '#6c5ce7'),
129129
]
130130

131-
for idx, (name, emoji, color) in enumerate(operators):
131+
for idx, (name, symbol, color) in enumerate(operators):
132132
ax = axes[idx]
133133

134134
# Create operator box
@@ -140,9 +140,9 @@ def create_structural_operators_diagram():
140140
alpha=0.7)
141141
ax.add_patch(rect)
142142

143-
# Add emoji
144-
ax.text(0.5, 0.65, emoji, ha='center', va='center',
145-
fontsize=32)
143+
# Add symbol
144+
ax.text(0.5, 0.65, symbol, ha='center', va='center',
145+
fontsize=48, fontweight='bold', color='white')
146146

147147
# Add operator name
148148
ax.text(0.5, 0.35, name, ha='center', va='center',

wiki/images/network_resonance.png

-394 Bytes
Loading
46.1 KB
Loading

wiki/wiki_graphics_preview.png

425 KB
Loading

0 commit comments

Comments
 (0)