/*
* 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 System.Linq;
using QuantConnect.Algorithm.Framework.Alphas;
using QuantConnect.Data.UniverseSelection;
namespace QuantConnect.Algorithm.Framework.Portfolio
{
///
/// Provides an implementation of that gives equal weighting to all
/// securities. The target percent holdings of each security is 1/N where N is the number of securities. For
/// insights of direction , long targets are returned and for insights of direction
/// , short targets are returned.
///
public class EqualWeightingPortfolioConstructionModel : PortfolioConstructionModel
{
private DateTime _rebalancingTime;
private readonly TimeSpan _rebalancingPeriod;
private List _removedSymbols;
private readonly InsightCollection _insightCollection = new InsightCollection();
private DateTime? _nextExpiryTime;
///
/// Initialize a new instance of
///
/// Rebalancing frequency
public EqualWeightingPortfolioConstructionModel(Resolution resolution = Resolution.Daily)
{
_rebalancingPeriod = resolution.ToTimeSpan();
}
///
/// Method that will determine if the portfolio construction model should create a
/// target for this insight
///
/// The insight to create a target for
/// True if the portfolio should create a target for the insight
public virtual bool ShouldCreateTargetForInsight(Insight insight)
{
return true;
}
///
/// Will determine the target percent for each insight
///
/// The active insights to generate a target for
/// A target percent for each insight
public virtual Dictionary DetermineTargetPercent(ICollection activeInsights)
{
var result = new Dictionary();
// give equal weighting to each security
var count = activeInsights.Count(x => x.Direction != InsightDirection.Flat);
var percent = count == 0 ? 0 : 1m / count;
foreach (var insight in activeInsights)
{
result[insight] = (double)((int)insight.Direction * percent);
}
return result;
}
///
/// Create portfolio targets from the specified insights
///
/// The algorithm instance
/// The insights to create portfolio targets from
/// An enumerable of portfolio targets to be sent to the execution model
public override IEnumerable CreateTargets(QCAlgorithm algorithm, Insight[] insights)
{
var targets = new List();
if (algorithm.UtcTime <= _nextExpiryTime &&
algorithm.UtcTime <= _rebalancingTime &&
insights.Length == 0 &&
_removedSymbols == null)
{
return targets;
}
// Validate we should create a target for this insight
_insightCollection.AddRange(insights.Where(ShouldCreateTargetForInsight));
// Create flatten target for each security that was removed from the universe
if (_removedSymbols != null)
{
var universeDeselectionTargets = _removedSymbols.Select(symbol => new PortfolioTarget(symbol, 0));
targets.AddRange(universeDeselectionTargets);
_removedSymbols = null;
}
// Get insight that haven't expired of each symbol that is still in the universe
var activeInsights = _insightCollection.GetActiveInsights(algorithm.UtcTime);
// Get the last generated active insight for each symbol
var lastActiveInsights = (from insight in activeInsights
group insight by insight.Symbol into g
select g.OrderBy(x => x.GeneratedTimeUtc).Last()).ToList();
var errorSymbols = new HashSet();
// Determine target percent for the given insights
var percents = DetermineTargetPercent(lastActiveInsights);
foreach (var insight in lastActiveInsights)
{
var target = PortfolioTarget.Percent(algorithm, insight.Symbol, percents[insight]);
if (target != null)
{
targets.Add(target);
}
else
{
errorSymbols.Add(insight.Symbol);
}
}
// Get expired insights and create flatten targets for each symbol
var expiredInsights = _insightCollection.RemoveExpiredInsights(algorithm.UtcTime);
var expiredTargets = from insight in expiredInsights
group insight.Symbol by insight.Symbol into g
where !_insightCollection.HasActiveInsights(g.Key, algorithm.UtcTime) && !errorSymbols.Contains(g.Key)
select new PortfolioTarget(g.Key, 0);
targets.AddRange(expiredTargets);
_nextExpiryTime = _insightCollection.GetNextExpiryTime();
_rebalancingTime = algorithm.UtcTime.Add(_rebalancingPeriod);
return targets;
}
///
/// 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)
{
// Get removed symbol and invalidate them in the insight collection
_removedSymbols = changes.RemovedSecurities.Select(x => x.Symbol).ToList();
_insightCollection.Clear(_removedSymbols.ToArray());
}
}
}