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

refactor: add display mode

Browse Source
This commit is contained in:
Toh4iem9
2025-10-04 16:01:36 +02:00
parent dbb65f7394
commit aeedabeecd
1 changed files with 29 additions and 40 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Indicators/MyIndicators/CutlerRSI_Pro.md
+29 -40
View File
@@ -2,74 +2,63 @@
## 1. Summary (Introduction)
Cutler's RSI is a variation of the classic Relative Strength Index (RSI). While the standard RSI (developed by J. Welles Wilder) uses Wilder's own smoothing method (an RMA/SMMA), Cutler's version simplifies the formula by using a **Simple Moving Average (SMA)** to average the positive and negative price changes. This results in an oscillator with a unique character.
Cutler's RSI is a variation of the classic Relative Strength Index (RSI). While the standard RSI uses Wilder's smoothing (an RMA/SMMA), Cutler's version uses a **Simple Moving Average (SMA)** to average the positive and negative price changes.
Our professional toolkit provides a unified implementation of this indicator family:
* **`CutlerRSI_Pro.mq5`**: Plots the main Cutler's RSI line and a configurable moving average signal line.
* **`CutlerRSI_Oscillator_Pro.mq5`**: Displays the difference between the RSI and its signal line as a histogram for a clearer view of momentum.
- **`CutlerRSI_Pro.mq5`**: Plots the main Cutler's RSI line and an **optional, configurable moving average signal line**.
- **`CutlerRSI_Oscillator_Pro.mq5`**: Displays the difference between the RSI and its signal line as a histogram.
Both indicators can be calculated using either **standard** or **Heikin Ashi** price data, selectable from a single input parameter.
Both indicators can be calculated using either **standard** or **Heikin Ashi** price data.
## 2. Mathematical Foundations and Calculation Logic
The core difference between Cutler's RSI and the standard RSI lies in the smoothing method applied to the price changes.
### Required Components
* **RSI Period (N):** The lookback period for the calculation.
* **Source Price (P):** The price series used for the calculation (e.g., Close).
The core difference lies in the smoothing method applied to the price changes.
### Calculation Steps (Algorithm)
1. **Calculate Price Changes:** For each period, determine the change in price from the previous period.
$\text{Change}_i = P_i - P_{i-1}$
2. **Separate Positive and Negative Changes:**
* If $\text{Change}_i > 0$, then $\text{Positive Change}_i = \text{Change}_i$ and $\text{Negative Change}_i = 0$.
* If $\text{Change}_i < 0$, then $\text{Positive Change}_i = 0$ and $\text{Negative Change}_i = \text{Abs}(\text{Change}_i)$.
3. **Calculate the Simple Moving Average of Changes:** Apply an SMA with period `N` to both the positive and negative change series.
1. **Calculate Price Changes:** $\text{Change}_i = P_i - P_{i-1}$
2. **Separate Positive and Negative Changes.**
3. **Calculate the Simple Moving Average of Changes:**
$\text{Avg Positive}_i = \text{SMA}(\text{Positive Change}, N)_i$
$\text{Avg Negative}_i = \text{SMA}(\text{Negative Change}, N)_i$
4. **Calculate the Relative Strength (RS) and Final RSI:**
$\text{RS}_i = \frac{\text{Avg Positive}_i}{\text{Avg Negative}_i}$
$\text{Cutler's RSI}_i = 100 - \frac{100}{1 + \text{RS}_i}$
5. **Calculate the Signal Line & Oscillator:** The signal line is a moving average of the Cutler's RSI line, and the oscillator is the difference between the two.
## 3. MQL5 Implementation Details
Our MQL5 implementation follows a highly modular, object-oriented design to ensure accuracy, reusability, and maintainability across the entire indicator family.
Our MQL5 implementation follows a highly modular, object-oriented design.
* **Centralized Calculation Engine (`CutlerRSI_Engine.mqh`):**
The core of our implementation is a single, powerful calculation engine. This include file contains the complete, mathematically precise logic for calculating both the Cutler's RSI and its signal line. It supports both standard and Heikin Ashi data sources through class inheritance (`CCutlerRSI_Engine` and `CCutlerRSI_Engine_HA`). This approach eliminates code duplication entirely.
- **Centralized Calculation Engine (`CutlerRSI_Engine.mqh`):**
The core of our implementation is a single, powerful calculation engine that contains the complete logic for calculating both the Cutler's RSI and its signal line.
* **Specialized Wrappers (`CutlerRSI_Calculator.mqh`, `CutlerRSI_Oscillator_Calculator.mqh`):**
The final indicators use thin "wrapper" classes that utilize the central engine.
* `CutlerRSI_Calculator` calls the engine and directly outputs the RSI and signal lines.
* `CutlerRSI_Oscillator_Calculator` calls the same engine, receives the RSI and signal lines, and then performs one additional step: calculating the difference to produce the histogram.
- **Specialized Wrappers (`CutlerRSI_Calculator.mqh`, `CutlerRSI_Oscillator_Calculator.mqh`):**
The final indicators use thin "wrapper" classes that utilize the central engine to produce the desired output (line or histogram).
* **Efficient RSI Calculation:** The engine calculates the Cutler's RSI in a single `for` loop using an efficient **sliding window sum** technique. This is mathematically equivalent to an SMA but significantly faster than recalculating the sum on every bar.
- **Selectable Display Mode:** The `CutlerRSI_Pro` indicator includes a `Display Mode` input that allows the user to show either the RSI line by itself or the RSI line together with its moving average signal line.
* **Stability via Full Recalculation:** All versions employ a "brute-force" full recalculation within `OnCalculate` to ensure maximum stability.
- **Efficient RSI Calculation:** The engine calculates the Cutler's RSI using an efficient **sliding window sum** technique.
- **Stability via Full Recalculation:** All versions employ a "brute-force" full recalculation for maximum stability.
## 4. Parameters
* **RSI Period (`InpPeriodRSI`):** The lookback period for the SMA of price changes. Default is `14`.
* **Applied Price (`InpSourcePrice`):** The source price for the calculation. This unified dropdown menu allows you to select from all standard and Heikin Ashi price types. Default is `PRICE_CLOSE_STD`.
* **Signal Line Settings:**
* `InpPeriodMA`: The lookback period for the signal line.
* `InpMethodMA`: The type of moving average for the signal line.
- **RSI Period (`InpPeriodRSI`):** The lookback period for the SMA of price changes. Default is `14`.
- **Applied Price (`InpSourcePrice`):** The source price for the calculation. This unified dropdown menu allows you to select from all standard and Heikin Ashi price types.
- **Signal Line Settings:**
- `InpDisplayMode`: Toggles the visibility of the signal line.
- `InpPeriodMA`: The lookback period for the signal line.
- `InpMethodMA`: The type of moving average for the signal line.
## 5. Usage and Interpretation
The interpretation of Cutler's RSI is identical to the standard RSI.
* **Overbought/Oversold Levels:** The primary use is to identify overbought (typically above 70) and oversold (typically below 30) conditions.
* **Crossovers:**
* **Signal Line Crossover:** When the Cutler's RSI line crosses above its moving average, it can be seen as a bullish signal. A cross below is a bearish signal.
* **Centerline Crossover:** A crossover of the RSI line above the 50 level indicates that momentum is shifting to bullish. A crossover below 50 indicates bearish momentum.
* **Divergence:** Look for divergences between the RSI and the price action.
* **Oscillator (Histogram):** The histogram provides a clear visual of the relationship between the Cutler's RSI and its signal line, highlighting the acceleration and deceleration of momentum.
- **Overbought/Oversold Levels:** Identify overbought (typically above 70) and oversold (typically below 30) conditions.
- **Crossovers:**
- **Signal Line Crossover:** When the Cutler's RSI line crosses above its moving average, it can be seen as a bullish signal.
- **Centerline Crossover:** A crossover of the RSI line above the 50 level indicates bullish momentum.
- **Divergence:** Look for divergences between the RSI and the price action.
- **Oscillator (Histogram):** The histogram provides a clear visual of the relationship between the Cutler's RSI and its signal line.