Skip to content

Commit 4cecc77

Browse files
spec: add bar-basic specification (#614)
## New Specification: `bar-basic` Closes #612 --- ### specification.md # bar-basic: Basic Bar Chart ## Description A vertical bar chart that displays categorical data with rectangular bars whose heights are proportional to the values they represent. This fundamental visualization is ideal for comparing discrete categories and identifying which categories have the highest or lowest values. Bar charts excel at showing rankings, distributions across categories, and making relative comparisons intuitive. ## Applications - Comparing quarterly sales figures across different product lines - Visualizing survey responses showing preference counts for different options - Displaying population statistics across different age groups or regions ## Data - `category` (categorical) - Labels for each bar on the x-axis - `value` (numeric) - Heights of the bars representing the measured quantity - Size: 3-15 categories recommended for readability - Example: Product sales by category, survey response counts, performance metrics by department ## Notes - Bar widths should be consistent across all categories - Consider adding value labels on or above bars for precise reading - Use a single color for all bars, or highlight specific bars to draw attention - Ensure adequate spacing between bars for visual clarity --- **Next:** Add `approved` label to the issue to merge this PR. --- :robot: *[spec-create workflow](https://github.com/MarkusNeusinger/pyplots/actions/runs/20149854394)* Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
1 parent 1812256 commit 4cecc77

2 files changed

Lines changed: 54 additions & 0 deletions

File tree

plots/bar-basic/specification.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# bar-basic: Basic Bar Chart
2+
3+
## Description
4+
5+
A vertical bar chart that displays categorical data with rectangular bars whose heights are proportional to the values they represent. This fundamental visualization is ideal for comparing discrete categories and identifying which categories have the highest or lowest values. Bar charts excel at showing rankings, distributions across categories, and making relative comparisons intuitive.
6+
7+
## Applications
8+
9+
- Comparing quarterly sales figures across different product lines
10+
- Visualizing survey responses showing preference counts for different options
11+
- Displaying population statistics across different age groups or regions
12+
13+
## Data
14+
15+
- `category` (categorical) - Labels for each bar on the x-axis
16+
- `value` (numeric) - Heights of the bars representing the measured quantity
17+
- Size: 3-15 categories recommended for readability
18+
- Example: Product sales by category, survey response counts, performance metrics by department
19+
20+
## Notes
21+
22+
- Bar widths should be consistent across all categories
23+
- Consider adding value labels on or above bars for precise reading
24+
- Use a single color for all bars, or highlight specific bars to draw attention
25+
- Ensure adequate spacing between bars for visual clarity

plots/bar-basic/specification.yaml

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# Specification-level metadata for bar-basic
2+
# Auto-synced to PostgreSQL on push to main
3+
4+
spec_id: bar-basic
5+
title: Basic Bar Chart
6+
7+
# Specification tracking
8+
created: 2025-12-11T22:46:28Z
9+
issue: 612
10+
suggested: MarkusNeusinger
11+
history: []
12+
13+
# Classification tags (applies to all library implementations)
14+
tags:
15+
plot_type:
16+
- bar
17+
domain:
18+
- general
19+
- business
20+
- statistics
21+
features:
22+
- basic
23+
- comparison
24+
- categorical
25+
audience:
26+
- beginner
27+
data_type:
28+
- categorical
29+
- numeric

0 commit comments

Comments
 (0)