Merge branch 'main' into implementation/step-basic/seaborn

Author: MarkusNeusinger

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

@@ -1,13 +1,14 @@
 """ anyplot.ai
 step-basic: Basic Step Plot
-Library: matplotlib 3.10.9 | Python 3.13.13
-Quality: 88/100 | Updated: 2026-04-30
+Library: matplotlib 3.11.1 | Python 3.13.14
+Quality: 90/100 | Updated: 2026-07-25
 """
 
 import os
 
 import matplotlib.pyplot as plt
 import numpy as np
+from matplotlib.colors import to_rgba
 
 
 # Theme tokens
@@ -16,51 +17,77 @@
 ELEVATED_BG = "#FFFDF6" if THEME == "light" else "#242420"
 INK = "#1A1A17" if THEME == "light" else "#F0EFE8"
 INK_SOFT = "#4A4A44" if THEME == "light" else "#B8B7B0"
-BRAND = "#009E73"  # Okabe-Ito position 1
+BRAND = "#009E73"  # Imprint palette position 1
 
 # Data - monthly cumulative sales figures
-np.random.seed(42)
-months = np.arange(1, 13)
 month_labels = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"]
 
 monthly_sales = np.array([45, 52, 48, 61, 55, 72, 68, 85, 78, 92, 88, 105])
 cumulative_sales = np.cumsum(monthly_sales)
+edges = np.arange(0, 13)  # 12 month-wide steps: edges[i] -> edges[i+1] holds cumulative_sales[i]
+
+# Milestone the running total crosses mid-year, for a data-storytelling callout
+milestone = 500
+milestone_idx = int(np.argmax(cumulative_sales >= milestone))
 
 # Plot
-fig, ax = plt.subplots(figsize=(16, 9), facecolor=PAGE_BG)
+fig, ax = plt.subplots(figsize=(8, 4.5), dpi=400, facecolor=PAGE_BG)
 ax.set_facecolor(PAGE_BG)
 
-# Filled area under the step for visual emphasis
-ax.fill_between(months, cumulative_sales, step="post", alpha=0.12, color=BRAND)
-
-# Step line with 'post' style — value applies from current point until next
-ax.step(months, cumulative_sales, where="post", linewidth=3, color=BRAND, label="Cumulative Sales")
+# ax.stairs is the distinctive step-plot API (matplotlib >=3.4): a single
+# StepPatch driven by bin-style edges, used once filled (baseline=0) for the
+# area and once outline-only (baseline=None, no bottom edge) for the line.
+ax.stairs(cumulative_sales, edges, baseline=0, fill=True, color=BRAND, alpha=0.12)
+ax.stairs(cumulative_sales, edges, baseline=None, color=BRAND, linewidth=2.5, label="Cumulative Sales")
 
-# Markers at each data point to highlight discrete change events
+# Markers at the start of each step ('post' style: value holds from this point until the next)
+# Semi-opaque brand fill (rather than a raw page-background cutout) keeps markers
+# prominent against the filled area at small/thumbnail scale in both themes.
 ax.scatter(
-    months, cumulative_sales, s=200, color=PAGE_BG, edgecolors=BRAND, linewidth=2.5, zorder=5, label="Monthly Totals"
+    edges[:-1],
+    cumulative_sales,
+    s=140,
+    facecolors=to_rgba(BRAND, 0.35),
+    edgecolors=BRAND,
+    linewidth=2,
+    zorder=5,
+    label="Monthly Totals",
+)
+
+# Milestone callout
+ax.axhline(milestone, color=INK_SOFT, linewidth=1, linestyle="--", alpha=0.5)
+ax.annotate(
+    f"{milestone}k milestone\nreached in {month_labels[milestone_idx]}",
+    xy=(edges[milestone_idx], milestone),
+    xytext=(edges[milestone_idx] - 2.6, milestone + 130),
+    fontsize=8,
+    color=INK,
+    arrowprops={"arrowstyle": "->", "color": INK_SOFT, "linewidth": 1},
+    bbox={"facecolor": ELEVATED_BG, "edgecolor": INK_SOFT, "boxstyle": "round,pad=0.3", "alpha": 0.9},
 )
 
 # Style
-ax.set_xlabel("Month", fontsize=20, color=INK)
-ax.set_ylabel("Cumulative Sales (thousands $)", fontsize=20, color=INK)
-ax.set_title("step-basic · matplotlib · anyplot.ai", fontsize=24, fontweight="medium", color=INK)
+ax.set_xlabel("Month", fontsize=10, color=INK)
+ax.set_ylabel("Cumulative Sales (thousands $)", fontsize=10, color=INK)
+ax.set_title("step-basic · matplotlib · anyplot.ai", fontsize=12, fontweight="medium", color=INK)
 
