feat(plotnine): implement circos-basic

[github-actions]

Implementation: circos-basic - python/plotnine

Implements the python/plotnine version of circos-basic.

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

Parent Issue: #3005

---

🤖 impl-generate workflow

[claude]

AI Review - Attempt 1/3

Image Description

Light render (plot-light.png): The circos plot displays trade flows between 6 world regions (Asia, Europe, North America, South America, Middle East, Africa) on a warm off-white (#FAF8F1) background. The outer ring features colored segments for each region, with proportional arc widths showing regional trade importance. Semi-transparent ribbon connections show trade magnitude through width. An inner concentric track layer adds depth. Circular grid lines are subtle. The title "circos-basic · plotnine · anyplot.ai" is displayed prominently in dark text (24pt, bold). Region labels positioned around the circle at 14pt, bold, are fully readable. The legend (right-positioned, 16pt title, 14pt text) clearly identifies all regions. All text contrasts well against the light background with no legibility issues.

Dark render (plot-dark.png): The same circos structure renders on a warm near-black (#1A1A17) background. The data colors (segment colors and ribbon colors) are identical to the light render—only the chrome has adapted to the dark theme. The title and region labels are light-colored text (#F0EFE8) and remain perfectly readable. The legend box has an elevated background (#242420) providing sufficient contrast. Grid lines are subtle and visible. The brand green (#009E73) segment is clearly distinguishable. All text is light-on-dark with no dark-on-dark failures. Both renders successfully implement theme-adaptive design with data colors staying constant.

Score: 90/100

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

Visual Quality (30/30)

• VQ-01: Text Legibility (8/8) - All fonts explicitly sized; title 24pt, labels 14pt, legend 16pt/14pt; perfectly readable in both themes
• VQ-02: No Overlap (6/6) - No overlapping text; region labels well-spaced; legend isolated on right
• VQ-03: Element Visibility (6/6) - Ribbons clearly visible with proportional widths; segments distinct; tracks visible
• VQ-04: Color Accessibility (2/2) - Okabe-Ito palette is colorblind-safe; alpha blending (0.5 ribbons, 0.4 tracks) maintains contrast
• VQ-05: Layout & Canvas (4/4) - 12×12 figure size; plot fills 50-70% of canvas; well-balanced margins; nothing cut-off
• VQ-06: Axis Labels & Title (2/2) - Title correct format; region labels serve as descriptive positioning
• VQ-07: Palette Compliance (2/2) - First segment uses #009E73 (brand green); all colors follow Okabe-Ito order; background colors correct (#FAF8F1 light, #1A1A17 dark); chrome properly theme-adapted in both renders

Design Excellence (13/20)

• DE-01: Aesthetic Sophistication (5/8) - Professional layout with thoughtful use of transparency (alpha 0.5, 0.4, 0.15); intentional visual hierarchy; elegant but relatively standard for circos plot type
• DE-02: Visual Refinement (4/6) - Subtle grid (alpha 0.15), clean spacing, generous whitespace, no axis clutter; good refinement without exceptional polish
• DE-03: Data Storytelling (4/6) - Circos effectively conveys trade flows; ribbon width encodes magnitude; color by source aids identification; clear visual relationships and hierarchy guide viewer through data

Spec Compliance (15/15)

• SC-01: Plot Type (5/5) - Correct circos plot with all expected components (segments, ribbons, tracks, labels)
• SC-02: Required Features (4/4) - All present: segments with gaps, proportional ribbon widths, distinct segment colors, concentric tracks
• SC-03: Data Mapping (3/3) - Source/target map to ribbon endpoints; value maps to width; segment size maps to arc size; all relationships clear
• SC-04: Title & Legend (3/3) - Title format correct; legend properly labeled with region names

Data Quality (15/15)

• DQ-01: Feature Coverage (6/6) - Shows full range of trade flows (weak and strong); all regions represented; varying magnitudes; inner track demonstrates multi-layer capability
• DQ-02: Realistic Context (5/5) - Real-world trade flows between recognizable world regions; plausible values and proportions; neutral, non-controversial topic
• DQ-03: Appropriate Scale (4/4) - Values appropriate for global trade (85, 72, 45, etc.); proportions realistic; no factual impossibilities

Code Quality (10/10)

• CQ-01: KISS Structure (3/3) - Linear flow: imports → data → geometry construction → plot creation → save; no functions or classes
• CQ-02: Reproducibility (2/2) - Hardcoded deterministic data; fully reproducible
• CQ-03: Clean Imports (2/2) - Only used imports (os, numpy, pandas, plotnine components)
• CQ-04: Code Elegance (2/2) - Clean, well-structured code; appropriate complexity; no fake functionality
• CQ-05: Output & API (1/1) - Correct output format (plot-{THEME}.png); DPI=300; current API

Library Mastery (7/10)

• LM-01: Idiomatic Usage (5/5) - Expert ggplot grammar: ggplot() + geom_*() + theme(); proper aes() mapping; coord_fixed() for aspect; scale_fill_manual() for colors; idiomatic theme configuration
• LM-02: Distinctive Features (2/5) - Uses Bezier curve interpolation for ribbon paths and manual geometry construction, but this is custom data work rather than library-specific features; geoms used are generic (polygon, path, text)

Score Caps Applied

• None applied

Strengths

• Perfect visual quality with all text explicitly sized and readable in both themes
• Excellent theme-adaptive implementation with proper chrome flipping and data color consistency
• Clean code structure following KISS principle with deterministic data
• Proper palette compliance: first segment correctly uses brand green (#009E73)
• Realistic, neutral data context showing plausible world trade patterns
• All specification requirements met with correct plot type and features
• Strong visual hierarchy and clear data storytelling through ribbon proportions

Weaknesses

• Library mastery limited: implementation uses generic plotnine geoms rather than leveraging library-specific features; most sophistication is in manual geometry calculation, not plotnine patterns
• Design excellence moderate: while functional and professional, lacks exceptional aesthetic polish or custom visual refinements beyond defaults
• Visual storytelling could be strengthened with additional emphasis techniques (e.g., highlighting key trade corridors or regional clusters)

Issues Found

None requiring fixes. Implementation is publication-ready.

AI Feedback for Next Attempt

N/A - Implementation approved at 90/100, exceeding Review 1 threshold (≥90).

Verdict: APPROVED