feat(plotly): implement circos-basic

[github-actions]

Implementation: circos-basic - python/plotly

Implements the python/plotly version of circos-basic.

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

Parent Issue: #3005

---

🤖 impl-generate workflow

[claude]

AI Review - Attempt 1/3

Image Description

Light render (plot-light.png): The plot displays a sophisticated circos chart on a warm off-white background (#FAF8F1) with 8 geographic segments arranged in a circle. The outer ring features distinct Okabe-Ito colored arcs (starting with brand green #009E73 for North America), with segment labels positioned around the circle at appropriate radii and angles. Semi-transparent blended ribbons connect related segments based on trade flow values, creating a flowing visual pattern. An inner concentric track shows GDP index values as colored bars for each region. The title 'circos-basic · plotly · anyplot.ai' is clearly readable in dark text at the top. A horizontal legend at the bottom lists all segments with matching colors. All text elements (title, labels, legend) are fully readable with excellent contrast against the light background.

Dark render (plot-dark.png): The same circos structure renders on a warm near-black background (#1A1A17) with all text and chrome properly adapted to light colors. The segment colors are identical to the light render (only chrome flipped), confirming theme-adaptive design. Title and labels now render in light INK color, maintaining perfect readability. The legend background is darker (#242420) with light text. All elements remain clearly visible—no dark-on-dark failures, and the brand green (#009E73) remains vibrant on the dark surface. Both renders demonstrate consistent, professional theme adaptation.

Score: 91/100

Category	Score	Max
Visual Quality	30	30
Design Excellence	14	20
Spec Compliance	15	15
Data Quality	15	15
Code Quality	10	10
Library Mastery	7	10
Total	91	100

Visual Quality (30/30)

• VQ-01: Text Legibility (8/8) - All font sizes explicitly set; perfectly readable in both themes
• VQ-02: No Overlap (6/6) - Segment labels properly positioned with smart anchor logic
• VQ-03: Element Visibility (6/6) - All elements optimally visible and adapted to circular layout
• VQ-04: Color Accessibility (2/2) - Okabe-Ito palette; good contrast; CVD-safe
• VQ-05: Layout & Canvas (4/4) - Plot fills 60-70% of canvas with balanced margins
• VQ-06: Axis Labels & Title (2/2) - Descriptive title in correct format
• VQ-07: Palette Compliance (2/2) - First series #009E73 ✓; Okabe-Ito order ✓; backgrounds correct ✓; theme-adaptive text ✓

Design Excellence (14/20)

• DE-01: Aesthetic Sophistication (5/8) - Thoughtful Bezier ribbons and color blending, but relies on defaults rather than custom innovations
• DE-02: Visual Refinement (5/6) - Clean, refined layout with no unnecessary elements
• DE-03: Data Storytelling (4/6) - Good visual hierarchy; could emphasize key patterns more

Spec Compliance (15/15)

• SC-01: Plot Type (5/5) - Correct circos with all subtypes present
• SC-02: Required Features (4/4) - All spec features realized: segments, proportional ribbons, color coding, inner track
• SC-03: Data Mapping (3/3) - Circular coordinates correct; all values proportional
• SC-04: Title & Legend (3/3) - Title format and legend labels correct

Data Quality (15/15)

• DQ-01: Feature Coverage (6/6) - Shows all circos aspects with varying sizes and strengths
• DQ-02: Realistic Context (5/5) - Real-world trade flow scenario; neutral and plausible
• DQ-03: Appropriate Scale (4/4) - All proportions factually sensible

Code Quality (10/10)

• CQ-01: KISS Structure (3/3) - Linear flow; no unnecessary functions
• CQ-02: Reproducibility (2/2) - seed(42) set; deterministic data
• CQ-03: Clean Imports (2/2) - All imports used
• CQ-04: Code Elegance (2/2) - Pythonic; Bezier math well-executed
• CQ-05: Output & API (1/1) - Correct output format and API

Library Mastery (7/10)

• LM-01: Idiomatic Usage (4/5) - Proper use of go.Figure(), add_trace(), update_layout()
• LM-02: Distinctive Features (3/5) - Bezier ribbon construction and advanced annotation positioning show sophistication

Score Caps Applied

• None

Strengths

• Excellent theme adaptation: both renders perfectly readable with consistent data colors
• Sophisticated Bezier ribbon construction with color blending creates visual interest
• Smart annotation positioning logic handles all quadrants correctly
• Complete spec compliance with all required features fully realized
• Clean, reproducible code with deterministic data

Weaknesses

• Design Excellence could be elevated: consider custom color palette or more striking visual emphasis on key patterns

Issues Found

None — implementation is solid and ready for publication.

AI Feedback for Next Attempt

N/A — this implementation is APPROVED on first review.

Verdict: APPROVED