User Guide
Master the most powerful geometric indicator for TradingView. This guide covers everything from basic setup to advanced pattern recognition techniques.
Getting Started
Welcome to GeoWave - the most advanced geometric pattern recognition system ever built for TradingView. This guide will walk you through installation, configuration, and practical usage of every feature.
Installation
- Open TradingView and navigate to your chart
- Click the Indicators button in the top toolbar
- Search for "GeoWave" in the indicator search
- Click to add it to your chart
Adding GeoWave to your TradingView chart
XABCD Patterns
GeoWave automatically identifies and labels market swings using the XABCD nomenclature. The indicator tracks the last 5 alternating pivots and assigns them labels:
- X - The origin point of the pattern
- A - First swing completion
- B - Retracement of XA
- C - Extension beyond A
- D - Potential reversal zone (PRZ) - updates in real-time
XABCD pattern labeled on a price chart
Adaptive Pattern Detection
GeoWave uses adaptive thresholds that automatically adjust to market conditions. This means the indicator responds intelligently to changing volatility:
Depth (Default: 12)
Number of bars required before and after a swing point for confirmation. Higher values = fewer, more significant swings.
Threshold Multiplier (Default: 2.0)
Sensitivity multiplier for detecting significant price movements. Higher values filter out noise.
Smoothing Window (Default: 14)
Period for volatility calculation. Standard 14-period works for most instruments.
Provisional D Point
The D point updates in real-time to track the most extreme price after C. When D is not yet confirmed, the C→D line displays as dashed. Once price reverses enough to confirm a new swing point, the pattern locks in.
Multi-Level Detection
This is one of GeoWave's most powerful features. Multi-Level Detection scans for larger market structures simultaneously with your base swings, allowing you to see multiple timeframe perspectives at once.
How It Works
Each level detects progressively larger swing patterns:
| Level | Detection Threshold | Swing Size |
|---|---|---|
| Base | Standard | Standard swings |
| +1 | Level 1 | Larger swings |
| +2 | Level 2 | Even larger |
| ... | ... | ... |
| +15 | Level 15 | Major market structure |
| +18 | Level 18 | Highest timeframe structure |
The Multi-Level Grid
When ratios from higher levels approach Fibonacci values (within your threshold %), they appear in the Multi-Level Grid on the left side of your chart. Each detection shows:
- Level: Which detection level (+1, +2, etc.)
- Ratio: The ratio type (BcD, AB/CD, X1, XcD)
- Value: The actual ratio value
- Fib: The nearest Fibonacci level
Projecting from Higher Levels
You can project targets and time cycles from any detection level, not just the base. Use the Target Source and Time Cycle Source dropdowns to select which level's XABCD structure to project from.
Target Source: Base | +1 | +2 | +3 | ... | +18 Time Cycle Source: Base | +1 | +2 | +3 | ... | +18
Ratio Analysis
GeoWave calculates and displays 6 key ratio relationships between the identified swings. These ratios are displayed in a real-time table on your chart:
| Ratio | Formula | Description |
|---|---|---|
| BcD | CD ÷ BC | C-D swing divided by B-C swing |
| AB/CD | CD ÷ AB | C-D swing divided by A-B swing |
| X1 | AD ÷ BC | A-D swing divided by B-C swing |
| X2 | AD ÷ XC | A-D swing divided by X-C swing |
| XcD | CD ÷ XC | C-D swing divided by X-C swing |
| XaD | AD ÷ XA | A-D swing divided by X-A swing |
Real-time ratio table displayed on chart
Target Levels
GeoWave projects multiple target levels based on different swing calculations. There are 6 independent target groups, each with its own color and configurable ratios. Targets project from point D and extend 50 bars to the right.
Target Source
By default, targets project from the Base level's XABCD pattern. Use the Target Source dropdown to project from higher detection levels (+1 through +15) for larger-scale targets.
Target Source: Base | +1 | +2 | +3 | ... | +18
The 6 Target Groups
| Target | Calculation | Default Color |
|---|---|---|
| BcD | From C using BC swing length | Blue |
| XcD | From C using XC swing length | Aqua |
| AB/CD | From C using AB swing length | White |
| X1 | From A using BC swing length | Red |
| X2 | From A using XC swing length | Purple |
| XaD | From A using XA swing length | Orange |
Available Target Ratios
Each target group can project the following Fibonacci ratios (all off by default):
Available Ratios: 23.6% | 33.3% | 38.2% | 50% | 61.8% | 66.7% | 78.6% | 88.6% | 100% | 127.2% | 141.4% | 150% | 161.8% | 200%
Target Display
Targets appear as dotted horizontal lines extending 50 bars from point D. Each line is labeled with the target type and exact price level.
Multiple target levels projected on chart
Time Projections
GeoWave doesn't just analyze price - it projects time, using historical swings as a reference to project forward time cycles. By combining harmonic price ratios and time cycles, the strength of the signal increases.
Available Time Cycles
Each time cycle projects from a specific pivot pair forward. Enable the cycles you want to track:
| Cycle | Projects From | Ratios |
|---|---|---|
| BD | D pivot forward | 33.3%, 38.2%, 50%, 61.8%, 78.6%, 100%, 127.2%, 141.4%, 161.8%, 200% |
| XD | D pivot forward | 33.3%, 38.2%, 50%, 61.8%, 78.6%, 100%, 127.2%, 141.4%, 161.8%, 200% |
| AC | C pivot forward | 33.3%, 38.2%, 50%, 61.8%, 78.6%, 100%, 127.2%, 141.4%, 161.8%, 200% |
| XA | A pivot forward | 33.3%, 38.2%, 50%, 61.8%, 78.6%, 100%, 127.2%, 141.4%, 161.8%, 200% |
| XB | B pivot forward | 33.3%, 38.2%, 50%, 61.8%, 78.6%, 100%, 127.2%, 141.4%, 161.8%, 200% |
| XC | C pivot forward | 33.3%, 38.2%, 50%, 61.8%, 78.6%, 100%, 127.2%, 141.4%, 161.8%, 200% |
| AB | B pivot forward | 33.3%, 38.2%, 50%, 61.8%, 78.6%, 100%, 127.2%, 141.4%, 161.8%, 200% |
Time Cycle Display
Vertical lines indicate projected time zones. When price reaches a key level at a projected time, the probability of a reversal increases substantially..
Square the Range
Based on W.D. Gann's principles, Square the Range creates geometric projections that identify intersections of price and time vectors. The technique "squares" a price range into a time box, then projects diagonal trend lines that often act as dynamic support/resistance.
Configuration
| Setting | Default | Description |
|---|---|---|
| Enable Square the Range | Off | Master toggle for this feature |
| Source Level | Base | Which detection level's swing points to use |
| Pivot Selection | X-A | Which pivot pair defines the box |
| Show Fib Levels | Off | Draw horizontal lines at 33.3%, 38.2%, 50%, 61.8%, 66.6%, 78.6% through the box |
| Show 2x Gradient | ✓ On | Steeper 2:1 angle lines |
| Show 1/2x Gradient | Off | Shallower 1:2 angle lines |
| Extend Lines Outside Box | Off | Project lines into the future |
| Extension Length | 50 bars | How far to extend (10-500) |
Pivot Selection Options
- X-A: Uses X and A pivots (first swing) - default
- X-C: Uses X and C pivots (larger range)
- A-B: Uses A and B pivots (retracement swing)
- B-C: Uses B and C pivots (continuation swing)
- C-D: Uses C and D pivots (final swing)
- A-D: Uses A and D pivots (full pattern range)
Square the Range box with intersecting diagonals
Gradient Lines
1x Gradient (Always shown)
The main diagonal lines that complete their price swap over 100% of the time duration. These are the primary Gann angles - dashed style.
2x Gradient (Default: On)
Steeper diagonals that complete their price swap in 50% of the time. Faster-moving markets often respect these angles - dotted style.
1/2x Gradient (Default: Off)
Shallower diagonals that take 200% of the time to complete. Slower-moving markets often respect these angles - dotted style.
Tiling
Tiling creates a grid of adjacent boxes around your main squared range, extending the geometric structure in all directions.
| Setting | Default | Description |
|---|---|---|
| Tile Level 1 | Off | 5 adjacent boxes: Above, Above-Right, Right, Below-Right, Below |
| Level 1 Tile Color | Teal (60%) | Color for first ring of tiles |
| Tile Level 2 | Off | Extends tiling one more layer outward |
| Level 2 Tile Color | Teal (75%) | Color for second ring of tiles |
| Tile 2x1 Angles | Off | Draw 2x1 (double speed) gradients in tiles |
| Tile 1x2 Angles | Off | Draw 1x2 (half speed) gradients in tiles |
Signal Scoring
GeoWave includes a sophisticated Signal Scoring System that quantifies the strength of detected patterns. Each D pivot receives a score based on how many ratios align with Fibonacci levels and how "powerful" those Fibonacci numbers are.
How Scoring Works
- For each pattern, GeoWave checks all 6 ratios (BcD, AB/CD, X1, X2, XcD, XaD)
- If a ratio is within the Fib Threshold % of a Fibonacci level, it scores
- The score reflects the statistical significance of detected patterns
- The score is also weighted by the Ratio Type Weight
- For multi-level patterns, higher detection levels get a Level Weight multiplier (up to +18)
- Multiple patterns at the same D point are aggregated with a confluence bonus
Score Tooltips
Hover over any score label to see a detailed breakdown of exactly what contributed to that score:
── Base ── BcD: 61.8% → 1×3 = 3 AB/CD: 100% → 1×2.5 = 2.5 Base: 5.5 × Lvl 1 = 5.5 ── +5 ── XcD: 78.6% → 1×1.5 = 1.5 X1: 141.4% → 1×1.5 = 1.5 Base: 3 × Lvl 1.67 = 5.01 ── TOTAL ── Sum: 10.51 Confluence (4 hits): ×1.3 Final: 13.66
The tooltip shows: ratio name, detected Fib%, weight × power = contribution, and final aggregation with confluence bonus.
Fibonacci Power Weights
Not all Fibonacci ratios are equally significant. The "power" weights determine how much each Fibonacci level contributes to the score:
| Fib Level | Default Power | Significance |
|---|---|---|
| 61.8% | 4.0 | Golden ratio - highest significance |
| 161.8% | 4.0 | Golden extension - highest significance |
| 100% | 5.0 | Equal legs - very significant |
| 50% | 3.5 | Half retracement - significant |
| 200% | 2.5 | Double extension - significant |
| 38.2% | 2.0 | Primary retracement level |
| 78.6% | 1.5 | Secondary retracement level |
| 127.2% | 1.5 | Secondary extension level |
| 141.4% | 1.5 | Secondary extension level |
| 33.3%, 66.7% | 1.5 | Third-wave relationships |
| 23.6%, 88.6% | 1.0 | Minor Fibonacci levels |
Ratio Type Weights
Each ratio type (BcD, XcD, etc.) can have its own weight multiplier:
| Ratio | Formula | Default Weight |
|---|---|---|
| BcD | CD / BC | 1.0 |
| AB/CD | CD / AB | 1.0 |
| X1 | AD / BC | 1.0 |
| X2 | AD / XC | 1.0 |
| XcD | CD / XC | 1.0 |
| XaD | AD / XA | 1.0 |
Confluence & Level Weights
Confluence Bonus (Default: 0.25 per hit)
When multiple ratio hits occur at the same D pivot, each additional hit adds a 10% bonus to the total score. More confluence = higher score.
Level Weights (Base: 1.0, Max +18: 3.0)
Higher detection levels get progressively higher weight multipliers. The weight is linearly interpolated - a +9 pattern gets ~1.5x, while +18 gets the full 3x multiplier.
Max Score References
Single Pattern: 15.0 (reference max for color gradient)
Multi Pattern: 80.0 (reference max when multiple patterns converge)
Retracement Filters
GeoWave automatically filters out non-retracement patterns for XcD and XaD ratios. If the X-C-D or X-A-D price movements are monotonic (continuously up or down without retracing), those ratios are excluded from both display and scoring.
Reading Score Labels
When "Show D Pivot Scores" is enabled, you'll see labels at each D pivot with color-coded scores:
- Red scores (0-5): Weak pattern - few ratio alignments, low confluence
- Orange/Yellow scores (5-10): Moderate pattern - some Fibonacci alignments
- Green scores (10-15): Strong pattern - multiple ratio confluences, high significance
- Score with "(2x)", "(3x)", etc.: Multiple patterns detected at same D pivot (confluence bonus applied)
Configuration
Access the settings panel by clicking the gear icon next to the indicator name. Here's a breakdown of all configuration options organized by group:
📐 Swingset Detection
| Setting | Default | Description |
|---|---|---|
| Depth | 12 | Bars before/after for swing point confirmation |
| Threshold Multiplier | 2.0 | Sensitivity multiplier for detecting significant movements |
| Smoothing Window | 14 | Period for volatility calculation |
🔧 Fine Tuning (Offsets)
Skip N most recent swing points to analyze historical patterns:
| Setting | Default | Range |
|---|---|---|
| Offset X, A, B, C, D | 0 | 0-10 each |
📊 Multi-Level Settings
| Setting | Default | Description |
|---|---|---|
| Enable Multi-Level Detection | Off | Master switch for higher-level detection |
| Enable ALL Levels (+1 to +18) | Off | Enable all 18 multi-level detections at once |
| +1 through +18 | Off | Individual toggles for each level (18 total) |
| Fib Threshold % | 3% | Only show swings within this % of Fib |
🎯 Target Levels
| Setting | Default | Description |
|---|---|---|
| Enable Target Levels | Off | Master switch for all target projections |
| Target Type | BcD | BcD, AB/CD, X1, X2, XcD, XaD |
| Target Source Level | Base | Which detection level for target calculation |
| Individual Fib Targets | Various | Toggle each: 23.6, 33.3, 38.2, 50, etc. |
| Target Offset Bars | 50 | How far targets extend right (0-500) |
⏱️ Time Cycles
| Setting | Default | Description |
|---|---|---|
| Enable Time Cycles | Off | Master switch for time projections |
| Time Cycle Type | BD 100% | XA, AB, BC, CD, BD, XD, AD |
| Time Cycle Source | Base | Which detection level for time calculation |
| Time Fib Ratios | 100% | Toggle: 33.3%, 38.2%, 50%, 61.8%, 78.6%, 100%, 127.2%, 141.4%, 161.8%, 200% |
🔲 Square the Range
See the Square the Range section for full details. Key defaults:
- Enable: Off
- Source Level: Base
- Pivot Selection: X-A
- Show Fib Levels: Off
- Show 2x Gradient: On
- Show 1/2x Gradient: Off
- Extension Length: 50 bars
⭐ Signal Scoring
See the Signal Scoring section for full details. Key defaults:
| Setting | Default | Description |
|---|---|---|
| Show D Pivot Scores | Off | Display score labels on chart |
| Fib Threshold % | 3% | How close ratio must be to Fib |
| Confluence Bonus | 0.1 | Bonus per additional ratio hit |
| Level Weights | 1.0 - 3.0 | Base (1.0) to +18 (3.0) |
| Exclude 100% BcD/XcD | ✓ On | Ignore "no retracement" scenarios |
👁️ Display Settings
| Setting | Default | Description |
|---|---|---|
| Pivot Price Value Markers | ✓ On | Show price labels on pivots |
| Show XABCD Lines | ✓ On | Main pattern structure lines |
| Show D Pivot Scores | Off | Display signal score at each D pivot on the chart |
| Show Latest D Pivot Only | Off | Only show swing sets where D is at the most recent D pivot bar across all levels |
| Fib Highlight Threshold | 3% | How close to highlight green |
🎨 Colors & Styling
| Element | Default Color | Notes |
|---|---|---|
| Base Pattern Lines | Cyan | Main XABCD swing lines |
| Multi-Level Lines | Purple | Higher detection level patterns |
| Target Lines | Gold | Fibonacci target levels |
| Time Cycle Lines | Teal | Vertical time projections |
| Square Range Lines | Blue | Gann box diagonals |
| Fib Highlight | Green | Ratios within threshold |
Configuration panel overview
Ready to start trading with geometric precision?
Get GeoWave