[violin-swarm] Violin Plot with Overlaid Swarm Points

[MarkusNeusinger]

A violin plot with individual data points overlaid as a swarm plot. Combines smooth distribution visualization with raw data visibility, showing both density estimation and actual observations.

[claude]

✅ Spec ID: violin-swarm

Rationale: Combines the full violin shape visualization with individual data points displayed as a swarm, providing both smooth density estimation and raw data visibility.

This is distinct from raincloud-basic (which uses half-violin in horizontal orientation with a cloud/rain metaphor) and from violin-box (which combines violin with box plot rather than swarm points).

Add label approved to begin generation.

[github-actions]

✅ Specification Ready: violin-swarm

PR: #3528

---

specification.md

violin-swarm: Violin Plot with Overlaid Swarm Points

Description

A violin plot with individual data points overlaid as a swarm plot, combining smooth kernel density estimation with raw data visibility. The violin shape shows the distribution density while the swarm points reveal actual observations, enabling viewers to see both the overall distribution pattern and individual data values simultaneously. This hybrid approach provides maximum transparency, showing exactly how many observations exist at each level while maintaining the smooth distribution visualization.

Applications

• Comparing gene expression levels across treatment conditions in biological research
• Analyzing response time distributions across experimental groups while showing individual trials
• Visualizing patient biomarker values across clinical groups with full data transparency
• Presenting survey response distributions where sample sizes vary between groups

Data

• category (categorical) - Group labels for comparison on the categorical axis
• value (numeric) - Continuous variable values shown on the value axis
• Size: 20-200 observations per category, 2-5 categories
• Example: Reaction times (ms) across 4 experimental conditions with 50 observations each

Notes

• Overlay swarm points on top of the violin, centered within the violin shape
• Use transparency on the violin (alpha 0.3-0.5) so swarm points remain visible
• Size swarm points appropriately to avoid excessive overlap while remaining visible
• Consider using a contrasting color for points vs violin fill
• Swarm points should spread horizontally to avoid overlap, staying within the violin boundary

---

Next: Add approved label to merge this specification to main.

---

🤖 spec-create workflow

[github-actions]

🚀 Specification Merged!

Specification: violin-swarm
PR: #3528 (merged)

The specification is now in main and synced to PostgreSQL.

---

Next: Add generate:{library} labels to start generating implementations.

Available libraries: matplotlib, seaborn, plotly, bokeh, altair, plotnine, pygal, highcharts, letsplot

Or use workflow dispatch for bulk operations.

---

🤖 spec-create workflow