gavindiaz/mql5
1
0
Fork 0
mirror of https://github.com/softwaredevelop/mql5.git synced 2026-07-27 20:47:44 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs(indicators): refactor

Browse Source
This commit is contained in:
Toh4iem9
2026-02-05 12:15:11 +01:00
parent 1586810e8a
commit ba5f54c75b
1 changed files with 35 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Indicators/MyIndicators/RVOL_Pro.md
+35 -37
View File
@@ -1,54 +1,52 @@
# RVOL Pro (Relative Volume)
# RVOL Pro (Indicator)
## 1. Summary (Introduction)
Relative Volume (RVOL) is a crucial tool for professional traders to validate price action and gauge institutional interest. Instead of displaying absolute volume, which can be misleading, RVOL measures the current bar's volume as a multiple of its recent average. This instantly highlights periods of unusually high or low activity.
The `RVOL_Pro` (Relative Volume) is a critical volume analysis tool designed to contextualize trading activity. Raw volume bars can be misleading because volume naturally varies by time of day (e.g., London Open vs. Asian Lunch). RVOL solves this by displaying the **ratio** between the current volume and the average volume of the past $N$ periods.
The `RVOL_Pro` indicator provides a clean, multi-color histogram for immediate visual feedback, allowing traders to confirm breakouts, spot potential reversals (climactic volume), and identify low-participation moves that might be traps.
This normalization allows traders to instantly spot **Institutional Activity** (Smart Money) regardless of the asset or timeframe. It answers the question: *"Is this price move supported by real participation?"*
## 2. Mathematical Foundations and Calculation Logic
## 2. Methodology and Logic
The core of the RVOL indicator is a simple yet powerful ratio that contextualizes volume.
The formula is straightforward but powerful:
### Required Components
$$RVOL = \frac{\text{Current Volume}}{\text{Average Volume}(N)}$$
* **Current Volume:** The volume of the current bar (`Volume_i`).
* **Average Volume:** A simple moving average (SMA) of the volume over the `N` preceding bars.
### Calculation Steps (Algorithm)
1. **Calculate the Average Volume:** Compute the SMA of the volume for the `N` bars *prior* to the current bar.
$\text{Average Volume}_{i} = \frac{1}{N} \sum_{k=1}^{N} \text{Volume}_{i-k}$
2. **Calculate the RVOL Ratio:** Divide the current bar's volume by the calculated average.
$\text{RVOL}_i = \frac{\text{Volume}_i}{\text{Average Volume}_i}$
An RVOL value of `2.5` means the current bar's volume is 2.5 times higher than the recent average, indicating significant market activity.
* **Average Volume:** Calculated as a Simple Moving Average (SMA) of the volume over the lookback period (Default: 20).
* **Result:**
* `1.0`: Volume is exactly average.
* `2.0`: Volume is double the average (200%).
* `0.5`: Volume is half the average (50%).
## 3. MQL5 Implementation Details
* **Modular Calculation Engine (`RVOL_Calculator.mqh`):**
The entire calculation logic is encapsulated within the `CRVOLCalculator` class. This engine is lightweight, stateless within itself (relying on passed data), and can be reused in scripts or Expert Advisors.
* **Optimized Incremental Calculation (O(1) per Bar):**
The indicator utilizes `prev_calculated` to ensure that calculations are only performed on new or changed bars. The core logic involves a loop over the last `N` bars to compute the average, which is a constant-time operation for each new bar, guaranteeing high performance and zero lag.
* **Visual Signaling (`DRAW_COLOR_HISTOGRAM`):**
The wrapper `RVOL_Pro.mq5` uses a multi-color histogram for intuitive signaling. It employs two buffers: one for the RVOL value (`INDICATOR_DATA`) and one for the color index (`INDICATOR_COLOR_INDEX`). This allows the color of each bar in the histogram to change dynamically based on user-defined thresholds.
The indicator is built using the "Professional Suite" modular architecture.
* **Calculator Engine (`RelativeVolume_Calculator.mqh`):**
* **Logic:** A dedicated class handles the rolling average calculation.
* **Consistency:** This is the exact same engine used by `Market_Scanner_Pro`, ensuring that the "VOL_QUAL" metric in your CSV export perfectly matches what you see on the chart.
* **Visuals:**
* Uses `DRAW_COLOR_HISTOGRAM` for immediate visual decoding.
* **Tick Volume:** By default, it uses Tick Volume (standard in Forex). For Futures/Stocks, it can be adapted to Real Volume if available.
## 4. Parameters
* **Calculation Settings:**
* `InpPeriod`: The lookback period for calculating the average volume. (Default: `20`).
* `InpVolumeType`: The type of volume to use (`VOLUME_TICK` or `VOLUME_REAL`). `VOLUME_REAL` is recommended for exchange-traded instruments where available.
* **Visual Settings:**
* `InpLevelHigh`: The threshold above which volume is considered "High". (Default: `1.5`).
* `InpLevelExtreme`: The threshold above which volume is considered "Extreme". (Default: `2.5`).
* `InpColorNormal`, `InpColorHigh`, `InpColorExtreme`: Customizable colors for the three volume states, allowing for easy visual identification of market activity.
* `InpPeriod`: The lookback window for the average volume calculation (Default: `20`).
* `InpThreshold`: The level at which volume is considered "High/Institutional" (Default: `2.0`). This controls when the histogram turns Orange/Red.
## 5. Usage and Interpretation
* **Breakout Confirmation:** A price breakout from a range or pattern accompanied by RVOL > `1.5` has a higher probability of being valid and indicates strong participation in the move.
* **Exhaustion / Climactic Volume:** An extreme RVOL spike (> `2.5` or `3.0`) at the end of a prolonged trend can signal a reversal.
* **Blow-off Top:** Extreme RVOL on a large bullish candle after a long uptrend.
* **Capitulation Bottom:** Extreme RVOL on a large bearish candle after a long downtrend.
* **Lack of Interest:** A price move (especially a breakout attempt) on low RVOL (< `0.8`) suggests a lack of institutional conviction and increases the likelihood of a "fakeout" or trap.
* **Absorption (Advanced):** High RVOL on a small-bodied candle (Doji/spinning top) near a key support/resistance level can signal that large passive orders are "absorbing" the aggressive market orders, often preceding a reversal.
1. **Breakout Confirmation (The "Fuel"):**
* A breakout from a consolidation (Squeeze) is only valid if accompanied by **High RVOL (Orange Bar)**.
* If price breaks a support/resistance level on **Low RVOL (Gray Bar)**, it is likely a "Fakeout" or a trap.
2. **Trend Continuation:**
* In a healthy trend, impulse moves (legs) should have higher RVOL than pullbacks.
* If a pullback starts having higher volume than the trend leg, the trend is losing control.
3. **Climax and Reversal (Absorption):**
* Look for specific candle shapes combined with High RVOL.
* **Example:** A huge spike in volume (`RVOL > 3.0`) on a Doji or a "Pin Bar" often marks the exact top or bottom (Exhaustion Volume).
4. **No-Trade Zone:**
* If the histogram is consistently Gray/Low, the market lacks liquidity and interest. Stay aside.