Skip to content

Commit 2605d28

Browse files
spec: add lollipop-grouped specification (#3486)
## New Specification: `lollipop-grouped` Related to #3485 --- ### specification.md # lollipop-grouped: Grouped Lollipop Chart ## Description A grouped lollipop chart displays multiple series across categorical variables using thin stems and circular markers arranged in groups. Each category has multiple lollipops side by side, one for each series, enabling direct comparison of metrics across groups. It combines the clarity of dot plots with the organization of grouped bar charts while reducing visual clutter. ## Applications - Comparing sales performance across regions for multiple product lines - Survey results showing scores for different questions across demographic groups - Performance metrics (accuracy, speed, cost) across different algorithms or models - Year-over-year comparisons of multiple KPIs across departments ## Data - `category` (string) - Categorical labels for grouping (e.g., regions, departments) - `series` (string) - Series identifier distinguishing each lollipop within a group - `value` (numeric) - The measurement or count for each category-series combination - Size: 3-8 categories with 2-5 series for optimal readability - Example: Quarterly revenue by product line across 4 regions ## Notes - Stems should be thin lines connecting baseline to marker - Markers should be circular dots with distinct colors for each series - Lollipops within a group should be positioned side by side with slight offset - Include a legend to identify series colors - Consider horizontal orientation if category labels are long - Sort categories by a meaningful metric to reveal patterns --- **Next:** Add `approved` label to the issue to merge this PR. --- :robot: *[spec-create workflow](https://github.com/MarkusNeusinger/pyplots/actions/runs/20854707930)* Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent 5571591 commit 2605d28

2 files changed

Lines changed: 57 additions & 0 deletions

File tree

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# lollipop-grouped: Grouped Lollipop Chart
2+
3+
## Description
4+
5+
A grouped lollipop chart displays multiple series across categorical variables using thin stems and circular markers arranged in groups. Each category has multiple lollipops side by side, one for each series, enabling direct comparison of metrics across groups. It combines the clarity of dot plots with the organization of grouped bar charts while reducing visual clutter.
6+
7+
## Applications
8+
9+
- Comparing sales performance across regions for multiple product lines
10+
- Survey results showing scores for different questions across demographic groups
11+
- Performance metrics (accuracy, speed, cost) across different algorithms or models
12+
- Year-over-year comparisons of multiple KPIs across departments
13+
14+
## Data
15+
16+
- `category` (string) - Categorical labels for grouping (e.g., regions, departments)
17+
- `series` (string) - Series identifier distinguishing each lollipop within a group
18+
- `value` (numeric) - The measurement or count for each category-series combination
19+
- Size: 3-8 categories with 2-5 series for optimal readability
20+
- Example: Quarterly revenue by product line across 4 regions
21+
22+
## Notes
23+
24+
- Stems should be thin lines connecting baseline to marker
25+
- Markers should be circular dots with distinct colors for each series
26+
- Lollipops within a group should be positioned side by side with slight offset
27+
- Include a legend to identify series colors
28+
- Consider horizontal orientation if category labels are long
29+
- Sort categories by a meaningful metric to reveal patterns
Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# Specification-level metadata for lollipop-grouped
2+
# Auto-synced to PostgreSQL on push to main
3+
4+
spec_id: lollipop-grouped
5+
title: Grouped Lollipop Chart
6+
7+
# Specification tracking
8+
created: 2026-01-09T14:16:33Z
9+
updated: null
10+
issue: 3485
11+
suggested: MarkusNeusinger
12+
13+
# Classification tags (applies to all library implementations)
14+
# See docs/reference/tagging-system.md for detailed guidelines
15+
tags:
16+
plot_type:
17+
- lollipop
18+
- point
19+
data_type:
20+
- categorical
21+
- numeric
22+
domain:
23+
- general
24+
- business
25+
features:
26+
- grouped
27+
- comparison
28+
- multi

0 commit comments

Comments
 (0)