[waterfall-basic] Basic Waterfall Chart

[MarkusNeusinger]

Description

A waterfall chart showing how an initial value is affected by intermediate positive or negative values, leading to a final value. Each bar represents a change from the previous cumulative total, with positive values going up and negative values going down. Essential for understanding cumulative effects.

Applications

• Financial analysis: revenue to net profit breakdown
• Inventory changes over time
• Project cost tracking (additions and reductions)
• Sales pipeline progression

Data

• category (string) - step labels
• value (numeric) - change values (positive or negative)
• Size: 5-15 steps

Notes

• Color positive and negative changes differently
• Show connecting lines between bars
• Include start and end total bars
• Display running total labels

[claude]

✅ Spec ID: waterfall-basic

Rationale: A waterfall chart is a distinct visualization type showing cumulative effects of sequential values. This is a new plot type not yet in the repository.

Add label approved to begin generation.

[github-actions]

✅ Specification Ready: waterfall-basic

PR: #778

---

specification.md

waterfall-basic: Basic Waterfall Chart

Description

A waterfall chart visualizes how an initial value is affected by a series of intermediate positive or negative values, leading to a final value. Each bar represents a change from the previous cumulative total, with positive values extending upward and negative values extending downward. This chart type is essential for understanding cumulative effects and breaking down the components that contribute to a final result.

Applications

• Financial analysis: breaking down revenue to net profit through costs, taxes, and adjustments
• Inventory management: tracking stock levels through additions and withdrawals over time
• Project cost tracking: visualizing budget changes through additions and reductions
• Sales pipeline progression: showing conversion rates and drop-offs through stages

Data

• category (string) - step labels describing each change (e.g., "Starting Balance", "Sales", "Costs", "Taxes", "Net Profit")
• value (numeric) - change values (positive for increases, negative for decreases)
• Size: 5-15 steps
• Example: quarterly financial breakdown from revenue to net income

Notes

• Color positive and negative changes differently (e.g., green for positive, red for negative)
• Show connecting lines between bars to emphasize the cumulative flow
• Include distinct start and end total bars (often in a different color like blue or gray)
• Display running total labels on or near bars for clarity
• First and last bars typically represent totals, middle bars represent changes

---

Next: Add approved label to merge this specification to main.

---

🤖 spec-create workflow

[github-actions]

🚀 Specification Merged!

Specification: waterfall-basic
PR: #778 (merged)

The specification is now in main and synced to PostgreSQL.

---

Next: Add generate:{library} labels to start generating implementations.

Available libraries: matplotlib, seaborn, plotly, bokeh, altair, plotnine, pygal, highcharts, letsplot

Or use workflow dispatch for bulk operations.

---

🤖 spec-create workflow