Merge remote-tracking branch 'origin/main'

Author: MarkusNeusinger

plots/donut-basic/implementations/python/bokeh.py

@@ -1,10 +1,11 @@
-""" pyplots.ai
+""" anyplot.ai
 donut-basic: Basic Donut Chart
-Library: bokeh 3.8.1 | Python 3.13.11
-Quality: 91/100 | Created: 2025-12-23
+Library: bokeh 3.9.0 | Python 3.14.4
+Quality: 88/100 | Updated: 2026-04-24
 """
 
-from math import pi
+import os
+from math import cos, pi, sin
 
 import numpy as np
 from bokeh.io import export_png, output_file, save
@@ -13,128 +14,122 @@
 from bokeh.transform import cumsum
 
 
-# Data - Portfolio allocation by asset class
-categories = ["Technology", "Healthcare", "Finance", "Energy", "Retail"]
-values = [35, 25, 20, 12, 8]
-total = sum(values)
+# Theme tokens
+THEME = os.getenv("ANYPLOT_THEME", "light")
+PAGE_BG = "#FAF8F1" if THEME == "light" else "#1A1A17"
+ELEVATED_BG = "#FFFDF6" if THEME == "light" else "#242420"
+INK = "#1A1A17" if THEME == "light" else "#F0EFE8"
+INK_SOFT = "#4A4A44" if THEME == "light" else "#B8B7B0"
 
-# Calculate angles for donut segments
-data = {
-    "category": categories,
-    "value": values,
-    "angle": [v / total * 2 * pi for v in values],
-    "percentage": [f"{v / total * 100:.1f}%" for v in values],
-}
+# Okabe-Ito categorical palette (first segment is always brand green)
+OKABE_ITO = ["#009E73", "#D55E00", "#0072B2", "#CC79A7", "#E69F00"]
 
-# Cumulative angles for label positioning
-cumulative = np.cumsum([0] + data["angle"][:-1]).tolist()
-data["start_angle"] = cumulative
-data["end_angle"] = np.cumsum(data["angle"]).tolist()
+# Data — Annual budget allocation by department (USD thousands)
+categories = ["Engineering", "Operations", "Marketing", "Sales", "Support"]
+values = [480, 210, 155, 125, 55]
+total = sum(values)
 
-# Colors - Python Blue as primary, then colorblind-safe palette
-colors = ["#306998", "#FFD43B", "#4ECDC4", "#FF6B6B", "#95E1D3"]
-data["color"] = colors
+angles = [v / total * 2 * pi for v in values]
+percentages = [f"{v / total * 100:.1f}%" for v in values]
 
-source = ColumnDataSource(data=data)
+source = ColumnDataSource(
+    data={"category": categories, "value": values, "angle": angles, "color": OKABE_ITO[: len(categories)]}
+)
 
-# Create figure (square format for circular chart)
+# Plot — square canvas for circular shapes
 p = figure(
     width=3600,
     height=3600,
-    title="donut-basic · bokeh · pyplots.ai",
+    title="Budget by Department · donut-basic · bokeh · anyplot.ai",
     toolbar_location=None,
     tools="",
-    x_range=(-1.4, 1.8),
-    y_range=(-1.3, 1.3),
+    x_range=(-1.4, 1.4),
+    y_range=(-1.4, 1.4),
 )
 
-# Draw donut using annular wedge
 p.annular_wedge(
     x=0,
     y=0,
-    inner_radius=0.45,
-    outer_radius=0.95,
+    inner_radius=0.55,
+    outer_radius=1.0,
     start_angle=cumsum("angle", include_zero=True),
     end_angle=cumsum("angle"),
-    line_color="white",
-    line_width=4,
+    line_color=PAGE_BG,
+    line_width=6,
     fill_color="color",
+    legend_field="category",
     source=source,
 )
 
-# Add percentage labels on segments
-for pct, start, end, color in zip(data["percentage"], data["start_angle"], data["end_angle"], colors, strict=True):
-    mid_angle = (start + end) / 2
-    # Position labels at middle of the ring
-    label_radius = 0.70
-    # Adjust angle to start from top and go clockwise
-    x = label_radius * np.cos(mid_angle - pi / 2 + pi)
-    y = label_radius * np.sin(mid_angle - pi / 2 + pi)
-
-    # Use white text for dark backgrounds, dark for light backgrounds
-    text_color = "white" if color in ["#306998", "#FF6B6B", "#4ECDC4"] else "#333333"
-
-    label = Label(
-        x=x,
-        y=y,
-        text=pct,
-        text_font_size="26pt",
-        text_color=text_color,
-        text_font_style="bold",
+# Percentage labels on each segment (Bokeh: angle 0 = 3 o'clock, CCW)
+cumulative_starts = np.cumsum([0.0] + angles[:-1])
+for pct, start, ang in zip(percentages, cumulative_starts, angles, strict=True):
+    mid = start + ang / 2
+    label_radius = 0.78
+    x = label_radius * cos(mid)
+    y = label_radius * sin(mid)
+    p.add_layout(
+        Label(
+            x=x,
+            y=y,
+            text=pct,
+            text_font_size="44pt",
+            text_color="#F0EFE8",
+            text_font_style="bold",
+            text_align="center",
+            text_baseline="middle",
+        )
+    )
+
+# Center metric
+p.add_layout(
+    Label(
+        x=0,
+        y=0.13,
+        text="Total budget",
+        text_font_size="40pt",
+        text_color=INK_SOFT,
         text_align="center",
         text_baseline="middle",
     )
-    p.add_layout(label)
-
-# Add center text showing total
-center_label = Label(
-    x=0, y=0.08, text="Total", text_font_size="32pt", text_color="#555555", text_align="center", text_baseline="middle"
-)
-p.add_layout(center_label)
-
-center_value = Label(
-    x=0,
-    y=-0.12,
-    text=str(total),
-    text_font_size="48pt",
-    text_color="#306998",
-    text_font_style="bold",
-    text_align="center",
-    text_baseline="middle",
 )
-p.add_layout(center_value)
-
-# Add legend entries on the right
-legend_x = 1.20
-legend_y_start = 0.6
-legend_spacing = 0.24
-
-for i, (cat, val, color) in enumerate(zip(categories, values, colors, strict=True)):
-    y_pos = legend_y_start - i * legend_spacing
-    # Color box
-    p.rect(x=legend_x, y=y_pos, width=0.10, height=0.10, fill_color=color, line_color=None)
-    # Label text
-    legend_label = Label(
-        x=legend_x + 0.10,
-        y=y_pos,
-        text=f"{cat} ({val}%)",
-        text_font_size="22pt",
-        text_color="#333333",
-        text_align="left",
+p.add_layout(
+    Label(
+        x=0,
+        y=-0.10,
+        text=f"${total:,}K",
+        text_font_size="96pt",
+        text_color=INK,
+        text_font_style="bold",
+        text_align="center",
         text_baseline="middle",
     )
-    p.add_layout(legend_label)
+)
+
+# Style — theme-adaptive chrome
+p.background_fill_color = PAGE_BG
+p.border_fill_color = PAGE_BG
+p.outline_line_color = None
+
+p.title.text_font_size = "56pt"
+p.title.text_color = INK
+p.title.align = "center"
+p.title.text_font_style = "normal"
 
-# Style
-p.title.text_font_size = "36pt"
-p.title.text_color = "#333333"
 p.axis.visible = False
 p.grid.visible = False
-p.outline_line_color = None
-p.background_fill_color = None
-p.border_fill_color = None
+
+p.legend.background_fill_color = ELEVATED_BG
+p.legend.border_line_color = None
+p.legend.label_text_color = INK_SOFT
+p.legend.label_text_font_size = "36pt"
+p.legend.location = "top_right"
+p.legend.spacing = 18
+p.legend.padding = 24
+p.legend.glyph_height = 60
+p.legend.glyph_width = 60
 
 # Save
-export_png(p, filename="plot.png")
-output_file("plot.html")
+export_png(p, filename=f"plot-{THEME}.png")
+output_file(f"plot-{THEME}.html")
 save(p)

plots/donut-basic/implementations/python/plotly.py

@@ -1,7 +1,7 @@
-""" pyplots.ai
+""" anyplot.ai
 donut-basic: Basic Donut Chart
-Library: plotly 6.5.0 | Python 3.13.11
-Quality: 92/100 | Created: 2025-12-23
+Library: plotly 6.7.0 | Python 3.14.4
+Quality: 89/100 | Updated: 2026-04-24
 """
 
 import plotly.graph_objects as go

