/*
* 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 System.Linq;
using QuantConnect.Algorithm;
using QuantConnect.AlgorithmFactory;
using QuantConnect.Brokerages.Backtesting;
using QuantConnect.Configuration;
using QuantConnect.Interfaces;
using QuantConnect.Logging;
using QuantConnect.Packets;
using QuantConnect.Data;
using QuantConnect.Lean.Engine.DataFeeds;
using QuantConnect.Securities;
using QuantConnect.Util;
namespace QuantConnect.Lean.Engine.Setup
{
///
/// Backtesting setup handler processes the algorithm initialize method and sets up the internal state of the algorithm class.
///
public class BacktestingSetupHandler : ISetupHandler
{
///
/// The worker thread instance the setup handler should use
///
public WorkerThread WorkerThread { get; set; }
///
/// Internal errors list from running the setup procedures.
///
public List Errors { get; set; }
///
/// Maximum runtime of the algorithm in seconds.
///
/// Maximum runtime is a formula based on the number and resolution of symbols requested, and the days backtesting
public TimeSpan MaximumRuntime { get; private set; }
///
/// Starting capital according to the users initialize routine.
///
/// Set from the user code.
///
public decimal StartingPortfolioValue { get; private set; }
///
/// Start date for analysis loops to search for data.
///
///
public DateTime StartingDate { get; private set; }
///
/// Maximum number of orders for this backtest.
///
/// To stop algorithm flooding the backtesting system with hundreds of megabytes of order data we limit it to 100 per day
public int MaxOrders { get; private set; }
///
/// Initialize the backtest setup handler.
///
public BacktestingSetupHandler()
{
MaximumRuntime = TimeSpan.FromSeconds(300);
Errors = new List();
StartingDate = new DateTime(1998, 01, 01);
}
///
/// Create a new instance of an algorithm from a physical dll path.
///
/// The path to the assembly's location
/// Details of the task required
/// A new instance of IAlgorithm, or throws an exception if there was an error
public virtual IAlgorithm CreateAlgorithmInstance(AlgorithmNodePacket algorithmNodePacket, string assemblyPath)
{
string error;
IAlgorithm algorithm;
var debugNode = algorithmNodePacket as BacktestNodePacket;
var debugging = debugNode != null && debugNode.IsDebugging || Config.GetBool("debugging", false);
if (debugging && !BaseSetupHandler.InitializeDebugging(algorithmNodePacket, WorkerThread))
{
throw new AlgorithmSetupException("Failed to initialize debugging");
}
// Limit load times to 90 seconds and force the assembly to have exactly one derived type
var loader = new Loader(debugging, algorithmNodePacket.Language, TimeSpan.FromSeconds(90), names => names.SingleOrAlgorithmTypeName(Config.Get("algorithm-type-name")), WorkerThread);
var complete = loader.TryCreateAlgorithmInstanceWithIsolator(assemblyPath, algorithmNodePacket.RamAllocation, out algorithm, out error);
if (!complete) throw new AlgorithmSetupException($"During the algorithm initialization, the following exception has occurred: {error}");
return algorithm;
}
///
/// Creates a new instance
///
/// Job packet
/// The algorithm instance before Initialize has been called
/// The brokerage factory
/// The brokerage instance, or throws if error creating instance
public IBrokerage CreateBrokerage(AlgorithmNodePacket algorithmNodePacket, IAlgorithm uninitializedAlgorithm, out IBrokerageFactory factory)
{
factory = new BacktestingBrokerageFactory();
var optionMarketSimulation = new BasicOptionAssignmentSimulation();
return new BacktestingBrokerage(uninitializedAlgorithm, optionMarketSimulation);
}
///
/// Setup the algorithm cash, dates and data subscriptions as desired.
///
/// The parameters object to use
/// Boolean true on successfully initializing the algorithm
public bool Setup(SetupHandlerParameters parameters)
{
var algorithm = parameters.Algorithm;
var job = parameters.AlgorithmNodePacket as BacktestNodePacket;
if (job == null)
{
throw new ArgumentException("Expected BacktestNodePacket but received " + parameters.AlgorithmNodePacket.GetType().Name);
}
Log.Trace($"BacktestingSetupHandler.Setup(): Setting up job: Plan: {job.UserPlan}, UID: {job.UserId.ToStringInvariant()}, " +
$"PID: {job.ProjectId.ToStringInvariant()}, Version: {job.Version}, Source: {job.RequestSource}"
);
if (algorithm == null)
{
Errors.Add(new AlgorithmSetupException("Could not create instance of algorithm"));
return false;
}
algorithm.Name = job.GetAlgorithmName();
//Make sure the algorithm start date ok.
if (job.PeriodStart == default(DateTime))
{
Errors.Add(new AlgorithmSetupException("Algorithm start date was never set"));
return false;
}
var controls = job.Controls;
var isolator = new Isolator();
var initializeComplete = isolator.ExecuteWithTimeLimit(TimeSpan.FromMinutes(5), () =>
{
try
{
parameters.ResultHandler.SendStatusUpdate(AlgorithmStatus.Initializing, "Initializing algorithm...");
//Set our parameters
algorithm.SetParameters(job.Parameters);
//Algorithm is backtesting, not live:
algorithm.SetLiveMode(false);
//Set the source impl for the event scheduling
algorithm.Schedule.SetEventSchedule(parameters.RealTimeHandler);
// set the option chain provider
algorithm.SetOptionChainProvider(new CachingOptionChainProvider(new BacktestingOptionChainProvider()));
// set the future chain provider
algorithm.SetFutureChainProvider(new CachingFutureChainProvider(new BacktestingFutureChainProvider()));
// set the object store
algorithm.SetObjectStore(parameters.ObjectStore);
// before we call initialize
BaseSetupHandler.LoadBacktestJobAccountCurrency(algorithm, job);
//Initialise the algorithm, get the required data:
algorithm.Initialize();
// set start and end date if present in the job
if (job.PeriodStart.HasValue)
{
algorithm.SetStartDate(job.PeriodStart.Value);
}
if (job.PeriodFinish.HasValue)
{
algorithm.SetEndDate(job.PeriodFinish.Value);
}
// after we call initialize
BaseSetupHandler.LoadBacktestJobCashAmount(algorithm, job);
// finalize initialization
algorithm.PostInitialize();
}
catch (Exception err)
{
Log.Error(err);
Errors.Add(new AlgorithmSetupException("During the algorithm initialization, the following exception has occurred: ", err));
}
}, controls.RamAllocation,
sleepIntervalMillis:10, // entire system is waiting on this, so be as fast as possible
workerThread: WorkerThread);
//Before continuing, detect if this is ready:
if (!initializeComplete) return false;
//Calculate the max runtime for the strategy
MaximumRuntime = GetMaximumRuntime(algorithm.StartDate, algorithm.EndDate, algorithm.SubscriptionManager, algorithm.UniverseManager, parameters.AlgorithmNodePacket.Controls);
// Python takes forever; lets give it 10x longer to finish.
if (job.Language == Language.Python)
{
MaximumRuntime = MaximumRuntime.Add(TimeSpan.FromSeconds(MaximumRuntime.TotalSeconds * 9));
}
BaseSetupHandler.SetupCurrencyConversions(algorithm, parameters.UniverseSelection);
StartingPortfolioValue = algorithm.Portfolio.Cash;
// we set the free portfolio value based on the initial total value and the free percentage value
algorithm.Settings.FreePortfolioValue =
algorithm.Portfolio.TotalPortfolioValue * algorithm.Settings.FreePortfolioValuePercentage;
//Max Orders: 10k per backtest:
if (job.UserPlan == UserPlan.Free)
{
MaxOrders = 10000;
}
else
{
MaxOrders = int.MaxValue;
MaximumRuntime += MaximumRuntime;
}
MaxOrders = job.Controls.BacktestingMaxOrders;
//Set back to the algorithm,
algorithm.SetMaximumOrders(MaxOrders);
//Starting date of the algorithm:
StartingDate = algorithm.StartDate;
//Put into log for debugging:
Log.Trace("SetUp Backtesting: User: " + job.UserId + " ProjectId: " + job.ProjectId + " AlgoId: " + job.AlgorithmId);
Log.Trace($"Dates: Start: {algorithm.StartDate.ToStringInvariant("d")} " +
$"End: {algorithm.EndDate.ToStringInvariant("d")} " +
$"Cash: {StartingPortfolioValue.ToStringInvariant("C")}");
if (Errors.Count > 0)
{
initializeComplete = false;
}
return initializeComplete;
}
///
/// Calculate the maximum runtime for this algorithm job.
///
/// State date of the algorithm
/// End date of the algorithm
/// Subscription Manager
/// Universe manager containing configured universes
/// Job controls instance
/// Timespan maximum run period
private TimeSpan GetMaximumRuntime(DateTime start, DateTime finish, SubscriptionManager subscriptionManager, UniverseManager universeManager, Controls controls)
{
// option/futures chain subscriptions
var derivativeSubscriptions = subscriptionManager.Subscriptions
.Where(x => x.Symbol.IsCanonical())
.Select(x => controls.GetLimit(x.Resolution))
.Sum();
// universe coarse/fine/custom subscriptions
var universeSubscriptions = universeManager
// use max limit for universes without explicitly added securities
.Sum(u => u.Value.Members.Count == 0 ? controls.GetLimit(u.Value.UniverseSettings.Resolution) : u.Value.Members.Count);
var subscriptionCount = derivativeSubscriptions + universeSubscriptions;
double maxRunTime = 0;
var jobDays = (finish - start).TotalDays;
maxRunTime = 10 * subscriptionCount * jobDays;
//Rationalize:
if ((maxRunTime / 3600) > 12)
{
//12 hours maximum
maxRunTime = 3600 * 12;
}
else if (maxRunTime < 60)
{
//If less than 60 seconds.
maxRunTime = 60;
}
Log.Trace("BacktestingSetupHandler.GetMaxRunTime(): Job Days: " + jobDays + " Max Runtime: " + Math.Round(maxRunTime / 60) + " min");
//Override for windows:
if (OS.IsWindows)
{
maxRunTime = 24 * 60 * 60;
}
return TimeSpan.FromSeconds(maxRunTime);
}
///
/// Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
///
/// 2
public void Dispose()
{
}
} // End Result Handler Thread:
} // End Namespace