mql5/Indicators/MyIndicators/AMA_TrendActivity_Pro.md

# 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.