Merge branch 'main' into implementation/lollipop-basic/altair

Author: MarkusNeusinger

plots/lollipop-basic/implementations/python/matplotlib.py

@@ -1,12 +1,13 @@
 """ anyplot.ai
 lollipop-basic: Basic Lollipop Chart
-Library: matplotlib 3.10.9 | Python 3.14.4
-Quality: 88/100 | Updated: 2026-04-26
+Library: matplotlib 3.11.0 | Python 3.13.14
+Quality: 87/100 | Updated: 2026-07-01
 """
 
 import os
 
 import matplotlib.pyplot as plt
+import matplotlib.ticker as mticker
 import numpy as np
 
 
@@ -15,10 +16,12 @@
 ELEVATED_BG = "#FFFDF6" if THEME == "light" else "#242420"
 INK = "#1A1A17" if THEME == "light" else "#F0EFE8"
 INK_SOFT = "#4A4A44" if THEME == "light" else "#B8B7B0"
+INK_MUTED = "#6B6A63" if THEME == "light" else "#A8A79F"
 
+# Imprint palette — first series always brand green
 BRAND_GREEN = "#009E73"
 
-# Data: Product sales by category
+# Data: retail category sales (thousands)
 categories = [
     "Electronics",
     "Clothing",
@@ -33,27 +36,58 @@
 ]
 values = [87, 72, 65, 58, 52, 45, 41, 38, 32, 25]
 
-# Sort by value descending for clear ranking
-sorted_indices = np.argsort(values)[::-1]
-categories = [categories[i] for i in sorted_indices]
-values = [values[i] for i in sorted_indices]
+# Sort descending for clear ranking story
+order = np.argsort(values)[::-1]
+categories = [categories[i] for i in order]
+values = np.array([values[i] for i in order])
 
-fig, ax = plt.subplots(figsize=(16, 9), facecolor=PAGE_BG)
+avg_val = values.mean()
+
+fig, ax = plt.subplots(figsize=(8, 4.5), dpi=400, facecolor=PAGE_BG)
 ax.set_facecolor(PAGE_BG)
 
-x_positions = np.arange(len(categories))
-ax.vlines(x_positions, ymin=0, ymax=values, color=BRAND_GREEN, linewidth=2.5)
-ax.scatter(x_positions, values, color=BRAND_GREEN, s=300, zorder=3, edgecolors=PAGE_BG, linewidths=1.5)
+x = np.arange(len(categories))
+
+# Stems
+ax.vlines(x, ymin=0, ymax=values, color=BRAND_GREEN, linewidth=2.0, zorder=2)
+
+# Markers — slightly larger for the top performer to create focal point
+marker_sizes = np.where(x == 0, 120, 80)
+ax.scatter(x, values, color=BRAND_GREEN, s=marker_sizes, zorder=3, edgecolors=PAGE_BG, linewidths=1.0)
+
+# Value labels above each marker
+for xi, v in zip(x, values, strict=False):
+    ax.text(xi, v + 2.5, f"{v}K", ha="center", va="bottom", fontsize=8, color=INK_SOFT, fontweight="medium")
+
+# Average reference line — structural anchor for context
+ax.axhline(avg_val, color=INK_MUTED, linewidth=0.9, linestyle="--", zorder=1)
+ax.text(len(x) - 0.5, avg_val + 1.5, f"avg {avg_val:.0f}K", ha="right", va="bottom", fontsize=7.5, color=INK_MUTED)
+
+# Callout annotation on the top performer using matplotlib's annotation API
+ax.annotate(
+    "Top performer",
+    xy=(x[0], values[0]),
+    xytext=(x[0] + 0.9, values[0] + 13),
+    fontsize=6.5,
+    color=INK,
+    ha="center",
+    arrowprops={"arrowstyle": "->", "color": INK_MUTED, "lw": 0.8},
+    bbox={"facecolor": ELEVATED_BG, "edgecolor": INK_SOFT, "boxstyle": "round,pad=0.3", "linewidth": 0.6},
+)
+
+title = "lollipop-basic · python · matplotlib · anyplot.ai"
+ax.set_title(title, fontsize=12, fontweight="medium", color=INK, pad=8)
+ax.set_xlabel("Product Category", fontsize=10, color=INK)
+ax.set_ylabel("Sales (thousands)", fontsize=10, color=INK)
 
