mirror of
https://github.com/softwaredevelop/mql5.git
synced 2026-08-26 02:38:05 +00:00
new files added
This commit is contained in:
Toh4iem9
@@ -0,0 +1,192 @@
|
|||||||
|
# Kaufman's Adaptive Moving Average (KAMA) Acceleration Pro (v1.00)
|
||||||
|
|
||||||
|
Quantitative Second-Derivative Kinetic Acceleration & Force Subwindow Suite
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 1. Summary (Introduction)
|
||||||
|
|
||||||
|
**KAMA Acceleration Pro** is an institutional-grade kinetic momentum oscillator that calculates the mathematical **second derivative ($\Delta^2 \text{KAMA}$)** of Perry Kaufman's Adaptive Moving Average.
|
||||||
|
|
||||||
|
In market physics, price represents **Position**, the slope represents **Velocity**, and the change in slope represents **Acceleration (Force)**. While `KAMA_Slope_Pro` monitors trend direction and velocity, `KAMA_Acceleration_Pro` detects changes in the underlying force driving the market. It serves as the ultimate early-warning indicator, exposing trend exhaustion, deceleration, and explosive impulse triggers long before moving average crossovers or structural breaks manifest on the main price chart.
|
||||||
|
|
||||||
|
```text
|
||||||
|
|
||||||
|
┌────────────────────────────────────────────────────────────────────────┐
|
||||||
|
│ THE KAMA KINETIC TRI-FACTOR SUITE │
|
||||||
|
├──────────────────────┬────────────────────────┬────────────────────────┤
|
||||||
|
│ Indicator │ Physical Domain │ Core Function │
|
||||||
|
├──────────────────────┼────────────────────────┼────────────────────────┤
|
||||||
|
│ KAMA_Pro │ Position (0th Deriv) │ Trend & Dynamic S/R │
|
||||||
|
│ KAMA_Slope_Pro │ Velocity (1st Deriv) │ Momentum & Speed │
|
||||||
|
│ KAMA_Acceleration_Pro│ Force (2nd Deriv) │ Impulse & Exhaustion │
|
||||||
|
└──────────────────────┴────────────────────────┴────────────────────────┘
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### Key Capabilities
|
||||||
|
|
||||||
|
* **Discrete Second-Derivative Engine:** Directly computes the rate of momentum change ($\Delta^2 \text{KAMA}$) with $O(1)$ efficiency.
|
||||||
|
* **Swapped Thermal 5-Zone Color Matrix:** Classifies acceleration into five institutional thermodynamic states: Strong Bull/Bear Impulses, Decelerating Fades, and Low-Energy Consolidation.
|
||||||
|
* **Integrated Signal Smoothing Engine:** Features 8 moving average algorithms (including True Volume and Tick-Volume VWMA) for precise signal line crossover identification.
|
||||||
|
* **Unified MTF Architecture with DataSync Daemon:** Seamlessly integrates with `DataSync_Tools.mqh` for non-repainting, flat-step multi-timeframe synchronization.
|
||||||
|
* **Expanded Precision Architecture (`_Digits + 4`):** Automatically scales sub-point floating resolution to eliminate quantization errors in discrete second differences.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Mathematical Foundations & Kinetic Dynamics
|
||||||
|
|
||||||
|
```text
|
||||||
|
|
||||||
|
Δ² KAMA = KAMA(t) - 2·KAMA(t - 1) + KAMA(t - 2)
|
||||||
|
▲ (Bullish Acceleration Expansion: DodgerBlue)
|
||||||
|
│
|
||||||
|
──────┼──────────────────────────────────────────── 0.0 (Zero Force / Chop: Gray)
|
||||||
|
│
|
||||||
|
▼ (Bearish Acceleration Expansion: Crimson)
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2.1. Discrete Second-Derivative Derivation
|
||||||
|
|
||||||
|
Velocity (Slope) is defined as the discrete first difference:
|
||||||
|
$$\text{Slope}_t = \text{KAMA}_t - \text{KAMA}_{t-1}$$
|
||||||
|
|
||||||
|
Acceleration is the discrete rate of change of Velocity:
|
||||||
|
$$\text{Accel}_t = \text{Slope}_t - \text{Slope}_{t-1} = (\text{KAMA}_t - \text{KAMA}_{t-1}) - (\text{KAMA}_{t-1} - \text{KAMA}_{t-2})$$
|
||||||
|
$$\text{Accel}_t = \text{KAMA}_t - 2 \cdot \text{KAMA}_{t-1} + \text{KAMA}_{t-2}$$
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.2. Swapped Thermal 5-Zone Momentum Matrix
|
||||||
|
|
||||||
|
The acceleration derivative is classified into 5 distinct thermal zones relative to a user-defined neutral deadband threshold ($\epsilon = \text{InpThreshold}$):
|
||||||
|
|
||||||
|
| Index | Color | Classification | Mathematical Condition | Kinetic Market Interpretation |
|
||||||
|
| :---: | :---: | :--- | :--- | :--- |
|
||||||
|
| **0.0** | `clrGray` | **Neutral / Inertia** | $\|\text{Accel}_t\| \le \epsilon$ | Zero net acceleration; market is drifting with constant velocity or flat. |
|
||||||
|
| **1.0** | `clrDodgerBlue` | **Strong Bullish Force** | $\text{Accel}_t > \epsilon \quad \text{and} \quad \text{Accel}_t > \text{Accel}_{t-1}$ | Upward force expanding; parabolic trend impulse active. |
|
||||||
|
| **2.0** | `clrLightSkyBlue` | **Fading Bullish Force** | $\text{Accel}_t > \epsilon \quad \text{and} \quad \text{Accel}_t \le \text{Accel}_{t-1}$ | Upward acceleration tapering off; buyer exhaustion warning. |
|
||||||
|
| **3.0** | `clrCrimson` | **Strong Bearish Force** | $\text{Accel}_t < -\epsilon \quad \text{and} \quad \text{Accel}_t < \text{Accel}_{t-1}$ | Downward force expanding; aggressive institutional selling impulse. |
|
||||||
|
| **4.0** | `clrCoral` | **Fading Bearish Force** | $\text{Accel}_t < -\epsilon \quad \text{and} \quad \text{Accel}_t \ge \text{Accel}_{t-1}$ | Downward acceleration tapering off; short-covering bounce potential. |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2.3. Signal Moving Average Smoothing
|
||||||
|
|
||||||
|
An optional moving average smoothing line filters high-frequency acceleration micro-noise:
|
||||||
|
$$\text{Signal}_t = \mathcal{MA}(\text{Accel}, \text{Period} = \text{InpSignalPeriod}, \text{Type} = \text{InpSignalType})$$
|
||||||
|
|
||||||
|
*When `InpSignalType = VWMA`, real or tick volume is incorporated:*
|
||||||
|
$$\text{Signal}_{\text{VWMA}, t} = \frac{\sum_{j=0}^{M-1} \text{Accel}_{t-j} \cdot V_{t-j}}{\sum_{j=0}^{M-1} V_{t-j}}$$
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 3. MQL5 Architecture & Engineering Standards
|
||||||
|
|
||||||
|
```text
|
||||||
|
|
||||||
|
┌────────────────────────────────────────────────────────┐
|
||||||
|
│ KAMA_Acceleration_Calculator.mqh │
|
||||||
|
│ (Core Math Engine - Encapsulated CKamaCalculator) │
|
||||||
|
└──────────────────────────┬─────────────────────────────┘
|
||||||
|
│ Outputs Accel & Thermal Color Index
|
||||||
|
▼
|
||||||
|
┌────────────────────────────────────────────────────────┐
|
||||||
|
│ KAMA_Acceleration_Pro.mq5 │
|
||||||
|
│ (Unified Wrapper: Native Timeframe & MTF Engine) │
|
||||||
|
├──────────────────────────┬─────────────────────────────┤
|
||||||
|
│ Buffer Layer (3) │ Centralized Tools │
|
||||||
|
│ • BufferAccel (DATA) │ • DataSync_Tools.mqh │
|
||||||
|
│ • BufferColor (INDEX) │ • MovingAverage_Engine │
|
||||||
|
│ • BufferSignal (DATA) │ • Expanded Precision │
|
||||||
|
└──────────────────────────┴─────────────────────────────┘
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
1. **Embedded Engine Composition:** `CKamaAccelerationCalculator` encapsulates `CKamaCalculator` directly on the stack/heap without external memory leaks.
|
||||||
|
2. **Sub-Point Floating Resolution:** Acceleration signals reside in sub-pip micro-decimal territory. The indicator explicitly sets `INDICATOR_DIGITS = _Digits + 4` to prevent visual truncation on modern low-spread crypto, FX, and equity instruments.
|
||||||
|
3. **2026 MTF Framework (`DataSync_Tools.mqh`):**
|
||||||
|
* Asynchronous 1-second timer guard (`OnTimerUpdate`).
|
||||||
|
* Closed-bar caching prevents historical re-computation.
|
||||||
|
* Dynamic staircase anchor (`first_bar_of_forming_htf`) guarantees non-repainting flat steps in real-time.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 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_M15`, `PERIOD_H1`), it activates the synchronized MTF engine.
|
||||||
|
|
||||||
|
### KAMA Core Settings
|
||||||
|
|
||||||
|
* `InpErPeriod` (*default: `10`*): The lookback window ($N$) used to calculate price direction and volatility.
|
||||||
|
* `InpFastEmaPeriod` (*default: `2`*): The fastest smoothing period ($F$) during high directional efficiency.
|
||||||
|
* `InpSlowEmaPeriod` (*default: `30`*): The slowest smoothing period ($S$) during low efficiency.
|
||||||
|
* `InpSourcePrice` (*default: `PRICE_CLOSE_STD`*): Input price series (Standard OHLC or Synthetic Heikin Ashi).
|
||||||
|
* `InpThreshold` (*default: `0.000010`*): The deadband threshold ($\epsilon$) below which acceleration is classified as neutral consolidation (`clrGray`).
|
||||||
|
|
||||||
|
### Signal MA Settings
|
||||||
|
|
||||||
|
* `InpShowSignal` (*default: `true`*): Toggle visibility of the Signal Moving Average line.
|
||||||
|
* `InpSignalPeriod` (*default: `5`*): The lookback period for the signal line.
|
||||||
|
* `InpSignalType` (*default: `EMA`*): The mathematical smoothing algorithm (`SMA`, `EMA`, `SMMA`, `LWMA`, `TMA`, `DEMA`, `TEMA`, `VWMA`).
|
||||||
|
* `InpColorSignal` (*default: `clrMaroon`*): Color applied to the signal line plot.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 5. Quantitative Trading Strategies & Signal Mechanics
|
||||||
|
|
||||||
|
```text
|
||||||
|
|
||||||
|
BULLISH FORCE EXPANSION BEARISH FORCE EXPANSION
|
||||||
|
DodgerBlue (Strong Force) Crimson (Strong Force)
|
||||||
|
▲ │
|
||||||
|
│ ▼
|
||||||
|
LightSkyBlue (Fading Force) Coral (Fading Force)
|
||||||
|
│ ▲
|
||||||
|
▼ │
|
||||||
|
Gray (Zero Force) Gray (Zero Force)
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5.1. Leading Exhaustion & Early Take-Profit
|
||||||
|
|
||||||
|
* **Bullish Peak Warning:** When the price is making new highs and the KAMA Slope is positive, but the Acceleration histogram transitions from **`clrDodgerBlue`** to **`clrLightSkyBlue`**, the upward force is actively decaying. This is an institutional signal to tighten stop-losses or lock in partial profits.
|
||||||
|
* **Bearish Floor Warning:** When price plunges but Acceleration transitions from **`clrCrimson`** to **`clrCoral`**, selling pressure is decelerating, preceding a short-squeeze bounce.
|
||||||
|
|
||||||
|
### 5.2. Signal Line Crossovers as Impulse Triggers
|
||||||
|
|
||||||
|
* **Bullish Impulse Trigger:** Acceleration histogram crosses above the Signal MA line from below zero $\rightarrow$ High-conviction aggressive long entry.
|
||||||
|
* **Bearish Impulse Trigger:** Acceleration histogram crosses below the Signal MA line from above zero $\rightarrow$ High-conviction aggressive short entry.
|
||||||
|
|
||||||
|
### 5.3. The Tri-Factor KAMA Confluence Framework
|
||||||
|
|
||||||
|
For systematic institutional trading, combine all three indicators on a single chart:
|
||||||
|
|
||||||
|
```text
|
||||||
|
|
||||||
|
┌───────────┬──────────────────────────┬──────────────────────────┬──────────────────────────┐
|
||||||
|
│ Market │ Main Chart: KAMA_Pro │ Subwindow 1: KAMA_Slope │ Subwindow 2: KAMA_Accel │
|
||||||
|
├───────────┼──────────────────────────┼──────────────────────────┼──────────────────────────┤
|
||||||
|
│ Strong Long│ Price > Rising KAMA │ Green (MediumSeaGreen) │ Blue (DodgerBlue) │
|
||||||
|
│ Early Exit│ Price > Rising KAMA │ Green (PaleGreen) │ Fading (LightSkyBlue) │
|
||||||
|
│ Strong Short│ Price < Falling KAMA │ Red (Crimson) │ Crimson (Crimson) │
|
||||||
|
│ Early Cover│ Price < Falling KAMA │ Red (LightCoral) │ Fading (Coral) │
|
||||||
|
│ No Trade │ Flat KAMA Line │ Gray (clrGray) │ Gray (clrGray) │
|
||||||
|
└───────────┴──────────────────────────┴──────────────────────────┴──────────────────────────┘
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 6. Indicator Buffer Map (For Developers & EA Integration)
|
||||||
|
|
||||||
|
| Buffer Index | Name | Type | Description |
|
||||||
|
| :---: | :---: | :---: | :--- |
|
||||||
|
| **0** | `BufferAccel` | `INDICATOR_DATA` | Discrete Acceleration 2nd Derivative Values ($\Delta^2 \text{KAMA}$) |
|
||||||
|
| **1** | `BufferAccelColor` | `INDICATOR_COLOR_INDEX` | Thermal 5-Zone Palette Index ($0.0 \dots 4.0$) |
|
||||||
|
| **2** | `BufferSignalMA` | `INDICATOR_DATA` | Smoothed Signal Moving Average Plot |
|
||||||
|
|
||||||
|
*All buffers strictly maintain non-series chronological order (`ArraySetAsSeries = false`), ensuring seamless integration with MetaTrader 5 Expert Advisors via `iCustom()`.*
|
||||||
Reference in New Issue
Block a user