mql5/Indicators/MyIndicators/MovingAverage_Ribbon_MTF_Pro.md

# Moving Average Ribbon MTF Pro

## 1. Summary (Introduction)

The `MovingAverage_Ribbon_MTF_Pro` is a specialized multi-timeframe (MTF) analysis tool designed to project a complete Moving Average Ribbon from a higher timeframe onto your current chart.

It allows you to visualize the trend structure of a **higher, user-selected timeframe** (e.g., seeing the H4 ribbon structure while trading on M15). This provides invaluable context for trend alignment and dynamic support/resistance zones.

## 2. Features

* **4 Independent Lines:** Calculate four separate moving averages based on a single higher timeframe.
* **Full Customization:** Each line has its own Period and MA Type (SMA, EMA, SMMA, LWMA, TMA, DEMA, TEMA).
* **Dynamic Data Window:** The indicator automatically updates the Data Window labels (e.g., showing "EMA(8)" instead of "MA 1") to reflect your current settings, making analysis easier.
* **Heikin Ashi Support:** Can calculate the ribbon based on Heikin Ashi price levels.

## 3. MQL5 Implementation Details

* **Modular Architecture:** The indicator uses a "Manager" class (`MovingAverage_Ribbon_MTF_Calculator.mqh`) that controls four independent instances of a helper calculator. This allows for mixing different MA types within the same ribbon.

* **Optimized Incremental Calculation:**
    Despite calculating 4 lines on a higher timeframe, the indicator remains extremely fast:
  * **State Tracking:** Each of the 4 lines tracks its own calculation state on the higher timeframe.
  * **Persistent Buffers:** Recursive states are preserved, ensuring O(1) complexity per tick.
  * **Efficient Mapping:** The projection logic is optimized to minimize array operations.

## 4. Parameters

### Timeframe & Price

* **`InpUpperTimeframe`:** The single higher timeframe for the entire ribbon.
* **`InpSourcePrice`:** The source price (Standard or Heikin Ashi).

### Line Settings (MA 1 - MA 4)

* **`InpPeriod`:** Lookback period.
* **`InpMAType`:** The algorithm to use (SMA, EMA, etc.).

## 5. Usage and Interpretation

* **Ribbon Expansion:** When the lines fan out (expand) and slope in the same direction, the higher timeframe trend is strengthening.
* **Ribbon Contraction/Twist:** When the lines converge or cross over each other, the higher timeframe is consolidating or reversing.
* **Dynamic Zones:** The area between the fast and slow lines of the MTF ribbon acts as a powerful support/resistance zone during pullbacks.