diff --git a/Indicators/MyIndicators/Authors/Ehlers/1_Smoothers/ZeroLag_EMA_Pro.md b/Indicators/MyIndicators/Authors/Ehlers/1_Smoothers/ZeroLag_EMA_Pro.md new file mode 100644 index 0000000..c0c64a4 --- /dev/null +++ b/Indicators/MyIndicators/Authors/Ehlers/1_Smoothers/ZeroLag_EMA_Pro.md @@ -0,0 +1,61 @@ +# Zero-Lag EMA Professional (ZLEMA) + +## 1. Summary (Introduction) + +The Zero-Lag Exponential Moving Average (ZLEMA), based on concepts by John Ehlers, is an enhanced version of the traditional EMA designed to **reduce or eliminate lag**. + +This indicator offers two distinct calculation modes: + +1. **Standard ZLEMA (Default):** A fast and robust implementation based on a "double EMA" technique. It provides a significant reduction in lag compared to a standard EMA, making it an excellent, responsive trendline. This is the recommended mode for most trading applications. +2. **Ehlers' Error Correcting Mode (Advanced):** An experimental mode that implements Ehlers' original, self-optimizing "Error Correcting" algorithm. On every bar, it searches for an optimal `gain` factor to minimize the error between the filter and the price. While academically interesting, this mode is significantly more CPU-intensive and may not necessarily produce better trading signals. + +The result is a versatile moving average that can be used as either a fast, standard ZLEMA or as a platform for experimenting with Ehlers' more complex adaptive theories. + +## 2. Mathematical Foundations and Calculation Logic + +The indicator can operate in one of two modes, each with a different underlying formula. + +### Standard ZLEMA (Double EMA Method) + +This is the most common and efficient implementation of the zero-lag concept. + +1. Calculate a standard `N`-period EMA on the source price (`EMA1`). +2. Calculate a second `N`-period EMA on the `EMA1` series (`EMA2`). +3. The "lag" is identified as the difference `(EMA1 - EMA2)`. +4. This lag is added back to the first EMA to produce the de-lagged value: + $\text{ZLEMA} = \text{EMA1} + (\text{EMA1} - \text{EMA2})$ + +### Ehlers' Error Correcting (EC) Method + +This method uses a feedback loop to continuously adjust the filter's responsiveness. + +1. Calculate a standard `N`-period EMA of the price. +2. On each bar, iterate through a range of possible `gain` values. +3. For each `gain`, calculate a trial EC value using the formula: + $\text{EC}_{\text{trial}} = \alpha(\text{EMA} + \text{gain}(P_i - \text{EC}_{i-1})) + (1-\alpha)\text{EC}_{i-1}$ +4. Find the `BestGain` that results in the minimum error (`|P_i - EC_trial|`). +5. Calculate the final EC value for the bar using this `BestGain`. + +## 3. MQL5 Implementation Details + +* **Dual-Mode Calculator (`ZeroLag_EMA_Calculator.mqh`):** The calculator class contains both calculation methods, selectable via a boolean flag during initialization. +* **Heikin Ashi Integration:** An inherited `_HA` class allows both modes to be calculated seamlessly on smoothed Heikin Ashi data. +* **Stability via Full Recalculation:** Both modes are recursive. The indicator employs a full recalculation on every `OnCalculate` call to ensure stability. + +## 4. Parameters + +* **Period (`InpPeriod`):** The lookback period (`N`) for the underlying EMA calculations in both modes. +* **Applied Price (`InpSourcePrice`):** The source price for the calculation. +* **Advanced Settings:** + * `Optimize Gain (`InpOptimizeGain`): If`true`, the indicator uses the slower, experimental "Error Correcting" method. If`false` (default), it uses the fast and standard "Double EMA" method. **It is recommended to keep this set to `false` for general use.** + * `Gain Limit (`InpGainLimit`): Only applies if`Optimize Gain` is `true`. Sets the range (`+/- GainLimit`) for the optimization search loop. + +## 5. Usage and Interpretation + +The ZLEMA should be used as a faster, more responsive alternative to a traditional moving average. The interpretation is the same, but the signals are more timely. + +* **Dynamic Support and Resistance:** The ZLEMA line acts as a dynamic S/R level. Due to its reduced lag, it will be tested sooner and more accurately than a standard EMA. +* **Trend Filtering:** A longer-period ZLEMA can be used to define the overall market bias, providing earlier warnings of potential trend changes. +* **Crossover Signals:** Crossover systems (price-cross or two-line cross) will generate signals earlier than equivalent EMA-based systems, allowing for faster entry into new trends. + +**Caution:** The ZLEMA's increased responsiveness also means it can be more susceptible to "whipsaws" in choppy, sideways markets. It is most effective in clear, trending market conditions.