feat(plotnine): implement venn-basic

[github-actions]

Implementation: venn-basic - plotnine

Implements the plotnine version of venn-basic.

File: plots/venn-basic/implementations/plotnine.py

---

🤖 impl-generate workflow

[claude]

AI Review - Attempt 1/3

Image Description

The plot displays a classic three-circle Venn diagram showing the overlap between Python Developers, Data Scientists, and ML Engineers. The three circles are arranged in a triangular formation with significant overlap in the center. Colors used are a muted blue (#306998) for Python Developers, yellow (#FFD43B) for Data Scientists, and a lighter blue (#4B8BBE) for ML Engineers. Each region displays its count: 60 (Python only), 35 (Data Scientists only), 25 (ML Engineers only), 20 (Python ∩ Data Scientists), 10 (Python ∩ ML), 15 (Data Scientists ∩ ML), and 10 (all three). Set labels are positioned outside the circles. The title "venn-basic · plotnine · pyplots.ai" is centered at the top. The background is clean white with no axes or grid lines visible.

Quality Score: 91/100

Criteria Checklist

Visual Quality (36/40 pts)

• VQ-01: Text Legibility (10/10) - All numbers and labels are clearly readable with appropriate font sizes
• VQ-02: No Overlap (8/8) - No overlapping text, all region counts are well-positioned
• VQ-03: Element Visibility (8/8) - Circles are well-sized with good transparency (alpha=0.45) showing overlaps clearly
• VQ-04: Color Accessibility (4/5) - Colors are distinguishable but two shades of blue could be confusing for some users
• VQ-05: Layout Balance (4/5) - Good use of canvas but slightly more space at bottom than top
• VQ-06: Axis Labels (2/2) - N/A for Venn diagrams, axes correctly hidden
• VQ-07: Grid & Legend (0/2) - Legend hidden as labels are on plot, but no legend explaining what counts mean

Spec Compliance (25/25 pts)

• SC-01: Plot Type (8/8) - Correct three-circle Venn diagram
• SC-02: Data Mapping (5/5) - Set memberships and intersections correctly mapped
• SC-03: Required Features (5/5) - All spec features present: 3 sets, overlaps, counts in regions, distinct colors with transparency
• SC-04: Data Range (3/3) - All regions visible and counts displayed
• SC-05: Legend Accuracy (2/2) - Set labels positioned correctly outside circles
• SC-06: Title Format (2/2) - Uses correct format "venn-basic · plotnine · pyplots.ai"

Data Quality (18/20 pts)

• DQ-01: Feature Coverage (6/8) - Shows all 7 regions of a 3-set Venn but all sets use similar-ish data ranges
• DQ-02: Realistic Context (7/7) - Tech team skills overlap is a plausible, neutral business scenario
• DQ-03: Appropriate Scale (5/5) - Numbers (60, 35, 25, etc.) are realistic for a team/organization context

Code Quality (9/10 pts)

• CQ-01: KISS Structure (3/3) - Clean imports → data → plot → save structure
• CQ-02: Reproducibility (2/3) - Deterministic data (no random), but no explicit seed for any potential randomness
• CQ-03: Clean Imports (2/2) - All imports are used
• CQ-04: No Deprecated API (1/1) - No deprecated functions
• CQ-05: Output Correct (1/1) - Saves as plot.png

Library Features (3/5 pts)

• LF-01: Uses distinctive library features (3/5) - Uses plotnine's grammar of graphics well with geom_polygon and geom_text, but Venn diagrams are not a native strength of plotnine

Strengths

• Excellent implementation of a Venn diagram using plotnine's grammar of graphics approach
• Clean, readable layout with well-positioned count labels in each region
• Good use of transparency (alpha=0.45) to show overlap regions clearly
• Realistic tech team scenario with mathematically consistent intersection counts
• Proper calculation of exclusive region counts from set totals and intersections
• Clean theme with hidden axes and grid appropriate for a Venn diagram

Weaknesses

• Two of the three colors are shades of blue (#306998 and #4B8BBE), which could be confusing for colorblind users
• Figure size is 12x12 (square) instead of 16x9 as recommended in library guidelines

Verdict: APPROVED