mql5/Indicators/MyIndicators/KeltnerChannel_Pro.md

Keltner Channel Pro

1. Summary (Introduction)

The Keltner Channel is a volatility-based indicator, with the modern version popularized by Linda Bradford Raschke. It consists of three lines: a central moving average line, an upper band, and a lower band, with the channel width determined by the Average True Range (ATR). It is primarily used to identify trend direction and spot potential breakouts.

Our KeltnerChannel_Pro implementation is a unified, professional version that combines three distinct calculation methodologies into a single, flexible indicator:

1. Standard: Classic Keltner Channel using standard price data for both the MA and ATR.
2. HA-Hybrid: A smoothed MA based on Heikin Ashi prices, with channel width based on standard, real-market ATR.
3. HA-Pure: A fully smoothed channel where both the MA and the ATR are calculated from Heikin Ashi data.

2. Mathematical Foundations and Calculation Logic

The Keltner Channel is constructed by creating a channel around a central moving average, with the width determined by market volatility.

Required Components

• Middle Line (Basis): A moving average of a selected price.
• ATR (Average True Range): A measure of market volatility.
• Factor (Multiplier): A user-defined multiplier that adjusts the channel width.

Calculation Steps (Algorithm)

1. Calculate the Middle Line: Compute the moving average (e.g., 20-period EMA) of the selected source price. \text{Middle Line}_i = \text{MA}(\text{Source Price}, \text{MA Period})_i

2. Calculate the Average True Range (ATR): Compute the ATR for a given period (e.g., 10).

3. Calculate the Upper and Lower Bands: Add and subtract a multiple of the ATR from the middle line. \text{Upper Band}_i = \text{Middle Line}_i + (\text{Factor} \times \text{ATR}_i) \text{Lower Band}_i = \text{Middle Line}_i - (\text{Factor} \times \text{ATR}_i)

3. MQL5 Implementation Details

Our MQL5 implementation follows a modern, object-oriented design to ensure stability, reusability, and maintainability.

• Modular Calculation Engine (KeltnerChannel_Calculator.mqh): The entire calculation logic is encapsulated within a reusable include file.

  • Composition Pattern: The calculator orchestrates two powerful engines:
    1. MA Engine: It uses the MovingAverage_Engine.mqh for the Middle Line, enabling advanced smoothing types like DEMA or TEMA.
    2. ATR Engine: It uses the ATR_Calculator.mqh for precise volatility measurement.
  • ATR Source Logic: The calculator internally checks the InpAtrSource parameter and decides whether to calculate the True Range from standard candles or from Heikin Ashi candles, providing all three logical variations within a clean, unified structure.

• Optimized Incremental Calculation (O(1)): Unlike basic implementations that recalculate the entire history on every tick, this indicator employs an intelligent incremental algorithm.

  • It utilizes the prev_calculated state to determine the exact starting point for updates.
  • Persistent State: The internal buffers persist their state between ticks. This allows recursive smoothing methods to continue seamlessly from the last known value without re-processing the entire history.
  • This results in O(1) complexity per tick, ensuring instant updates and zero lag, even on charts with extensive history.

4. Parameters

The indicator's parameters are logically grouped for clarity:

• Middle Line (MA) Settings:
  • InpMaPeriod: The lookback period for the middle line. (Default: 20).
  • InpMaMethod: The type of moving average for the middle line. Supports: SMA, EMA, SMMA, LWMA, TMA, DEMA, TEMA. (Default: EMA).
  • InpSourcePrice: The source price for the middle line. (Standard or Heikin Ashi).
• Channel (ATR) Settings:
  • InpAtrPeriod: The lookback period for the ATR calculation. (Default: 10).
  • InpMultiplier: The factor to multiply the ATR by. (Default: 2.0).
  • InpAtrSource: Determines the source for the ATR calculation (Standard or Heikin Ashi), allowing you to create "Hybrid" or "Pure" HA channels.

5. Usage and Interpretation

• Trend Identification: The slope of the channel helps identify the trend. An upward-sloping channel suggests an uptrend, while a downward-sloping one suggests a downtrend.
• Breakouts: A strong close above the upper band can signal the start or continuation of an uptrend. A strong close below the lower band can signal the start or continuation of a downtrend.
• Overbought/Oversold (in Ranges): In a sideways market, moves to the upper band can be seen as overbought, and moves to the lower band can be seen as oversold.
• Caution: Like all channel indicators, Keltner Channels can give false breakout signals. It is often used in conjunction with momentum oscillators to confirm the strength of a move.