plots/donut-basic/implementations/python/plotnine.py

@@ -0,0 +1,129 @@
+""" anyplot.ai
+donut-basic: Basic Donut Chart
+Library: plotnine 0.15.3 | Python 3.14.4
+Quality: 86/100 | Created: 2026-04-24
+"""
+
+import math
+import os
+import sys
+
+
+# Avoid name collision: drop this script's directory from sys.path
+# so `from plotnine import ...` resolves to the installed package.
+_HERE = os.path.dirname(os.path.abspath(__file__))
+sys.path = [p for p in sys.path if os.path.abspath(p) != _HERE]
+
+import numpy as np  # noqa: E402
+import pandas as pd  # noqa: E402
+from plotnine import (  # noqa: E402
+    aes,
+    annotate,
+    coord_fixed,
+    element_blank,
+    element_rect,
+    element_text,
+    geom_polygon,
+    geom_text,
+    ggplot,
+    labs,
+    scale_fill_identity,
+    scale_x_continuous,
+    scale_y_continuous,
+    theme,
+)
+
+
+# Theme tokens
+THEME = os.getenv("ANYPLOT_THEME", "light")
+PAGE_BG = "#FAF8F1" if THEME == "light" else "#1A1A17"
+INK = "#1A1A17" if THEME == "light" else "#F0EFE8"
+INK_SOFT = "#4A4A44" if THEME == "light" else "#B8B7B0"
+LABEL_ON_WEDGE = "#F0EFE8"
+
+# Okabe-Ito palette (first segment is always the brand green)
+OKABE_ITO = ["#009E73", "#D55E00", "#0072B2", "#CC79A7", "#E69F00"]
+
+# Data - Annual budget allocation by department (USD thousands)
+categories = ["Engineering", "Marketing", "Operations", "Sales", "Support"]
+values = [480, 210, 155, 125, 55]
+total = sum(values)
+
+# Ring dimensions
+inner_radius = 0.62
+outer_radius = 1.0
+label_radius = 1.18
+pct_radius = (inner_radius + outer_radius) / 2
+
+# Build annular-segment polygons for each category
+wedge_rows = []
+label_rows = []
+pct_rows = []
+
+start_angle = math.pi / 2  # Start at 12 o'clock
+for category, value, color in zip(categories, values, OKABE_ITO, strict=True):
+    sweep = (value / total) * 2 * math.pi
+    end_angle = start_angle - sweep  # Clockwise
+
+    # Slight gap between wedges for crisp separation
+    gap = 0.008
+    a0 = end_angle + gap
+    a1 = start_angle - gap
+
+    n = 80
+    inner_arc = np.linspace(a0, a1, n)
+    outer_arc = np.linspace(a1, a0, n)
+
+    points = [(inner_radius * math.cos(a), inner_radius * math.sin(a)) for a in inner_arc]
+    points += [(outer_radius * math.cos(a), outer_radius * math.sin(a)) for a in outer_arc]
+
+    for order, (x, y) in enumerate(points):
+        wedge_rows.append({"x": x, "y": y, "segment": category, "order": order, "fill": color})
+
+    mid_angle = (start_angle + end_angle) / 2
+    label_rows.append(
+        {"x": label_radius * math.cos(mid_angle), "y": label_radius * math.sin(mid_angle), "label": category}
+    )
+    pct_rows.append(
+        {
+            "x": pct_radius * math.cos(mid_angle),
+            "y": pct_radius * math.sin(mid_angle),
+            "label": f"{value / total * 100:.1f}%",
+        }
+    )
+
+    start_angle = end_angle
+
+wedge_df = pd.DataFrame(wedge_rows)
+label_df = pd.DataFrame(label_rows)
+pct_df = pd.DataFrame(pct_rows)
+
+# Plot
+plot = (
+    ggplot()
+    + geom_polygon(aes(x="x", y="y", group="segment", fill="fill"), data=wedge_df, color=PAGE_BG, size=1.2)
+    + geom_text(aes(x="x", y="y", label="label"), data=pct_df, size=14, fontweight="bold", color=LABEL_ON_WEDGE)
+    + geom_text(aes(x="x", y="y", label="label"), data=label_df, size=16, color=INK)
+    + annotate("text", x=0, y=0.13, label="Total budget", size=14, color=INK_SOFT)
+    + annotate("text", x=0, y=-0.08, label=f"${total:,}K", size=28, fontweight="bold", color=INK)
+    + scale_fill_identity()
+    + coord_fixed(ratio=1)
+    + scale_x_continuous(limits=(-1.45, 1.45))
+    + scale_y_continuous(limits=(-1.35, 1.35))
+    + labs(title="Budget by Department · donut-basic · plotnine · anyplot.ai")
+    + theme(
+        figure_size=(12, 12),
+        plot_background=element_rect(fill=PAGE_BG, color=PAGE_BG),
+        panel_background=element_rect(fill=PAGE_BG, color=PAGE_BG),
+        plot_title=element_text(size=22, color=INK, ha="center", margin={"b": 18}),
+        axis_title=element_blank(),
+        axis_text=element_blank(),
+        axis_ticks=element_blank(),
+        axis_line=element_blank(),
+        panel_grid_major=element_blank(),
+        panel_grid_minor=element_blank(),
+        legend_position="none",
+    )
+)
+
+plot.save(f"plot-{THEME}.png", dpi=300)