QuanTAlib/lib/trends/htit/Htit.md

HTIT: Hilbert Transform Instantaneous Trend

"John Ehlers brought rocket science to trading. Literally. HTIT uses signal processing to find the trend by removing the cycle. It's not smoothing; it's extraction."

HTIT (Hilbert Transform Instantaneous Trend) is a trend-following indicator that doesn't rely on simple averaging. Instead, it uses the Hilbert Transform to measure the dominant cycle period of the market and then computes a trendline that filters out that specific cycle. It adapts to the market's rhythm rather than imposing a fixed period.

Historical Context

John Ehlers, a pioneer in applying DSP to trading, introduced this in his book Rocket Science for Traders. He recognized that markets have cyclic components (noise) and trend components. By identifying the cycle, you can mathematically subtract it to reveal the pure trend.

Architecture & Physics

This is a complex, multi-stage signal processing pipeline:

1. Smooth: 4-bar WMA to remove high-frequency noise.
2. Detrend: High-pass filter to remove the DC component (trend) temporarily to isolate the cycle.
3. Hilbert Transform: Compute In-Phase (I) and Quadrature (Q) components.
4. Period Measurement: Use the phase rate of change (Homodyne Discriminator) to measure the dominant cycle period.
5. Trend Extraction: Average the price over the measured dominant cycle period to cancel out the cycle.

Zero-Allocation Design

Despite the complexity, we maintain zero allocations.

• RingBuffers: We use multiple small RingBuffers for the various stages (smooth, detrend, I/Q, period).
• State Struct: Complex state (phasors, periods) is managed in a value type.
• Fixed Buffers: The pipeline depth is constant, allowing for static buffer sizing.

Mathematical Foundation

The core idea is that if you average a sine wave over exactly one period, the result is 0.

\text{Trend}_t = \frac{1}{\text{DC}} \sum_{i=0}^{\text{DC}-1} P_{t-i}

Where \text{DC} is the measured Dominant Cycle period.

The Hilbert Transform is used to find \text{DC} dynamically:

\text{Phase} = \arctan(Q / I) \text{DC} = \frac{2\pi}{\Delta \text{Phase}}

Performance Profile

This is an O(1) algorithm, but the constant factor is large due to the many steps.

Metric	Complexity	Notes
Throughput	Moderate	Heavy floating-point math per bar
Complexity	O(1)	Pipeline depth is fixed
Accuracy	9/10	Extracts trend by removing cycle
Timeliness	7/10	Adapts, but has some lag
Overshoot	8/10	Generally good, stable trendline
Smoothness	9/10	Very smooth trendline

Validation

Validated against Ehlers' original EasyLanguage code and Python ports.

Provider	Error Tolerance	Notes
Ehlers	N/A	Logic matches Rocket Science for Traders

Common Pitfalls

1. Warmup: This indicator needs significant warmup (at least 12 bars, ideally 50+) for the feedback loops (period smoothing) to stabilize.
2. Lag: While it adapts, the trendline still lags because it's essentially a dynamic SMA. The advantage is that the period is optimal for the current market condition.
3. Complexity: Debugging this is a nightmare. Trust the math.