Merge branch 'main' into implementation/stem-basic/pygal

Author: MarkusNeusinger

plots/stem-basic/implementations/python/altair.py

@@ -1,58 +1,108 @@
-""" pyplots.ai
+""" anyplot.ai
 stem-basic: Basic Stem Plot
-Library: altair 6.0.0 | Python 3.13.11
-Quality: 92/100 | Created: 2025-12-23
+Library: altair 6.1.0 | Python 3.13.13
+Quality: 89/100 | Updated: 2026-04-30
 """
 
+import os
+
 import altair as alt
 import numpy as np
 import pandas as pd
 
 
-# Data - Discrete signal samples (simulating a damped oscillation)
+# 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"
+BRAND = "#009E73"  # Okabe-Ito position 1
+
+# Data — acoustic impulse response samples
 np.random.seed(42)
-x = np.arange(0, 30)
-y = np.exp(-x / 10) * np.cos(x * 0.8) + np.random.randn(30) * 0.05
+n_samples = 30
+sample_index = np.arange(n_samples)
+amplitude = np.exp(-sample_index / 8) * np.cos(sample_index * 0.9) + np.random.randn(n_samples) * 0.03
+
+df = pd.DataFrame({"n": sample_index, "amplitude": amplitude, "baseline": 0.0})
+
+# Decay envelope — highlights the exponential decay story
+n_env = np.linspace(0, n_samples - 1, 200)
+env_df = pd.DataFrame({"n": n_env, "upper": np.exp(-n_env / 8), "lower": -np.exp(-n_env / 8)})
 
-df = pd.DataFrame({"x": x, "y": y, "y0": 0})
+# Shaded decay region (subtle background emphasis)
+envelope_area = (
+    alt.Chart(env_df)
+    .mark_area(color=BRAND, opacity=0.07)
+    .encode(x=alt.X("n:Q"), y=alt.Y("upper:Q"), y2=alt.Y2("lower:Q"))
+)
+
+# Dashed bounds of the decay envelope
+envelope_upper = (
+    alt.Chart(env_df)
+    .mark_line(color=INK_SOFT, strokeWidth=1.5, strokeDash=[5, 4], opacity=0.45)
+    .encode(x=alt.X("n:Q"), y=alt.Y("upper:Q"))
+)
 
-# Create stems (vertical lines from baseline y=0 to each data point)
+envelope_lower = (
+    alt.Chart(env_df)
+    .mark_line(color=INK_SOFT, strokeWidth=1.5, strokeDash=[5, 4], opacity=0.45)
+    .encode(x=alt.X("n:Q"), y=alt.Y("lower:Q"))
+)
+
+# Baseline rule at y=0
+baseline_rule = alt.Chart(pd.DataFrame({"y": [0]})).mark_rule(color=INK_SOFT, strokeWidth=1.5).encode(y=alt.Y("y:Q"))
+
+# Stems: vertical rules from baseline to each data point
 stems = (
     alt.Chart(df)
-    .mark_rule(color="#306998", strokeWidth=2.5, opacity=0.8)
+    .mark_rule(color=BRAND, strokeWidth=2.5, opacity=0.85)
     .encode(
-        x=alt.X("x:Q", title="Sample Index", axis=alt.Axis(labelFontSize=18, titleFontSize=22)),
-        y=alt.Y("y0:Q"),
-        y2=alt.Y2("y:Q"),
+        x=alt.X("n:Q", title="Sample Index (n)", axis=alt.Axis(labelFontSize=18, titleFontSize=22)),
+        y=alt.Y("baseline:Q"),
+        y2=alt.Y2("amplitude:Q"),
     )
 )
 
-# Create markers at the top of each stem
+# Markers at the tip of each stem
 markers = (
     alt.Chart(df)
-    .mark_circle(color="#306998", size=300, stroke="white", strokeWidth=2)
+    .mark_circle(color=BRAND, size=300, stroke=PAGE_BG, strokeWidth=2)
     .encode(
-        x=alt.X("x:Q"),
-        y=alt.Y("y:Q", title="Amplitude", axis=alt.Axis(labelFontSize=18, titleFontSize=22)),
-        tooltip=[alt.Tooltip("x:Q", title="Sample"), alt.Tooltip("y:Q", title="Amplitude", format=".3f")],
+        x=alt.X("n:Q"),
+        y=alt.Y("amplitude:Q", title="Amplitude (a.u.)", axis=alt.Axis(labelFontSize=18, titleFontSize=22)),
+        tooltip=[
+            alt.Tooltip("n:Q", title="Sample (n)"),
+            alt.Tooltip("amplitude:Q", title="Amplitude (a.u.)", format=".3f"),
+        ],
     )
 )
 
-# Create baseline at y=0
-baseline = alt.Chart(pd.DataFrame({"y": [0]})).mark_rule(color="#333333", strokeWidth=2).encode(y=alt.Y("y:Q"))
-
-# Combine stems, markers, and baseline
+# Compose and apply theme-adaptive chrome
 chart = (
-    (baseline + stems + markers)
+    (envelope_area + envelope_upper + envelope_lower + baseline_rule + stems + markers)
     .properties(
-        width=1600, height=900, title=alt.Title("stem-basic · altair · pyplots.ai", fontSize=28, anchor="middle")
+        width=1600,
+        height=900,
+        background=PAGE_BG,
+        title=alt.Title("stem-basic · altair · anyplot.ai", fontSize=28, anchor="middle", color=INK),
+    )
+    .configure_view(fill=PAGE_BG, stroke=None)
+    .configure_axis(
+        domainColor=INK_SOFT,
+        tickColor=INK_SOFT,
+        gridColor=INK,
+        gridOpacity=0.10,
+        labelColor=INK_SOFT,
+        titleColor=INK,
+        labelFontSize=18,
+        titleFontSize=22,
     )
-    .configure_axis(labelFontSize=18, titleFontSize=22, grid=True, gridOpacity=0.3, gridDash=[4, 4])
-    .configure_view(strokeWidth=0)
+    .configure_axisX(grid=False)
+    .configure_title(color=INK, fontSize=28)
 )
 
-# Save as PNG (scale_factor=3 to get 4800x2700)
-chart.save("plot.png", scale_factor=3.0)
-
-# Save as HTML for interactive version
-chart.save("plot.html")
+# Save
+chart.save(f"plot-{THEME}.png", scale_factor=3.0)
+chart.save(f"plot-{THEME}.html")

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

@@ -1,22 +1,35 @@
-""" pyplots.ai
+""" anyplot.ai
 stem-basic: Basic Stem Plot
-Library: bokeh 3.8.1 | Python 3.13.11
-Quality: 91/100 | Created: 2025-12-23
+Library: bokeh 3.9.0 | Python 3.13.13
+Quality: 84/100 | Updated: 2026-04-30
 """
 
