/*
* 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 allocates percent of account
/// to each insight, defaulting to 3%.
/// For insights of direction , long targets are returned and
/// for insights of direction , short targets are returned.
/// By default, no rebalancing shall be done.
/// Rules:
/// 1. On active Up insight, increase position size by percent
/// 2. On active Down insight, decrease position size by percent
/// 3. On active Flat insight, move by percent towards 0
/// 4. On expired insight, and no other active insight, emits a 0 target'''
///
public class AccumulativeInsightPortfolioConstructionModel : PortfolioConstructionModel
{
private readonly PortfolioBias _portfolioBias;
private readonly double _percent;
///
/// 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)
/// The percentage amount of the portfolio value to allocate
/// to a single insight. The value of percent should be in the range [0,1].
/// The default value is 0.03.
public AccumulativeInsightPortfolioConstructionModel(IDateRule rebalancingDateRules,
PortfolioBias portfolioBias = PortfolioBias.LongShort,
double percent = 0.03)
: this(rebalancingDateRules.ToFunc(), portfolioBias, percent)
{
}
///
/// 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)
/// The percentage amount of the portfolio value to allocate
/// to a single insight. The value of percent should be in the range [0,1].
/// The default value is 0.03.
public AccumulativeInsightPortfolioConstructionModel(Func rebalancingFunc = null,
PortfolioBias portfolioBias = PortfolioBias.LongShort,
double percent = 0.03)
: base(rebalancingFunc)
{
_portfolioBias = portfolioBias;
_percent = Math.Abs(percent);
}
///
/// 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)
/// The percentage amount of the portfolio value to allocate
/// to a single insight. The value of percent should be in the range [0,1].
/// The default value is 0.03.
public AccumulativeInsightPortfolioConstructionModel(Func rebalancingFunc,
PortfolioBias portfolioBias = PortfolioBias.LongShort,
double percent = 0.03)
: this(rebalancingFunc != null ? (Func)(timeUtc => rebalancingFunc(timeUtc)) : null,
portfolioBias,
percent)
{
}
///
/// 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
/// The percentage amount of the portfolio value to allocate
/// to a single insight. The value of percent should be in the range [0,1].
/// The default value is 0.03.
public AccumulativeInsightPortfolioConstructionModel(PyObject rebalance,
PortfolioBias portfolioBias = PortfolioBias.LongShort,
double percent = 0.03)
: this((Func)null,
portfolioBias,
percent)
{
SetRebalancingFunc(rebalance);
}
///
/// Initialize a new instance of
///
/// Rebalancing frequency
/// Specifies the bias of the portfolio (Short, Long/Short, Long)
/// The percentage amount of the portfolio value to allocate
/// to a single insight. The value of percent should be in the range [0,1].
/// The default value is 0.03.
public AccumulativeInsightPortfolioConstructionModel(TimeSpan timeSpan,
PortfolioBias portfolioBias = PortfolioBias.LongShort,
double percent = 0.03)
: this(dt => dt.Add(timeSpan), portfolioBias, percent)
{
}
///
/// Initialize a new instance of
///
/// Rebalancing frequency
/// Specifies the bias of the portfolio (Short, Long/Short, Long)
/// The percentage amount of the portfolio value to allocate
/// to a single insight. The value of percent should be in the range [0,1].
/// The default value is 0.03.
public AccumulativeInsightPortfolioConstructionModel(Resolution resolution,
PortfolioBias portfolioBias = PortfolioBias.LongShort,
double percent = 0.03)
: this(resolution.ToTimeSpan(), portfolioBias, percent)
{
}
///
/// Gets the target insights to calculate a portfolio target percent for
///
/// An enumerable of the target insights
protected override List GetTargetInsights()
{
return Algorithm.Insights.GetActiveInsights(Algorithm.UtcTime).Where(ShouldCreateTargetForInsight)
.OrderBy(insight => insight.GeneratedTimeUtc)
.ToList();
}
///
/// Determines 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 percentPerSymbol = new Dictionary();
foreach (var insight in activeInsights)
{
double targetPercent;
if (percentPerSymbol.TryGetValue(insight.Symbol, out targetPercent))
{
if (insight.Direction == InsightDirection.Flat)
{
// We received a Flat
// if adding or subtracting will push past 0, then make it 0
if (Math.Abs(targetPercent) < _percent)
{
targetPercent = 0;
}
else
{
// otherwise, we flatten by percent
targetPercent += (targetPercent > 0 ? -_percent : _percent);
}
}
}
targetPercent += _percent * (int)insight.Direction;
// adjust to respect portfolio bias
if (_portfolioBias != PortfolioBias.LongShort
&& Math.Sign(targetPercent) != (int)_portfolioBias)
{
targetPercent = 0;
}
percentPerSymbol[insight.Symbol] = targetPercent;
}
return activeInsights.DistinctBy(insight => insight.Symbol)
.ToDictionary(insight => insight, insight => percentPerSymbol[insight.Symbol]);
}
}
}