Update app.py

app.py

@@ -3,6 +3,7 @@ import matplotlib.pyplot as plt
 import numpy as np
 
 def draw_circle(ax, center, radius, color='black', fill=False, lw=1.5):
+    # Create a circle on the plot
     circle = plt.Circle(
         center,
         radius,
@@ -15,9 +16,11 @@ def draw_circle(ax, center, radius, color='black', fill=False, lw=1.5):
     ax.add_artist(circle)
 
 def draw_line(ax, start, end, color='black', lw=1.5):
+    # Draw a line between two points
     ax.plot([start[0], end[0]], [start[1], end[1]], color=color, lw=lw)
 
 def setup_plot(xlim=(-2, 2), ylim=(-2, 2), aspect='equal'):
+    # Set up the plotting area
     fig, ax = plt.subplots(figsize=(8, 8))
     ax.set_xlim(xlim)
     ax.set_ylim(ylim)
@@ -27,40 +30,36 @@ def setup_plot(xlim=(-2, 2), ylim=(-2, 2), aspect='equal'):
 
 def draw_shree_yantra(ax, radius=1, sides=12, line_skips=None, circle_fill=False,
                      line_color='black', circle_color='black', layers=2):
+    # The heart of the Yantra - where the magic happens
     if line_skips is None:
         line_skips = [2, 5, 7, 10]
 
-    # Step 1: Draw outer circles
+    # Outer circles - the cosmic spheres
     outer_circles = [radius * (i+1) / layers for i in range(layers)]
     for r in outer_circles:
         draw_circle(ax, (0, 0), r, color=circle_color, fill=circle_fill, lw=2)
 
-    # Step 2: Draw polygons and connecting lines for each layer
+    # Polygons and connecting lines - the web of existence
     for layer in range(1, layers + 1):
         current_radius = radius * layer / layers
-        # Draw polygon
         points = [np.array([np.cos(theta), np.sin(theta)]) for theta in np.linspace(0, 2*np.pi, sides, endpoint=False)]
         scaled_points = [p * current_radius for p in points]
         polygon = plt.Polygon(scaled_points, closed=True, fill=False, edgecolor=circle_color, lw=2)
         ax.add_artist(polygon)
 
-        # Draw symmetric connecting lines
+        # Connecting lines - the threads of interconnectedness
         for i, p1 in enumerate(scaled_points):
             for skip in line_skips:
                 j = (i + skip) % sides
                 p2 = scaled_points[j]
-                # To ensure symmetry, draw each line only once
                 if i < j:
                     draw_line(ax, p1, p2, color=line_color, lw=1.5)
 
-    # Step 3: Draw central circle
+    # Central circle - the bindu, the source of all creation
     draw_circle(ax, (0, 0), radius / layers, color=circle_color, fill=False, lw=2)
 
 def enforce_symmetry(selected_skips, sides):
-    """
-    Ensure that for every skip, its complementary skip is also selected.
-    For example, if skip=2 is selected in a 12-sided polygon, skip=10 (12-2) is also selected.
-    """
+    # Ensure balance in the universe (and our Yantra)
     symmetric_skips = set()
     for skip in selected_skips:
         symmetric_skips.add(skip)
@@ -74,37 +73,34 @@ def main():
 
     st.sidebar.header("🔧 Customize Your Shree Yantra")
 
-    # Sidebar controls
+    # Let the user shape their own cosmic diagram
     radius = st.sidebar.slider("🔵 Outer Circle Radius", 0.5, 3.0, 1.5, 0.1)
     sides = st.sidebar.slider("🔺 Number of Sides (Polygon)", 6, 20, 12, 1)
     layers = st.sidebar.slider("📚 Number of Layers", 1, 5, 2, 1)
 
-    # Define default skips
+    # The sacred skips
     predefined_skips = [2, 5, 7, 10]
 
-    # Generate available skips based on the number of sides
     max_skip = sides // 2
     available_skips = list(range(1, max_skip + 1))
 
-    # Adjust default skips to be within available options
     default_skips = [skip for skip in predefined_skips if skip in available_skips]
     if not default_skips:
         default_skips = [2] if 2 in available_skips else [1]
 
-    # Provide user flexibility to select skips
+    # Let the user choose their path
     selected_skips = st.sidebar.multiselect(
         "🔀 Line Skips",
         options=available_skips,
         default=default_skips
     )
 
-    # Enforce symmetry in skips
+    # Balance in all things
     symmetric_skips = enforce_symmetry(selected_skips, sides)
 
-    # Display selected symmetric skips
     st.sidebar.write("**🔄 Symmetric Skips Applied:**", symmetric_skips)
 
-    # Additional sidebar controls
+    # Colors of creation
     line_color = st.sidebar.color_picker("✏️ Line Color", "#000000")
     circle_color = st.sidebar.color_picker("🖌️ Circle & Polygon Color", "#000000")
     circle_fill = st.sidebar.checkbox("🎨 Fill Outer Circles", value=False)
@@ -116,6 +112,7 @@ def main():
     if not symmetric_skips:
         st.warning("⚠️ Please select at least one line skip to draw connecting lines.")
     else:
+        # Create the Yantra
         draw_shree_yantra(
             ax,
             radius=radius,
@@ -135,4 +132,4 @@ def main():
     """)
 
 if __name__ == "__main__":
-    main()
+    main()