-ax.set_xticks(months)
+ax.set_xlim(0, 12)
+ax.set_ylim(0, cumulative_sales.max() * 1.12)
+ax.set_xticks(edges[:-1] + 0.5)
 ax.set_xticklabels(month_labels)
-ax.tick_params(axis="both", labelsize=16, colors=INK_SOFT)
+ax.tick_params(axis="both", labelsize=8, colors=INK_SOFT)
 
 ax.spines["top"].set_visible(False)
 ax.spines["right"].set_visible(False)
 for s in ("left", "bottom"):
     ax.spines[s].set_color(INK_SOFT)
 
-ax.yaxis.grid(True, alpha=0.10, linewidth=0.8, color=INK)
+ax.yaxis.grid(True, alpha=0.15, linewidth=0.8, color=INK)
 
-leg = ax.legend(fontsize=16, loc="upper left")
+leg = ax.legend(fontsize=8, loc="upper left")
 leg.get_frame().set_facecolor(ELEVATED_BG)
 leg.get_frame().set_edgecolor(INK_SOFT)
 plt.setp(leg.get_texts(), color=INK_SOFT)
 
 plt.tight_layout()
-plt.savefig(f"plot-{THEME}.png", dpi=300, bbox_inches="tight", facecolor=PAGE_BG)
+plt.savefig(f"plot-{THEME}.png", dpi=400, facecolor=PAGE_BG)  # bbox_inches stays default (None)

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

@@ -1,7 +1,7 @@
 """ anyplot.ai
 step-basic: Basic Step Plot
-Library: plotly 6.7.0 | Python 3.13.13
-Quality: 89/100 | Created: 2026-04-30
+Library: plotly 6.9.0 | Python 3.13.14
+Quality: 89/100 | Created: 2026-07-25
 """
 
 import os
@@ -10,14 +10,13 @@
 import plotly.graph_objects as go
 
 
-# Theme tokens
+# Theme tokens (Imprint palette — theme-adaptive chrome)
 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"
-GRID = "rgba(26,26,23,0.10)" if THEME == "light" else "rgba(240,239,232,0.10)"
-BRAND = "#009E73"  # Okabe-Ito position 1
+GRID = "rgba(26,26,23,0.15)" if THEME == "light" else "rgba(240,239,232,0.15)"
+BRAND = "#009E73"  # Imprint palette position 1
 
 # Data - Monthly cumulative sales showing discrete jumps
 np.random.seed(42)
@@ -26,6 +25,7 @@
 
 monthly_sales = np.random.randint(15000, 45000, size=12)
 cumulative_sales = np.cumsum(monthly_sales)
+year_total = int(cumulative_sales[-1])
 
 # Plot
 fig = go.Figure()
@@ -35,48 +35,69 @@
         x=x,
         y=cumulative_sales,
         mode="lines+markers",
-        line={"shape": "hv", "color": BRAND, "width": 4},
-        marker={"size": 14, "color": BRAND, "line": {"color": PAGE_BG, "width": 2}},
+        line={"shape": "hv", "color": BRAND, "width": 3},
+        marker={"size": 11, "color": BRAND, "line": {"color": PAGE_BG, "width": 2}},
+        fill="tozeroy",
+        fillcolor="rgba(0,158,115,0.12)",
         name="Cumulative Sales",
+        customdata=months,
+        hovertemplate="<b>%{customdata}</b><br>Cumulative: $%{y:,.0f}<extra></extra>",
     )
 )
 
+# Year-total reference line — focal point highlighting the running total
+fig.add_hline(y=year_total, line_dash="dot", line_color=INK_SOFT, line_width=1.5, opacity=0.7)
+fig.add_annotation(
+    x=0,
+    xref="paper",
+    y=year_total,
+    yref="y",
+    xanchor="left",
+    yanchor="bottom",
+    yshift=12,
+    text=f"Year total ${year_total:,.0f}",
+    showarrow=False,
+    font={"size": 11, "color": INK_SOFT},
+)
+
 # Style
 fig.update_layout(
+    autosize=False,
+    width=800,
+    height=450,
     paper_bgcolor=PAGE_BG,
     plot_bgcolor=PAGE_BG,
     font={"color": INK},
     title={
-        "text": "Monthly Cumulative Sales · step-basic · plotly · anyplot.ai",
-        "font": {"size": 28, "color": INK},
+        "text": "step-basic · python · plotly · anyplot.ai",
+        "font": {"size": 16, "color": INK},
         "x": 0.5,
         "xanchor": "center",
     },
     xaxis={
-        "title": {"text": "Month", "font": {"size": 22, "color": INK}},
-        "tickfont": {"size": 18, "color": INK_SOFT},
+        "title": {"text": "Month", "font": {"size": 12, "color": INK}},
+        "tickfont": {"size": 10, "color": INK_SOFT},
         "tickmode": "array",
         "tickvals": x,
         "ticktext": months,
-        "showgrid": True,
-        "gridcolor": GRID,
-        "gridwidth": 1,
+        "showgrid": False,
         "linecolor": INK_SOFT,
-        "zerolinecolor": INK_SOFT,
+        "zeroline": False,
     },
     yaxis={
-        "title": {"text": "Cumulative Sales ($)", "font": {"size": 22, "color": INK}},
-        "tickfont": {"size": 18, "color": INK_SOFT},
+        "title": {"text": "Cumulative Sales ($)", "font": {"size": 12, "color": INK}},
+        "tickfont": {"size": 10, "color": INK_SOFT},
         "showgrid": True,
         "gridcolor": GRID,
         "gridwidth": 1,
         "linecolor": INK_SOFT,
-        "zerolinecolor": INK_SOFT,
+        "zeroline": False,
+        "rangemode": "tozero",
     },
     showlegend=False,
-    margin={"l": 100, "r": 50, "t": 100, "b": 80},
+    margin={"l": 90, "r": 50, "t": 90, "b": 70},
 )
 
 # Save
