/* * 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; using QuantConnect.Data.UniverseSelection; using QuantConnect.Util; namespace QuantConnect.Algorithm.Framework.Alphas { /// /// Provides an implementation of that combines multiple alpha /// models into a single alpha model and properly sets each insights 'SourceModel' property. /// public class CompositeAlphaModel : AlphaModel { private readonly List _alphaModels = new List(); /// /// Initializes a new instance of the class /// /// The individual alpha models defining this composite model public CompositeAlphaModel(params IAlphaModel[] alphaModels) { if (alphaModels.IsNullOrEmpty()) { throw new ArgumentException("Must specify at least 1 alpha model for the CompositeAlphaModel"); } _alphaModels.AddRange(alphaModels); } /// /// Initializes a new instance of the class /// /// The individual alpha models defining this composite model public CompositeAlphaModel(params PyObject[] alphaModels) { if (alphaModels.IsNullOrEmpty()) { throw new ArgumentException("Must specify at least 1 alpha model for the CompositeAlphaModel"); } foreach (var pyAlphaModel in alphaModels) { AddAlpha(pyAlphaModel); } } /// /// Initializes a new instance of the class /// /// The individual alpha model defining this composite model public CompositeAlphaModel(PyObject alphaModel) : this(new[] { alphaModel} ) { } /// /// Updates this alpha model with the latest data from the algorithm. /// This is called each time the algorithm receives data for subscribed securities. /// This method patches this call through the each of the wrapped models. /// /// The algorithm instance /// The new data available /// The new insights generated public override IEnumerable Update(QCAlgorithm algorithm, Slice data) { foreach (var model in _alphaModels) { var name = model.GetModelName(); foreach (var insight in model.Update(algorithm, data)) { if (string.IsNullOrEmpty(insight.SourceModel)) { // set the source model name if not already set insight.SourceModel = name; } yield return insight; } } } /// /// Event fired each time the we add/remove securities from the data feed. /// This method patches this call through the each of the wrapped models. /// /// The algorithm instance that experienced the change in securities /// The security additions and removals from the algorithm public override void OnSecuritiesChanged(QCAlgorithm algorithm, SecurityChanges changes) { foreach (var model in _alphaModels) { model.OnSecuritiesChanged(algorithm, changes); } } /// /// Adds a new /// /// The alpha model to add public void AddAlpha(IAlphaModel alphaModel) { _alphaModels.Add(alphaModel); } /// /// Adds a new /// /// The alpha model to add public void AddAlpha(PyObject pyAlphaModel) { IAlphaModel alphaModel; if (!pyAlphaModel.TryConvert(out alphaModel)) { alphaModel = new AlphaModelPythonWrapper(pyAlphaModel); } _alphaModels.Add(alphaModel); } } }