Update app.py

app.py

@@ -8,13 +8,12 @@ import networkx as nx
 def generate_potentiality_matrix(sequence_length):
     """
     Visualizes the "Prime Potentiality" by aligning the integer stream to Mod 10.
-    1, 3, 7, 9 are the 'Active Lanes' (Rivers).
+    1, 3, 7, 9 are the 'Active Lanes' (Rivers) where Primes can exist.
     """
-    # 1. Create the Integer Stream
-    # We go deep (up to 5000+) to show the river effect
+    # 1. Create the Integer Stream (Deep depth to show the 'River' effect)
     integers = np.arange(sequence_length)
     
-    # 2. Mod 10 Alignment (The "Natural" Width)
+    # 2. Mod 10 Alignment (The "Natural" Width of the decimal system)
     width = 10 
     rows = int(np.ceil(sequence_length / width))
     
@@ -23,18 +22,21 @@ def generate_potentiality_matrix(sequence_length):
     padded_ints = np.pad(integers, (0, padded_len - len(integers)), mode='constant')
     
     # 3. Calculate "Potentiality" (The Heat)
-    # 0 = Composite Ground, 0.5 = Potential Lane, 1.0 = Kinetic Prime
+    # 0.0 = Ground State (Even/5s - Composite)
+    # 0.2 = Potential Lane (Odd Composite in 1,3,7,9)
+    # 1.0 = Kinetic Signal (Actual Prime)
     matrix_values = np.zeros(padded_len)
     
     for i, val in enumerate(padded_ints):
-        if sympy.isprime(int(val)) and val > 5:
+        val_int = int(val)
+        if sympy.isprime(val_int) and val_int > 5:
             matrix_values[i] = 1.0  # Kinetic Signal (Prime)
-        elif val % 2 == 0 or val % 5 == 0:
+        elif val_int % 2 == 0 or val_int % 5 == 0:
             matrix_values[i] = 0.0  # Ground State (Composite)
         else:
             matrix_values[i] = 0.2  # Potential Energy (Odd Composite in Prime Lane)
 
-    # Reshape to Mod 10 Grid
+    # Reshape to Mod 10 Grid (Rows x 10 Columns)
     grid = matrix_values.reshape(rows, width)
     
     # 4. Visualization
@@ -51,11 +53,11 @@ def generate_potentiality_matrix(sequence_length):
     ))
     
     fig.update_layout(
-        title=f"Prime Potentiality Rivers (Mod 10)",
+        title=f"Prime Potentiality Rivers (Mod 10 Alignment)",
         xaxis_title="Modulus 10 Residue (Last Digit)",
         yaxis_title="Sequence Depth (Time)",
         template="plotly_dark",
-        yaxis=dict(autorange="reversed"), # Stream flows down
+        yaxis=dict(autorange="reversed"), # Stream flows down like the matrix screenshots
         height=800
     )
     return fig
@@ -69,7 +71,7 @@ def visualize_prime_matroska(shells, show_feed):
     fig = go.Figure()
     
     # 1. Draw the "Prime Vectors" (Spokes)
-    # These are the rails the data travels on
+    # These are the rails the data travels on based on the Mod 10 index
     max_radius = shells * 10
     for i in range(10):
         angle = (2 * np.pi * i) / 10
@@ -78,6 +80,7 @@ def visualize_prime_matroska(shells, show_feed):
         color = "#00ffea" if is_prime_lane else "#333"
         width = 2 if is_prime_lane else 1
         
+        # Draw the vector spoke
         fig.add_trace(go.Scatter(
             x=[0, max_radius * np.cos(angle)],
             y=[0, max_radius * np.sin(angle)],
@@ -88,7 +91,7 @@ def visualize_prime_matroska(shells, show_feed):
         ))
 
     # 2. Draw the Concentric Shells (Domains)
-    # These are the Matroska Layers
+    # These represent the Nested Matroska Layers
     for layer in range(1, shells + 1):
         radius = layer * 10
         t = np.linspace(0, 2*np.pi, 100)
@@ -103,16 +106,17 @@ def visualize_prime_matroska(shells, show_feed):
             showlegend=False
         ))
         
-        # 3. Simulate "Data Atoms" residing in the shell
-        # They only land on the Prime Vectors (1, 3, 7, 9)
+        # 3. Simulate "Active Atoms" (The Feed)
+        # Data atoms only inhabit the Prime Potentiality Vectors (1, 3, 7, 9)
         if show_feed:
             for p_mod in [1, 3, 7, 9]:
                 p_angle = (2 * np.pi * p_mod) / 10
+                # Add 'Data' markers at the intersection of Shells and Prime Vectors
                 fig.add_trace(go.Scatter(
                     x=[radius * np.cos(p_angle)], 
                     y=[radius * np.sin(p_angle)],
                     mode='markers',
-                    marker=dict(size=6, color='#ff0055'), # Red = Hot Data
+                    marker=dict(size=6, color='#ff0055'), # Red = Hot Data Packet
                     showlegend=False
                 ))
 
@@ -128,11 +132,11 @@ def visualize_prime_matroska(shells, show_feed):
 
 # --- THE INTERFACE ---
 with gr.Blocks(theme=gr.themes.Monochrome()) as demo:
-    gr.Markdown("# LOGOS: Prime-Indexed Topology")
-    gr.Markdown("Visualizing the **Mod 10 Potentiality Rivers** and the **Radial Matroska Network**.")
+    gr.Markdown("# LOGOS: Prime-Indexed Topology & Potentiality")
+    gr.Markdown("Interactive architectural validation for **Mod 10 Potentiality Rivers** and the **Radial Matroska Network**.")
     
     with gr.Tab("Prime Potentiality (Mod 10)"):
-        gr.Markdown("The vertical 'Rivers' of prime potential (1, 3, 7, 9) vs the Composite banks.")
+        gr.Markdown("Visualizing the 'Vertical Rivers' of prime potential (1, 3, 7, 9) vs the Composite banks (0, 2, 4, 5, 6, 8).")
         seq_len = gr.Slider(100, 10000, value=2500, label="Stream Depth")
         matrix_plot = gr.Plot(label="Potentiality Matrix")
         btn_matrix = gr.Button("Generate Matrix")
@@ -148,18 +152,6 @@ with gr.Blocks(theme=gr.themes.Monochrome()) as demo:
         btn_net = gr.Button("Build Topology")
         btn_net.click(visualize_prime_matroska, inputs=[shells_slider, feed_toggle], outputs=matroska_plot)
 
-# ... (rest of your code above stays the same)
-
-    with gr.Tab("Matroska Network (Radial)"):
-        gr.Markdown("The Destination Topology: Concentric Shells indexed by Prime Moduli.")
-        with gr.Row():
-            shells_slider = gr.Slider(1, 20, value=5, step=1, label="Domain Depth (Shells)")
-            feed_toggle = gr.Checkbox(value=True, label="Show Active Atoms (Feed)")
-        
-        matroska_plot = gr.Plot(label="Radial Topology")
-        btn_net = gr.Button("Build Topology")
-        btn_net.click(visualize_prime_matroska, inputs=[shells_slider, feed_toggle], outputs=matroska_plot)
-
-# --- UPDATE THIS LAUNCH COMMAND ---
-# Disable SSR to fix the asyncio/file descriptor crash
+# --- LAUNCH COMMAND ---
+# Disable SSR (Server Side Rendering) to prevent asyncio/file descriptor crashes in HF Spaces
 demo.launch(ssr_mode=False)