/*
* 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;
using System.Collections.Generic;
using QuantConnect.Data;
using QuantConnect.Data.Consolidators;
using QuantConnect.Data.UniverseSelection;
using QuantConnect.Indicators;
using QuantConnect.Securities;
namespace QuantConnect.Algorithm.Framework.Alphas
{
///
/// Alpha model that uses historical returns to create insights
///
public class HistoricalReturnsAlphaModel : AlphaModel
{
private readonly int _lookback;
private readonly Resolution _resolution;
private readonly TimeSpan _predictionInterval;
private readonly Dictionary _symbolDataBySymbol;
private readonly InsightCollection _insightCollection;
///
/// Initializes a new instance of the class
///
/// Historical return lookback period
/// The resolution of historical data
public HistoricalReturnsAlphaModel(
int lookback = 1,
Resolution resolution = Resolution.Daily
)
{
_lookback = lookback;
_resolution = resolution;
_predictionInterval = _resolution.ToTimeSpan().Multiply(_lookback);
_symbolDataBySymbol = new Dictionary();
_insightCollection = new InsightCollection();
Name = $"{nameof(HistoricalReturnsAlphaModel)}({lookback},{resolution})";
}
///
/// Updates this alpha model with the latest data from the algorithm.
/// This is called each time the algorithm receives data for subscribed securities
///
/// The algorithm instance
/// The new data available
/// The new insights generated
public override IEnumerable Update(QCAlgorithm algorithm, Slice data)
{
var insights = new List();
foreach (var (symbol, symbolData) in _symbolDataBySymbol)
{
if (symbolData.CanEmit())
{
var direction = InsightDirection.Flat;
var magnitude = (double)symbolData.ROC.Current.Value;
if (magnitude > 0) direction = InsightDirection.Up;
if (magnitude < 0) direction = InsightDirection.Down;
if (direction == InsightDirection.Flat)
{
CancelInsights(algorithm, symbol);
continue;
}
insights.Add(Insight.Price(symbolData.Security.Symbol, _predictionInterval, direction, magnitude, null));
}
}
_insightCollection.AddRange(insights);
return insights;
}
///
/// Event fired each time the we add/remove securities from the data feed
///
/// The algorithm instance that experienced the change in securities
/// The security additions and removals from the algorithm
public override void OnSecuritiesChanged(QCAlgorithm algorithm, SecurityChanges changes)
{
// clean up data for removed securities
foreach (var removed in changes.RemovedSecurities)
{
SymbolData data;
if (_symbolDataBySymbol.TryGetValue(removed.Symbol, out data))
{
_symbolDataBySymbol.Remove(removed.Symbol);
algorithm.SubscriptionManager.RemoveConsolidator(removed.Symbol, data.Consolidator);
}
CancelInsights(algorithm, removed.Symbol);
}
// initialize data for added securities
var addedSymbols = new List();
foreach (var added in changes.AddedSecurities)
{
if (!_symbolDataBySymbol.ContainsKey(added.Symbol))
{
var symbolData = new SymbolData(algorithm, added, _lookback, _resolution);
_symbolDataBySymbol[added.Symbol] = symbolData;
addedSymbols.Add(symbolData.Security.Symbol);
}
}
if (addedSymbols.Count > 0)
{
// warmup our indicators by pushing history through the consolidators
algorithm.History(addedSymbols, _lookback, _resolution)
.PushThrough(bar =>
{
SymbolData symbolData;
if (_symbolDataBySymbol.TryGetValue(bar.Symbol, out symbolData))
{
symbolData.ROC.Update(bar.EndTime, bar.Value);
}
});
}
}
private void CancelInsights(QCAlgorithm algorithm, Symbol symbol)
{
if (_insightCollection.TryGetValue(symbol, out var insights))
{
algorithm.Insights.Cancel(insights);
_insightCollection.Clear(new[] { symbol });
}
}
///
/// Contains data specific to a symbol required by this model
///
private class SymbolData
{
public Security Security;
public IDataConsolidator Consolidator;
public RateOfChange ROC;
public long previous = 0;
public SymbolData(QCAlgorithm algorithm, Security security, int lookback, Resolution resolution)
{
Security = security;
Consolidator = algorithm.ResolveConsolidator(security.Symbol, resolution);
algorithm.SubscriptionManager.AddConsolidator(security.Symbol, Consolidator);
ROC = new RateOfChange(security.Symbol.ToString(), lookback);
algorithm.RegisterIndicator(security.Symbol, ROC, Consolidator);
}
public bool CanEmit()
{
if (previous == ROC.Samples) return false;
previous = ROC.Samples;
return ROC.IsReady;
}
}
}
}