-ax.set_xlabel("Product Category", fontsize=20, color=INK)
-ax.set_ylabel("Sales (thousands)", fontsize=20, color=INK)
-ax.set_title("lollipop-basic · matplotlib · anyplot.ai", fontsize=24, fontweight="medium", color=INK)
+ax.set_xticks(x)
+ax.set_xticklabels(categories, rotation=45, ha="right", fontsize=8)
+ax.tick_params(axis="both", labelsize=8, colors=INK_SOFT, labelcolor=INK_SOFT)
 
-ax.set_xticks(x_positions)
-ax.set_xticklabels(categories, rotation=45, ha="right", fontsize=16)
-ax.tick_params(axis="both", labelsize=16, colors=INK_SOFT, labelcolor=INK_SOFT)
+ax.set_ylim(0, max(values) * 1.38)
 
-ax.set_ylim(0, max(values) * 1.1)
+# Tidy y-axis numeric labels via FuncFormatter
+ax.yaxis.set_major_formatter(mticker.FuncFormatter(lambda v, _: f"{v:.0f}"))
 
 ax.spines["top"].set_visible(False)
 ax.spines["right"].set_visible(False)
@@ -63,5 +97,6 @@
 ax.yaxis.grid(True, alpha=0.15, color=INK, linewidth=0.8)
 ax.set_axisbelow(True)
 
-plt.tight_layout()
-plt.savefig(f"plot-{THEME}.png", dpi=300, bbox_inches="tight", facecolor=PAGE_BG)
+# Manual margins — bbox_inches must stay None (default) to preserve exact canvas size
+fig.subplots_adjust(left=0.10, right=0.97, top=0.91, bottom=0.26)
+plt.savefig(f"plot-{THEME}.png", dpi=400, facecolor=PAGE_BG)

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

@@ -1,7 +1,7 @@
 """ anyplot.ai
 lollipop-basic: Basic Lollipop Chart
-Library: plotly 6.7.0 | Python 3.14.4
-Quality: 87/100 | Updated: 2026-04-26
+Library: plotly 6.8.0 | Python 3.13.14
+Quality: 92/100 | Updated: 2026-07-01
 """
 
 import os
@@ -15,90 +15,112 @@
 ELEVATED_BG = "#FFFDF6" if THEME == "light" else "#242420"
 INK = "#1A1A17" if THEME == "light" else "#F0EFE8"
 INK_SOFT = "#4A4A44" if THEME == "light" else "#B8B7B0"
-GRID = "rgba(26,26,23,0.10)" if THEME == "light" else "rgba(240,239,232,0.10)"
-BRAND = "#009E73"  # Okabe-Ito position 1 — ALWAYS first series
+GRID = "rgba(26,26,23,0.15)" if THEME == "light" else "rgba(240,239,232,0.15)"
+BRAND = "#009E73"  # Imprint palette position 1 — ALWAYS first series
+ACCENT = "#C475FD"  # Imprint palette position 2 — focal point for top performer
 
