diff --git a/Indicators/MyIndicators/Authors/Ehlers/2_Oscillators/Laguerre_RSI_Adaptive_Pro.md b/Indicators/MyIndicators/Authors/Ehlers/2_Oscillators/Laguerre_RSI_Adaptive_Pro.md new file mode 100644 index 0000000..331ad1a --- /dev/null +++ b/Indicators/MyIndicators/Authors/Ehlers/2_Oscillators/Laguerre_RSI_Adaptive_Pro.md @@ -0,0 +1,58 @@ +# Laguerre RSI Adaptive Professional + +## 1. Summary (Introduction) + +> **Part of the Laguerre Indicator Family** +> +> This indicator is a member of a family of tools based on John Ehlers' Laguerre filter. Each member utilizes the filter's extremely low-lag and smooth characteristics to analyze different aspects of market behavior. +> +> * [Laguerre Filter](./Laguerre_Filter_Pro.md): A fast, responsive moving average. +> * [Laguerre RSI](./Laguerre_RSI_Pro.md): A smooth, momentum oscillator with a fixed `gamma`. +> * [Laguerre Filter Adaptive](./Laguerre_Filter_Adaptive_Pro.md): A self-adjusting Laguerre Filter. +> * **Laguerre RSI Adaptive:** A self-adjusting Laguerre RSI that dynamically adapts its smoothing based on the measured market cycle. + +The Laguerre RSI Adaptive is the culmination of John Ehlers' cycle analysis and filtering techniques, applied to the concept of the Relative Strength Index. It is an intelligent oscillator that **automatically adjusts its own speed and smoothness** by measuring the dominant cycle period of the market in real-time. + +* In **strong, trending markets**, the indicator measures a long cycle period. It automatically becomes **slower and smoother**, staying pinned to the overbought/oversold zones to avoid generating premature, trend-fading exit signals. +* In **choppy, sideways markets**, it measures a short cycle period. It automatically becomes **faster and more responsive**, oscillating quickly between extremes to capture the turning points of the range. + +This self-adjusting mechanism creates a robust oscillator that aims to be "fast when you need it, slow when you don't," providing clearer signals across different market conditions. + +## 2. Mathematical Foundations and Calculation Logic + +The indicator uses a multi-stage digital signal processing (DSP) pipeline. The core of this is the **Homodyne Discriminator**, a method for measuring the instantaneous cycle period, which then controls the `gamma` of the Laguerre RSI calculation. + +### Calculation Steps (Algorithm) + +1. **Band-Pass Filtering:** The source price is first passed through a band-pass filter to isolate the most common market cycle components. +2. **Hilbert Transform:** The filtered price data is processed by a Hilbert Transform to generate its "InPhase" (I) and "Quadrature" (Q) components. +3. **Homodyne Discriminator:** The algorithm calculates the rate of change of the signal's phase from the I/Q components. +4. **Cycle Period Calculation:** The rate of phase change is converted into the dominant cycle period (in bars), which is then smoothed and stabilized. +5. **Adaptive Gamma Calculation:** The measured cycle period is used to calculate the optimal `gamma` for that specific bar: + $\gamma = \frac{4}{\text{Cycle Period}}$ +6. **Laguerre Filter Application:** The standard four-component Laguerre filter (`L0, L1, L2, L3`) is applied to the source price, using the **dynamically calculated `gamma`** for that bar. +7. **Final RSI Calculation:** The final indicator value is calculated from the components of the adaptive filter using the standard Laguerre RSI formula: + * The "up" (`cu`) and "down" (`cd`) sums are calculated from the differences between the `L0, L1, L2, L3` components. + * $\text{Adaptive Laguerre RSI}_i = 100 \times \frac{cu}{cu + cd}$ + +## 3. MQL5 Implementation Details + +* **Self-Contained Calculator:** Due to the complexity of the cycle measurement algorithm, this indicator uses a dedicated, self-contained calculator (`Laguerre_RSI_Adaptive_Calculator.mqh`). +* **Heikin Ashi Integration:** An inherited `_HA` class allows the entire adaptive calculation to be performed seamlessly on smoothed Heikin Ashi data. +* **Stability via Full Recalculation:** The calculation is a highly complex, multi-stage recursive process. To ensure absolute stability, the indicator employs a **full recalculation** on every `OnCalculate` call. +* **Value Clamping:** The final calculated value is mathematically clamped to the 0-100 range. + +## 4. Parameters + +* **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. +* **Note:** This indicator has **no `gamma` or period parameters**, as its primary function is to calculate these values automatically from the price action. + +## 5. Usage and Interpretation + +The Adaptive Laguerre RSI should be interpreted as an "intelligent" RSI that changes its character based on the market's behavior. + +* **Context-Aware Signals:** The key advantage is that the indicator's signals are more reliable across different market regimes. + * **In a Ranging Market:** The indicator will be fast and responsive, providing clear overbought/oversold signals near the top and bottom of the range. A cross down from the 80 level or up from the 20 level can be used as a reversal signal. + * **In a Trending Market:** The indicator will become slow and smooth, "hugging" the 80-100 zone in a strong uptrend or the 0-20 zone in a strong downtrend. In this state, it acts as a **trend confirmation tool**. A brief dip out of the extreme zone followed by a return can signal a trend continuation entry point. +* **Reduced False Signals:** By slowing down in trends, the indicator avoids generating premature "sell" signals in an uptrend or "buy" signals in a downtrend, which is a common problem with standard, fixed-period oscillators. +* **Divergence:** Divergence signals (as described in the standard Laguerre RSI documentation) are still valid and can be particularly powerful, as they indicate a mismatch between price action and the adaptively measured momentum.