From 79a35fb66ca0c08b1afb2d26278733b587cebc82 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Mon, 15 Dec 2025 20:45:19 +0000 Subject: [PATCH] spec: add rose-basic specification Created from issue #1003 --- plots/rose-basic/specification.md | 27 ++++++++++++++++++++++++ plots/rose-basic/specification.yaml | 32 +++++++++++++++++++++++++++++ 2 files changed, 59 insertions(+) create mode 100644 plots/rose-basic/specification.md create mode 100644 plots/rose-basic/specification.yaml diff --git a/plots/rose-basic/specification.md b/plots/rose-basic/specification.md new file mode 100644 index 0000000000..fadcde84ce --- /dev/null +++ b/plots/rose-basic/specification.md @@ -0,0 +1,27 @@ +# rose-basic: Basic Rose Chart + +## Description + +A rose chart (also called Nightingale or coxcomb diagram) displays categorical data in a circular format where segments are arranged around the center like pie slices, but with radius proportional to the value rather than angle. This visualization excels at showing cyclical or directional patterns where the circular arrangement has natural meaning. The equal-angle wedges make comparison of values across categories intuitive while emphasizing the periodic nature of the data. + +## Applications + +- Visualizing monthly sales, weather patterns, or other data with natural 12-month cycles +- Displaying wind direction frequency (wind rose) showing how often wind blows from each compass direction +- Comparing day-of-week patterns like customer visits, social media engagement, or energy consumption +- Showing hourly distributions where the circular clock face arrangement aids interpretation + +## Data + +- `category` (categorical) - Angular positions representing periodic categories (e.g., months, directions, hours) +- `value` (numeric) - Determines segment radius; larger values extend further from center +- Size: 4-24 categories typical; 8-12 optimal for readability +- Example: Monthly rainfall amounts, wind direction frequencies, or hourly traffic counts + +## Notes + +- Segment radius should be proportional to value (not area) for easier visual comparison +- Categories should have natural circular ordering (months, compass directions, hours) +- Use consistent color scheme; single color with varying saturation or distinct colors per category +- Start position typically at top (12 o'clock) for time data or north for directional data +- Include radial gridlines to aid value estimation diff --git a/plots/rose-basic/specification.yaml b/plots/rose-basic/specification.yaml new file mode 100644 index 0000000000..8667b39088 --- /dev/null +++ b/plots/rose-basic/specification.yaml @@ -0,0 +1,32 @@ +# Specification-level metadata for rose-basic +# Auto-synced to PostgreSQL on push to main + +spec_id: rose-basic +title: Basic Rose Chart + +# Specification tracking +created: 2025-12-15T20:44:57Z +issue: 1003 +suggested: MarkusNeusinger +history: [] + +# Classification tags (applies to all library implementations) +tags: + plot_type: + - rose + - polar + - radial + domain: + - general + - meteorology + - statistics + features: + - basic + - circular + - categorical + audience: + - beginner + - intermediate + data_type: + - categorical + - numeric