/* * QUANTCONNECT.COM - Democratizing Finance, Empowering Individuals. * Lean Algorithmic Trading Engine v2.0. Copyright 2014 QuantConnect Corporation. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ using System; namespace QuantConnect.Indicators { /// /// This indicator computes the Kaufman Efficiency Ratio (KER). /// The Kaufman Efficiency Ratio is calculated as explained here: /// https://www.marketvolume.com/technicalanalysis/efficiencyratio.asp /// public class KaufmanEfficiencyRatio : WindowIndicator { private decimal _sumRoc1; private decimal _periodRoc; private decimal _trailingValue; /// /// Gets a flag indicating when this indicator is ready and fully initialized /// public override bool IsReady => Samples >= Period; /// /// Initializes a new instance of the class using the specified name and period. /// /// The name of this indicator /// The period of the Efficiency Ratio (ER) public KaufmanEfficiencyRatio(string name, int period) : base(name, period + 1) { } /// /// Initializes a new instance of the class using the specified period. /// /// The period of the Efficiency Ratio (ER) public KaufmanEfficiencyRatio(int period) : this($"KER({period})", period) { } /// /// Computes the next value of this indicator from the given state /// /// The input given to the indicator /// The window for the input history /// A new value for this indicator protected override decimal ComputeNextValue(IReadOnlyWindow window, IndicatorDataPoint input) { if (Samples < Period) { if (Samples > 1) { _sumRoc1 += Math.Abs(input.Value - window[1].Value); } return input.Value; } if (Samples == Period) { _sumRoc1 += Math.Abs(input.Value - window[1].Value); } var newTrailingValue = window[Period - 1]; _periodRoc = input.Value - newTrailingValue.Value; if (Samples > Period) { // Adjust sumROC1: // - Remove trailing ROC1 // - Add new ROC1 _sumRoc1 -= Math.Abs(_trailingValue - newTrailingValue.Value); _sumRoc1 += Math.Abs(input.Value - window[1].Value); } _trailingValue = newTrailingValue.Value; // Calculate the efficiency ratio return _sumRoc1 <= _periodRoc || _sumRoc1 == 0 ? 1m : Math.Abs(_periodRoc / _sumRoc1); } /// /// Resets this indicator to its initial state /// public override void Reset() { _sumRoc1 = 0; _periodRoc = 0; _trailingValue = 0; base.Reset(); } } }