-fig.write_image(f"plot-{THEME}.png", width=1600, height=900, scale=3)
+fig.write_image(f"plot-{THEME}.png", width=800, height=450, scale=4)
 fig.write_html(f"plot-{THEME}.html", include_plotlyjs="cdn")

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

@@ -1,61 +1,70 @@
 """ anyplot.ai
 step-basic: Basic Step Plot
-Library: plotnine 0.15.3 | Python 3.13.13
-Quality: 90/100 | Updated: 2026-04-30
+Library: plotnine 0.15.7 | Python 3.13.14
+Quality: 90/100 | Updated: 2026-07-25
 """
 
 import os
 
 import pandas as pd
 from plotnine import (
     aes,
+    annotate,
+    element_blank,
     element_line,
     element_rect,
     element_text,
+    geom_hline,
     geom_point,
     geom_step,
     ggplot,
     labs,
+    scale_x_continuous,
     theme,
     theme_minimal,
 )
 
 
 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"
+INK_TERTIARY = "#6B6A63" if THEME == "light" else "#A8A79F"
 
 BRAND = "#009E73"
 ACCENT = "#C475FD"
 
-# Data - Monthly cumulative sales figures showing discrete jumps
+# Data - Monthly cumulative sales figures showing discrete jumps, vs. an annual target
 months = list(range(1, 13))
+month_labels = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"]
 cumulative_sales = [12, 12, 27, 27, 45, 58, 58, 73, 89, 89, 105, 120]
+target = 100
 
 df = pd.DataFrame({"month": months, "sales": cumulative_sales})
 
 # Plot
 plot = (
     ggplot(df, aes(x="month", y="sales"))
-    + geom_step(color=BRAND, size=1.5, direction="hv")
-    + geom_point(color=ACCENT, size=4, stroke=0.5)
-    + labs(x="Month", y="Cumulative Sales (thousands)", title="step-basic · plotnine · anyplot.ai")
+    + geom_hline(yintercept=target, color=INK_SOFT, size=0.6, linetype="dashed")
+    + annotate("text", x=1, y=target + 5, label=f"Annual target: {target}k", color=INK_TERTIARY, size=6, ha="left")
+    + geom_step(color=BRAND, size=1.0, direction="hv")
+    + geom_point(color=ACCENT, size=2.5, stroke=0.4)
+    + scale_x_continuous(breaks=months, labels=month_labels)
+    + labs(x="Month", y="Cumulative Sales (thousands)", title="step-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),
-        text=element_text(size=14, color=INK),
-        axis_title=element_text(size=20, color=INK),
-        axis_text=element_text(size=16, color=INK_SOFT),
-        plot_title=element_text(size=24, color=INK),
-        panel_grid_major=element_line(color=INK, size=0.3, alpha=0.10),
-        panel_grid_minor=element_line(color=INK, size=0.2, alpha=0.05),
+        text=element_text(size=7, color=INK),
+        axis_title=element_text(size=10, color=INK),
+        axis_text=element_text(size=8, color=INK_SOFT),
+        plot_title=element_text(size=12, color=INK, weight="bold"),
+        panel_grid_major=element_line(color=INK, size=0.3, alpha=0.15),
+        panel_grid_minor=element_blank(),
         axis_line=element_line(color=INK_SOFT),
     )
 )
 
 # Save
-plot.save(f"plot-{THEME}.png", dpi=300, width=16, height=9, verbose=False)
+plot.save(f"plot-{THEME}.png", dpi=400, width=8, height=4.5, units="in", verbose=False)