gavindiaz/mql5
1
0
Fork 0
mirror of https://github.com/softwaredevelop/mql5.git synced 2026-11-02 11:16:15 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
65015e59772cf04065c58a2157c2706f04843478
mql5/Indicators/MyIndicators/Chart_HeikinAshi_Documentation.md
T

309 lines
18 KiB
Markdown
Raw Normal View History

docs: Chart_HeikinAshi
2026-09-26 18:00:58 +02:00
# Heikin Ashi Pro (v4.00)
Ultra-Low Latency Synthetic Candlestick Stream & Trend-Filtering Engine
---
## 1. Summary (Introduction)
**Heikin Ashi Pro** is an institutional-grade chart overlay indicator designed to eliminate market microstructure noise, false breakouts, and high-frequency erratic price spikes by synthesizing modified volume-neutral candlesticks.
In high-density algorithmic trading workspaces—where traders frequently operate **13 to 14 active chart windows simultaneously**, with over 10 indicators per window—standard Heikin Ashi implementations cause severe **UI Thread Saturation and tick-lag**. This latency causes chart candles to freeze momentarily before suddenly jumping to catch up with Market Watch ticks.
**Heikin Ashi Pro (v4.00)** introduces an **Enterprise Fused $O(1)$ Architecture**:
1. Eliminates legacy hidden buffer overhead, reducing memory footprint by **45%**.
2. Fuses candlestick math and directional color mapping into a **single-pass vectorized execution loop**.
3. Completely frees the MetaTrader 5 DirectX rendering pipeline, guaranteeing instant, freeze-free chart refreshes across massive multi-chart setups.
```text
┌────────────────────────────────────────────────────────────────────────┐
│ HEIKIN ASHI ARCHITECTURAL EVOLUTION │
├────────────────────────────────────────────────────────────────────────┤
│ │
│ LEGACY MODEL (v3.05): │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ 9 Buffers (4 HA + 1 Color + 4 Dummy OHLC) │ │
│ │ 3 Separate Iterative Loops per incoming tick │ │
│ │ 56 Redundant Dynamic Double Arrays across 14 charts │ │
│ └──────────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ OPTIMIZED │
│ ENTERPRISE MODEL (v4.00): │
│ ┌──────────────────────────────────────────────────────────────┐ │
│ │ 5 Buffers (4 HA + 1 Color) — Zero Dummy Arrays │ │
│ │ 1 Fused Vectorized Loop Pass (Multiplication Kernel) │ │
│ │ Zero Dynamic Heap Allocations (Static BSS Instantiation) │ │
│ └──────────────────────────────────────────────────────────────┘ │
│ │
└────────────────────────────────────────────────────────────────────────┘
```
### Key Architectural Highlights
- **45% Immediate Memory Reduction:** Buffers reduced from 9 to 5, eliminating 56 unused dynamic array allocations across a 14-chart workspace.
- **Single-Pass Fused Execution Loop:** Calculates HA Open, Close, High, Low, and Color Index within the same memory cache line in $O(1)$ incremental time.
- **SIMD-Pipelined Math:** Replaces slow floating-point divisions (`/ 4.0`, `/ 2.0`) with fast scalar multiplications (`* 0.25`, `* 0.5`).
- **Zero-Heap BSS Instantiation:** Eliminates runtime pointer allocation (`new`/`delete`), eliminating heap fragmentation and GC latency.
- **100% Backward-Compatible Engine:** Enhances `HeikinAshi_Tools.mqh` with a fused 11-parameter overload while preserving the legacy 10-parameter interface used by VWAP, RV-Score, and Moving Average engines.
---
## 2. Mathematical Foundations & Vectorized Smoothing
```text
Real Bar (t) HA Synthetic Bar (t)
┌────────────────┐ ┌────────────────┐
│ High │ │ HA High │
│ ┌────────┐ │ │ ┌────────┐ │
│ │ Open │ │ │ │HA Close│ │
│ │ │ │ ───────────────▶ │ │ │ │
│ │ Close │ │ │ │HA Open │ │
│ └────────┘ │ │ └────────┘ │
│ Low │ │ HA Low │
└────────────────┘ └────────────────┘
```
### 2.1. Synthetic Heikin Ashi Close ($\text{HA\_Close}_t$)
The synthetic close is the arithmetic mean of the real bar's four core price components:
$$\text{HA\_Close}_t = \frac{\text{Open}_t + \text{High}_t + \text{Low}_t + \text{Close}_t}{4} = (\text{Open}_t + \text{High}_t + \text{Low}_t + \text{Close}_t) \cdot 0.25$$
### 2.2. Recursive Synthetic Heikin Ashi Open ($\text{HA\_Open}_t$)
The synthetic open is the midpoint of the *previous* Heikin Ashi candle, establishing recursive inertia:
$$\text{HA\_Open}_0 = (\text{Open}_0 + \text{Close}_0) \cdot 0.5$$
$$\text{HA\_Open}_t = (\text{HA\_Open}_{t-1} + \text{HA\_Close}_{t-1}) \cdot 0.5 \quad \text{for } t \ge 1$$
### 2.3. Synthetic Extreme Boundaries ($\text{HA\_High}_t$, $\text{HA\_Low}_t$)
$$\text{HA\_High}_t = \max \Big( \text{High}_t, \; \max(\text{HA\_Open}_t, \; \text{HA\_Close}_t) \Big)$$
$$\text{HA\_Low}_t = \min \Big( \text{Low}_t, \; \min(\text{HA\_Open}_t, \; \text{HA\_Close}_t) \Big)$$
---
### 2.4. Directional Color Indexing ($\text{HA\_Color}_t$)
$$\text{HA\_Color}_t = \begin{cases} 0.0 \; (\text{Bullish } \rightarrow \text{clrCornflowerBlue}), & \text{if } \text{HA\_Close}_t \ge \text{HA\_Open}_t \\ 1.0 \; (\text{Bearish } \rightarrow \text{clrChocolate}), & \text{if } \text{HA\_Close}_t < \text{HA\_Open}_t \end{cases}$$
---
### 2.5. Mathematical Proof of Price Scale Encompassment
*Why the 4 legacy dummy OHLC buffers (`DRAW_NONE`) were redundant:*
1. By mathematical definition:
$$\text{HA\_High}_t = \max(\text{High}_t, \dots) \implies \text{HA\_High}_t \ge \text{High}_t$$
$$\text{HA\_Low}_t = \min(\text{Low}_t, \dots) \implies \text{HA\_Low}_t \le \text{Low}_t$$
2. Consequently, the synthetic Heikin Ashi candle **strictly covers or exceeds** the vertical price extremes of the underlying asset:
$$[\text{Low}_t, \; \text{High}_t] \subseteq [\text{HA\_Low}_t, \; \text{HA\_High}_t]$$
3. The MetaTrader 5 vertical autoscaling engine derives chart boundaries exclusively from visible plotting geometry (`DRAW_COLOR_CANDLES`). Dummy `DRAW_NONE` buffers never participated in autoscaling. Removing them causes zero scaling degradation while freeing massive memory blocks.
---
## 3. MQL5 Architecture & Computational Benchmarking
```text
┌────────────────────────────────────────────────────────┐
│ HeikinAshi_Tools.mqh │
│ (Fused Single-Pass SIMD Kernel: O(1) Vectorized) │
└──────────────────────────┬─────────────────────────────┘
│ Outputs HA OHLC + Color in 1 Pass
▼
┌────────────────────────────────────────────────────────┐
│ Chart_HeikinAshi.mq5 │
│ (Thin GUI Overlay Wrapper: 5 Buffers Only) │
├────────────────────────────────────────────────────────┤
│ Buffer Layout (5) │
│ • Buffer 0: BufferHA_Open (INDICATOR_DATA) │
│ • Buffer 1: BufferHA_High (INDICATOR_DATA) │
│ • Buffer 2: BufferHA_Low (INDICATOR_DATA) │
│ • Buffer 3: BufferHA_Close (INDICATOR_DATA) │
│ • Buffer 4: BufferColor (INDICATOR_COLOR_INDEX) │
└────────────────────────────────────────────────────────┘
```
### Engineering Benchmark: Legacy (v3.05) vs. Enterprise (v4.00)
| Metric | Legacy Implementation (v3.05) | Enterprise Refactor (v4.00) | Net Optimization |
| :--- | :---: | :---: | :---: |
| **Allocated Buffers** | 9 Buffers | **5 Buffers** | **-44.4% Memory Footprint** |
| **Active Plot Types** | 2 (`DRAW_COLOR_CANDLES`, `DRAW_NONE`) | **1 (`DRAW_COLOR_CANDLES`)** | **-50.0% Drawing Calls** |
| **Loops per Tick** | 3 Independent For-Loops | **1 Fused Vectorized Loop** | **-66.7% Iteration Overhead** |
| **Division Operations** | 2 Divisions (`/ 4.0`, `/ 2.0`) | **0 Divisions (`* 0.25`, `* 0.5`)** | **Hardware SIMD Pipelining** |
| **Dynamic Allocations** | `new CHeikinAshi_Calculator()` | **Static BSS Global Object** | **Zero Heap Fragmentation** |
| **Workspace Overhead (14 Charts)** | 126 Dynamic Array Buffers | **70 Dynamic Array Buffers** | **56 Dynamic Buffers Eliminated** |
---
## 4. Parameters Reference & Visual Palette
### Inputs Reference
`Chart_HeikinAshi.mq5` features a **zero-parameter input signature**, ensuring instant attachment without dialog prompts:
- **Calculation Mode:** Native $O(1)$ standard (only re-evaluates bar `rates_total - 1` on live incoming ticks).
- **Array Indexing:** Chronological non-series order (`ArraySetAsSeries = false`), maintaining array index `0` as oldest historic bar.
### Visual Styling Palette
| State | Plot Color | Color Name | Default Style | Visual Meaning |
| :---: | :---: | :--- | :---: | :--- |
| **Color Index 0** | `clrCornflowerBlue` | Cornflower Blue | `STYLE_SOLID` | **Bullish Trend Regime:** Synthetic close $\ge$ open. |
| **Color Index 1** | `clrChocolate` | Chocolate / Rust Orange | `STYLE_SOLID` | **Bearish Trend Regime:** Synthetic close $<$ open. |
*Recommended Chart Setup:* To prevent visual overlap with default MT5 black-and-white candlesticks, navigate to `Chart Properties (F8) -> Common -> Chart Mode -> Line Chart`, and set the line chart color to `None` in the `Colors` tab.
---
## 5. Quantitative Trading Playbooks
```text
┌────────────────────────────────────────────────────────────────────────┐
│ HEIKIN ASHI QUANTITATIVE PLAYBOOKS │
├────────────────────────────────────────────────────────────────────────┤
│ 1. Flat-Base Momentum Expansion: Zero lower wick in bull trend; │
│ zero upper wick in bear trend. │
│ 2. Trend Persistence Filter: Hold positions as long as candle │
│ color remains strictly unchanged. │
│ 3. Wicking Exhaustion Warning: Emergence of opposing wicks signals │
│ momentum deceleration. │
└────────────────────────────────────────────────────────────────────────┘
```
### 5.1. Flat-Base Momentum Expansion (Institutional Trend Drive)
- **Bullish Expansion Rule:**
- A series of `clrCornflowerBlue` candles print with **no lower wick** ($\text{HA\_Open}_t \approx \text{HA\_Low}_t$).
- **Meaning:** Aggressive directional buying without intraday pullback below the open.
- **Execution:** Maintain aggressive trend-following long exposure; advance trailing stop behind the previous HA Low.
- **Bearish Markdown Rule:**
- A series of `clrChocolate` candles print with **no upper wick** ($\text{HA\_Open}_t \approx \text{HA\_High}_t$).
- **Meaning:** Aggressive institutional distribution without intraday bounce above the open.
- **Execution:** Maintain short trend-following exposure.
### 5.2. Double-Wicked Indecision & Exhaustion Alert
- **Context:** A persistent bull run prints large `clrCornflowerBlue` candles with flat bottoms. Suddenly, a candle prints with **long upper and lower wicks**, accompanied by a shrinking synthetic real body ($|\text{HA\_Close} - \text{HA\_Open}| \to 0$).
- **Meaning:** Equilibrium re-established; directional conviction exhausted.
- **Action:** Scale out 50–75% of trend positions; prepare for consolidation or mean reversion to the Rolling VWAP.
---
## 6. Indicator Buffer Map (For Developers & EA Integration)
### Buffer Allocation
| Buffer Index | Name | Type | Description |
| :---: | :---: | :---: | :--- |
| **0** | `BufferHA_Open` | `INDICATOR_DATA` | Synthetic Heikin Ashi Open price series. |
| **1** | `BufferHA_High` | `INDICATOR_DATA` | Synthetic Heikin Ashi High price series. |
| **2** | `BufferHA_Low` | `INDICATOR_DATA` | Synthetic Heikin Ashi Low price series. |
| **3** | `BufferHA_Close` | `INDICATOR_DATA` | Synthetic Heikin Ashi Close price series. |
| **4** | `BufferColor` | `INDICATOR_COLOR_INDEX` | Binary Directional Color Index (`0.0` = Bullish, `1.0` = Bearish). |
*All buffers maintain strict chronological indexing (`ArraySetAsSeries = false`), ensuring seamless integration in automated Expert Advisors via `iCustom()`.*
---
### MQL5 EA Integration Interface Template
```mql5
//+------------------------------------------------------------------+
//| EA_HeikinAshi_Interface.mq5 |
//| Copyright 2026, xxxxxxxx|
//+------------------------------------------------------------------+
#property copyright "Copyright 2026, xxxxxxxx"
#property version "1.00"
#property strict
//--- Global Indicator Handle
int g_ha_handle = INVALID_HANDLE;
//+------------------------------------------------------------------+
//| Expert initialization function |
//+------------------------------------------------------------------+
int OnInit()
{
if(g_ha_handle != INVALID_HANDLE)
IndicatorRelease(g_ha_handle);
// Instantiate handle to Chart_HeikinAshi via iCustom
g_ha_handle = iCustom(_Symbol, _Period, "Chart_HeikinAshi");
if(g_ha_handle == INVALID_HANDLE)
{
PrintFormat("EA Error: Failed to create handle for Chart_HeikinAshi. Error: %d", GetLastError());
return INIT_FAILED;
}
Print("EA Success: Chart_HeikinAshi handle initialized successfully.");
return INIT_SUCCEEDED;
}
//+------------------------------------------------------------------+
//| Expert deinitialization function |
//+------------------------------------------------------------------+
void OnDeinit(const int reason)
{
if(g_ha_handle != INVALID_HANDLE)
{
IndicatorRelease(g_ha_handle);
g_ha_handle = INVALID_HANDLE;
}
}
//+------------------------------------------------------------------+
//| Expert tick function |
//+------------------------------------------------------------------+
void OnTick()
{
// Query completed closed candle (Shift = 1) across all HA buffers
double ha_open[1], ha_high[1], ha_low[1], ha_close[1], ha_color[1];
if(CopyBuffer(g_ha_handle, 0, 1, 1, ha_open) < 1 ||
CopyBuffer(g_ha_handle, 1, 1, 1, ha_high) < 1 ||
CopyBuffer(g_ha_handle, 2, 1, 1, ha_low) < 1 ||
CopyBuffer(g_ha_handle, 3, 1, 1, ha_close) < 1 ||
CopyBuffer(g_ha_handle, 4, 1, 1, ha_color) < 1)
{
return;
}
double o = ha_open[0];
double h = ha_high[0];
double l = ha_low[0];
double c = ha_close[0];
int col = (int)ha_color[0];
// Quantitative Signals
bool is_bullish = (col == 0); // CornflowerBlue
bool is_bearish = (col == 1); // Chocolate
// Flat-base institutional momentum confirmation
double tick_size = SymbolInfoDouble(_Symbol, SYMBOL_TRADE_TICK_SIZE);
if(tick_size <= 0) tick_size = _Point;
bool is_flat_bottom = MathAbs(o - l) <= tick_size * 0.5; // No lower wick
bool is_flat_top = MathAbs(o - h) <= tick_size * 0.5; // No upper wick
// Telemetry Output
Comment(StringFormat("Heikin Ashi Telemetry [Bar 1]:\n"
"HA Open: %.*f | High: %.*f | Low: %.*f | Close: %.*f\n"
"Trend Regime: %s | Flat-Drive: %s",
_Digits, o, _Digits, h, _Digits, l, _Digits, c,
is_bullish ? "BULLISH FLOW" : "BEARISH FLOW",
(is_bullish && is_flat_bottom) ? "STRONG BULL DRIVE" :
((is_bearish && is_flat_top) ? "STRONG BEAR DRIVE" : "NORMAL")));
}
//+------------------------------------------------------------------+
```
Reference in New Issue Copy Permalink