/* * 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) { } } }