chore(plotly): add metadata for sankey-basic

github-actions[bot] · github-actions[bot] · commit fcdf14ed7877 · 2026-04-30T08:55:02.000Z
diff --git a/plots/sankey-basic/implementations/python/plotly.py b/plots/sankey-basic/implementations/python/plotly.py
@@ -1,91 +1,83 @@
-""" pyplots.ai
+"""anyplot.ai
 sankey-basic: Basic Sankey Diagram
-Library: plotly 6.5.0 | Python 3.13.11
-Quality: 93/100 | Created: 2025-12-23
+Library: plotly | Python 3.13
+Quality: pending | Updated: 2026-04-30
 """
 
+import os
+
 import plotly.graph_objects as go
 
 
-# Data - Energy flow from sources to end-use sectors (in TWh)
+# 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"
+
+# Okabe-Ito palette for source nodes (positions 1-4)
+OKABE_ITO = ["#009E73", "#D55E00", "#0072B2", "#CC79A7"]
+SOURCE_RGBA = ["rgba(0,158,115,0.4)", "rgba(213,94,0,0.4)", "rgba(0,114,178,0.4)", "rgba(204,121,167,0.4)"]
+
+# Data - Energy flow from sources to sectors (TWh)
 sources = ["Coal", "Natural Gas", "Nuclear", "Renewables"]
 targets = ["Residential", "Commercial", "Industrial", "Transportation"]
-
-# Node labels (sources first, then targets)
 labels = sources + targets
 
-# Define flows: (source_index, target_index, value)
-# Indices: Coal=0, Gas=1, Nuclear=2, Renewables=3
-# Residential=4, Commercial=5, Industrial=6, Transportation=7
 flows = [
-    # Coal flows
-    (0, 4, 5),  # Coal -> Residential
-    (0, 5, 8),  # Coal -> Commercial
-    (0, 6, 25),  # Coal -> Industrial
-    # Natural Gas flows
-    (1, 4, 22),  # Gas -> Residential
-    (1, 5, 18),  # Gas -> Commercial
-    (1, 6, 15),  # Gas -> Industrial
-    (1, 7, 3),  # Gas -> Transportation
-    # Nuclear flows
-    (2, 4, 12),  # Nuclear -> Residential
-    (2, 5, 10),  # Nuclear -> Commercial
-    (2, 6, 8),  # Nuclear -> Industrial
-    # Renewables flows
-    (3, 4, 8),  # Renewables -> Residential
-    (3, 5, 6),  # Renewables -> Commercial
-    (3, 6, 5),  # Renewables -> Industrial
-    (3, 7, 4),  # Renewables -> Transportation
+    (0, 4, 5),
+    (0, 5, 8),
+    (0, 6, 25),
+    (1, 4, 22),
+    (1, 5, 18),
+    (1, 6, 15),
+    (1, 7, 3),
+    (2, 4, 12),
+    (2, 5, 10),
+    (2, 6, 8),
+    (3, 4, 8),
+    (3, 5, 6),
+    (3, 6, 5),
+    (3, 7, 4),
 ]
 
 source_indices = [f[0] for f in flows]
 target_indices = [f[1] for f in flows]
 values = [f[2] for f in flows]
 
-# Colors for source nodes (Python Blue variations and Yellow)
-node_colors = [
-    "#306998",  # Coal - Python Blue
-    "#4A90C2",  # Natural Gas - Light Blue
-    "#FFD43B",  # Nuclear - Python Yellow
-    "#7AB648",  # Renewables - Green
-    "#8FA8BD",  # Residential
-    "#A3B8CC",  # Commercial
-    "#B8C9DB",  # Industrial
-    "#CCD9E8",  # Transportation
-]
-
-# Link colors with transparency (based on source)
-link_colors = [
-    "rgba(48, 105, 152, 0.5)"
-    if s == 0
-    else "rgba(74, 144, 194, 0.5)"
-    if s == 1
-    else "rgba(255, 212, 59, 0.5)"
-    if s == 2
-    else "rgba(122, 182, 72, 0.5)"
-    for s in source_indices
-]
+# Source nodes use Okabe-Ito colors; target nodes use INK_SOFT
+node_colors = OKABE_ITO + [INK_SOFT] * 4
+link_colors = [SOURCE_RGBA[s] for s in source_indices]
 
-# Create Sankey diagram
+# Plot
 fig = go.Figure(
     data=[
         go.Sankey(
-            node=dict(pad=25, thickness=35, line=dict(color="white", width=2), label=labels, color=node_colors),
-            link=dict(source=source_indices, target=target_indices, value=values, color=link_colors),
+            node={
+                "pad": 25,
+                "thickness": 35,
+                "line": {"color": PAGE_BG, "width": 1},
+                "label": labels,
+                "color": node_colors,
+            },
+            link={"source": source_indices, "target": target_indices, "value": values, "color": link_colors},
         )
     ]
 )
 
-# Update layout for 4800x2700 px output
 fig.update_layout(
-    title=dict(
-        text="Energy Distribution · sankey-basic · plotly · pyplots.ai", font=dict(size=36), x=0.5, xanchor="center"
-    ),
-    font=dict(size=22),
-    template="plotly_white",
-    margin=dict(l=80, r=80, t=120, b=60),
+    title={
+        "text": "Energy Distribution · sankey-basic · plotly · anyplot.ai",
+        "font": {"size": 28, "color": INK},
+        "x": 0.5,
+        "xanchor": "center",
+    },
+    paper_bgcolor=PAGE_BG,
+    plot_bgcolor=PAGE_BG,
+    font={"size": 22, "color": INK},
+    margin={"l": 80, "r": 80, "t": 120, "b": 60},
 )
 
-# Save outputs
-fig.write_image("plot.png", width=1600, height=900, scale=3)
-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")
diff --git a/plots/sankey-basic/metadata/python/plotly.yaml b/plots/sankey-basic/metadata/python/plotly.yaml
@@ -1,215 +1,21 @@
+# Per-library metadata for plotly implementation of sankey-basic
+# Auto-generated by impl-generate.yml
+
 library: plotly
+language: python
 specification_id: sankey-basic
 created: '2025-12-23T19:43:26Z'
-updated: '2025-12-23T19:52:16Z'
-generated_by: claude-opus-4-5-20251101
-workflow_run: 20469993740
-issue: 0
-python_version: 3.13.11
-library_version: 6.5.0
-preview_url: https://storage.googleapis.com/anyplot-images/plots/sankey-basic/plotly/plot.png
-preview_html: https://storage.googleapis.com/anyplot-images/plots/sankey-basic/plotly/plot.html
-quality_score: 93
-impl_tags:
-  dependencies: []
-  techniques:
-    - html-export
-  patterns: []
-  dataprep: []
-  styling: []
+updated: '2026-04-30T08:55:02Z'
+generated_by: claude-sonnet
+workflow_run: 25156267074
+issue: 810
+python_version: 3.13.13
+library_version: 6.7.0
+preview_url_light: https://storage.googleapis.com/anyplot-images/plots/sankey-basic/python/plotly/plot-light.png
+preview_url_dark: https://storage.googleapis.com/anyplot-images/plots/sankey-basic/python/plotly/plot-dark.png
+preview_html_light: https://storage.googleapis.com/anyplot-images/plots/sankey-basic/python/plotly/plot-light.html
+preview_html_dark: https://storage.googleapis.com/anyplot-images/plots/sankey-basic/python/plotly/plot-dark.html
+quality_score: null
 review:
-  strengths:
-  - Excellent use of Plotly go.Sankey with proper node/link configuration
-  - Well-chosen color scheme with source-based link coloring and appropriate transparency
-  - Realistic energy distribution scenario that effectively demonstrates Sankey diagram
-    purpose
-  - Clean code structure following KISS principles with clear data organization
-  - Proper output sizing (1600x900 scale=3) producing 4800x2700 target resolution
-  weaknesses:
-  - Could include flow value labels on hover or annotations to show exact TWh values
-  - Transportation sector only receives flows from Gas and Renewables, missing Coal
-    and Nuclear contributions
-  image_description: "The plot displays a Sankey diagram showing energy distribution\
-    \ from four source nodes (Natural Gas, Nuclear, Renewables, Coal) on the left\
-    \ to four target nodes (Residential, Commercial, Transportation, Industrial) on\
-    \ the right. \n\n**Colors**: Source nodes use distinct colors - dark blue for\
-    \ Coal, light blue for Natural Gas, yellow for Nuclear, and green for Renewables.\
-    \ Target nodes use muted grayish-blue tones. Flow links are semi-transparent (alpha\
-    \ ~0.5) and colored to match their source.\n\n**Title**: \"Energy Distribution\
-    \ · sankey-basic · plotly · pyplots.ai\" centered at top in appropriate font size.\n\
-    \n**Layout**: The diagram fills the canvas well with adequate margins. Node labels\
-    \ are positioned clearly next to their respective nodes. Flow widths are proportional\
-    \ to values, making it easy to identify major pathways (Natural Gas → Residential\
-    \ being the largest flow)."
-  criteria_checklist:
-    visual_quality:
-      score: 38
-      max: 40
-      items:
-      - id: VQ-01
-        name: Text Legibility
-        score: 10
-        max: 10
-        passed: true
-        comment: 'All text clearly readable: title at appropriate size (~36pt), node
-          labels at ~22pt, all crisp and legible'
-      - id: VQ-02
-        name: No Overlap
-        score: 8
-        max: 8
-        passed: true
-        comment: No overlapping text; node labels are well-positioned and do not interfere
-          with flows
-      - id: VQ-03
-        name: Element Visibility
-        score: 8
-        max: 8
-        passed: true
-        comment: Flow links appropriately sized with 0.5 opacity allowing visibility
-          where flows cross
-      - id: VQ-04
-        name: Color Accessibility
-        score: 5
-        max: 5
-        passed: true
-        comment: Color scheme uses blue, yellow, green which are colorblind-friendly;
-          distinct hues for different sources
-      - id: VQ-05
-        name: Layout Balance
-        score: 5
-        max: 5
-        passed: true
-        comment: Excellent canvas utilization; diagram fills ~70% of space with balanced
-          margins
-      - id: VQ-06
-        name: Axis Labels
-        score: 0
-        max: 2
-        passed: true
-        comment: N/A for Sankey diagrams (no axes) - applying 2 points for node labels
-          which are descriptive
-      - id: VQ-07
-        name: Grid & Legend
-        score: 2
-        max: 2
-        passed: true
-        comment: Clean white template, no distracting elements; node colors serve
-          as implicit legend
-    spec_compliance:
-      score: 25
-      max: 25
-      items:
-      - id: SC-01
-        name: Plot Type
-        score: 8
-        max: 8
-        passed: true
-        comment: Correct Sankey diagram showing flows between nodes
-      - id: SC-02
-        name: Data Mapping
-        score: 5
-        max: 5
-        passed: true
-        comment: Source-target-value correctly mapped; link widths proportional to
-          flow values
-      - id: SC-03
-        name: Required Features
-        score: 5
-        max: 5
-        passed: true
-        comment: 'All spec features present: distinct colors for sources, link opacity
-          for crossing flows, clear node labels'
-      - id: SC-04
-        name: Data Range
-        score: 3
-        max: 3
-        passed: true
-        comment: All flows visible and readable
-      - id: SC-05
-        name: Legend Accuracy
-        score: 2
-        max: 2
-        passed: true
-        comment: Node labels accurately describe each category
-      - id: SC-06
-        name: Title Format
-        score: 2
-        max: 2
-        passed: true
-        comment: 'Follows exact format: "Energy Distribution · sankey-basic · plotly
-          · pyplots.ai"'
-    data_quality:
-      score: 18
-      max: 20
-      items:
-      - id: DQ-01
-        name: Feature Coverage
-        score: 7
-        max: 8
-        passed: true
-        comment: 'Shows flows from 4 sources to 4 targets with varying magnitudes;
-          demonstrates multiple flow paths and crossings; minor: could show more dramatic
-          variation in flow sizes'
-      - id: DQ-02
-        name: Realistic Context
-        score: 7
-        max: 7
-        passed: true
-        comment: Energy distribution from sources (Coal, Gas, Nuclear, Renewables)
-          to sectors (Residential, Commercial, Industrial, Transportation) is a classic,
-          comprehensible real-world scenario
-      - id: DQ-03
-        name: Appropriate Scale
-        score: 4
-        max: 5
-        passed: true
-        comment: 'Values in TWh are sensible for energy; Natural Gas having highest
-          residential flow is realistic; minor: Transportation sector could have more
-          diverse energy sources'
-    code_quality:
-      score: 10
-      max: 10
-      items:
-      - id: CQ-01
-        name: KISS Structure
-        score: 3
-        max: 3
-        passed: true
-        comment: 'Simple linear structure: imports → data → colors → figure creation
-          → layout → save'
-      - id: CQ-02
-        name: Reproducibility
-        score: 3
-        max: 3
-        passed: true
-        comment: Deterministic data (no random values used)
-      - id: CQ-03
-        name: Clean Imports
-        score: 2
-        max: 2
-        passed: true
-        comment: Only `plotly.graph_objects` imported and used
-      - id: CQ-04
-        name: No Deprecated API
-        score: 1
-        max: 1
-        passed: true
-        comment: Uses current Plotly API (go.Sankey)
-      - id: CQ-05
-        name: Output Correct
-        score: 1
-        max: 1
-        passed: true
-        comment: Saves as `plot.png` and `plot.html`
-    library_features:
-      score: 5
-      max: 5
-      items:
-      - id: LF-01
-        name: Uses distinctive library features
-        score: 5
-        max: 5
-        passed: true
-        comment: Uses Plotly's interactive Sankey with go.Sankey, custom node padding/thickness,
-          link transparency, HTML output for interactivity
-  verdict: APPROVED
+  strengths: []
+  weaknesses: []
