diff --git a/Indicators/MyIndicators/Authors/Ehlers/3_Adaptive_MAs/MAMA_MTF_Pro.md b/Indicators/MyIndicators/Authors/Ehlers/3_Adaptive_MAs/MAMA_MTF_Pro.md new file mode 100644 index 0000000..2a83573 --- /dev/null +++ b/Indicators/MyIndicators/Authors/Ehlers/3_Adaptive_MAs/MAMA_MTF_Pro.md @@ -0,0 +1,47 @@ +# MAMA MTF Professional + +## 1. Summary (Introduction) + +The MAMA MTF Pro is a multi-timeframe (MTF) version of John Ehlers' highly advanced MESA Adaptive Moving Average system. This indicator calculates the MAMA and its companion FAMA line on a **higher, user-selected timeframe** and projects them onto the current, lower-timeframe chart. + +This provides a powerful, smoothed-out view of the dominant, higher-level trend, allowing traders to use the MTF MAMA/FAMA lines as a broad, dynamic zone of support and resistance. The crossover signals from the higher timeframe, known for being exceptionally resistant to whipsaws, can be used to define the primary market bias. + +The indicator is highly versatile: if the user selects `PERIOD_CURRENT` as the timeframe, it functions identically to the standard `MAMA_Pro` indicator. + +## 2. Mathematical Foundations and Calculation Logic + +The underlying calculation is identical to the standard MAMA. It is an adaptive moving average where the smoothing factor (`alpha`) is dynamically adjusted based on the **rate of change of the market's phase**, measured on the **higher timeframe**. + +### Calculation Steps (Algorithm) + +1. **Fetch Higher Timeframe Data:** The indicator first retrieves the OHLC price data for the user-selected higher timeframe. +2. **Calculate MAMA and FAMA on HTF:** The full, multi-stage MAMA/FAMA algorithm (including cycle measurement, phase calculation, and adaptive alpha) is executed using the higher timeframe's price data. +3. **Project to Current Chart:** The calculated higher-timeframe MAMA and FAMA values are then mapped to the current chart. This creates "step-like" lines where each value from the higher timeframe is held constant for the duration of its corresponding bars on the lower timeframe. + +## 3. MQL5 Implementation Details + +* **Self-Contained and Robust:** This indicator is fully self-contained and does not depend on any external indicator files (`iCustom`). It directly fetches the required higher-timeframe price data and uses the included `MAMA_Calculator.mqh` engine for all calculations. +* **Modular Calculation Engine (`MAMA_Calculator.mqh`):** The indicator reuses the exact same, proven calculation engine as the standard `MAMA_Pro`, ensuring mathematical consistency. +* **Dual-Mode Logic:** The `OnCalculate` function contains a smart branching logic. + * If a higher timeframe is selected, it performs the full MTF data fetching and projection process. + * If the current timeframe is selected, it bypasses the MTF logic and functions identically to the standard `MAMA_Pro`, calculating directly on the current chart's data for maximum efficiency. +* **Stability via Full Recalculation:** The indicator employs a full recalculation for both modes, which is the only robust method for the highly state-dependent MAMA algorithm. + +## 4. Parameters + +* **Upper Timeframe (`InpUpperTimeframe`):** The higher timeframe on which the MAMA/FAMA will be calculated. If set to `PERIOD_CURRENT`, the indicator will run on the current chart's timeframe. +* **Fast Limit (`InpFastLimit`):** The maximum possible value for the adaptive `alpha`. Ehlers' recommended value is **0.5**. +* **Slow Limit (`InpSlowLimit`):** The minimum possible value for the adaptive `alpha`. Ehlers' recommended value is **0.05**. +* **Applied Price (`InpSourcePrice`):** The source price for the calculation. This unified dropdown menu allows you to select from all standard and Heikin Ashi price types. + +## 5. Usage and Interpretation + +The MTF version of the MAMA/FAMA system is primarily a **high-level trend and regime filter**. + +* **Defining the Primary Trend:** The state of the higher-timeframe lines provides a clear, low-noise view of the dominant trend. + * If the **red MTF MAMA is above the blue MTF FAMA**, the primary trend is considered **bullish**. Traders should focus on buying opportunities on their trading timeframe. + * If the **red MTF MAMA is below the blue MTF FAMA**, the primary trend is considered **bearish**. Traders should focus on selling opportunities. +* **Dynamic Support & Resistance Zone:** The space between the MTF MAMA and MTF FAMA lines can be viewed as a broad, dynamic zone of support or resistance. + * In an uptrend, a pullback of the price on the lower timeframe into or near this MAMA/FAMA zone can present a high-probability entry point for a long position. + * In a downtrend, a rally into this zone can present a high-probability short entry. +* **Filtering Lower Timeframe Signals:** Use the state of the MAMA MTF to filter signals from faster, lower-timeframe indicators. For example, only take buy signals from a standard Stochastic or RSI when the MTF MAMA is above the MTF FAMA.