update(arc-basic): bokeh — comprehensive quality review

Comprehensive review and update of bokeh implementation for arc-basic.

Author: MarkusNeusinger

plots/arc-basic/implementations/bokeh.py

@@ -1,18 +1,17 @@
-""" pyplots.ai
+"""pyplots.ai
 arc-basic: Basic Arc Diagram
-Library: bokeh 3.8.1 | Python 3.13.11
-Quality: 91/100 | Created: 2025-12-23
+Library: bokeh 3.8.2 | Python 3.14.3
+Quality: /100 | Updated: 2026-02-23
 """
 
 import numpy as np
 from bokeh.io import export_png, save
-from bokeh.models import ColumnDataSource, Label, Legend, LegendItem
+from bokeh.models import ColumnDataSource, HoverTool, Label, Legend, LegendItem
 from bokeh.plotting import figure
 
 
 # Data - Character interactions in a story chapter
 nodes = ["Alice", "Bob", "Carol", "David", "Eve", "Frank", "Grace", "Henry"]
-# Edges as (source_idx, target_idx, weight) - character conversation connections
 edges = [
     (0, 1, 3),  # Alice-Bob: frequent
     (0, 2, 2),  # Alice-Carol: moderate
@@ -30,95 +29,128 @@
 
 # Node positions along horizontal axis
 n_nodes = len(nodes)
-x_positions = np.linspace(0, 10, n_nodes)
+x_positions = np.linspace(0.5, 10.5, n_nodes)
 y_baseline = 0
 
+# Weight-based styling: darker and thicker for stronger connections
+weight_colors = {1: "#93B5CF", 2: "#306998", 3: "#1A3F5C"}
+weight_labels = {1: "Brief", 2: "Moderate", 3: "Frequent"}
+
 # Create figure
 p = figure(
     width=4800,
     height=2700,
-    title="arc-basic · bokeh · pyplots.ai",
-    x_axis_label="Characters",
-    y_axis_label="",
-    x_range=(-0.5, 10.5),
-    y_range=(-1.5, 4.5),
+    title="arc-basic \u00b7 bokeh \u00b7 pyplots.ai",
+    x_range=(-0.2, 11.2),
+    y_range=(-0.8, 3.3),
+    toolbar_location=None,
 )
 
-# Style the figure
+# Style
 p.title.text_font_size = "28pt"
-p.xaxis.axis_label_text_font_size = "22pt"
-p.yaxis.axis_label_text_font_size = "22pt"
-p.xaxis.major_label_text_font_size = "18pt"
-p.yaxis.major_label_text_font_size = "18pt"
-
-# Hide y-axis (not meaningful for arc diagram)
+p.title.text_color = "#333333"
+p.xaxis.visible = False
 p.yaxis.visible = False
+p.xgrid.visible = False
 p.ygrid.visible = False
+p.outline_line_color = None
 
-# Draw arcs as bezier curves, collect renderers for legend
-long_range_renderers = []
-short_range_renderers = []
+# Draw arcs using Bokeh's native bezier glyph
+arc_renderers_by_weight = {1: [], 2: [], 3: []}
 
 for src_idx, tgt_idx, weight in edges:
     x_src = x_positions[src_idx]
     x_tgt = x_positions[tgt_idx]
 
-    # Arc height proportional to distance between nodes
     distance = abs(x_tgt - x_src)
-    arc_height = distance * 0.5
+    arc_height = distance * 0.35
 
-    # Generate arc points using quadratic bezier
-    t = np.linspace(0, 1, 50)
-    # Control point at midpoint, elevated by arc_height
-    cx = (x_src + x_tgt) / 2
+    # Split control points at 1/3 and 2/3 for smooth, rounded arcs
+    cx0 = x_src + (x_tgt - x_src) / 3
+    cx1 = x_src + 2 * (x_tgt - x_src) / 3
     cy = arc_height
 
-    # Quadratic bezier: B(t) = (1-t)^2*P0 + 2*(1-t)*t*P1 + t^2*P2
-    arc_x = (1 - t) ** 2 * x_src + 2 * (1 - t) * t * cx + t**2 * x_tgt
-    arc_y = (1 - t) ** 2 * y_baseline + 2 * (1 - t) * t * cy + t**2 * y_baseline
-
-    # Line width based on weight
-    line_width = weight * 2
-
-    # Color based on connection type (long-range vs short-range)
-    if distance > 5:
-        color = "#FFD43B"  # Python Yellow for long-range
-        alpha = 0.7
-    else:
-        color = "#306998"  # Python Blue for short-range
-        alpha = 0.5
-
-    arc_source = ColumnDataSource(data={"x": arc_x, "y": arc_y})
-    renderer = p.line(x="x", y="y", source=arc_source, line_width=line_width, line_color=color, line_alpha=alpha)
-
-    # Collect renderers for legend
-    if distance > 5:
-        long_range_renderers.append(renderer)
-    else:
-        short_range_renderers.append(renderer)
+    line_width = weight * 2.5
+    color = weight_colors[weight]
+    alpha = 0.35 + weight * 0.15
+
+    arc_source = ColumnDataSource(
+        data={
+            "x0": [x_src],
+            "y0": [y_baseline],
+            "x1": [x_tgt],
+            "y1": [y_baseline],
+            "cx0": [cx0],
+            "cy0": [cy],
+            "cx1": [cx1],
+            "cy1": [cy],
+            "source_name": [nodes[src_idx]],
+            "target_name": [nodes[tgt_idx]],
+            "weight_label": [weight_labels[weight]],
+        }
+    )
+    renderer = p.bezier(
+        x0="x0",
+        y0="y0",
+        x1="x1",
+        y1="y1",
+        cx0="cx0",
+        cy0="cy0",
+        cx1="cx1",
+        cy1="cy1",
+        source=arc_source,
+        line_width=line_width,
+        line_color=color,
+        line_alpha=alpha,
+    )
+    arc_renderers_by_weight[weight].append(renderer)
+
+# HoverTool for edge details (Bokeh-distinctive interactivity)
+hover = HoverTool(
+    tooltips=[("Connection", "@source_name \u2194 @target_name"), ("Frequency", "@weight_label")], line_policy="interp"
+)
+p.add_tools(hover)
 
-# Draw nodes along baseline
+# Draw nodes
 node_source = ColumnDataSource(data={"x": x_positions, "y": [y_baseline] * n_nodes, "name": nodes})
-p.scatter(x="x", y="y", source=node_source, size=25, fill_color="#306998", line_color="white", line_width=2)
+p.scatter(x="x", y="y", source=node_source, size=30, fill_color="#306998", line_color="white", line_width=3)
+
+# Node hover
+node_hover = HoverTool(tooltips=[("Character", "@name")], renderers=[p.renderers[-1]])
+p.add_tools(node_hover)
 
-# Add node labels below the baseline
+# Node labels
 for i, name in enumerate(nodes):
-    label = Label(x=x_positions[i], y=-0.5, text=name, text_font_size="20pt", text_align="center", text_baseline="top")
+    label = Label(
+        x=x_positions[i],
+        y=-0.25,
+        text=name,
+        text_font_size="20pt",
+        text_align="center",
+        text_baseline="top",
+        text_color="#333333",
+    )
     p.add_layout(label)
 
-# Add subtle grid only for x
-p.xgrid.grid_line_alpha = 0.3
-p.xgrid.grid_line_dash = [6, 4]
-
-# Add legend for connection types
+# Legend by interaction frequency
 legend_items = []
-if long_range_renderers:
-    legend_items.append(LegendItem(label="Long-range (distance > 5)", renderers=[long_range_renderers[0]]))
-if short_range_renderers:
-    legend_items.append(LegendItem(label="Short-range (distance ≤ 5)", renderers=[short_range_renderers[0]]))
-
-legend = Legend(items=legend_items, location="top_right", label_text_font_size="18pt")
-p.add_layout(legend, "right")
+for weight, label_text in [(3, "Frequent"), (2, "Moderate"), (1, "Brief")]:
+    if arc_renderers_by_weight[weight]:
+        legend_items.append(LegendItem(label=label_text, renderers=[arc_renderers_by_weight[weight][0]]))
+
+legend = Legend(
+    items=legend_items,
+    location="top_right",
+    label_text_font_size="20pt",
+    label_text_color="#444444",
+    border_line_color=None,
+    background_fill_alpha=0.85,
+    glyph_width=40,
+    glyph_height=8,
+    spacing=12,
+    padding=18,
+)
+p.add_layout(legend)
 
 # Save outputs
 export_png(p, filename="plot.png")

plots/arc-basic/metadata/bokeh.yaml

@@ -1,16 +1,16 @@
 library: bokeh
 specification_id: arc-basic
 created: '2025-12-23T08:49:26Z'
-updated: '2025-12-23T09:11:15Z'
-generated_by: claude-opus-4-5-20251101
+updated: '2026-02-23T12:00:00+00:00'
+generated_by: claude-opus-4-6
 workflow_run: 20455962917
 issue: 0
-python_version: 3.13.11
-library_version: 3.8.1
+python_version: '3.14.3'
+library_version: 3.8.2
 preview_url: https://storage.googleapis.com/pyplots-images/plots/arc-basic/bokeh/plot.png
 preview_thumb: https://storage.googleapis.com/pyplots-images/plots/arc-basic/bokeh/plot_thumb.png
 preview_html: https://storage.googleapis.com/pyplots-images/plots/arc-basic/bokeh/plot.html
-quality_score: 91
+quality_score: null
 impl_tags:
   dependencies: []
   techniques: