[point-and-figure-basic] Point and Figure Chart

[MarkusNeusinger]

Description

A Point & Figure (P&F) chart using columns of X's (price rises) and O's (price falls) to visualize price movements while filtering out time and minor fluctuations.

Applications

• Technical analysis and pattern recognition
• Support/resistance level identification
• Price target calculation
• Trend analysis without time distortion

Data

• date (datetime) - Trading dates
• high, low, close (numeric) - Price data
• Box size and reversal parameters
• Time range: 6-12 months

Notes

• X columns for rising prices, O columns for falling
• Configurable box size (price increment per box)
• 3-box reversal as default (configurable)
• Draw support/resistance trend lines
• No time axis (columns represent reversals, not time)

[claude]

✅ Spec ID: point-and-figure-basic

Rationale: Point and Figure is a distinct technical analysis chart type that uses X/O symbols for price movements - different from existing Kagi (line thickness) and Renko (bricks) charts. Valid and useful addition to the financial charting collection.

Add label approved to begin generation.

[github-actions]

✅ Specification Ready: point-and-figure-basic

PR: #3763

---

specification.md

point-and-figure-basic: Point and Figure Chart

Description

A Point and Figure (P&F) chart is a price-action focused visualization that uses columns of X's (rising prices) and O's (falling prices) to display significant price movements while filtering out time and minor fluctuations. Unlike traditional time-based charts, P&F charts only plot a new symbol when price moves by a defined box size, and only start a new column when price reverses by a specified number of boxes (typically 3). This makes it ideal for identifying clear trends, support/resistance levels, and generating trading signals.

Applications

• Identifying trend direction and strength in stock trading by observing the dominance of X columns (bullish) versus O columns (bearish)
• Detecting support and resistance levels where price repeatedly reverses, visible as horizontal price zones with multiple column reversals
• Calculating price targets using the traditional count methods based on column widths at breakout points
• Filtering out market noise in volatile markets to focus on meaningful price changes rather than time-based fluctuations

Data

• date (datetime) - Trading dates for each price observation
• high (numeric) - High price for each period
• low (numeric) - Low price for each period
• close (numeric) - Closing price for each period (primary data for calculations)
• Box size: Fixed price increment that determines when a new X or O is added (e.g., $1, $2, or ATR-based)
• Reversal: Number of boxes required to start a new column in the opposite direction (default: 3)
• Size: 200-500 price observations over 6-12 months to generate meaningful patterns

Notes

• Use X symbols for rising price columns and O symbols for falling price columns
• Green color for X columns (bullish) and red color for O columns (bearish) provides visual distinction
• Each column contains only X's or only O's - never mixed
• A new column starts only when price reverses by the reversal amount (e.g., 3 boxes)
• The X-axis represents columns (reversals), not time - this is a key feature of P&F charts
• Draw support trend lines connecting ascending lows (45-degree up) and resistance trend lines connecting descending highs (45-degree down)
• Box size significantly impacts chart appearance: smaller boxes show more detail, larger boxes emphasize major trends
• Consider adding a price scale on the Y-axis with grid lines at box size intervals

---

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

---

🤖 spec-create workflow

[github-actions]

🚀 Specification Merged!

Specification: point-and-figure-basic
PR: #3763 (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