/*
* 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 QuantConnect.Interfaces;
using QuantConnect.Securities;
using System.Collections.Generic;
using QuantConnect.Data.UniverseSelection;
using Python.Runtime;
namespace QuantConnect.Algorithm.Framework.Selection
{
///
/// Provides an implementation of that subscribes to future chains
///
public class FutureUniverseSelectionModel : UniverseSelectionModel
{
private DateTime _nextRefreshTimeUtc;
private readonly TimeSpan _refreshInterval;
private readonly UniverseSettings _universeSettings;
private readonly Func> _futureChainSymbolSelector;
///
/// Gets the next time the framework should invoke the `CreateUniverses` method to refresh the set of universes.
///
public override DateTime GetNextRefreshTimeUtc() => _nextRefreshTimeUtc;
///
/// Creates a new instance of
///
/// Time interval between universe refreshes
/// Selects symbols from the provided future chain
public FutureUniverseSelectionModel(TimeSpan refreshInterval, Func> futureChainSymbolSelector)
: this(refreshInterval, futureChainSymbolSelector, null)
{
}
///
/// Creates a new instance of
///
/// Time interval between universe refreshes
/// Selects symbols from the provided future chain\
public FutureUniverseSelectionModel(TimeSpan refreshInterval, PyObject futureChainSymbolSelector)
: this(refreshInterval, futureChainSymbolSelector.ConvertToDelegate>>(), null)
{
}
///
/// Creates a new instance of
///
/// Time interval between universe refreshes
/// Selects symbols from the provided future chain\
/// Universe settings define attributes of created subscriptions, such as their resolution and the minimum time in universe before they can be removed
public FutureUniverseSelectionModel(TimeSpan refreshInterval, PyObject futureChainSymbolSelector, UniverseSettings universeSettings)
: this(refreshInterval, futureChainSymbolSelector.ConvertToDelegate>>(), universeSettings)
{
}
///
/// Creates a new instance of
///
/// Time interval between universe refreshes
/// Selects symbols from the provided future chain
/// Universe settings define attributes of created subscriptions, such as their resolution and the minimum time in universe before they can be removed
public FutureUniverseSelectionModel(
TimeSpan refreshInterval,
Func> futureChainSymbolSelector,
UniverseSettings universeSettings
)
{
_nextRefreshTimeUtc = DateTime.MinValue;
_refreshInterval = refreshInterval;
_universeSettings = universeSettings;
_futureChainSymbolSelector = futureChainSymbolSelector;
}
///
/// Creates the universes for this algorithm. Called once after
///
/// The algorithm instance to create universes for
/// The universes to be used by the algorithm
public override IEnumerable CreateUniverses(QCAlgorithm algorithm)
{
_nextRefreshTimeUtc = algorithm.UtcTime + _refreshInterval;
var uniqueSymbols = new HashSet();
foreach (var futureSymbol in _futureChainSymbolSelector(algorithm.UtcTime))
{
if (futureSymbol.SecurityType != SecurityType.Future)
{
throw new ArgumentException("FutureChainSymbolSelector must return future symbols.");
}
// prevent creating duplicate future chains -- one per symbol
if (uniqueSymbols.Add(futureSymbol))
{
foreach (var universe in algorithm.CreateFutureChain(futureSymbol, Filter, _universeSettings))
{
yield return universe;
}
}
}
}
///
/// Defines the future chain universe filter
///
protected virtual FutureFilterUniverse Filter(FutureFilterUniverse filter)
{
// NOP
return filter;
}
}
///
/// Provides an implementation of that subscribes to future chains
///
public class FuturesUniverseSelectionModel : FutureUniverseSelectionModel
{
///
/// Creates a new instance of
///
/// Time interval between universe refreshes
/// Selects symbols from the provided future chain
public FuturesUniverseSelectionModel(TimeSpan refreshInterval, Func> futureChainSymbolSelector)
: base(refreshInterval, futureChainSymbolSelector)
{
}
///
/// Creates a new instance of
///
/// Time interval between universe refreshes
/// Selects symbols from the provided future chain
/// Universe settings define attributes of created subscriptions, such as their resolution and the minimum time in universe before they can be removed
public FuturesUniverseSelectionModel(TimeSpan refreshInterval,
Func> futureChainSymbolSelector,
UniverseSettings universeSettings)
: base(refreshInterval, futureChainSymbolSelector, universeSettings)
{
}
}
}