mirror of
https://github.com/softwaredevelop/mql5.git
synced 2026-07-28 04:57:44 +00:00
Toh4iem9
70 lines
5.3 KiB
Markdown
70 lines
5.3 KiB
Markdown
# AMA Trend Activity Professional
|
|
|
|
## 1. Summary (Introduction)
|
|
|
|
The AMA Trend Activity is a custom-built "meta-indicator" designed to measure the directional strength and activity of the **Adaptive Moving Average (AMA)**. While the AMA line itself shows the trend, this oscillator quantifies *how trendy* the market is according to the AMA's behavior, specifically its rate of change relative to volatility.
|
|
|
|
Developed as part of our indicator toolkit, its primary purpose is to act as a **trend filter**. It generates high values when the AMA is moving decisively in one direction (indicating an efficient, trending market) and low values when the AMA line flattens out (indicating a sideways, noisy market).
|
|
|
|
Our `AMA_TrendActivity_Pro` implementation is a unified, professional version that allows all underlying calculations (both AMA and ATR) to be based on either **standard** or **Heikin Ashi** data.
|
|
|
|
## 2. Mathematical Foundations and Calculation Logic
|
|
|
|
This indicator analyzes the behavior of two underlying indicators, AMA and ATR, to produce a final, normalized oscillator.
|
|
|
|
### Required Components
|
|
|
|
* **AMA:** The underlying adaptive moving average. Its slope is the primary input.
|
|
* **ATR (Average True Range):** Used as a normalization factor to make the indicator's output comparable across different instruments and timeframes.
|
|
* **Smoothing Period:** A final smoothing period for the oscillator output.
|
|
|
|
### Calculation Steps (Algorithm)
|
|
|
|
1. **Calculate AMA:** First, the standard Kaufman's AMA is calculated based on its parameters.
|
|
|
|
2. **Calculate ATR:** Separately, the standard Wilder's ATR is calculated.
|
|
|
|
3. **Calculate Raw Activity:** For each bar, the indicator measures the rate of change (slope) of the AMA line and normalizes it by the market's current volatility (ATR). This produces a raw, unbounded value representing the trend's relative strength.
|
|
$\text{Raw Activity}_i = \frac{\text{Abs}(\text{AMA}_i - \text{AMA}_{i-1})}{\text{ATR}_i}$
|
|
|
|
4. **Normalize with Arctan:** To solve the problem of scale across different timeframes, the `Raw Activity` value is passed through the inverse tangent (`Arctan`) function and then scaled to a consistent `0..1` range. The `Arctan` function elegantly maps any positive input into a predictable range, making the indicator robust on any timeframe.
|
|
$\text{Scaled Activity}_i = \frac{\text{Arctan}(\text{Raw Activity}_i)}{\pi/2}$
|
|
|
|
5. **Final Smoothing:** The `Scaled Activity` values are smoothed with a Simple Moving Average (SMA) to create the final, plotted histogram.
|
|
$\text{Final Activity}_i = \text{SMA}(\text{Scaled Activity}, \text{Smoothing Period})_i$
|
|
|
|
## 3. MQL5 Implementation Details
|
|
|
|
Our MQL5 implementation follows a modern, object-oriented design pattern to ensure stability, reusability, and maintainability.
|
|
|
|
* **Modular Calculator Engine (`AMA_TrendActivity_Calculator.mqh`):**
|
|
All core calculation logic is encapsulated within a reusable include file.
|
|
|
|
* **Composition Pattern:**
|
|
Instead of complex inheritance trees, the `CActivityCalculator` class uses **composition**. It internally owns and manages instances of the standard `CAMACalculator` and `CATRCalculator`. This ensures that the Activity indicator uses exactly the same mathematical logic as the standalone AMA and ATR indicators, guaranteeing consistency.
|
|
|
|
* **Optimized Incremental Calculation (O(1)):**
|
|
Unlike basic implementations that recalculate the entire history on every tick, this indicator employs a sophisticated incremental algorithm.
|
|
* **Persistent State:** The calculator maintains internal buffers (`m_buffer_ama`, `m_buffer_atr`, `m_scaled_activity`) that persist their state between ticks.
|
|
* **Smart Updates:** The calculation logic (AMA -> ATR -> Activity -> Smoothing) is broken down into steps, each capable of resuming from the last calculated bar (`prev_calculated`).
|
|
* This results in **O(1) complexity** per tick, ensuring instant updates and zero lag, even on charts with extensive history.
|
|
|
|
## 4. Parameters (`AMA_TrendActivity_Pro.mq5`)
|
|
|
|
* **AMA Settings:**
|
|
* `InpAmaPeriod`: The period for the AMA's Efficiency Ratio.
|
|
* `InpFastEmaPeriod`: The "fast" period for the AMA's scaling.
|
|
* `InpSlowEmaPeriod`: The "slow" period for the AMA's scaling.
|
|
* `InpSourcePrice`: The source price for the underlying AMA. This unified dropdown menu allows you to select from all standard and Heikin Ashi price types.
|
|
* **Activity Calculation Settings:**
|
|
* `InpAtrPeriod`: The period for the ATR used in normalization.
|
|
* `InpSmoothingPeriod`: The period for the final SMA smoothing of the oscillator.
|
|
|
|
## 5. Usage and Interpretation
|
|
|
|
* **Trend Filter:** This is the indicator's primary function. A trader can establish a threshold (e.g., 0.1 or 0.2).
|
|
* **Activity > Threshold:** The market is considered to be in a **trending phase**. Trend-following strategies are more likely to be effective.
|
|
* **Activity < Threshold:** The market is considered to be in a **ranging or consolidating phase**. Mean-reversion strategies may be more appropriate.
|
|
* **Identifying Trend Exhaustion:** A sharp decline in the activity histogram after a strong trend can signal that momentum is waning and the trend may be nearing exhaustion or entering a consolidation phase.
|
|
* **Confirming Breakouts:** A spike in the activity histogram accompanying a price breakout from a range can provide strong confirmation that the breakout has momentum behind it.
|