/*
* 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.Linq;
using QuantConnect.Util;
using QuantConnect.Orders;
using QuantConnect.Securities;
using QuantConnect.Interfaces;
using System.Collections.Generic;
namespace QuantConnect
{
///
/// Estimates dollar volume capacity of algorithm (in account currency) using all Symbols in the portfolio.
///
///
/// Any mention of dollar volume is volume in account currency, but "dollar volume" is used
/// to maintain consistency with financial terminology and our use
/// case of having alphas measured capacity be in USD.
///
public class CapacityEstimate
{
private readonly IAlgorithm _algorithm;
private readonly Dictionary _capacityBySymbol;
private List _monitoredSymbolCapacity;
// We use multiple collections to avoid having to perform an O(n) lookup whenever
// we're wanting to check whether a particular SymbolData instance is being "monitored",
// but still want to preserve indexing via an integer index
// (monitored meaning it is currently aggregating market dollar volume for its capacity calculation).
// For integer indexing, we use the List above, v.s. for lookup we use this HashSet.
private HashSet _monitoredSymbolCapacitySet;
private DateTime _nextSnapshotDate;
private TimeSpan _snapshotPeriod;
private Symbol _smallestAssetSymbol;
///
/// Private capacity member, We wrap this value type because it's being
/// read and written by multiple threads.
///
private ReferenceWrapper _capacity;
///
/// The total capacity of the strategy at a point in time
///
public decimal Capacity
{
// Round our capacity to the nearest 1000
get => _capacity.Value.DiscretelyRoundBy(1000.00m);
private set => _capacity = new ReferenceWrapper(value);
}
///
/// Provide a reference to the lowest capacity symbol used in scaling down the capacity for debugging.
///
public Symbol LowestCapacityAsset => _smallestAssetSymbol;
///
/// Initializes an instance of the class.
///
/// Used to get data at the current time step and access the portfolio state
public CapacityEstimate(IAlgorithm algorithm)
{
_algorithm = algorithm;
_capacityBySymbol = new Dictionary();
_monitoredSymbolCapacity = new List();
_monitoredSymbolCapacitySet = new HashSet();
// Set the minimum snapshot period to one day, but use algorithm start/end if the algo runtime is less than seven days
_snapshotPeriod = TimeSpan.FromDays(Math.Max(Math.Min((_algorithm.EndDate - _algorithm.StartDate).TotalDays - 1, 7), 1));
_nextSnapshotDate = _algorithm.StartDate + _snapshotPeriod;
_capacity = new ReferenceWrapper(0);
}
///
/// Processes an order whenever it's encountered so that we can calculate the capacity
///
/// Order event to use to calculate capacity
public void OnOrderEvent(OrderEvent orderEvent)
{
if (orderEvent.Status != OrderStatus.Filled && orderEvent.Status != OrderStatus.PartiallyFilled)
{
return;
}
SymbolCapacity symbolCapacity;
if (!_capacityBySymbol.TryGetValue(orderEvent.Symbol, out symbolCapacity))
{
symbolCapacity = new SymbolCapacity(_algorithm, orderEvent.Symbol);
_capacityBySymbol[orderEvent.Symbol] = symbolCapacity;
}
symbolCapacity.OnOrderEvent(orderEvent);
if (_monitoredSymbolCapacitySet.Contains(symbolCapacity))
{
return;
}
_monitoredSymbolCapacity.Add(symbolCapacity);
_monitoredSymbolCapacitySet.Add(symbolCapacity);
}
#pragma warning disable CS1574
///
/// Updates the market capacity for any Symbols that require a market update.
/// Sometimes, after the specified , we
/// take a "snapshot" (point-in-time capacity) of the portfolio's capacity.
///
/// This result will be written into the Algorithm Statistics via the
///
#pragma warning restore CS1574
public void UpdateMarketCapacity(bool forceProcess)
{
for (var i = _monitoredSymbolCapacity.Count - 1; i >= 0; --i)
{
var capacity = _monitoredSymbolCapacity[i];
if (capacity.UpdateMarketCapacity())
{
_monitoredSymbolCapacity.RemoveAt(i);
_monitoredSymbolCapacitySet.Remove(capacity);
}
}
var utcDate = _algorithm.UtcTime.Date;
if (forceProcess || utcDate >= _nextSnapshotDate && _capacityBySymbol.Count != 0)
{
var totalPortfolioValue = _algorithm.Portfolio.TotalPortfolioValue;
var totalSaleVolume = _capacityBySymbol.Values
.Sum(s => s.SaleVolume);
if (totalPortfolioValue == 0 || _capacityBySymbol.Count == 0)
{
return;
}
var smallestAsset = _capacityBySymbol.Values
.OrderBy(c => c.MarketCapacityDollarVolume)
.First();
_smallestAssetSymbol = smallestAsset.Security.Symbol;
// When there is no trading, rely on the portfolio holdings
var percentageOfSaleVolume = totalSaleVolume != 0
? smallestAsset.SaleVolume / totalSaleVolume
: 0;
var buyingPowerUsed = smallestAsset.Security.MarginModel.GetReservedBuyingPowerForPosition(new ReservedBuyingPowerForPositionParameters(smallestAsset.Security))
.AbsoluteUsedBuyingPower * smallestAsset.Security.Leverage;
var percentageOfHoldings = buyingPowerUsed / totalPortfolioValue;
var scalingFactor = Math.Max(percentageOfSaleVolume, percentageOfHoldings);
var dailyMarketCapacityDollarVolume = smallestAsset.MarketCapacityDollarVolume / smallestAsset.Trades;
var newCapacity = scalingFactor == 0
? _capacity.Value
: dailyMarketCapacityDollarVolume / scalingFactor;
// Weight our capacity based on previous value if we have one
if (_capacity.Value != 0)
{
newCapacity = (0.33m * newCapacity) + (_capacity.Value * 0.66m);
}
// Set our new capacity value
Capacity = newCapacity;
foreach (var capacity in _capacityBySymbol.Select(pair => pair.Value).ToList())
{
if (!capacity.ShouldRemove())
{
capacity.Reset();
continue;
}
// we remove non invested and non tradable (delisted, deselected) securities this will allow the 'smallestAsset'
// to be changing between snapshots, and avoid the collections to grow
_capacityBySymbol.Remove(capacity.Security.Symbol);
_monitoredSymbolCapacity.Remove(capacity);
_monitoredSymbolCapacitySet.Remove(capacity);
}
_nextSnapshotDate = utcDate + _snapshotPeriod;
}
}
}
}