From c002310fc474c9b83c77060372ad681af33ed5eb Mon Sep 17 00:00:00 2001 From: Toh4iem9 Date: Wed, 24 Sep 2025 12:40:00 +0200 Subject: [PATCH] new files added --- Indicators/MyIndicators/RSI_Pro.md | 86 ++++++++++++++++++++++++++++++ 1 file changed, 86 insertions(+) create mode 100644 Indicators/MyIndicators/RSI_Pro.md diff --git a/Indicators/MyIndicators/RSI_Pro.md b/Indicators/MyIndicators/RSI_Pro.md new file mode 100644 index 0000000..411a663 --- /dev/null +++ b/Indicators/MyIndicators/RSI_Pro.md @@ -0,0 +1,86 @@ +# RSI Pro Indicator Family (Pro, %B, Width, Oscillator) + +## 1. Summary (Introduction) + +This document covers our comprehensive, professionally coded MQL5 implementation of an advanced Relative Strength Index (RSI) indicator family. Moving beyond the classic RSI, this suite transforms the well-known momentum oscillator into a complete, multi-faceted analysis system for measuring the **dynamics of momentum itself**. + +The core of the family is the **`RSI_Pro`** indicator, which integrates a fully customizable signal line and optional Bollinger Bands directly onto the RSI values. From this powerful base, we derive three specialized oscillators: + +* **`RSI_PercentB`**: Normalizes the RSI's position relative to its own volatility bands. +* **`RSI_Band_Width_Pro`**: Measures the volatility of momentum, identifying "momentum squeezes". +* **`RSI_Oscillator`**: Displays the difference between the RSI and its signal line as a histogram. + +All indicators in this family are built on a shared, modular calculation engine and offer a seamless choice between standard price data and smoothed **Heikin Ashi** data, providing a powerful toolkit for advanced momentum analysis. + +## 2. Mathematical Foundations and Calculation Logic + +All indicators in this family are derived from the same core components: the RSI, its moving average, and the standard deviation of the RSI. + +### Required Components + +* **RSI Period:** The lookback period for the base RSI calculation. +* **Source Price:** The price series for the RSI calculation (standard prices or Heikin Ashi Close). +* **MA Period & Method:** The period and type of moving average for the signal line / Bollinger Bands centerline. +* **Bands Deviation:** The standard deviation multiplier for the Bollinger Bands on the RSI. + +### Calculation Steps (Algorithm) + +1. **Prepare Source Price:** The engine first prepares the price series. If a standard price is selected, it is used directly. If a Heikin Ashi price is selected, the indicator first calculates the HA values and uses the corresponding HA price series as the source. + +2. **Calculate the Base RSI:** A standard RSI is calculated on the prepared price series using Wilder's smoothing method. + +3. **Calculate the Signal Line / Centerline:** The base RSI line is then smoothed using the selected `MA Method` and `MA Period`. This creates the signal line for the `RSI_Pro` and `RSI_Oscillator`, and the centerline for the Bollinger Bands. + +4. **Calculate Bollinger Bands on RSI:** Standard Bollinger Bands are calculated based on the **RSI values**, using the MA line from the previous step as the centerline. + +5. **Calculate Derivative Indicators:** + * **`RSI_Oscillator`**: The difference between the RSI and its signal line. + $\text{Oscillator}_t = \text{RSI}_t - \text{Signal Line}_t$ + * **`RSI_PercentB`**: Normalizes the RSI's position relative to its bands. + $\%B_t = \frac{\text{RSI}_t - \text{Lower Band}_t}{\text{Upper Band}_t - \text{Lower Band}_t}$ + * **`RSI_Band_Width`**: Measures the normalized width of the RSI's bands. + $\text{BandWidth}_t = \frac{\text{Upper Band}_t - \text{Lower Band}_t}{\text{Signal Line}_t}$ + +## 3. MQL5 Implementation Details + +Our MQL5 suite is built on a single, shared, modular, and robust calculation engine to ensure consistency and maintainability across the entire indicator family. + +* **Unified, Reusable Calculation Engine (`RSI_Pro_Calculator.mqh`):** The entire calculation logic for all components (RSI, MA, Bands) and for both standard and Heikin Ashi versions is encapsulated within this powerful include file. + * An elegant, object-oriented inheritance model (`CRSIProCalculator` and `CRSIProCalculator_HA`) allows all indicators in the family to dynamically choose the correct calculation engine at runtime based on user input. + * This **DRY (Don't Repeat Yourself)** approach ensures that any future improvements to the core logic are automatically inherited by all indicators in the family. + +* **Stability via Full Recalculation:** All indicators employ a "brute-force" **full recalculation** on every tick. This is our core principle to ensure perfect accuracy and prevent any risk of calculation errors or visual glitches. + +* **Flexible "Pro" Indicators:** Functionality is consolidated into powerful "Pro" versions. + * **`RSI_Pro.mq5`**: The main indicator, featuring a custom `enum` to seamlessly switch between standard and a full range of Heikin Ashi price types. It also has a `Display Mode` to show the RSI alone, with its signal line, or with the full Bollinger Bands. + * **`RSI_Band_Width_Pro.mq5`**: This advanced oscillator includes selectable analysis modes: **Bands on BandWidth** (for dynamic momentum Squeeze detection) and **Extremes Channel** (for historical momentum Squeeze/Bulge levels). + +## 4. Parameters + +* **RSI Period (`InpPeriodRSI`):** The lookback period for the base RSI. +* **Source Price (`InpSourcePrice`):** A comprehensive list of price sources, including all standard prices and a full range of Heikin Ashi prices. +* **MA Period & Method:** The period and type of moving average for the signal line and/or Bollinger Bands centerline. +* **Bands Deviation:** The standard deviation multiplier for the Bollinger Bands on the RSI. +* **Display Mode:** (For `RSI_Pro` and `RSI_Band_Width_Pro`) Controls which components are visible on the chart. + +## 5. Usage and Interpretation + +This indicator family allows for a multi-layered analysis of market momentum. + +* **`RSI_Pro` (The Main Dashboard):** + * Use this as the primary tool to get a complete picture. The Bollinger Bands on the RSI define the **expected range of momentum**. The signal line shows the **trend of momentum**. + * A crossover of the RSI and its signal line is a basic momentum shift signal. + * The RSI touching its own outer bands signals a **statistical extreme in momentum**, which is often a more reliable signal than the fixed 70/30 levels. + +* **`RSI_Oscillator` (The MACD of RSI):** + * This provides a clear, histogram-based view of the difference between momentum (RSI) and its trend (Signal Line). + * A zero-line crossover confirms that momentum has crossed its own average, signaling a potential acceleration in price. It is excellent for spotting divergences. + +* **`RSI_PercentB` (The Normalized View):** + * This oscillator normalizes the RSI's position into a 0-1 scale. It provides an objective measure of overbought/oversold conditions based on the momentum's own volatility. + * Values above 1.0 or below 0.0 are clear signals of extreme momentum that may precede a reversal or consolidation. + +* **`RSI_Band_Width_Pro` (The Momentum Volatility Meter):** + * This is the most advanced tool in the family. It measures the **volatility of momentum**. + * A **"Momentum Squeeze"** (low Band Width values, identified by the "Extremes Channel" or "Bands on BandWidth" modes) signals that momentum is consolidating. This often precedes a powerful breakout in price, as pent-up momentum is released. + * A **"Momentum Bulge"** (high Band Width values) signals that momentum is at a historical extreme and may be unsustainable, often preceding a trend exhaustion.