Merge remote-tracking branch 'origin/main'

Author: MarkusNeusinger

plots/boxen-basic/specification.md

@@ -0,0 +1,27 @@
+# boxen-basic: Basic Boxen Plot (Letter-Value Plot)
+
+## Description
+
+A boxen plot (also known as letter-value plot) extends the traditional box plot to show more quantile information, making it ideal for large datasets with 1000+ observations. Instead of just displaying the median and quartiles, it shows additional "letter values" (eighths, sixteenths, etc.) as nested boxes, revealing the full shape of the distribution including tail behavior. This makes outlier detection more meaningful and distribution comparison more detailed.
+
+## Applications
+
+- Analyzing response time distributions across server clusters with millions of requests
+- Comparing gene expression levels in large-scale genomics studies
+- Quality control in manufacturing with high-volume production data
+- Exploring salary or income distributions in large census datasets
+
+## Data
+
+- `category` (string) - group labels for comparison (optional for single distribution)
+- `value` (numeric) - numerical values to plot
+- Size: 1000-100000+ points per category, 1-8 categories
+- Example: Server response times by endpoint, test scores by school
+
+## Notes
+
+- Show nested boxes representing letter values (median, quartiles, eighths, sixteenths, etc.)
+- Boxes should decrease in width for deeper quantiles
+- Use contrasting colors or shading to distinguish quantile levels
+- Display outliers beyond the deepest letter value as individual points
+- Include clear axis labels and legend explaining quantile levels

plots/boxen-basic/specification.yaml

@@ -0,0 +1,28 @@
+# Specification-level metadata for boxen-basic
+# Auto-synced to PostgreSQL on push to main
+
+spec_id: boxen-basic
+title: Basic Boxen Plot (Letter-Value Plot)
+
+# Specification tracking
+created: 2026-01-09T07:51:15Z
+updated: null
+issue: 3414
+suggested: MarkusNeusinger
+
+# Classification tags (applies to all library implementations)
+# See docs/reference/tagging-system.md for detailed guidelines
+tags:
+  plot_type:
+    - boxen
+    - box
+  data_type:
+    - numeric
+    - continuous
+  domain:
+    - statistics
+    - general
+  features:
+    - basic
+    - distribution
+    - large-data

plots/frequency-polygon-basic/specification.md

@@ -0,0 +1,27 @@
+# frequency-polygon-basic: Frequency Polygon for Distribution Comparison
+
+## Description
+
+A frequency polygon connects the midpoints of histogram bins with straight line segments, creating a smooth outline of the distribution shape. This visualization excels at comparing multiple distributions simultaneously since lines overlap without obscuring each other, unlike stacked or overlapping histogram bars. Frequency polygons reveal differences in central tendency, spread, skewness, and modality across groups with minimal visual clutter.
+
+## Applications
+
+- Comparing test score distributions across multiple classes or exam sessions
+- Analyzing response time distributions between experimental conditions in psychology research
+- Visualizing age distributions across different customer segments or cohorts
+
+## Data
+
+- `values` (numeric) - The continuous variable to bin and display
+- `group` (categorical) - The grouping variable distinguishing each distribution
+- Size: 50-1000 observations per group recommended; works well with 2-5 groups
+- Example: Heights by age group, salaries by department, reaction times by treatment
+
+## Notes
+
+- Use distinct line colors and/or styles (solid, dashed) to differentiate groups
+- Include a legend clearly identifying each group
+- Consider adding markers at data points for small datasets
+- Extend lines to zero at both ends to close the polygon shape
+- Align bin edges across all groups for accurate comparison
+- Semi-transparent fill beneath lines can enhance visual appeal while preserving clarity

plots/frequency-polygon-basic/specification.yaml

@@ -0,0 +1,28 @@
+# Specification-level metadata for frequency-polygon-basic
+# Auto-synced to PostgreSQL on push to main
+
+spec_id: frequency-polygon-basic
+title: Frequency Polygon for Distribution Comparison
+
+# Specification tracking
+created: 2026-01-09T07:51:35Z
+updated: null
+issue: 3418
+suggested: MarkusNeusinger
+
+# Classification tags (applies to all library implementations)
+# See docs/reference/tagging-system.md for detailed guidelines
+tags:
+  plot_type:
+    - line
+    - histogram
+  data_type:
+    - numeric
+    - continuous
+  domain:
+    - statistics
+    - general
+  features:
+    - basic
+    - distribution
+    - comparison