mql5/Indicators/MyIndicators/TrendQuality_Pro.md

Trend Quality Pro (Indicator)

1. Summary (Introduction)

The TrendQuality_Pro is a sophisticated market filter designed to distinguish between "Clean Trends" and "Market Noise". It is based on Perry Kaufman's Efficiency Ratio (ER) concept.

While most indicators (like MA or MACD) only tell you the direction of the trend, this indicator tells you the quality or efficiency of that movement. It answers the critical question: "Is the market moving with conviction, or is it just chopping around?"

2. Methodology and Logic

The indicator calculates how efficient price movement is over a specific period.

The Formula

ER = \frac{\text{Net Change}}{\text{Sum of Changes}}

• Net Change: The absolute difference between the current price and the price N bars ago. (The "distance traveled").
• Sum of Changes: The sum of absolute bar-to-bar price changes over the same period. (The "effort" or "path length").

Interpretation

The value always oscillates between 0.0 and 1.0.

• ER = 1.0 (Maximum Efficiency): Price moved in a straight vertical line. Every tick was in the trend direction.
• ER ≈ 0.0 (Maximum Noise): Price moved up and down violently but ended up exactly where it started. Maximum volatility with zero progress.

3. MQL5 Implementation Details

The indicator utilizes the "Professional Suite" modular architecture for maximum performance.

• Calculator Engine (EfficiencyRatio_Calculator.mqh):
  • Logic: Encapsulates the Kaufman formula in a reusable class.
  • Optimization: Uses standard arrays and incremental loops. While a theoretical O(1) sliding window sum is possible, the generic loop implementation is extremely fast for standard periods (<100) and ensures numerical stability.
• Visuals:
  • Uses DRAW_COLOR_HISTOGRAM for clear visual feedback.
  • Dynamic Coloring: The histogram bars change color based on the ER value, allowing traders to instantly recognize market regimes (Noise vs. Trend) without reading the specific numbers.

4. Parameters

• Timeframe & Price:

  • InpPeriod: The lookback window for the calculation (Default: 10). Lower values make it more sensitive; higher values smooth out short-term fluctuations.
  • InpPrice: The price source (Close, Median, etc.).

• Thresholds (Color Logic):

  • InpThreshold: The level above which a market is considered "Trending" (Default: 0.30).
  • InpStrongLevel: The level above which a trend is considered "Strong/Parabolic" (Default: 0.60).

5. Usage and Workflow

1. The "No-Trade" Filter (Gray Bars): If the histogram is Gray (Value < 0.30), the market is in a "Choppy" or "Noise" regime. Trend-following strategies (like Moving Average crossovers) will likely fail here. Stay sideline or use Mean Reversion.
2. Trend Confirmation (Blue Bars): If the histogram turns Blue (Value > 0.30), a clean trend is establishing. This is the green light for trend-following entries (e.g., Pullbacks to EMA).
3. Super-Trend Warning (Gold Bars): If the histogram turns Gold (Value > 0.60), the trend is extremely efficient/strong.
   • Pros: Profits accumulate fast.
   • Cons: Such efficiency is unsustainable long-term. Be prepared for a snap-back or consolidation (check Z-Score for confirmation of exhaustion).