new files added

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.