gavindiaz/mql5
1
0
Fork 0
mirror of https://github.com/softwaredevelop/mql5.git synced 2026-07-27 20:47:44 +00:00
Code Issues Packages Projects Releases Wiki Activity

refactor: Dynamic Data Window Labels

Browse Source
This commit is contained in:
Toh4iem9
2025-12-18 14:17:02 +01:00
parent 032a5a2597
commit 6a5532e76a
1 changed files with 22 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Indicators/MyIndicators/MovingAverage_Ribbon_MTF_Pro.md
+22 -38
View File
@@ -4,55 +4,39 @@
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.
Unlike standard ribbons that only show trends on the current chart, this indicator 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.
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.
The indicator calculates four moving average lines on the chosen higher timeframe and projects them onto the current chart as "step-like" lines.
## 2. Features
The indicator provides control over:
* **Central Timeframe:** One single higher timeframe that applies to the entire ribbon.
* **Period:** Independent period settings for each of the 4 lines.
* **MA Type:** Independent type settings (SMA, EMA, SMMA, LWMA, TMA, DEMA, TEMA) for each of the 4 lines.
* **Price Source:** Standard or Heikin Ashi.
## 2. Mathematical Foundations and Calculation Logic
The indicator performs four independent MTF moving average calculations based on a shared higher timeframe.
1. **Fetch Higher Timeframe Data:** The indicator retrieves the OHLC price data for the single user-selected higher timeframe (`InpUpperTimeframe`).
2. **Calculate the Moving Averages:** Four separate moving averages are calculated on this higher timeframe data, using their respective periods and types.
3. **Project to Current Chart:** All four calculated series are mapped to the current chart. Each value from the higher timeframe is held constant for the duration of its corresponding bars on the lower timeframe, creating the visual "step" effect.
* **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
This indicator is built on a robust, `iCustom()`-free, and highly modular architecture.
* **Modular "Manager" Calculator (`MovingAverage_Ribbon_MTF_Calculator.mqh`):** The main engine uses the composition design pattern. It contains four independent instances of the `CSingleMAMTFCalculator` helper class.
* Even though they share the same source timeframe, each line is calculated independently to allow for different MA types (e.g., mixing EMA and SMA) and periods.
* **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:**
The indicator employs a sophisticated incremental algorithm to ensure high performance.
* **HTF State Tracking:** It tracks the calculation state of the higher timeframe separately.
* **Persistent Buffers:** The internal buffers for recursive calculations (EMA, SMMA, DEMA, TEMA) persist between ticks.
* **Efficient Mapping:** The projection loop only updates the bars corresponding to the new data.
* This results in **O(1) complexity** per tick, ensuring the indicator remains lightweight even when running on multiple charts.
* **No External Dependencies:** The entire calculation is self-contained. It directly fetches the required higher-timeframe price data using built-in `Copy...` functions.
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 Source:**
* **`InpUpperTimeframe`:** The single higher timeframe on which the entire ribbon will be calculated. If set to `PERIOD_CURRENT`, it behaves like a standard ribbon.
* **`InpSourcePrice`:** The source price for all calculations (Standard or Heikin Ashi).
### Timeframe & Price
* **MA 1-4 Settings:**
* **`InpPeriod1` - `InpPeriod4`:** The lookback period for each line.
* **`InpMAType1` - `InpMAType4`:** The MA type (SMA, EMA, SMMA, LWMA, TMA, DEMA, TEMA) for each line.
* **`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
The MTF Ribbon provides crucial context for lower-timeframe price action.
* **Trend Alignment:** Use the MTF Ribbon to ensure you are trading in the direction of the higher timeframe's momentum. If the H4 ribbon (displayed on your M15 chart) is expanding and sloping up, look primarily for buy setups.
* **Dynamic Support/Resistance Zones:** The space between the MTF lines acts as a strong support/resistance zone. When price pulls back to these "steps," it often presents a high-probability entry point.
* **Range Detection:** When the MTF ribbon lines become flat and intertwined, it indicates that the higher timeframe is in a consolidation phase.
* **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.