/*
* 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 Python.Runtime;
using QuantConnect.Data.UniverseSelection;
using QuantConnect.Interfaces;
using QuantConnect.Securities;
namespace QuantConnect.Algorithm.Framework.Selection
{
///
/// Provides an implementation of that subscribes to option chains
///
public class OptionUniverseSelectionModel : UniverseSelectionModel
{
private DateTime _nextRefreshTimeUtc;
private readonly TimeSpan _refreshInterval;
private readonly UniverseSettings _universeSettings;
private readonly Func> _optionChainSymbolSelector;
///
/// 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 option chain
public OptionUniverseSelectionModel(TimeSpan refreshInterval, Func> optionChainSymbolSelector)
: this(refreshInterval, optionChainSymbolSelector, null)
{
}
///
/// Creates a new instance of
///
/// Time interval between universe refreshes
/// Selects symbols from the provided option chain
public OptionUniverseSelectionModel(TimeSpan refreshInterval, PyObject optionChainSymbolSelector)
: this(refreshInterval, optionChainSymbolSelector.ConvertToDelegate>>(), null)
{
}
///
/// Creates a new instance of
///
/// Time interval between universe refreshes
/// Selects symbols from the provided option chain
/// Universe settings define attributes of created subscriptions, such as their resolution and the minimum time in universe before they can be removed
public OptionUniverseSelectionModel(TimeSpan refreshInterval, PyObject optionChainSymbolSelector, UniverseSettings universeSettings)
: this(refreshInterval, optionChainSymbolSelector.ConvertToDelegate>>(), universeSettings)
{
}
///
/// Creates a new instance of
///
/// Time interval between universe refreshes
/// Selects symbols from the provided option chain
/// Universe settings define attributes of created subscriptions, such as their resolution and the minimum time in universe before they can be removed
public OptionUniverseSelectionModel(
TimeSpan refreshInterval,
Func> optionChainSymbolSelector,
UniverseSettings universeSettings
)
{
_nextRefreshTimeUtc = DateTime.MinValue;
_refreshInterval = refreshInterval;
_universeSettings = universeSettings;
_optionChainSymbolSelector = optionChainSymbolSelector;
}
///
/// 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 uniqueUnderlyingSymbols = new HashSet();
foreach (var optionSymbol in _optionChainSymbolSelector(algorithm.UtcTime))
{
if (!optionSymbol.SecurityType.IsOption())
{
throw new ArgumentException("optionChainSymbolSelector must return option, index options, or futures options symbols.");
}
// prevent creating duplicate option chains -- one per underlying
if (uniqueUnderlyingSymbols.Add(optionSymbol.Underlying))
{
yield return algorithm.CreateOptionChain(optionSymbol, Filter, _universeSettings);
}
}
}
///
/// Defines the option chain universe filter
///
protected virtual OptionFilterUniverse Filter(OptionFilterUniverse filter)
{
// NOP
return filter;
}
}
}