diff --git a/Indicators/MyIndicators/Authors/Ehlers/5_Ehlers_Hybrids/MACD_SuperSmoother_Histogram_Pro.md b/Indicators/MyIndicators/Authors/Ehlers/5_Ehlers_Hybrids/MACD_SuperSmoother_Histogram_Pro.md new file mode 100644 index 0000000..3d9c456 --- /dev/null +++ b/Indicators/MyIndicators/Authors/Ehlers/5_Ehlers_Hybrids/MACD_SuperSmoother_Histogram_Pro.md @@ -0,0 +1,69 @@ +# MACD SuperSmoother Histogram Professional + +## 1. Summary (Introduction) + +The `MACD_SuperSmoother_Histogram_Pro` is the dedicated histogram component for our SuperSmoother MACD system. Its sole purpose is to calculate and display the difference between the `MACD_SuperSmoother_Line_Pro` and its corresponding signal line. + +This indicator visually represents the convergence and divergence of momentum. The height and depth of the histogram bars provide an immediate sense of momentum acceleration and deceleration in a low-lag environment. + +It is designed as a **companion indicator** to be overlaid in the same window as the `MACD_SuperSmoother_Line_Pro`. When their parameters are synchronized, they form a complete, modern, and highly responsive MACD system. The signal line's smoothing method is user-selectable from the four standard moving average types (SMA, EMA, SMMA, LWMA). + +## 2. Mathematical Foundations and Calculation Logic + +To ensure perfect synchronization and accuracy without external dependencies, this indicator performs the full MACD calculation internally before outputting only the histogram. + +### Required Components + +* **Fast Period (N)** and **Slow Period (M)** for the MACD Line. +* **Signal Line Period (S)** and **MA Type** for the Signal Line. +* **Source Price (P)**. + +### Calculation Steps (Algorithm) + +1. **Calculate the MACD Line:** First, a fast and a slow SuperSmoother filter are calculated on the source price. The MACD Line is their difference. + * $\text{MACD Line}_t = \text{SuperSmoother}(P, N)_t - \text{SuperSmoother}(P, M)_t$ + +2. **Calculate the Signal Line:** A moving average (of the user-selected type) is applied to the MACD Line calculated in the previous step. + * $\text{Signal Line}_t = \text{MA}(\text{MACD Line}, S)_t$ + +3. **Calculate the Histogram:** The final output is the difference between the MACD Line and the Signal Line. + * $\text{Histogram}_t = \text{MACD Line}_t - \text{Signal Line}_t$ + +## 3. MQL5 Implementation Details + +* **Self-Contained Calculation:** The indicator is fully self-contained. Its engine (`MACD_SuperSmoother_Histogram_Calculator.mqh`) internally recalculates the entire SuperSmoother MACD line using our robust `Ehlers_Smoother_Calculator`. This "shared engine" architecture avoids the instability of `iCustom` calls and ensures that the histogram is always perfectly synchronized with its corresponding line indicator, provided the inputs match. + +* **Reusable Components:** The calculator efficiently reuses our modular components: + * It contains two instances of `CEhlersSmootherCalculator` to generate the base MACD line. + * It uses our universal `CalculateMA` helper function to apply the selected moving average for the signal line. + +* **Object-Oriented Design (Inheritance):** The standard `_HA` derived class architecture is used to seamlessly support calculations on Heikin Ashi price data. + +## 4. Parameters + +* **Fast Period (`InpFastPeriod`):** The period for the fast SuperSmoother filter. Default is `12`. +* **Slow Period (`InpSlowPeriod`):** The period for the slow SuperSmoother filter. Default is `26`. +* **Signal Period (`InpSignalPeriod`):** The lookback period for the signal line's moving average. Default is `9`. +* **Signal MA Type (`InpSignalMAType`):** The type of moving average to use for the signal line (SMA, EMA, SMMA, LWMA). Default is `EMA`. +* **Applied Price (`InpSourcePrice`):** The source price for the calculation (Standard or Heikin Ashi). + +## 5. Usage and Interpretation + +This indicator is designed to be used in conjunction with `MACD_SuperSmoother_Line_Pro`. + +**How to set up the full system:** + +1. Add the `MACD_SuperSmoother_Line_Pro` indicator to a chart window. +2. Drag the `MACD_SuperSmoother_Histogram_Pro` indicator **onto the same indicator window**. +3. **Crucially, ensure that the `InpFastPeriod`, `InpSlowPeriod`, and `InpSourcePrice` parameters in both indicators are identical.** +4. You can now adjust the `Signal Period` and `Signal MA Type` in the Histogram indicator to see how different signal lines affect the momentum profile. + +### Interpreting the Histogram + +* **Zero Line Crossover:** This is the most direct signal. + * When the histogram crosses from **negative to positive**, it confirms that the MACD Line has crossed above its Signal Line, generating a bullish signal. + * When the histogram crosses from **positive to negative**, it confirms a bearish crossover. +* **Momentum Acceleration/Deceleration:** + * **Growing Bars:** If the histogram bars are getting larger (further from zero), it means the distance between the MACD Line and Signal Line is increasing, and momentum is accelerating. + * **Shrinking Bars (towards zero):** If the histogram bars are getting smaller, it signals that momentum is decelerating, which can be an early warning of a potential trend change or consolidation. +* **Divergence:** Divergence between the histogram's peaks/troughs and price action can signal powerful reversal opportunities.