using System.Runtime.CompilerServices; namespace QuanTAlib; /// /// ADX: Average Directional Movement Index /// A technical analysis indicator used to measure the strength of a trend, /// regardless of its direction. ADX combines the Positive and Negative /// Directional Movement Indicators to determine trend strength. /// /// /// The ADX calculation process: /// 1. Calculate True Range (TR) /// 2. Calculate +DM (Positive Directional Movement) /// 3. Calculate -DM (Negative Directional Movement) /// 4. Smooth TR, +DM, and -DM using Wilder's smoothing /// 5. Calculate +DI and -DI /// 6. Calculate DX (Directional Index) /// 7. Smooth DX to get ADX /// /// Key characteristics: /// - Oscillates between 0 and 100 /// - Values above 25 indicate strong trend /// - Values below 20 indicate weak or no trend /// - Can be used with +DI and -DI for trade signals /// - Does not indicate trend direction, only strength /// /// Formula: /// TR = max(high-low, abs(high-prevClose), abs(low-prevClose)) /// +DM = if(high-prevHigh > prevLow-low) then max(high-prevHigh, 0) else 0 /// -DM = if(prevLow-low > high-prevHigh) then max(prevLow-low, 0) else 0 /// +DI = 100 * smoothed(+DM) / smoothed(TR) /// -DI = 100 * smoothed(-DM) / smoothed(TR) /// DX = 100 * abs(+DI - -DI) / (+DI + -DI) /// ADX = smoothed(DX) /// /// Sources: /// J. Welles Wilder Jr. - "New Concepts in Technical Trading Systems" (1978) /// https://www.investopedia.com/terms/a/adx.asp /// /// Note: Default period of 14 was recommended by Wilder /// [SkipLocalsInit] public sealed class Adx : AbstractBarBase { private readonly Rma _smoothedTr; private readonly Rma _smoothedPlusDm; private readonly Rma _smoothedMinusDm; private readonly Rma _smoothedDx; private double _prevHigh, _prevLow, _prevClose; private double _p_prevHigh, _p_prevLow, _p_prevClose; private const double ScalingFactor = 100.0; private const int DefaultPeriod = 14; /// The number of periods used in the ADX calculation (default 14). /// Thrown when period is less than 1. [MethodImpl(MethodImplOptions.AggressiveInlining)] public Adx(int period = DefaultPeriod) { if (period < 1) throw new ArgumentOutOfRangeException(nameof(period)); _smoothedTr = new(period, useSma: true); _smoothedPlusDm = new(period, useSma: true); _smoothedMinusDm = new(period, useSma: true); _smoothedDx = new(period, useSma: true); _index = 0; WarmupPeriod = period * 2; // Need extra period for DX smoothing Name = $"ADX({period})"; } /// The data source object that publishes updates. /// The number of periods used in the ADX calculation. [MethodImpl(MethodImplOptions.AggressiveInlining)] public Adx(object source, int period) : this(period) { var pubEvent = source.GetType().GetEvent("Pub"); pubEvent?.AddEventHandler(source, new BarSignal(Sub)); } [MethodImpl(MethodImplOptions.AggressiveInlining)] protected override void ManageState(bool isNew) { if (isNew) { _index++; _p_prevHigh = _prevHigh; _p_prevLow = _prevLow; _p_prevClose = _prevClose; } else { _prevHigh = _p_prevHigh; _prevLow = _p_prevLow; _prevClose = _p_prevClose; } } [MethodImpl(MethodImplOptions.AggressiveInlining | MethodImplOptions.AggressiveOptimization)] private static double CalculateTrueRange(double high, double low, double prevClose) { double hl = high - low; double hpc = Math.Abs(high - prevClose); double lpc = Math.Abs(low - prevClose); return Math.Max(hl, Math.Max(hpc, lpc)); } [MethodImpl(MethodImplOptions.AggressiveInlining | MethodImplOptions.AggressiveOptimization)] private static (double plusDm, double minusDm) CalculateDirectionalMovement( double high, double low, double prevHigh, double prevLow) { double upMove = high - prevHigh; double downMove = prevLow - low; double plusDm = 0.0; double minusDm = 0.0; if (upMove > downMove && upMove > 0) plusDm = upMove; else if (downMove > upMove && downMove > 0) minusDm = downMove; return (plusDm, minusDm); } [MethodImpl(MethodImplOptions.AggressiveInlining | MethodImplOptions.AggressiveOptimization)] private static double CalculateDx(double plusDi, double minusDi) { double sum = plusDi + minusDi; if (sum > 0) return ScalingFactor * Math.Abs(plusDi - minusDi) / sum; return 0.0; } [MethodImpl(MethodImplOptions.AggressiveInlining | MethodImplOptions.AggressiveOptimization)] protected override double Calculation() { ManageState(Input.IsNew); if (_index == 1) { _prevHigh = Input.High; _prevLow = Input.Low; _prevClose = Input.Close; return 0.0; } // Calculate True Range and Directional Movement double tr = CalculateTrueRange(Input.High, Input.Low, _prevClose); var (plusDm, minusDm) = CalculateDirectionalMovement( Input.High, Input.Low, _prevHigh, _prevLow); // Update previous values _prevHigh = Input.High; _prevLow = Input.Low; _prevClose = Input.Close; // Smooth the indicators using Wilder's method _smoothedTr.Calc(tr, Input.IsNew); _smoothedPlusDm.Calc(plusDm, Input.IsNew); _smoothedMinusDm.Calc(minusDm, Input.IsNew); // Calculate +DI and -DI double smoothedTr = _smoothedTr.Value; if (smoothedTr > 0) { double plusDi = ScalingFactor * _smoothedPlusDm.Value / smoothedTr; double minusDi = ScalingFactor * _smoothedMinusDm.Value / smoothedTr; // Calculate DX double dx = CalculateDx(plusDi, minusDi); // Smooth DX to get ADX _smoothedDx.Calc(dx, Input.IsNew); return _smoothedDx.Value; } return 0.0; } }