From 957e2096a2a325546015ad7049a799a90243096a Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Mon, 15 Dec 2025 16:57:37 +0000 Subject: [PATCH] spec: add step-basic specification Created from issue #956 --- plots/step-basic/implementations/.gitkeep | 0 plots/step-basic/metadata/.gitkeep | 0 plots/step-basic/specification.md | 27 ++++++++++++++++++++ plots/step-basic/specification.yaml | 31 +++++++++++++++++++++++ 4 files changed, 58 insertions(+) create mode 100644 plots/step-basic/implementations/.gitkeep create mode 100644 plots/step-basic/metadata/.gitkeep create mode 100644 plots/step-basic/specification.md create mode 100644 plots/step-basic/specification.yaml diff --git a/plots/step-basic/implementations/.gitkeep b/plots/step-basic/implementations/.gitkeep new file mode 100644 index 0000000000..e69de29bb2 diff --git a/plots/step-basic/metadata/.gitkeep b/plots/step-basic/metadata/.gitkeep new file mode 100644 index 0000000000..e69de29bb2 diff --git a/plots/step-basic/specification.md b/plots/step-basic/specification.md new file mode 100644 index 0000000000..afa2b87069 --- /dev/null +++ b/plots/step-basic/specification.md @@ -0,0 +1,27 @@ +# step-basic: Basic Step Plot + +## Description + +A step plot (also known as a stair plot or stepped line chart) displays data using horizontal lines connected by vertical lines, creating a stair-step pattern. Unlike line charts that interpolate between points, step plots show values as constant until the next change occurs. This makes them ideal for visualizing data that changes at discrete intervals, emphasizing the exact moments when values change. + +## Applications + +- Tracking cumulative sales or revenue over time where totals increase in discrete jumps +- Visualizing stock price changes or pricing tier adjustments throughout a trading day +- Displaying inventory levels that decrease or increase at specific events +- Showing digital signals, binary states, or step functions in engineering and mathematics + +## Data + +- `x` (numeric/datetime) - Sequential or time-based variable representing when changes occur +- `y` (numeric) - The value that remains constant until the next step +- Size: 10-100 data points work well; too many points may clutter the visualization +- Example: Monthly cumulative sales figures, hourly inventory snapshots + +## Notes + +- Use 'pre' step style when the value applies from the previous point until the current one +- Use 'post' step style when the value applies from the current point until the next one +- Use 'mid' step style to center the step between adjacent points +- Consider adding markers at data points to highlight where changes occur +- Grid lines can help readers trace values across the plot diff --git a/plots/step-basic/specification.yaml b/plots/step-basic/specification.yaml new file mode 100644 index 0000000000..029994b57f --- /dev/null +++ b/plots/step-basic/specification.yaml @@ -0,0 +1,31 @@ +# Specification-level metadata for step-basic +# Auto-synced to PostgreSQL on push to main + +spec_id: step-basic +title: Basic Step Plot + +# Specification tracking +created: 2025-12-15T16:57:01Z +issue: 956 +suggested: MarkusNeusinger +history: [] + +# Classification tags (applies to all library implementations) +tags: + plot_type: + - step + - line + domain: + - general + - finance + - business + features: + - basic + - discrete + - sequential + audience: + - beginner + data_type: + - numeric + - datetime + - continuous