diff --git a/plots/bar-3d-categorical/implementations/python/matplotlib.py b/plots/bar-3d-categorical/implementations/python/matplotlib.py new file mode 100644 index 0000000000..e99a56938f --- /dev/null +++ b/plots/bar-3d-categorical/implementations/python/matplotlib.py @@ -0,0 +1,91 @@ +""" anyplot.ai +bar-3d-categorical: 3D Bar Chart for Categorical Comparison +Library: matplotlib 3.10.9 | Python 3.13.13 +Quality: 80/100 | Created: 2026-05-15 +""" + +import os + +import matplotlib.pyplot as plt +import numpy as np +from mpl_toolkits.mplot3d import Axes3D # noqa: F401 + + +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_MUTED = "#6B6A63" if THEME == "light" else "#A8A79F" + +# Data: retail sales (thousands USD) by product category and region +products = ["Electronics", "Clothing", "Home & Garden", "Sports"] +regions = ["North", "South", "East", "West"] + +sales = np.array([[142, 98, 115, 87], [76, 103, 91, 118], [55, 71, 63, 49], [88, 95, 72, 110]]) + +# Plot +fig = plt.figure(figsize=(16, 9), facecolor=PAGE_BG) +ax = fig.add_subplot(111, projection="3d", computed_zorder=False) +fig.subplots_adjust(left=0.0, right=0.85, bottom=0.05, top=0.92) + +# Theme-adaptive pane styling +for pane in (ax.xaxis.pane, ax.yaxis.pane, ax.zaxis.pane): + pane.fill = False + pane.set_edgecolor(INK_SOFT) + pane.set_alpha(0.4) + +ax.grid(True, alpha=0.10, linewidth=0.6, color=INK) + +norm = plt.Normalize(vmin=sales.min(), vmax=sales.max()) +cmap = plt.get_cmap("viridis") + +bar_width = 0.55 +bar_depth = 0.55 +num_products = len(products) +num_regions = len(regions) + +for i in range(num_products): + for j in range(num_regions): + value = sales[i, j] + color = cmap(norm(value)) + ax.bar3d( + i - bar_width / 2, j - bar_depth / 2, 0, bar_width, bar_depth, value, color=color, alpha=0.88, shade=True + ) + ax.text(i, j, value + 5, f"{value}", ha="center", va="bottom", fontsize=10, color=INK, fontweight="semibold") + +# View angle and z-axis headroom for value labels +ax.view_init(elev=28, azim=-48) +ax.set_zlim(0, 165) + +# Axis ticks and labels +ax.set_xticks(range(num_products)) +ax.set_xticklabels(products, fontsize=13, color=INK_SOFT) +ax.set_yticks(range(num_regions)) +ax.set_yticklabels(regions, fontsize=13, color=INK_SOFT) +ax.tick_params(axis="z", labelsize=13, colors=INK_SOFT) + +ax.set_xlabel("Product Category", fontsize=15, color=INK, labelpad=16) +ax.set_ylabel("Region", fontsize=15, color=INK, labelpad=16) +ax.set_zlabel("$ thousands", fontsize=14, color=INK_SOFT, labelpad=12) + +ax.set_title( + "Retail Sales by Product & Region · bar-3d-categorical · matplotlib · anyplot.ai", + fontsize=20, + fontweight="medium", + color=INK, + pad=16, +) + +# Colorbar — placed in its own axes to avoid tight_layout conflicts +cbar_ax = fig.add_axes([0.87, 0.15, 0.025, 0.65]) +sm = plt.cm.ScalarMappable(cmap=cmap, norm=norm) +sm.set_array([]) +cbar = fig.colorbar(sm, cax=cbar_ax) +cbar.set_label("Sales ($ thousands)", fontsize=14, color=INK) +cbar.ax.tick_params(labelsize=12, colors=INK_SOFT) +plt.setp(cbar.ax.yaxis.get_ticklabels(), color=INK_SOFT) +cbar.outline.set_edgecolor(INK_SOFT) +cbar_ax.set_facecolor(PAGE_BG) + +plt.savefig(f"plot-{THEME}.png", dpi=300, bbox_inches="tight", facecolor=PAGE_BG) diff --git a/plots/bar-3d-categorical/metadata/python/matplotlib.yaml b/plots/bar-3d-categorical/metadata/python/matplotlib.yaml new file mode 100644 index 0000000000..bdaa9dd57d --- /dev/null +++ b/plots/bar-3d-categorical/metadata/python/matplotlib.yaml @@ -0,0 +1,254 @@ +library: matplotlib +language: python +specification_id: bar-3d-categorical +created: '2026-05-15T09:00:40Z' +updated: '2026-05-15T09:17:03Z' +generated_by: claude-sonnet +workflow_run: 25909112458 +issue: 5248 +python_version: 3.13.13 +library_version: 3.10.9 +preview_url_light: https://storage.googleapis.com/anyplot-images/plots/bar-3d-categorical/python/matplotlib/plot-light.png +preview_url_dark: https://storage.googleapis.com/anyplot-images/plots/bar-3d-categorical/python/matplotlib/plot-dark.png +preview_html_light: null +preview_html_dark: null +quality_score: 80 +review: + strengths: + - 'Perfect spec compliance: all spec features present (spacing, viewing angle, value + labels, colorbar, grid, color encoding)' + - Realistic retail business scenario with meaningful variation across product/region + combinations + - Clean KISS structure, deterministic data, proper imports + - Correct viridis colormap for continuous value encoding (spec-appropriate and guideline-compliant) + - 'Thorough theme-adaptive chrome: pane edges, colorbar label/ticks/outline, value + labels, and axis labels all use theme tokens correctly in both renders' + - computed_zorder=False and shade=True show understanding of matplotlib 3D rendering + subtleties + weaknesses: + - 'Font sizes below guidelines: title 20pt (needs >=24), axis labels 15pt (needs + >=20), tick labels 13pt (needs >=16), value labels 10pt too small for 4800px canvas' + - Back-row value labels partially occluded by foreground bars due to 3D perspective + (positions 115, 87, 49) + - Dual height+color encoding redundantly encodes the same variable — color could + encode a different dimension for added analytical depth + - 'No visual storytelling: no focal point or emphasis on peak/trough bars (Electronics-North + 142k, Home & Garden-West 49k)' + image_description: |- + Light render (plot-light.png): + Background: Warm off-white, consistent with #FAF8F1 — correct theme surface + Chrome: Title "Retail Sales by Product & Region · bar-3d-categorical · matplotlib · anyplot.ai" in dark ink, readable. Axis labels "Product Category" and "Region" in dark ink (INK=#1A1A17), z-label "$ thousands" in INK_SOFT. Tick labels (Electronics, Clothing, Home & Garden, Sports; North, South, East, West) in dark ink, readable. Colorbar label and tick values in dark ink on right side. + Data: Bars colored with viridis — purple/dark blue for lowest values (~49k), through teal/green to yellow for highest (~142k). All 16 bars (4 products × 4 regions) visible. Value labels (10pt, dark) on top of each bar. Electronics-North tallest at 142 (yellow-green). + Legibility verdict: PASS — all text readable, though font sizes are below guidelines (title 20pt vs >=24, labels 15pt vs >=20, ticks 13pt vs >=16). Some back-row value labels (115, 87, 49) partially occluded by foreground bars inherent to 3D perspective. + + Dark render (plot-dark.png): + Background: Warm near-black, consistent with #1A1A17 — correct dark theme surface + Chrome: Title text appears light cream (#F0EFE8), readable against dark background. Axis labels "Product Category" and "Region" in light INK color (#F0EFE8), visible. Tick labels in light INK_SOFT (#B8B7B0), readable. Colorbar label and tick values in light colors. No dark-on-dark failures detected. + Data: Viridis colormap colors are identical to the light render — purple for low values, yellow for high values. Value labels on bars appear in light cream color (#F0EFE8), readable against bar surfaces. Data encoding unchanged between themes; only chrome flips. + Legibility verdict: PASS — all text readable in dark mode. Same font size limitations apply. Same partial occlusion of back-row value labels as in light render. + criteria_checklist: + visual_quality: + score: 23 + max: 30 + items: + - id: VQ-01 + name: Text Legibility + score: 5 + max: 8 + passed: true + comment: 'All sizes explicitly set but below guidelines: title 20pt (needs + >=24), labels 15pt (needs >=20), ticks 13pt (needs >=16), value labels 10pt + too small' + - id: VQ-02 + name: No Overlap + score: 4 + max: 6 + passed: true + comment: 'Some back-row value labels partially occluded by foreground bars + (inherent 3D depth: positions 115, 87, 49)' + - id: VQ-03 + name: Element Visibility + score: 5 + max: 6 + passed: true + comment: Bars well-sized (width/depth 0.55), shade=True adds realism, alpha=0.88 + appropriate + - id: VQ-04 + name: Color Accessibility + score: 2 + max: 2 + passed: true + comment: Viridis is perceptually-uniform and CVD-safe; value labels provide + per-bar precision + - id: VQ-05 + name: Layout & Canvas + score: 3 + max: 4 + passed: true + comment: Good layout; colorbar well-placed via add_axes; some empty foreground + space due to 3D perspective + - id: VQ-06 + name: Axis Labels & Title + score: 2 + max: 2 + passed: true + comment: Product Category, Region, $ thousands, colorbar Sales ($ thousands) + — all descriptive with context + - id: VQ-07 + name: Palette Compliance + score: 2 + max: 2 + passed: true + comment: 'Viridis correct for continuous sequential data; backgrounds #FAF8F1/#1A1A17; + all chrome theme-adaptive in both renders' + design_excellence: + score: 10 + max: 20 + items: + - id: DE-01 + name: Aesthetic Sophistication + score: 4 + max: 8 + passed: true + comment: Well-configured 3D chart with thoughtful pane styling and colorbar, + but doesn't exceed a polished library default + - id: DE-02 + name: Visual Refinement + score: 4 + max: 6 + passed: true + comment: Pane fill disabled, grid at alpha=0.10, deliberate colorbar placement + via add_axes — good 3D-appropriate refinement + - id: DE-03 + name: Data Storytelling + score: 2 + max: 6 + passed: false + comment: Dual encoding height+color both encode same value — no focal point, + no narrative, no visual hierarchy guiding viewer to insight + spec_compliance: + score: 15 + max: 15 + items: + - id: SC-01 + name: Plot Type + score: 5 + max: 5 + passed: true + comment: Correct 3D bar chart with bars rising from 2D categorical grid + - id: SC-02 + name: Required Features + score: 4 + max: 4 + passed: true + comment: Bar spacing, color encoding via viridis, viewing angle 28 deg/-48 + deg, base grid, value labels on all 16 bars, colorbar — all present + - id: SC-03 + name: Data Mapping + score: 3 + max: 3 + passed: true + comment: Product on X, Region on Y, Sales on Z; full 4x4 = 16 bars visible + - id: SC-04 + name: Title & Legend + score: 3 + max: 3 + passed: true + comment: Title contains spec-id, library, anyplot.ai; colorbar serves as legend + with clear Sales ($ thousands) label + data_quality: + score: 15 + max: 15 + items: + - id: DQ-01 + name: Feature Coverage + score: 6 + max: 6 + passed: true + comment: Full 4x4 grid, meaningful value variation (49-142k), dual encoding + demonstrates color+height + - id: DQ-02 + name: Realistic Context + score: 5 + max: 5 + passed: true + comment: Retail sales by product and region — realistic, neutral business + scenario + - id: DQ-03 + name: Appropriate Scale + score: 4 + max: 4 + passed: true + comment: Values 49-142k USD plausible for retail; Electronics-North highest + is realistic + code_quality: + score: 10 + max: 10 + items: + - id: CQ-01 + name: KISS Structure + score: 3 + max: 3 + passed: true + comment: 'Linear: imports -> data -> plot -> save; no functions or classes' + - id: CQ-02 + name: Reproducibility + score: 2 + max: 2 + passed: true + comment: Hardcoded sales array; fully deterministic + - id: CQ-03 + name: Clean Imports + score: 2 + max: 2 + passed: true + comment: All imports used; Axes3D side-effect import with noqa is standard + 3D matplotlib pattern + - id: CQ-04 + name: Code Elegance + score: 2 + max: 2 + passed: true + comment: Clean nested loop, proper norm/cmap pattern, no fake UI, no over-engineering + - id: CQ-05 + name: Output & API + score: 1 + max: 1 + passed: true + comment: Saves as plot-{THEME}.png; API usage current + library_mastery: + score: 7 + max: 10 + items: + - id: LM-01 + name: Idiomatic Usage + score: 4 + max: 5 + passed: true + comment: Correct use of projection=3d, computed_zorder=False, ax.bar3d(), + ax.view_init(), fig.add_axes() for colorbar + - id: LM-02 + name: Distinctive Features + score: 3 + max: 5 + passed: true + comment: computed_zorder=False (3D depth ordering control), xaxis.pane styling + (3D-only API), shade=True on bar3d — distinctive to matplotlib mpl_toolkits + verdict: APPROVED +impl_tags: + dependencies: [] + techniques: + - 3d-projection + - colorbar + - annotations + - manual-ticks + patterns: + - matrix-construction + - iteration-over-groups + - explicit-figure + dataprep: + - normalization + styling: + - custom-colormap + - alpha-blending + - grid-styling