update(bubble-packed): matplotlib — comprehensive quality review

Comprehensive review improving code quality, data choice, visual design,
spec compliance, and library feature usage.

Author: MarkusNeusinger

plots/bubble-packed/implementations/matplotlib.py

@@ -1,16 +1,16 @@
-""" pyplots.ai
+"""pyplots.ai
 bubble-packed: Basic Packed Bubble Chart
-Library: matplotlib 3.10.8 | Python 3.13.11
-Quality: 92/100 | Created: 2025-12-23
+Library: matplotlib 3.10.8 | Python 3.14.3
+Quality: /100 | Updated: 2026-02-23
 """
 
+import matplotlib.collections as mcoll
 import matplotlib.patches as mpatches
 import matplotlib.pyplot as plt
 import numpy as np
 
 
 # Data - Department budget allocation (in thousands)
-np.random.seed(42)
 labels = [
     "Engineering",
     "Marketing",
@@ -28,137 +28,167 @@
     "Security",
     "QA",
 ]
-values = [850, 420, 680, 320, 180, 290, 750, 210, 150, 380, 240, 550, 460, 170, 195]
-
-# Colors by group (Python Blue primary, Yellow secondary, others colorblind-safe)
-colors = [
-    "#306998",  # Engineering - Blue (Tech)
-    "#FFD43B",  # Marketing - Yellow (Business)
-    "#306998",  # Sales - Blue (Revenue)
-    "#4A90A4",  # Operations - Teal (Support)
-    "#4A90A4",  # HR - Teal (Support)
-    "#4A90A4",  # Finance - Teal (Support)
-    "#FFD43B",  # R&D - Yellow (Innovation)
-    "#4A90A4",  # Customer Support - Teal (Support)
-    "#7B9E89",  # Legal - Sage (Compliance)
-    "#306998",  # IT - Blue (Tech)
-    "#FFD43B",  # Design - Yellow (Creative)
-    "#306998",  # Product - Blue (Tech)
-    "#FFD43B",  # Data Science - Yellow (Analytics)
-    "#7B9E89",  # Security - Sage (Compliance)
-    "#7B9E89",  # QA - Sage (Quality)
-]
+values = [950, 420, 680, 310, 160, 280, 820, 200, 130, 370, 230, 580, 470, 145, 175]
+
+# Group assignments and colors (colorblind-safe palette)
+group_map = {
+    "Engineering": "Tech",
+    "IT": "Tech",
+    "Product": "Tech",
+    "Sales": "Tech",
+    "Marketing": "Creative",
+    "R&D": "Creative",
+    "Design": "Creative",
+    "Data Science": "Creative",
+    "Operations": "Support",
+    "HR": "Support",
+    "Finance": "Support",
+    "Customer Support": "Support",
+    "Legal": "Compliance",
+    "Security": "Compliance",
+    "QA": "Compliance",
+}
+group_colors = {"Tech": "#306998", "Creative": "#FFD43B", "Support": "#4A90A4", "Compliance": "#7B9E89"}
+colors = [group_colors[group_map[label]] for label in labels]
 
 # Scale values to radius (sqrt for area-proportional sizing)
-min_radius = 0.35
-max_radius = 1.9
-values_array = np.array(values)
+min_radius = 0.30
+max_radius = 2.0
+values_array = np.array(values, dtype=float)
 radii = min_radius + (max_radius - min_radius) * np.sqrt(
     (values_array - values_array.min()) / (values_array.max() - values_array.min())
 )
 
-# Circle packing using physics simulation
-n = len(labels)
-
-# Initial positions in grid
-grid_size = int(np.ceil(np.sqrt(n)))
-positions = np.zeros((n, 2))
-for i in range(n):
-    positions[i] = [(i % grid_size) * 4 - grid_size * 2, (i // grid_size) * 4 - grid_size * 2]
-
 # Sort by size (largest first) for better packing
+n = len(labels)
 order = np.argsort(-radii)
-positions = positions[order]
 radii_sorted = radii[order]
 labels_sorted = [labels[i] for i in order]
 values_sorted = [values[i] for i in order]
 colors_sorted = [colors[i] for i in order]
 
+# Initial positions in spiral pattern for tighter convergence
+angles = np.linspace(0, 4 * np.pi, n)
+spiral_r = np.linspace(0, 3, n)
+positions = np.column_stack([spiral_r * np.cos(angles), spiral_r * np.sin(angles)])
+
 # Physics simulation for packing
-for iteration in range(350):
-    # Pull toward center with decreasing strength
-    pull_strength = 0.06 * (1 - iteration / 400)
+for iteration in range(400):
+    pull_strength = 0.07 * (1 - iteration / 450)
+
+    # Pull toward center
     for i in range(n):
-        dist = np.sqrt(positions[i, 0] ** 2 + positions[i, 1] ** 2)
+        dist = np.linalg.norm(positions[i])
         if dist > 0.01:
             positions[i] -= pull_strength * positions[i] / dist
 
     # Push apart overlapping circles
     for i in range(n):
         for j in range(i + 1, n):
-            dx = positions[j, 0] - positions[i, 0]
-            dy = positions[j, 1] - positions[i, 1]
-            dist = np.sqrt(dx**2 + dy**2)
-            min_dist = radii_sorted[i] + radii_sorted[j] + 0.05  # Small gap between circles
+            delta = positions[j] - positions[i]
+            dist = np.linalg.norm(delta)
+            min_dist = radii_sorted[i] + radii_sorted[j] + 0.06
 
             if dist < min_dist and dist > 0.001:
                 overlap = (min_dist - dist) / 2
-                dx_norm = dx / dist
-                dy_norm = dy / dist
-                positions[i, 0] -= overlap * dx_norm
-                positions[i, 1] -= overlap * dy_norm
-                positions[j, 0] += overlap * dx_norm
-                positions[j, 1] += overlap * dy_norm
-
-# Create plot (4800x2700 px at 300 dpi)
+                direction = delta / dist
+                positions[i] -= overlap * direction
+                positions[j] += overlap * direction
+
+# Plot (4800x2700 px at 300 dpi)
 fig, ax = plt.subplots(figsize=(16, 9))
 
-# Draw circles
+# Draw circles using PatchCollection for efficient rendering
+circles = []
+face_colors = []
 for i in range(n):
-    circle = mpatches.Circle(
-        (positions[i, 0], positions[i, 1]),
-        radii_sorted[i],
-        facecolor=colors_sorted[i],
-        edgecolor="white",
-        linewidth=2.5,
-        alpha=0.88,
-    )
-    ax.add_patch(circle)
-
-    # Add labels inside larger circles
-    label_len = len(labels_sorted[i])
-    min_radius_for_label = 0.55 + label_len * 0.025
-    if radii_sorted[i] > min_radius_for_label:
+    circle = mpatches.Circle((positions[i, 0], positions[i, 1]), radii_sorted[i])
+    circles.append(circle)
+    face_colors.append(colors_sorted[i])
+
+collection = mcoll.PatchCollection(
+    circles, facecolors=face_colors, edgecolors="white", linewidths=2.5, alpha=0.90, zorder=2
+)
+ax.add_collection(collection)
+
+# Add labels inside circles that are large enough
+for i in range(n):
+    label_chars = len(labels_sorted[i])
+    min_r_for_label = 0.48 + label_chars * 0.018
+    if radii_sorted[i] > min_r_for_label:
         font_scale = min(1.0, radii_sorted[i] / 1.4)
         label_fontsize = max(9, int(15 * font_scale))
         value_fontsize = max(8, int(13 * font_scale))
+
+        # Determine text color based on background brightness
+        bg_color = colors_sorted[i]
+        text_color = "#1a1a2e" if bg_color == "#FFD43B" else "white"
+
+        # Wrap long labels for smaller circles
+        display_label = labels_sorted[i]
+        is_wrapped = False
+        if " " in display_label and radii_sorted[i] < 1.0:
+            display_label = display_label.replace(" ", "\n")
+            is_wrapped = True
+
+        # Adjust vertical offsets for wrapped vs single-line labels
+        label_y_offset = 0.05 if is_wrapped else 0.12
+        value_y_offset = -0.35 if is_wrapped else -0.22
+
         ax.text(
             positions[i, 0],
-            positions[i, 1] + radii_sorted[i] * 0.1,
-            labels_sorted[i],
+            positions[i, 1] + radii_sorted[i] * label_y_offset,
+            display_label,
             ha="center",
             va="center",
             fontsize=label_fontsize,
             fontweight="bold",
-            color="white",
+            color=text_color,
+            zorder=3,
         )
         ax.text(
             positions[i, 0],
-            positions[i, 1] - radii_sorted[i] * 0.22,
+            positions[i, 1] + radii_sorted[i] * value_y_offset,
             f"${values_sorted[i]}K",
             ha="center",
             va="center",
             fontsize=value_fontsize,
-            color="white",
-            alpha=0.95,
+            color=text_color,
+            alpha=0.85,
+            zorder=3,
         )
 
-# Set axis limits with padding
+# Axis limits with padding
 all_x = positions[:, 0]
 all_y = positions[:, 1]
 max_r = radii_sorted.max()
-padding = 0.6
+padding = 0.8
 ax.set_xlim(all_x.min() - max_r - padding, all_x.max() + max_r + padding)
 ax.set_ylim(all_y.min() - max_r - padding, all_y.max() + max_r + padding)
 ax.set_aspect("equal")
-
-# Remove axes for clean visualization
 ax.axis("off")
 
 # Title
 ax.set_title(
     "Department Budget Allocation · bubble-packed · matplotlib · pyplots.ai", fontsize=24, fontweight="bold", pad=20
 )
 
+# Legend for group colors
+legend_handles = [
+    mpatches.Patch(facecolor=color, edgecolor="white", linewidth=1.5, label=group)
+    for group, color in group_colors.items()
+]
+ax.legend(
+    handles=legend_handles,
+    loc="lower right",
+    fontsize=16,
+    framealpha=0.9,
+    edgecolor="#cccccc",
+    fancybox=True,
+    borderpad=0.8,
+    handlelength=1.5,
+    handleheight=1.2,
+)
+
 plt.tight_layout()
 plt.savefig("plot.png", dpi=300, bbox_inches="tight", facecolor="white")

plots/bubble-packed/metadata/matplotlib.yaml

@@ -1,16 +1,16 @@
 library: matplotlib
 specification_id: bubble-packed
 created: '2025-12-23T09:16:10Z'
-updated: '2025-12-23T09:18:25Z'
-generated_by: claude-opus-4-5-20251101
+updated: 2026-02-23T15:35:00+00:00
+generated_by: claude-opus-4-6
 workflow_run: 20456558183
 issue: 0
-python_version: 3.13.11
-library_version: 3.10.8
+python_version: "3.14.3"
+library_version: "3.10.8"
 preview_url: https://storage.googleapis.com/pyplots-images/plots/bubble-packed/matplotlib/plot.png
 preview_thumb: https://storage.googleapis.com/pyplots-images/plots/bubble-packed/matplotlib/plot_thumb.png
 preview_html: null
-quality_score: 92
+quality_score: null
 impl_tags:
   dependencies: []
   techniques:

plots/bubble-packed/specification.yaml

@@ -6,7 +6,7 @@ title: Basic Packed Bubble Chart
 
 # Specification tracking
 created: 2025-12-15T20:43:45Z
-updated: 2025-12-15T20:43:45Z
+updated: 2026-02-23T12:00:00Z
 issue: 992
 suggested: MarkusNeusinger
 
@@ -15,13 +15,15 @@ tags:
   plot_type:
     - bubble
     - packed
+    - circlepacking
   data_type:
     - categorical
     - numeric
+    - proportional
   domain:
     - general
     - business
   features:
     - basic
     - comparison
-    - hierarchical
+    - proportional