feat(plotly): implement rose-basic

[github-actions]

Implementation: rose-basic - python/plotly

Implements the python/plotly version of rose-basic.

File: plots/rose-basic/implementations/python/plotly.py

Parent Issue: #1003

---

🤖 impl-generate workflow

[claude]

AI Review - Attempt 1/3

Image Description

Light render (plot-light.png): The rose chart is displayed on a warm off-white background consistent with #FAF8F1. Twelve equal-angle wedges represent months (Jan–Dec) arranged clockwise starting from January at the 12 o'clock position. Each bar's radius encodes monthly rainfall (mm), and the viridis colorscale double-encodes the same value — dark blue/teal for the dry summer months (Jun=12mm, Jul=12mm) through yellow-green for the wet winter months (Dec=105mm, Nov=98mm). The title 'rose-basic · plotly · anyplot.ai' appears at the top in a clearly readable dark font (size 48). Month labels around the perimeter are sized at 28px in INK_SOFT tone and are fully legible. Radial tick labels (0–100 mm in 25 mm increments) are positioned at 45° and readable though somewhat stacked near the center. Radial gridlines are subtle. All text is readable against the light background — no light-on-light issues.

Dark render (plot-dark.png): The same rose chart appears on a near-black background consistent with #1A1A17. The title, month labels, and radial tick labels all appear in light-colored text (INK / INK_SOFT tokens). Data colors are identical to the light render — the viridis colorscale produces the same teal-to-yellow gradient across bars, confirming Okabe-Ito independence (only chrome flips). Bar edges use the dark background color for clean definition. Radial gridlines remain subtle (10% opacity). No dark-on-dark failures — all text is clearly readable against the near-black background, including the inner radial labels near the chart center. Both renders pass theme readability.

Score: 90/100

Category	Score	Max
Visual Quality	28	30
Design Excellence	13	20
Spec Compliance	15	15
Data Quality	15	15
Code Quality	10	10
Library Mastery	9	10
Total	90	100

Visual Quality (28/30)

• VQ-01: Text Legibility (8/8) — All font sizes explicitly set: title 48px, angular ticks 28px, radial ticks 22px; fully readable in both themes
• VQ-02: No Overlap (5/6) — Month labels well-spaced; radial labels slightly cramped near center but still readable
• VQ-03: Element Visibility (6/6) — Bars clearly visible, seasonal pattern immediately apparent
• VQ-04: Color Accessibility (2/2) — Viridis is CVD-safe and perceptually uniform
• VQ-05: Layout & Canvas (3/4) — Chart fills canvas well but landscape (16:9) format introduces some side whitespace for a circular plot; square format would be more optimal
• VQ-06: Axis Labels & Title (2/2) — Radial tick suffix 'mm' provides units; title gives context
• VQ-07: Palette Compliance (2/2) — Viridis used correctly for continuous value-mapped data; backgrounds are #FAF8F1 / #1A1A17; all chrome is theme-adaptive

Design Excellence (13/20)

• DE-01: Aesthetic Sophistication (5/8) — Above well-configured defaults: viridis double-encoding is a thoughtful design choice, PAGE_BG separator edges create clean definition, explicit typography sizing; not yet at 'strong design' level
• DE-02: Visual Refinement (4/6) — Subtle 10% opacity grid, custom bar width (0.9), adaptive edge colors on bars, explicit generous margins, clockwise orientation from north; good refinement visible
• DE-03: Data Storytelling (4/6) — Seasonal pattern immediately clear: the double-encoding (taller bar = warmer viridis color) creates strong visual emphasis on wet-season months; viewer instantly sees Nov–Jan wet, Jun–Aug dry

Spec Compliance (15/15)

• SC-01: Plot Type (5/5) — is Plotly's native polar bar (rose) chart type
• SC-02: Required Features (4/4) — Circular format, radius proportional to value, radial gridlines (dtick=25), 12 monthly categories, consistent colorscheme
• SC-03: Data Mapping (3/3) — Months on angular axis, rainfall on radial axis; clockwise direction starting at north (rotation=90) correct for calendar data
• SC-04: Title & Legend (3/3) — Title 'rose-basic · plotly · anyplot.ai' correct format; no legend needed for single-series chart

Data Quality (15/15)

• DQ-01: Feature Coverage (6/6) — Full range of values (12–105 mm) demonstrates the rose chart's ability to show cyclical patterns with prominent seasonal variation
• DQ-02: Realistic Context (5/5) — Monthly rainfall is the canonical, neutral rose chart example; clear real-world meaning
• DQ-03: Appropriate Scale (4/4) — Annual total ~681 mm with winter-peak pattern is factually consistent with a Mediterranean climate; all values are plausible

Code Quality (10/10)

• CQ-01: KISS Structure (3/3) — Linear structure: imports → theme tokens → data → plot → save; no functions or classes
• CQ-02: Reproducibility (2/2) — Hardcoded deterministic data; no randomness
• CQ-03: Clean Imports (2/2) — Only and imported, both used
• CQ-04: Code Elegance (2/2) — Clean, Pythonic dict-based marker config; appropriate complexity
• CQ-05: Output & API (1/1) — Saves and ; current Plotly API

Library Mastery (9/10)

• LM-01: Idiomatic Usage (5/5) — with proper polar axis config (angularaxis, radialaxis, direction, rotation) is idiomatic Plotly
• LM-02: Distinctive Features (4/5) — Plotly-distinctive: trace type, for rich interactive tooltips, for interactive export; interactive features not replicable in static libraries

Score Caps Applied

• None — No caps triggered

Strengths

• Native trace with full polar axis configuration; idiomatic and correct
• Viridis double-encoding (both radius and color encode rainfall value) is a thoughtful design choice that reinforces the seasonal pattern
• Complete theme adaptation: correct backgrounds (/), all chrome tokens applied to polar axis, legend, title
• Deterministic Mediterranean rainfall data is a textbook-quality rose chart example with clear cyclical insight
• Full Plotly interactivity preserved: rich hovertemplate, HTML export alongside PNG

Weaknesses

• Landscape (16:9) format introduces minor side whitespace for a circular chart; square format (1200×1200, scale=3) would better utilize canvas
• Radial labels slightly stacked near chart center; could be improved with fewer ticks or adjusted label placement

Issues Found

1. VQ-05 MINOR: Landscape canvas format (16:9) leaves horizontal whitespace for a circular rose chart
   • Fix: Use for 3600×3600 square format
2. VQ-02 MINOR: Radial tick labels (0–100 mm) slightly cramped near center at 45° angle
   • Fix: Reduce to 3 radial ticks or increase to 30/40

AI Feedback for Next Attempt

Score 90/100 — approved at first attempt threshold. If regenerating: switch to square canvas (3600×3600) for the circular chart and consider fewer radial gridlines to reduce label crowding near center. The viridis double-encoding and theme adaptation are well-executed — preserve both.

Verdict: APPROVED