/*
* 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
{
///
/// The Force Index is calculated by comparing the current market price with the previous market price
/// and multiplying its difference with the traded volume during a specific time period.
///
public class ForceIndex : TradeBarIndicator, IIndicatorWarmUpPeriodProvider
{
private TradeBar _previousInput;
///
/// This indicator is used to smooth the ForceIndex computation
///
/// This is not exposed publicly since it is the same value as this indicator, meaning
/// that this '_smoother' computers the ForceIndex directly, so exposing it publicly would be duplication
private readonly IndicatorBase _smoother;
///
/// Gets a flag indicating when this indicator is ready and fully initialized
///
public override bool IsReady => _smoother.IsReady;
///
/// Required period, in data points, for the indicator to be ready and fully initialized.
///
public int WarmUpPeriod { get; }
///
/// Creates a new ForceIndex indicator using the specified period and moving average type
///
/// The name of this indicator
/// The smoothing period used to smooth the instantaneous force index values
/// The type of smoothing used to smooth the true range values
public ForceIndex(string name, int period, MovingAverageType movingAverageType = MovingAverageType.Exponential)
: base(name)
{
_smoother = movingAverageType.AsIndicator($"{name}_{movingAverageType}", period);
WarmUpPeriod = period + 1;
}
///
/// Creates a new ForceIndex indicator using the specified period and moving average type
///
/// The smoothing period used to smooth the instantenous force index values
/// The type of smoothing used to smooth the instantenous force index values
public ForceIndex(int period, MovingAverageType movingAverageType = MovingAverageType.Exponential)
: this($"FI({period})", period, movingAverageType)
{
}
///
/// Computes the next value of this indicator from the given state
///
/// The input given to the indicator
/// A new value for this indicator
protected override decimal ComputeNextValue(TradeBar input)
{
if (Samples < 2)
{
_previousInput = input;
return 0;
}
// compute the instantaneous force index and then send it to our smoother
_smoother.Update(input.EndTime, (input.Close - _previousInput.Close) * input.Volume);
_previousInput = input;
return _smoother.Current.Value;
}
///
/// Resets this indicator to its initial state
///
public override void Reset()
{
_previousInput = null;
_smoother.Reset();
base.Reset();
}
}
}