/* * 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.Algorithm.Framework.Alphas; using QuantConnect.Algorithm.Framework.Alphas.Analysis; using QuantConnect.Algorithm.Framework.Alphas.Analysis.Providers; using QuantConnect.Algorithm.Framework.Execution; using QuantConnect.Algorithm.Framework.Portfolio; using QuantConnect.Algorithm.Framework.Risk; using QuantConnect.Algorithm.Framework.Selection; using QuantConnect.Data; using QuantConnect.Data.UniverseSelection; using QuantConnect.Securities; using QuantConnect.Util; namespace QuantConnect.Algorithm.Framework { /// /// Algorithm framework base class that enforces a modular approach to algorithm development /// public partial class QCAlgorithmFramework : QCAlgorithm { private readonly ISecurityValuesProvider _securityValuesProvider; /// /// Enables additional logging of framework models including: /// All insights, portfolio targets, order events, and any risk management altered targets /// public bool DebugMode { get; set; } /// /// Returns true since algorithms derived from this use the framework /// public override bool IsFrameworkAlgorithm => true; /// /// Gets or sets the universe selection model. /// public IUniverseSelectionModel UniverseSelection { get; set; } /// /// Gets or sets the alpha model /// public IAlphaModel Alpha { get; set; } /// /// Gets or sets the portoflio construction model /// public IPortfolioConstructionModel PortfolioConstruction { get; set; } /// /// Gets or sets the execution model /// public IExecutionModel Execution { get; set; } /// /// Gets or sets the risk management model /// public IRiskManagementModel RiskManagement { get; set; } /// /// Initializes a new instance of the class /// public QCAlgorithmFramework() { _securityValuesProvider = new AlgorithmSecurityValuesProvider(this); // set model defaults Execution = new ImmediateExecutionModel(); RiskManagement = new NullRiskManagementModel(); } /// /// Called by setup handlers after Initialize and allows the algorithm a chance to organize /// the data gather in the Initialize method /// public override void PostInitialize() { CheckModels(); foreach (var universe in UniverseSelection.CreateUniverses(this)) { AddUniverse(universe); } if (DebugMode) { InsightsGenerated += (algorithm, data) => Log($"{Time}: {string.Join(" | ", data.Insights.OrderBy(i => i.Symbol.ToString()))}"); } // emit warning message about using the framework with cash modelling if (BrokerageModel.AccountType == AccountType.Cash) { Error("These models are currently unsuitable for Cash Modeled brokerages (e.g. GDAX) and may result in unexpected trades." + " To prevent possible user error we've restricted them to Margin trading. You can select margin account types with" + " SetBrokerage( ... AccountType.Margin)"); } base.PostInitialize(); } /// /// Used to send data updates to algorithm framework models /// /// The current data slice public sealed override void OnFrameworkData(Slice slice) { // generate, timestamp and emit insights var insights = Alpha.Update(this, slice) .Select(SetGeneratedAndClosedTimes) .ToArray(); // only fire insights generated event if we actually have insights if (insights.Length != 0) { // debug printing of generated insights if (DebugMode) { Log($"{Time}: ALPHA: {string.Join(" | ", insights.Select(i => i.ToString()).OrderBy(i => i))}"); } OnInsightsGenerated(insights); } // construct portfolio targets from insights var targets = PortfolioConstruction.CreateTargets(this, insights).ToArray(); // set security targets w/ those generated via portfolio construction module foreach (var target in targets) { var security = Securities[target.Symbol]; security.Holdings.Target = target; } if (DebugMode) { // debug printing of generated targets if (targets.Length > 0) { Log($"{Time}: PORTFOLIO: {string.Join(" | ", targets.Select(t => t.ToString()).OrderBy(t => t))}"); } } var riskTargetOverrides = RiskManagement.ManageRisk(this, targets).ToArray(); // override security targets w/ those generated via risk management module foreach (var target in riskTargetOverrides) { var security = Securities[target.Symbol]; security.Holdings.Target = target; } if (DebugMode) { // debug printing of generated risk target overrides if (riskTargetOverrides.Length > 0) { Log($"{Time}: RISK: {string.Join(" | ", riskTargetOverrides.Select(t => t.ToString()).OrderBy(t => t))}"); } } // execute on the targets, overriding targets for symbols w/ risk targets var riskAdjustedTargets = riskTargetOverrides.Concat(targets).DistinctBy(pt => pt.Symbol).ToArray(); if (DebugMode) { // only log adjusted targets if we've performed an adjustment if (riskTargetOverrides.Length > 0) { Log($"{Time}: RISK ADJUSTED TARGETS: {string.Join(" | ", riskAdjustedTargets.Select(t => t.ToString()).OrderBy(t => t))}"); } } Execution.Execute(this, riskAdjustedTargets); } /// /// Used to send security changes to algorithm framework models /// /// Security additions/removals for this time step public sealed override void OnFrameworkSecuritiesChanged(SecurityChanges changes) { if (DebugMode) { Log($"{Time}: {changes}"); } Alpha.OnSecuritiesChanged(this, changes); PortfolioConstruction.OnSecuritiesChanged(this, changes); Execution.OnSecuritiesChanged(this, changes); RiskManagement.OnSecuritiesChanged(this, changes); } /// /// Sets the universe selection model /// /// Model defining universes for the algorithm public void SetUniverseSelection(IUniverseSelectionModel universeSelection) { UniverseSelection = universeSelection; } /// /// Sets the alpha model /// /// Model that generates alpha public void SetAlpha(IAlphaModel alpha) { Alpha = alpha; } /// /// Sets the portfolio construction model /// /// Model defining how to build a portoflio from insights public void SetPortfolioConstruction(IPortfolioConstructionModel portfolioConstruction) { PortfolioConstruction = portfolioConstruction; } /// /// Sets the execution model /// /// Model defining how to execute trades to reach a portfolio target public void SetExecution(IExecutionModel execution) { Execution = execution; } /// /// Sets the risk management model /// /// Model defining public void SetRiskManagement(IRiskManagementModel riskManagement) { RiskManagement = riskManagement; } private Insight SetGeneratedAndClosedTimes(Insight insight) { insight.GeneratedTimeUtc = UtcTime; insight.ReferenceValue = _securityValuesProvider.GetValues(insight.Symbol).Get(insight.Type); if (string.IsNullOrEmpty(insight.SourceModel)) { // set the source model name if not already set insight.SourceModel = Alpha.GetModelName(); } TimeSpan barSize; Security security; SecurityExchangeHours exchangeHours; if (Securities.TryGetValue(insight.Symbol, out security)) { exchangeHours = security.Exchange.Hours; barSize = security.Resolution.ToTimeSpan(); } else { barSize = insight.Period.ToHigherResolutionEquivalent(false).ToTimeSpan(); exchangeHours = MarketHoursDatabase.GetExchangeHours(insight.Symbol.ID.Market, insight.Symbol, insight.Symbol.SecurityType); } var localStart = UtcTime.ConvertFromUtc(exchangeHours.TimeZone); barSize = QuantConnect.Time.Max(barSize, QuantConnect.Time.OneMinute); var barCount = (int) (insight.Period.Ticks / barSize.Ticks); insight.CloseTimeUtc = QuantConnect.Time.GetEndTimeForTradeBars(exchangeHours, localStart, barSize, barCount, false).ConvertToUtc(exchangeHours.TimeZone); return insight; } private void CheckModels() { if (UniverseSelection == null) { throw new Exception($"Framework algorithms must specify a portfolio selection model using the '{nameof(UniverseSelection)}' property."); } if (Alpha == null) { throw new Exception($"Framework algorithms must specify a alpha model using the '{nameof(Alpha)}' property."); } if (PortfolioConstruction == null) { throw new Exception($"Framework algorithms must specify a portfolio construction model using the '{nameof(PortfolioConstruction)}' property"); } if (Execution == null) { throw new Exception($"Framework algorithms must specify an execution model using the '{nameof(Execution)}' property."); } if (RiskManagement == null) { throw new Exception($"Framework algorithms must specify an risk management model using the '{nameof(RiskManagement)}' property."); } } } }