+import os
+import sys
+
+
+sys.path = [p for p in sys.path if not p.endswith("/python")]
+
 import numpy as np
 from bokeh.io import export_png, output_file, save
 from bokeh.models import ColumnDataSource
 from bokeh.plotting import figure
 
 
+# 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"
+BRAND = "#009E73"
+
 # Data - Discrete signal samples (damped oscillation)
 np.random.seed(42)
 n_points = 30
 x = np.arange(n_points)
 y = np.exp(-0.1 * x) * np.sin(0.5 * x) * 2 + np.random.randn(n_points) * 0.1
 
-# Baseline for stems
 baseline = 0
 
 # Create data sources
@@ -27,39 +40,48 @@
 p = figure(
     width=4800,
     height=2700,
-    title="stem-basic · bokeh · pyplots.ai",
+    title="stem-basic · bokeh · anyplot.ai",
     x_axis_label="Sample Index",
     y_axis_label="Amplitude",
 )
 
 # Draw stems (vertical lines from baseline to data points)
-p.segment(x0="x0", y0="y0", x1="x1", y1="y1", source=stem_source, line_width=4, color="#306998", alpha=0.8)
+p.segment(x0="x0", y0="y0", x1="x1", y1="y1", source=stem_source, line_width=4, color=BRAND, alpha=0.85)
 
 # Draw markers at data points
-p.scatter(x="x", y="y", source=source, size=25, color="#306998", alpha=0.9)
+p.scatter(x="x", y="y", source=source, size=25, color=BRAND, alpha=1.0)
 
 # Draw baseline
-p.line(
-    x=[x.min() - 0.5, x.max() + 0.5],
-    y=[baseline, baseline],
-    line_width=3,
-    line_dash="dashed",
-    color="#999999",
-    alpha=0.6,
-)
+p.line(x=[x.min() - 0.5, x.max() + 0.5], y=[baseline, baseline], line_width=3, color=INK_SOFT, alpha=0.6)
 
-# Styling for 4800x2700
+# Sizing
 p.title.text_font_size = "36pt"
 p.xaxis.axis_label_text_font_size = "28pt"
 p.yaxis.axis_label_text_font_size = "28pt"
 p.xaxis.major_label_text_font_size = "22pt"
 p.yaxis.major_label_text_font_size = "22pt"
 
-# Grid styling
-p.grid.grid_line_alpha = 0.3
-p.grid.grid_line_dash = "dashed"
+# Theme-adaptive chrome
+p.background_fill_color = PAGE_BG
+p.border_fill_color = PAGE_BG
+p.outline_line_color = INK_SOFT
+
+p.title.text_color = INK
+p.xaxis.axis_label_text_color = INK
+p.yaxis.axis_label_text_color = INK
+p.xaxis.major_label_text_color = INK_SOFT
+p.yaxis.major_label_text_color = INK_SOFT
+p.xaxis.axis_line_color = INK_SOFT
+p.yaxis.axis_line_color = INK_SOFT
+p.xaxis.major_tick_line_color = INK_SOFT
+p.yaxis.major_tick_line_color = INK_SOFT
+
+p.xgrid.grid_line_color = INK
+p.ygrid.grid_line_color = INK
+p.xgrid.grid_line_alpha = 0.10
+p.ygrid.grid_line_alpha = 0.10
 
 # Save outputs
