/*
* 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 Python.Runtime;
using QuantConnect.Algorithm.Framework.Alphas;
using QuantConnect.Data.Fundamental;
using QuantConnect.Data.UniverseSelection;
using QuantConnect.Scheduling;
using QuantConnect.Securities;
namespace QuantConnect.Algorithm.Framework.Portfolio
{
///
/// Provides an implementation of that generates percent targets based on the
/// .
/// The target percent holdings of each sector is 1/S where S is the number of sectors and
/// the target percent holdings of each security is 1/N where N is the number of securities of each sector.
/// For insights of direction , long targets are returned and for insights of direction
/// , short targets are returned.
/// It will ignore for symbols that have no value.
///
public class SectorWeightingPortfolioConstructionModel : EqualWeightingPortfolioConstructionModel
{
private readonly Dictionary _sectorCodeBySymbol = new Dictionary();
///
/// Initialize a new instance of
///
/// The date rules used to define the next expected rebalance time
/// in UTC
public SectorWeightingPortfolioConstructionModel(IDateRule rebalancingDateRules)
: base(rebalancingDateRules.ToFunc())
{
}
///
/// Initialize a new instance of
///
/// For a given algorithm UTC DateTime returns the next expected rebalance time
/// or null if unknown, in which case the function will be called again in the next loop. Returning current time
/// will trigger rebalance. If null will be ignored
public SectorWeightingPortfolioConstructionModel(Func rebalancingFunc)
: base(rebalancingFunc)
{
}
///
/// Initialize a new instance of
///
/// For a given algorithm UTC DateTime returns the next expected rebalance UTC time.
/// Returning current time will trigger rebalance. If null will be ignored
public SectorWeightingPortfolioConstructionModel(Func rebalancingFunc)
: this(rebalancingFunc != null ? (Func)(timeUtc => rebalancingFunc(timeUtc)) : null)
{
}
///
/// Initialize a new instance of
///
/// Rebalancing func or if a date rule, timedelta will be converted into func.
/// For a given algorithm UTC DateTime the func returns the next expected rebalance time
/// or null if unknown, in which case the function will be called again in the next loop. Returning current time
/// will trigger rebalance. If null will be ignored
/// This is required since python net can not convert python methods into func nor resolve the correct
/// constructor for the date rules parameter.
/// For performance we prefer python algorithms using the C# implementation
public SectorWeightingPortfolioConstructionModel(PyObject rebalance)
: this((Func)null)
{
SetRebalancingFunc(rebalance);
}
///
/// Initialize a new instance of
///
/// Rebalancing frequency
public SectorWeightingPortfolioConstructionModel(TimeSpan timeSpan)
: this(dt => dt.Add(timeSpan))
{
}
///
/// Initialize a new instance of
///
/// Rebalancing frequency
public SectorWeightingPortfolioConstructionModel(Resolution resolution = Resolution.Daily)
: this(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
protected override bool ShouldCreateTargetForInsight(Insight insight)
{
return _sectorCodeBySymbol.ContainsKey(insight.Symbol);
}
///
/// Will determine the target percent for each insight
///
/// The active insights to generate a target for
/// A target percent for each insight
protected override Dictionary DetermineTargetPercent(List activeInsights)
{
var result = new Dictionary();
var insightBySectorCode = new Dictionary>();
foreach (var insight in activeInsights)
{
if (insight.Direction == InsightDirection.Flat)
{
result[insight] = 0;
continue;
}
List insights;
var sectorCode = _sectorCodeBySymbol[insight.Symbol];
if (insightBySectorCode.TryGetValue(sectorCode, out insights))
{
insights.Add(insight);
}
else
{
insightBySectorCode[sectorCode] = new List { insight };
}
}
// give equal weighting to each sector
var sectorPercent = insightBySectorCode.Count == 0 ? 0 : 1m / insightBySectorCode.Count;
foreach (var kvp in insightBySectorCode)
{
var insights = kvp.Value;
// give equal weighting to each security
var count = insights.Count;
var percent = count == 0 ? 0 : sectorPercent / count;
foreach (var insight in insights)
{
result[insight] = (double)((int)insight.Direction * percent);
}
}
return result;
}
///
/// 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)
{
foreach (var security in changes.RemovedSecurities)
{
// Removes the symbol from the _sectorCodeBySymbol dictionary
// since we cannot emit PortfolioTarget for removed securities
var symbol = security.Symbol;
if (_sectorCodeBySymbol.ContainsKey(symbol))
{
_sectorCodeBySymbol.Remove(symbol);
}
}
foreach (var security in changes.AddedSecurities)
{
var sectorCode = GetSectorCode(security);
if (!string.IsNullOrEmpty(sectorCode))
{
_sectorCodeBySymbol[security.Symbol] = sectorCode;
}
}
base.OnSecuritiesChanged(algorithm, changes);
}
///
/// Gets the sector code
///
/// The security to create a sector code for
/// The value of the sector code for the security
/// Other sectors can be defined using
protected virtual string GetSectorCode(Security security)
{
return security.Fundamentals?.CompanyReference.IndustryTemplateCode;
}
}
}