@@ -258,6 +258,82 @@ run_sequence(G, community, [Coupling(), Resonance()])
258258# Result: Coherence propagates through coupled network
259259```
260260
261+ ** Extended UM Examples** (from ` examples/coupling_network_formation.py ` ):
262+
263+ #### Network Synchronization with UM
264+ ``` python
265+ from tnfr.sdk import TNFRNetwork, NetworkConfig
266+
267+ # Create network with varied phases
268+ net = TNFRNetwork(" network_sync_demo" , NetworkConfig(random_seed = 42 ))
269+ net.add_nodes(8 )
270+
271+ # Set distinct phase groups
272+ for i, node in enumerate (net.graph.nodes()):
273+ net.graph.nodes[node][' theta' ] = (i % 4 ) * math.pi / 2
274+
275+ # Apply network_sync sequence (includes UM)
276+ # Sequence: AL → EN → IL → UM → RA → NAV
277+ net.apply_sequence(" network_sync" , repeat = 2 )
278+
279+ results = net.measure()
280+ # Result: Phase spread reduced, coherence increased through UM
281+ print (f " Coherence: { results.coherence:.3f } " )
282+ ```
283+
284+ #### Building Networks from Isolated Nodes
285+ ``` python
286+ # Start with isolated nodes
287+ net = TNFRNetwork(" formation" , NetworkConfig(random_seed = 42 ))
288+ net.add_nodes(15 )
289+
290+ # Add connections
291+ net.connect_nodes(0.25 , " random" )
292+
293+ # Apply formation sequence with UM
294+ net.apply_sequence(" network_sync" , repeat = 3 )
295+ net.apply_sequence(" consolidation" , repeat = 2 )
296+
297+ results = net.measure()
298+ # Result: Coherent network formed from isolated nodes
299+ print (f " Network Coherence: { results.coherence:.3f } " )
300+ ```
301+
302+ #### Bridging Incompatible Phase Groups
303+ ``` python
304+ net = TNFRNetwork(" phase_merging" , NetworkConfig(random_seed = 42 ))
305+ net.add_nodes(10 )
306+
307+ # Create opposing phase groups (maximally incompatible)
308+ for i, node in enumerate (net.graph.nodes()):
309+ if i < 5 :
310+ net.graph.nodes[node][' theta' ] = 0.0 # Group 1
311+ else :
312+ net.graph.nodes[node][' theta' ] = math.pi # Group 2
313+
314+ net.connect_nodes(0.3 , " random" )
315+
316+ # Apply repeated synchronization to bridge gap
317+ for _ in range (3 ):
318+ net.apply_sequence(" network_sync" )
319+
320+ results = net.measure()
321+ # Result: UM successfully merged incompatible phase groups
322+ print (f " Final coherence: { results.coherence:.3f } " )
323+ ```
324+
325+ ** Key UM Principles** :
326+ 1 . ** Phase Synchronization** : UM synchronizes θᵢ ≈ θⱼ (primary mechanism)
327+ 2 . ** EPI Preservation** : Each node maintains its structural identity
328+ 3 . ** Network Foundation** : UM creates substrate for RA and THOL
329+ 4 . ** Bidirectional** : Enables mutual influence and shared coherence
330+
331+ ** Typical UM Sequences** :
332+ - ** AL → UM** : Emission + coupling (paired activation)
333+ - ** UM → RA** : Coupling + propagation (network coherence)
334+ - ** UM → IL** : Coupling + stabilization (consolidated links)
335+ - ** Network_sync** : AL → EN → IL → UM → RA → NAV (complete cycle)
336+
261337---
262338
263339## Intermediate Sequences
0 commit comments