Commit 4cecc77
authored
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
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
0 commit comments