feat(plotly): implement parliament-basic

[github-actions]

Implementation: parliament-basic - plotly

Implements the plotly version of parliament-basic.

File: plots/parliament-basic/implementations/plotly.py

---

🤖 impl-generate workflow

[claude]

AI Review - Attempt 1/3

Image Description

The plot displays a semicircular parliament seat chart with 420 total seats arranged in 7 concentric arcs. Seats are rendered as circular dots, colored by party: Progressive Alliance (blue, 145 seats) on the left, followed by Civic Union (yellow, 118), Green Future (green, 52), Liberty Party (purple, 48), Reform Coalition (orange, 35), and Independent Group (pink, 22) moving toward the right. A dashed gray arc indicates the majority threshold (211 seats). The title "parliament-basic · plotly · pyplots.ai" appears centered at the top in dark gray. The total seat count "420 seats" is displayed at the center bottom of the semicircle. A horizontal legend at the bottom shows all parties with their seat counts, plus the majority threshold.

Quality Score: 93/100

Criteria Checklist

Visual Quality (37/40 pts)

• VQ-01: Text Legibility (10/10) - Title, legend, and annotations are all clearly readable at full size
• VQ-02: No Overlap (8/8) - No overlapping elements; seats are well-spaced
• VQ-03: Element Visibility (8/8) - Markers are appropriately sized with white borders for distinction
• VQ-04: Color Accessibility (5/5) - Colors are distinguishable and colorblind-friendly (blue, yellow, green, purple, orange, pink)
• VQ-05: Layout Balance (5/5) - Excellent use of canvas; semicircle is well-proportioned with balanced margins
• VQ-06: Axis Labels (0/2) - N/A for this plot type (no traditional axes)
• VQ-07: Grid & Legend (1/2) - Legend is well-placed horizontally; majority line is subtle but could be slightly more visible

Spec Compliance (25/25 pts)

• SC-01: Plot Type (8/8) - Correct semicircular parliament seat chart
• SC-02: Data Mapping (5/5) - Seats correctly arranged left-to-right by party
• SC-03: Required Features (5/5) - All spec features present: semicircular arcs, individual seats as dots, party colors, legend with seat counts, majority threshold line
• SC-04: Data Range (3/3) - All 420 seats visible and accounted for
• SC-05: Legend Accuracy (2/2) - Legend shows party names with accurate seat counts
• SC-06: Title Format (2/2) - Uses correct format: "parliament-basic · plotly · pyplots.ai"

Data Quality (18/20 pts)

• DQ-01: Feature Coverage (8/8) - Shows multiple parties with varying seat counts, demonstrating parliament composition visualization
• DQ-02: Realistic Context (5/7) - Uses fictional neutral party names which is appropriate, but the political nature of parliament charts is inherently political content. However, using neutral names mitigates this concern adequately.
• DQ-03: Appropriate Scale (5/5) - 420 total seats is realistic for a parliament; party distributions are plausible

Code Quality (8/10 pts)

• CQ-01: KISS Structure (3/3) - Clean sequential structure: imports → data → calculations → plot → save
• CQ-02: Reproducibility (1/3) - No random seed set, though data is deterministic (hardcoded). However, seat distribution algorithm could benefit from explicit seed for any numpy operations.
• CQ-03: Clean Imports (2/2) - Only numpy and plotly.graph_objects imported, both used
• CQ-04: No Deprecated API (1/1) - Uses current Plotly API
• CQ-05: Output Correct (1/1) - Saves as plot.png and plot.html

Library Features (5/5 pts)

• LF-01: Uses distinctive library features (5/5) - Excellent use of Plotly: interactive hover templates, go.Scatter for custom markers, annotations, clean layout configuration, HTML export for interactivity

Strengths

• Excellent semicircular seat arrangement algorithm that properly distributes seats across concentric arcs
• Clean visual design with white marker borders that distinguish individual seats
• Proper horizontal legend with seat counts for each party
• Smart use of Plotly's hover templates for interactivity
• Majority threshold line adds context as specified
• Total seats annotation at center is a nice touch
• Neutral fictional party names avoid political controversy
• Both PNG and interactive HTML outputs generated

Weaknesses

• The majority threshold dashed line is quite faint (rgba 0.3 alpha); could be slightly more visible while remaining subtle

Verdict: APPROVED