-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/stem-basic/implementations/python/plotly.py

@@ -1,82 +1,94 @@
-""" pyplots.ai
+""" anyplot.ai
 stem-basic: Basic Stem Plot
-Library: plotly 6.5.0 | Python 3.13.11
-Quality: 93/100 | Created: 2025-12-23
+Library: plotly 6.7.0 | Python 3.13.13
+Quality: 90/100 | Updated: 2026-04-30
 """
 
+import os
+
 import numpy as np
 import plotly.graph_objects as go
 
 
+# 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"
+GRID = "rgba(26,26,23,0.20)" if THEME == "light" else "rgba(240,239,232,0.20)"
+BRAND = "#009E73"  # Okabe-Ito position 1
+
 # Data - Discrete signal samples (damped oscillation)
 np.random.seed(42)
 x = np.arange(0, 30)
 y = np.exp(-x / 10) * np.cos(x * 0.8) + np.random.randn(30) * 0.05
 
-# Create figure
+# Plot
 fig = go.Figure()
 
-# Add baseline at y=0
+# Baseline at y=0
 fig.add_trace(
     go.Scatter(
         x=[x.min() - 0.5, x.max() + 0.5],
         y=[0, 0],
         mode="lines",
-        line={"color": "#333333", "width": 2},
+        line={"color": INK_SOFT, "width": 2},
         showlegend=False,
         hoverinfo="skip",
     )
 )
 
-# Add stems (vertical lines from baseline to data points)
+# Stems (vertical lines from baseline to data points)
 for xi, yi in zip(x, y, strict=True):
     fig.add_trace(
         go.Scatter(
-            x=[xi, xi],
-            y=[0, yi],
-            mode="lines",
-            line={"color": "#306998", "width": 2},
-            showlegend=False,
-            hoverinfo="skip",
+            x=[xi, xi], y=[0, yi], mode="lines", line={"color": BRAND, "width": 2}, showlegend=False, hoverinfo="skip"
         )
     )
 
-# Add markers at the top of each stem
+# Markers at the top of each stem
 fig.add_trace(
     go.Scatter(
         x=x,
         y=y,
         mode="markers",
-        marker={"color": "#306998", "size": 16, "line": {"color": "white", "width": 2}},
+        marker={"color": BRAND, "size": 16, "line": {"color": PAGE_BG, "width": 2}},
         showlegend=False,
         hovertemplate="Sample: %{x}<br>Amplitude: %{y:.3f}<extra></extra>",
     )
 )
 
-# Update layout for 4800x2700 px
+# Style
 fig.update_layout(
-    title={"text": "stem-basic · plotly · pyplots.ai", "font": {"size": 42}, "x": 0.5, "xanchor": "center"},
+    paper_bgcolor=PAGE_BG,
+    plot_bgcolor=PAGE_BG,
+    font={"color": INK},
+    title={
+        "text": "stem-basic · plotly · anyplot.ai",
+        "font": {"size": 42, "color": INK},
+        "x": 0.5,
+        "xanchor": "center",
+    },
     xaxis={
-        "title": {"text": "Sample Index", "font": {"size": 36}},
-        "tickfont": {"size": 28},
-        "gridcolor": "rgba(0,0,0,0.1)",
+        "title": {"text": "Sample Index (n)", "font": {"size": 36, "color": INK}},
+        "tickfont": {"size": 28, "color": INK_SOFT},
+        "gridcolor": GRID,
         "gridwidth": 1,
         "zeroline": False,
+        "linecolor": INK_SOFT,
     },
     yaxis={
-        "title": {"text": "Amplitude", "font": {"size": 36}},
-        "tickfont": {"size": 28},
-        "gridcolor": "rgba(0,0,0,0.1)",
+        "title": {"text": "Amplitude (a.u.)", "font": {"size": 36, "color": INK}},
+        "tickfont": {"size": 28, "color": INK_SOFT},
+        "gridcolor": GRID,
         "gridwidth": 1,
         "zeroline": False,
+        "linecolor": INK_SOFT,
     },
-    template="plotly_white",
     margin={"l": 120, "r": 60, "t": 130, "b": 110},
     showlegend=False,
 )
 
-# Save as PNG (4800x2700 px)
-fig.write_image("plot.png", width=1600, height=900, scale=3)
-
-# Save interactive HTML
-fig.write_html("plot.html")
+# Save
+fig.write_image(f"plot-{THEME}.png", width=1600, height=900, scale=3)
+fig.write_html(f"plot-{THEME}.html", include_plotlyjs="cdn")