gavindiaz/mql5
1
0
Fork 0
mirror of https://github.com/softwaredevelop/mql5.git synced 2026-08-24 17:58:07 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: refactor

Browse Source
This commit is contained in:
Toh4iem9
2026-08-24 12:13:32 +02:00
parent ebfc054743
commit d2f017b0f9
1 changed files with 166 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Indicators/MyIndicators/Authors/Kaufman/KAMA_Channel_Pro.md
+166 -37
View File
@@ -1,62 +1,191 @@
# KAMA Channel Pro # Kaufman's Adaptive Moving Average (KAMA) Channel Pro (v3.00)
Quantitative Volatility Envelope & Adaptive Keltner Channel Suite
---
## 1. Summary (Introduction) ## 1. Summary (Introduction)
The **KAMA Channel Pro** is an adaptive variation of the classic Keltner Channel. Instead of using a standard Moving Average (like SMA or EMA) for the centerline, it employs Perry Kaufman's **Adaptive Moving Average (KAMA)**. **KAMA Channel Pro** is an institutional-grade adaptive volatility envelope based on the Keltner Channel concept. Unlike traditional Keltner Channels that rely on lagging Simple (SMA) or Exponential (EMA) Moving Averages, this indicator utilizes **Perry Kaufman's Adaptive Moving Average (KAMA)** as its dynamic equilibrium centerline, enveloped by **Average True Range (ATR)** volatility bands.
This substitution transforms the channel into a highly responsive tool: This mathematical synthesis produces an intelligent, regime-switching channel:
* **Trending Markets:** The KAMA centerline tracks price closely, and the channel expands to encompass the trend. * **Trending Phase (High Efficiency):** KAMA accelerates dynamically to track price impulses closely, while expanding ATR bands encapsulate directional momentum without generating premature counter-trend exit signals.
* **Ranging Markets:** The KAMA flattens out significantly, and the channel becomes horizontal, clearly defining the support and resistance boundaries of the range. * **Consolidation Phase (Low Efficiency / Chop):** KAMA aggressively flattens out, transforming the channel into a stationary horizontal trading range that precisely defines institutional supply (Upper Band) and demand (Lower Band) boundaries.
The bands are calculated using the **Average True Range (ATR)**, providing a volatility-adjusted envelope around the adaptive centerline. ```text
┌────────────────────────────────────────────────────────────────────────┐
│ KAMA CHANNEL ARCHITECTURE │
├────────────────────────────────────────────────────────────────────────┤
│ Upper Band: KAMA(t) + [Multiplier × ATR(t)] │
│ Middle Band: Kaufman's Adaptive Moving Average (Centerline) │
│ Lower Band: KAMA(t) - [Multiplier × ATR(t)] │
└────────────────────────────────────────────────────────────────────────┘
```
### Key Capabilities
* **Adaptive Centerline Engine:** Low-lag trend tracking during expansions; horizontal baseline during sideways chop.
* **Wilder-Compliant Volatility Envelope:** Employs Wilder's classic RMA (Recursive Moving Average) smoothing for True Range calculations.
* **Hybrid Price Routing:** Allows independent price source selection (e.g., Heikin Ashi KAMA Centerline combined with Standard OHLC Volatility Bands).
* **2026 MTF Framework with DataSync Daemon:** High-performance multi-timeframe synchronization powered by `DataSync_Tools.mqh` with real-time flat-step staircase mapping.
* **Full Visual Customization:** Independent styling controls for the KAMA centerline and outer volatility boundaries.
---
## 2. Mathematical Foundations ## 2. Mathematical Foundations
The indicator combines two robust algorithms: ```text
1. **Centerline (KAMA):** Upper Band: KAMA + (M · ATR)
* Calculated based on the Efficiency Ratio (ER) of the price. ═══════════════════════════════════════════════════════════════
* When ER is high (efficient, trending move), KAMA speeds up. ▲ Volatility Expansion (ATR)
* When ER is low (inefficient, choppy move), KAMA slows down. │
───────────────────┼───────────────────────────────────────────
│ KAMA Centerline (Equilibrium)
▼
═══════════════════════════════════════════════════════════════
Lower Band: KAMA - (M · ATR)
2. **Bands (ATR):** ```
* $\text{Upper Band}_t = \text{KAMA}_t + (\text{Multiplier} \times \text{ATR}_t)$
* $\text{Lower Band}_t = \text{KAMA}_t - (\text{Multiplier} \times \text{ATR}_t)$
## 3. MQL5 Implementation Details ### 2.1. Centerline Calculation (KAMA)
* **Modular Design:** The calculator (`KAMA_Channel_Calculator.mqh`) composes two independent engines: `CKamaCalculator` for the centerline and `CATRCalculator` for the bands. The central equilibrium line is determined by the market's **Efficiency Ratio (ER)**:
* **O(1) Incremental Calculation:** Optimized for high performance. $$\text{Direction}_t = | P_t - P_{t-N} |$$
* **Heikin Ashi Integration:** Full support for Heikin Ashi price data for both the centerline and the ATR calculation. $$\text{Volatility}_t = \sum_{i=0}^{N-1} | P_{t-i} - P_{t-i-1} |$$
$$\text{ER}_t = \frac{\text{Direction}_t}{\text{Volatility}_t}$$
## 4. Parameters The Scaled Smoothing Constant ($\text{SC}_t$) scales between the fastest ($F$) and slowest ($S$) exponential factors:
$$\alpha_{\text{fast}} = \frac{2}{F + 1}, \quad\quad \alpha_{\text{slow}} = \frac{2}{S + 1}$$
$$\text{SC}_t = \left[ \text{ER}_t \cdot (\alpha_{\text{fast}} - \alpha_{\text{slow}}) + \alpha_{\text{slow}} \right]^2$$
$$\text{Middle}_t = \text{KAMA}_t = \text{KAMA}_{t-1} + \text{SC}_t \cdot (P_t - \text{KAMA}_{t-1})$$
### KAMA Settings (Centerline) ---
* **ER Period:** The lookback period for the Efficiency Ratio. Default is `10`. ### 2.2. Volatility Bands Calculation (Wilder's ATR)
* **Fast EMA Period:** The speed of KAMA during the strongest trend. Default is `2`.
* **Slow EMA Period:** The speed of KAMA during the noisiest range. Default is `30`.
* **Price Source:** Selects the input data (Standard or Heikin Ashi).
### Channel Settings (Bands) The channel width is governed by the Average True Range over period $P_{\text{ATR}}$:
* **ATR Period:** The lookback period for volatility. Default is `14`. #### 1. True Range ($TR$)
* **Multiplier:** The width of the channel in ATR units. Default is `2.0`.
* **ATR Source:** Selects whether to use Standard or Heikin Ashi candles for the ATR calculation.
## 5. Usage and Interpretation $$\text{TR}_t = \max \left( H_t - L_t, \; |H_t - C_{t-1}|, \; |L_t - C_{t-1}| \right)$$
### Trend Following (Breakouts) #### 2. Wilder's RMA Smoothing
* **Signal:** A candle close outside the channel (above Upper or below Lower) often signals the start of a strong impulsive move, especially if the KAMA line is also sloping in that direction. $$\text{ATR}_t = \frac{\text{ATR}_{t-1} \cdot (P_{\text{ATR}} - 1) + \text{TR}_t}{P_{\text{ATR}}}$$
* **Trailing Stop:** The KAMA line itself (or the opposite band) can serve as an excellent trailing stop level.
### Mean Reversion (Range Trading) #### 3. Outer Band Projection
* **Context:** When the KAMA line is flat (horizontal), the market is in a range. $$\text{Upper Band}_t = \text{Middle}_t + (M \cdot \text{ATR}_t)$$
* **Signal:** Price touching the Upper Band is a potential sell signal (target: KAMA line). Price touching the Lower Band is a potential buy signal. $$\text{Lower Band}_t = \text{Middle}_t - (M \cdot \text{ATR}_t)$$
*where $M = \text{InpMultiplier}$ (Channel Width Multiplier).*
### The "Flatline" Setup ---
* Watch for periods where the KAMA line becomes extremely flat. This indicates a consolidation phase. A subsequent breakout from the channel is often explosive. ## 3. MQL5 Architecture & Engineering Standards
```text
┌────────────────────────────────────────────────────────┐
│ KAMA_Channel_Calculator.mqh │
│ (Core Math Engine - Composition of KAMA & ATR) │
└──────────────────────────┬─────────────────────────────┘
│ Calculates Middle, Upper & Lower Bands (O(1))
▼
┌────────────────────────────────────────────────────────┐
│ KAMA_Channel_Pro.mq5 │
│ (Unified Wrapper: Native Timeframe & MTF Engine) │
├──────────────────────────┬─────────────────────────────┤
│ Direct Mode (O(1)) │ Synchronized MTF Pipeline │
│ • Current Timeframe │ • DataSync_Tools Daemon │
│ • Zero-Overhead Bypass │ • Non-Repainting Step Map │
└──────────────────────────┴─────────────────────────────┘
```
1. **Modular Composition Pattern:** `CKamaChannelCalculator` embeds `CKamaCalculator` and `CATRCalculator` directly via composition, guaranteeing zero memory fragmentation and eliminating obsolete polymorphic class duplication.
2. **2026 High-Performance MTF Pipeline:**
* **Asynchronous Data Guard:** Background 1-second timer daemon (`OnTimerUpdate`) manages history readiness without chart-blinking.
* **Forming LTF Block Flat-Force (Staircase Solution):** The mapping start index snaps to `first_bar_of_forming_htf`, updating all lower-timeframe sub-bars of the live higher-timeframe candle simultaneously.
* **State-Safe Live Bar Mocking:** Formulating HTF ticks are computed in real-time on index `g_htf_count - 1` without overwriting historical recursion registers.
---
## 4. Parameters Reference
### Timeframe Settings
* `InpTimeframe` (*default: `PERIOD_CURRENT`*): Timeframe for calculation. When set to `PERIOD_CURRENT`, it operates in native zero-lag mode. When set to a higher timeframe (e.g., `PERIOD_H1`, `PERIOD_D1`), it activates the synchronized MTF engine.
### KAMA Middle Settings
* `InpErPeriod` (*default: `10`*): Lookback period ($N$) for the KAMA Efficiency Ratio calculation.
* `InpFastEmaPeriod` (*default: `2`*): Fastest smoothing period ($F$) during high-efficiency trends.
* `InpSlowEmaPeriod` (*default: `30`*): Slowest smoothing period ($S$) during low-efficiency consolidations.
* `InpSourcePrice` (*default: `PRICE_CLOSE_STD`*): Applied price source for the KAMA centerline (Standard OHLC or Synthetic Heikin Ashi).
### Channel (ATR) Settings
* `InpAtrPeriod` (*default: `14`*): Lookback period ($P_{\text{ATR}}$) for volatility calculation.
* `InpMultiplier` (*default: `2.0`*): Volatility band multiplier ($M$).
* `InpAtrSource` (*default: `ATR_SOURCE_STANDARD`*): Selects whether True Range is derived from Standard candles or filtered Heikin Ashi candles.
### Visual Settings - Middle Line
* `InpColorMiddle` (*default: `clrCrimson`*): Color of the KAMA centerline.
* `InpStyleMiddle` (*default: `STYLE_SOLID`*): Line style of the KAMA centerline.
* `InpWidthMiddle` (*default: `2`*): Line thickness of the KAMA centerline.
### Visual Settings - Outer Bands
* `InpColorBands` (*default: `clrDarkOrange`*): Color applied to Upper and Lower volatility bands.
* `InpStyleBands` (*default: `STYLE_DOT`*): Line style for outer bands.
* `InpWidthBands` (*default: `1`*): Line thickness for outer bands.
---
## 5. Quantitative Trading Strategies & Signal Mechanics
```text
THE KAMA VOLATILITY SQUEEZE CYCLE
Flat Centerline + Narrow Bands ───► Consolidation (Squeeze Build-up)
Candle Close Outside Band ───► Explosive Volatility Expansion
Price Riding Outer Band ───► Strong Trend In Progress
Candle Close Inside Band ───► Exhaustion / Pullback to Centerline
```
### 5.1. The "Flatline" Volatility Squeeze (Breakout Setup)
* **Pre-Condition:** The KAMA centerline flattens out horizontally and the channel narrows significantly (contracting ATR). This identifies an institutional accumulation/distribution zone.
* **Trigger:** A decisive candle close beyond the Upper Band (Long) or Lower Band (Short) with an expanding KAMA Slope confirms an explosive volatility breakout.
### 5.2. Mean-Reversion Range Trading (The Fading Strategy)
* **Pre-Condition:** KAMA centerline is completely flat and horizontal.
* **Short Trigger:** Price spikes into the Upper Band and rejects $\rightarrow$ Target: KAMA Centerline.
* **Long Trigger:** Price drops into the Lower Band and rejects $\rightarrow$ Target: KAMA Centerline.
### 5.3. Multi-Timeframe Trend Envelopes (HTF Macro Filter)
By applying a Higher-Timeframe KAMA Channel (e.g., `PERIOD_H4` or `PERIOD_D1`) onto an intraday `M5` chart:
* Only take intraday long trades when price is trading in the upper half of the macro channel (between HTF Middle and HTF Upper Band).
* Only take intraday short trades when price is trading in the lower half of the macro channel (between HTF Middle and HTF Lower Band).
---
## 6. Indicator Buffer Map (For Developers & EA Integration)
| Buffer Index | Name | Type | Description |
| :---: | :---: | :---: | :--- |
| **0** | `BufferUpper` | `INDICATOR_DATA` | Upper Volatility Band ($\text{Middle} + M \cdot \text{ATR}$) |
| **1** | `BufferLower` | `INDICATOR_DATA` | Lower Volatility Band ($\text{Middle} - M \cdot \text{ATR}$) |
| **2** | `BufferMiddle` | `INDICATOR_DATA` | KAMA Equilibrium Centerline ($\text{Middle}$) |
*All buffers strictly maintain non-series chronological order (`ArraySetAsSeries = false`), ensuring instant compatibility with Expert Advisors and multi-indicator scanner dashboards via `iCustom()`.*