From 07866228553b35ffb77bbd27b16d2f0bf26ff3b3 Mon Sep 17 00:00:00 2001
From: Toh4iem9 <Toh4iem9@forge.mql5.io>
Date: Tue, 10 Feb 2026 01:01:02 +0100
Subject: [PATCH] new files added

---
 .../MyIndicators/Quant/TrendQuality_Pro.md    | 57 +++++++++++++++++++
 1 file changed, 57 insertions(+)
 create mode 100644 Indicators/MyIndicators/Quant/TrendQuality_Pro.md

diff --git a/Indicators/MyIndicators/Quant/TrendQuality_Pro.md b/Indicators/MyIndicators/Quant/TrendQuality_Pro.md
new file mode 100644
index 0000000..7034e78
--- /dev/null
+++ b/Indicators/MyIndicators/Quant/TrendQuality_Pro.md
@@ -0,0 +1,57 @@
+# 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).