/* * 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 { /// /// Represents the zero lag moving average indicator (ZLEMA) /// ie a technical indicator that aims is to eliminate the inherent lag associated to all trend /// following indicators which average a price over time. /// public class ZeroLagExponentialMovingAverage : WindowIndicator, IIndicatorWarmUpPeriodProvider { /// /// An exponential moving average is used /// private readonly int _period; private readonly ExponentialMovingAverage _ema; private readonly Delay _delayedPrice; /// /// Gets a flag indicating when this indicator is ready and fully initialized /// public override bool IsReady => _delayedPrice.IsReady && _ema.IsReady; /// /// Required period, in data points, for the indicator to be ready and fully initialized. /// public override int WarmUpPeriod => _period + (int)Math.Floor(((float)_period) / 2); /// /// Initializes a new instance of the ZeroLagMovingAverage class with the specified name and period /// /// The name of this indicator /// The period of the ZLEMA public ZeroLagExponentialMovingAverage(string name, int period) : base(name, period) { _period = period; _ema = new ExponentialMovingAverage(name + "_EMA", period); _delayedPrice = new Delay((int)Math.Round((period - 1) / 2.0)); } /// /// Initializes a new instance of the ZeroLagMovingAverage class with the default name and period /// /// The period of the ZLEMA public ZeroLagExponentialMovingAverage(int period) : this($"ZLEMA({period})", period) { } /// /// Resets this indicator to its initial state /// public override void Reset() { _ema.Reset(); _delayedPrice.Reset(); base.Reset(); } /// /// Computes the next value for this indicator from the given state. /// /// The window of data held in this indicator /// The input value to this indicator on this time step /// A new value for this indicator protected override decimal ComputeNextValue(IReadOnlyWindow window, IndicatorDataPoint input) { if (_delayedPrice.Update(input)) { _ema.Update(input.EndTime, input.Value + (input.Value - _delayedPrice.Current)); return _ema.Current.Value; } return 0; } } }