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