/*
* 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.Scheduling;
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 readonly PortfolioBias _portfolioBias;
///
/// Initialize a new instance of
///
/// The date rules used to define the next expected rebalance time
/// in UTC
/// Specifies the bias of the portfolio (Short, Long/Short, Long)
public EqualWeightingPortfolioConstructionModel(IDateRule rebalancingDateRules,
PortfolioBias portfolioBias = PortfolioBias.LongShort)
: this(rebalancingDateRules.ToFunc(), portfolioBias)
{
}
///
/// 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
/// Specifies the bias of the portfolio (Short, Long/Short, Long)
public EqualWeightingPortfolioConstructionModel(Func rebalancingFunc,
PortfolioBias portfolioBias = PortfolioBias.LongShort)
: base(rebalancingFunc)
{
_portfolioBias = portfolioBias;
}
///
/// 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
/// Specifies the bias of the portfolio (Short, Long/Short, Long)
public EqualWeightingPortfolioConstructionModel(Func rebalancingFunc,
PortfolioBias portfolioBias = PortfolioBias.LongShort)
: this(rebalancingFunc != null ? (Func)(timeUtc => rebalancingFunc(timeUtc)) : null, portfolioBias)
{
}
///
/// 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
/// Specifies the bias of the portfolio (Short, Long/Short, Long)
/// 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 EqualWeightingPortfolioConstructionModel(PyObject rebalance,
PortfolioBias portfolioBias = PortfolioBias.LongShort)
: this((Func)null, portfolioBias)
{
SetRebalancingFunc(rebalance);
}
///
/// Initialize a new instance of
///
/// Rebalancing frequency
/// Specifies the bias of the portfolio (Short, Long/Short, Long)
public EqualWeightingPortfolioConstructionModel(TimeSpan timeSpan,
PortfolioBias portfolioBias = PortfolioBias.LongShort)
: this(dt => dt.Add(timeSpan), portfolioBias)
{
}
///
/// Initialize a new instance of
///
/// Rebalancing frequency
/// Specifies the bias of the portfolio (Short, Long/Short, Long)
public EqualWeightingPortfolioConstructionModel(Resolution resolution = Resolution.Daily,
PortfolioBias portfolioBias = PortfolioBias.LongShort)
: this(resolution.ToTimeSpan(), portfolioBias)
{
}
///
/// 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(activeInsights.Count);
// give equal weighting to each security
var count = activeInsights.Count(x => x.Direction != InsightDirection.Flat && RespectPortfolioBias(x));
var percent = count == 0 ? 0 : 1m / count;
foreach (var insight in activeInsights)
{
result[insight] =
(double)((int)(RespectPortfolioBias(insight) ? insight.Direction : InsightDirection.Flat)
* percent);
}
return result;
}
///
/// Method that will determine if a given insight respects the portfolio bias
///
/// The insight to create a target for
/// True if the insight respects the portfolio bias
protected bool RespectPortfolioBias(Insight insight)
{
return _portfolioBias == PortfolioBias.LongShort || (int)insight.Direction == (int)_portfolioBias;
}
}
}