-# Data — Product sales by category (deterministic, sorted descending)
-categories = [
-    "Electronics",
-    "Clothing",
-    "Home & Garden",
-    "Sports",
-    "Books",
-    "Toys",
-    "Beauty",
-    "Automotive",
-    "Food & Grocery",
-    "Health",
+# Data — streaming platform monthly watch hours by genre (thousands of hours, sorted descending)
+genres = [
+    "Drama",
+    "Comedy",
+    "Thriller",
+    "Action",
+    "Documentary",
+    "Animation",
+    "Romance",
+    "Horror",
+    "Reality TV",
+    "Sci-Fi",
 ]
-values = [124820, 97340, 86715, 75260, 64480, 53905, 47620, 41370, 37815, 30945]
+watch_hours = [3840, 2970, 2450, 2180, 1820, 1540, 1280, 990, 820, 650]
 
 # Plot
 fig = go.Figure()
 
-# Stems — one segmented Scatter trace via None separators (single trace, fewer DOM nodes)
-stem_x = []
-stem_y = []
-for cat, val in zip(categories, values, strict=True):
-    stem_x.extend([cat, cat, None])
-    stem_y.extend([0, val, None])
+# Accent stem first — anchors Drama as the leftmost category on the x-axis
+fig.add_trace(
+    go.Scatter(
+        x=[genres[0], genres[0], None],
+        y=[0, watch_hours[0], None],
+        mode="lines",
+        line={"color": ACCENT, "width": 3},
+        showlegend=False,
+        hoverinfo="skip",
+    )
+)
+
+# Standard stems — brand color for positions 1–9 via None-separator trick
+stem_x, stem_y = [], []
+for genre, hours in zip(genres[1:], watch_hours[1:], strict=True):
+    stem_x.extend([genre, genre, None])
+    stem_y.extend([0, hours, None])
 
 fig.add_trace(
     go.Scatter(x=stem_x, y=stem_y, mode="lines", line={"color": BRAND, "width": 3}, showlegend=False, hoverinfo="skip")
 )
 
-# Markers — circular dots at the top of each stem
+# Markers — top performer in accent, rest in brand green
+marker_colors = [ACCENT] + [BRAND] * (len(genres) - 1)
 fig.add_trace(
     go.Scatter(
-        x=categories,
-        y=values,
+        x=genres,
+        y=watch_hours,
         mode="markers",
-        marker={"color": BRAND, "size": 22, "line": {"color": PAGE_BG, "width": 2.5}, "symbol": "circle"},
+        marker={"color": marker_colors, "size": 22, "line": {"color": PAGE_BG, "width": 2.5}, "symbol": "circle"},
         showlegend=False,
-        hovertemplate="<b>%{x}</b><br>Sales: $%{y:,.0f}<extra></extra>",
+        hovertemplate="<b>%{x}</b><br>%{y:,.0f}k hours/month<extra></extra>",
         cliponaxis=False,
     )
 )
 
+# Title fontsize scaled for length (plotly default 16px, floor 11px)
+title_text = "Streaming Hours by Genre · lollipop-basic · python · plotly · anyplot.ai"
+title_fontsize = max(11, round(16 * 67 / len(title_text)))
+
 # Style
 fig.update_layout(
+    autosize=False,
     title={
-        "text": "Product Sales by Category · lollipop-basic · plotly · anyplot.ai",
-        "font": {"size": 28, "color": INK},
+        "text": title_text,
+        "font": {"size": title_fontsize, "color": INK},
         "x": 0.5,
         "xanchor": "center",
-        "y": 0.95,
+        "y": 0.97,
     },
     xaxis={
-        "title": {"text": "Product Category", "font": {"size": 22, "color": INK}},
-        "tickfont": {"size": 18, "color": INK_SOFT},
+        "title": {"text": "Content Genre", "font": {"size": 12, "color": INK}},
+        "tickfont": {"size": 10, "color": INK_SOFT},
         "tickangle": -35,
         "showgrid": False,
+        "showline": True,
+        "mirror": False,
         "linecolor": INK_SOFT,
         "ticks": "outside",
         "tickcolor": INK_SOFT,
         "ticklen": 6,
     },
     yaxis={
-        "title": {"text": "Sales ($)", "font": {"size": 22, "color": INK}},
-        "tickfont": {"size": 18, "color": INK_SOFT},
-        "tickformat": "$,.0f",
+        "title": {"text": "Watch Hours (thousands/month)", "font": {"size": 12, "color": INK}},
+        "tickfont": {"size": 10, "color": INK_SOFT},
+        "tickformat": ",.0f",
         "gridcolor": GRID,
         "gridwidth": 1,
         "zeroline": True,
         "zerolinecolor": INK_SOFT,
         "zerolinewidth": 1.5,
+        "showline": True,
+        "mirror": False,
         "linecolor": INK_SOFT,
-        "range": [0, max(values) * 1.1],
+        "range": [0, max(watch_hours) * 1.12],
     },
     paper_bgcolor=PAGE_BG,
     plot_bgcolor=PAGE_BG,
     font={"color": INK, "family": "Inter, system-ui, sans-serif"},
-    margin={"l": 110, "r": 60, "t": 110, "b": 160},
+    margin={"l": 110, "r": 60, "t": 80, "b": 140},
     showlegend=False,
-    hoverlabel={"bgcolor": ELEVATED_BG, "bordercolor": INK_SOFT, "font": {"color": INK, "size": 16}},
+    hoverlabel={"bgcolor": ELEVATED_BG, "bordercolor": INK_SOFT, "font": {"color": INK, "size": 14}},
 )
 
-# Save
-fig.write_image(f"plot-{THEME}.png", width=1600, height=900, scale=3)
+# Save — canonical 3200×1800 landscape canvas
+fig.write_image(f"plot-{THEME}.png", width=800, height=450, scale=4)
 fig.write_html(f"plot-{THEME}.html", include_plotlyjs="cdn")

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

@@ -1,22 +1,32 @@
 """ anyplot.ai
 lollipop-basic: Basic Lollipop Chart
-Library: plotnine 0.15.3 | Python 3.14.4
-Quality: 85/100 | Updated: 2026-04-26
+Library: plotnine 0.15.7 | Python 3.13.14
+Quality: 84/100 | Updated: 2026-07-01
 """
 
 import os
+import sys
+
+
+# Prevent circular import: remove this script's directory from sys.path so
+# "from plotnine import ..." resolves to the installed library, not this file.
+_here = os.path.dirname(os.path.abspath(__file__))
+sys.path = [p for p in sys.path if os.path.abspath(p) != _here]
 
 import pandas as pd
 from plotnine import (
     aes,
+    element_blank,
     element_line,
     element_rect,
     element_text,
     geom_point,
     geom_segment,
+    geom_text,
     ggplot,
     ggsave,
     labs,
+    scale_size_continuous,
     theme,
     theme_minimal,
 )
@@ -28,7 +38,7 @@
 INK_SOFT = "#4A4A44" if THEME == "light" else "#B8B7B0"
 BRAND = "#009E73"
 
-# Data - Product sales by category, sorted by value
+# Product sales by category, sorted ascending for ranking narrative
 data = {
     "category": [
         "Electronics",
@@ -48,28 +58,37 @@
 df = pd.DataFrame(data)
 df = df.sort_values("value", ascending=True).reset_index(drop=True)
 df["category"] = pd.Categorical(df["category"], categories=df["category"], ordered=True)
+df["label"] = df["value"].astype(str) + "k"
 
-# Plot
 plot = (
     ggplot(df, aes(x="category", y="value"))
-    + geom_segment(aes(x="category", xend="category", y=0, yend="value"), color=BRAND, size=1.5)
-    + geom_point(color=BRAND, size=6, fill=BRAND)
-    + labs(x="Product Category", y="Sales (thousands $)", title="lollipop-basic · plotnine · anyplot.ai")
+    + geom_segment(aes(x="category", xend="category", y=0, yend="value"), color=BRAND, size=0.6)
+    + geom_point(aes(size="value"), color=BRAND, fill=BRAND, show_legend=False)
+    + geom_text(
+        aes(label="label"),
+        color=INK_SOFT,
+        size=2.8,  # geom_text size is in mm (~2.8mm ≈ 8pt at dpi=400)
+        nudge_y=16,
+        va="bottom",
+    )
+    + scale_size_continuous(range=[2, 7])
+    + labs(x="Product Category", y="Sales (thousands $)", title="lollipop-basic · python · plotnine · anyplot.ai")
     + theme_minimal()
     + theme(
-        figure_size=(16, 9),
+        figure_size=(8, 4.5),
         plot_background=element_rect(fill=PAGE_BG, color=PAGE_BG),
         panel_background=element_rect(fill=PAGE_BG, color=PAGE_BG),
-        text=element_text(size=14, color=INK),
-        axis_title=element_text(size=20, color=INK),
-        axis_text=element_text(size=16, color=INK_SOFT),
+        panel_border=element_blank(),
+        text=element_text(size=7, color=INK),
+        axis_title=element_text(size=10, color=INK),
+        axis_text=element_text(size=8, color=INK_SOFT),
         axis_text_x=element_text(angle=45, ha="right", color=INK_SOFT),
         axis_line=element_line(color=INK_SOFT),
-        plot_title=element_text(size=24, color=INK),
-        panel_grid_minor=element_line(alpha=0),
-        panel_grid_major_x=element_line(alpha=0),
+        plot_title=element_text(size=12, color=INK),
+        panel_grid_minor=element_blank(),
+        panel_grid_major_x=element_blank(),
         panel_grid_major_y=element_line(color=INK, alpha=0.15, size=0.3),
     )
 )
 
-ggsave(plot, filename=f"plot-{THEME}.png", dpi=300, width=16, height=9)
+ggsave(plot, filename=f"plot-{THEME}.png", dpi=400, width=8, height=4.5, units="in")