From 824587729a99d5ac2bb0839242088605becda9cb Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Sun, 14 Dec 2025 18:00:42 +0000
Subject: [PATCH] spec: add polar-basic specification

Created from issue #800
---
 plots/polar-basic/specification.md   | 27 +++++++++++++++++++++++++
 plots/polar-basic/specification.yaml | 30 ++++++++++++++++++++++++++++
 2 files changed, 57 insertions(+)
 create mode 100644 plots/polar-basic/specification.md
 create mode 100644 plots/polar-basic/specification.yaml

diff --git a/plots/polar-basic/specification.md b/plots/polar-basic/specification.md
new file mode 100644
index 0000000000..599460f5ea
--- /dev/null
+++ b/plots/polar-basic/specification.md
@@ -0,0 +1,27 @@
+# polar-basic: Basic Polar Chart
+
+## Description
+
+A polar chart displays data points on a circular coordinate system where position is determined by angle (theta) and distance from center (radius). This visualization is ideal for cyclical patterns, directional data, or any dataset where angular relationships are meaningful. It reveals periodic trends and directional distributions that would be obscured in Cartesian coordinates.
+
+## Applications
+
+- Displaying wind speed and direction measurements from weather stations
+- Visualizing time-of-day patterns (e.g., website traffic by hour, energy consumption cycles)
+- Showing compass-based data such as animal migration directions or survey response distributions
+- Analyzing seasonal patterns where the circular nature emphasizes yearly cycles
+
+## Data
+
+- `theta` (numeric) - Angular position in degrees (0-360) or radians (0-2π)
+- `radius` (numeric) - Distance from center, representing the measured value
+- `category` (string, optional) - Labels or groups for data points
+- Size: 12-100 points recommended for clarity
+- Example: Hourly temperature readings, wind direction frequency, or activity levels by hour
+
+## Notes
+
+- Radial gridlines should be clearly visible but not overwhelming
+- Angular labels should be at standard intervals (0°, 90°, 180°, 270° or compass directions)
+- Consider starting angle at top (90°) for time-based data or at right (0°) for standard mathematical convention
+- Use appropriate radial scale that doesn't compress data near the center
diff --git a/plots/polar-basic/specification.yaml b/plots/polar-basic/specification.yaml
new file mode 100644
index 0000000000..f0f90eb208
--- /dev/null
+++ b/plots/polar-basic/specification.yaml
@@ -0,0 +1,30 @@
+# Specification-level metadata for polar-basic
+# Auto-synced to PostgreSQL on push to main
+
+spec_id: polar-basic
+title: Basic Polar Chart
+
+# Specification tracking
+created: 2025-12-14T18:00:22Z
+issue: 800
+suggested: MarkusNeusinger
+history: []
+
+# Classification tags (applies to all library implementations)
+tags:
+  plot_type:
+    - polar
+    - radial
+  domain:
+    - general
+    - meteorology
+    - science
+  features:
+    - basic
+    - circular
+    - directional
+  audience:
+    - beginner
+  data_type:
+    - numeric
+    - angular