/* * 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 QuantConnect.Data.Market; namespace QuantConnect.Indicators { /// /// This indicator computes the n-period Ease of Movement Value using the following: /// MID = (high_1 + low_1)/2 - (high_0 + low_0)/2 /// RATIO = (currentVolume/10000) / (high_1 - low_1) /// EMV = MID/RATIO /// _SMA = n-period of EMV /// Returns _SMA /// Source: https://www.investopedia.com/terms/e/easeofmovement.asp /// public class EaseOfMovementValue : TradeBarIndicator, IIndicatorWarmUpPeriodProvider { private readonly SimpleMovingAverage _sma; private readonly int _scale = 10000; private decimal _previousHighMaximum; private decimal _previousLowMinimum; /// /// Gets a flag indicating when this indicator is ready and fully initialized /// public override bool IsReady => _sma.IsReady; /// /// Required period, in data points, for the indicator to be ready and fully initialized. /// public int WarmUpPeriod => _sma.WarmUpPeriod; /// /// Initializeds a new instance of the EaseOfMovement class using the specufued period /// /// The period over which to perform to computation /// The size of the number outputed by EMV public EaseOfMovementValue(int period = 1, int scale = 10000) : this($"EMV({period}, {scale})", period, scale) { } /// /// Creates a new EaseOfMovement indicator with the specified period /// /// The name of this indicator /// The period over which to perform to computation /// The size of the number outputed by EMV public EaseOfMovementValue(string name, int period, int scale) : base(name) { _sma = new SimpleMovingAverage(period); _scale = scale; } /// /// Computes the next value for this indicator from the given state. /// /// The input value to this indicator on this time step /// A a value for this indicator protected override decimal ComputeNextValue(TradeBar input) { if (_previousHighMaximum == 0 && _previousLowMinimum == 0) { _previousHighMaximum = input.High; _previousLowMinimum = input.Low; } if (input.Volume == 0 || input.High == input.Low) { _sma.Update(input.EndTime, 0); return _sma.Current.Value; } var midValue = ((input.High + input.Low) / 2) - ((_previousHighMaximum + _previousLowMinimum) / 2); var midRatio = ((input.Volume / _scale) / (input.High - input.Low)); _previousHighMaximum = input.High; _previousLowMinimum = input.Low; _sma.Update(input.EndTime, midValue / midRatio); return _sma.Current.Value; } /// /// Resets this indicator to its initial state /// public override void Reset() { _sma.Reset(); _previousHighMaximum = 0.0m; _previousLowMinimum = 0.0m; base.Reset(); } } }