chore: import upstream snapshot with attribution
This commit is contained in:
@@ -0,0 +1,226 @@
|
||||
/*
|
||||
* 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 Newtonsoft.Json;
|
||||
using QuantConnect.Orders;
|
||||
using QuantConnect.Logging;
|
||||
using QuantConnect.Statistics;
|
||||
using System.Collections.Generic;
|
||||
|
||||
namespace QuantConnect.Packets
|
||||
{
|
||||
/// <summary>
|
||||
/// Backtest result packet: send backtest information to GUI for user consumption.
|
||||
/// </summary>
|
||||
public class BacktestResultPacket : Packet
|
||||
{
|
||||
/// <summary>
|
||||
/// User Id placing this task
|
||||
/// </summary>
|
||||
public int UserId { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Project Id of the this task.
|
||||
/// </summary>
|
||||
public int ProjectId { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// User Session Id
|
||||
/// </summary>
|
||||
public string SessionId { get; set; } = string.Empty;
|
||||
|
||||
/// <summary>
|
||||
/// BacktestId for this result packet
|
||||
/// </summary>
|
||||
public string BacktestId { get; set; } = string.Empty;
|
||||
|
||||
/// <summary>
|
||||
/// OptimizationId for this result packet if any
|
||||
/// </summary>
|
||||
public string OptimizationId { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Compile Id for the algorithm which generated this result packet.
|
||||
/// </summary>
|
||||
public string CompileId { get; set; } = string.Empty;
|
||||
|
||||
/// <summary>
|
||||
/// Start of the backtest period as defined in Initialize() method.
|
||||
/// </summary>
|
||||
public DateTime PeriodStart { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// End of the backtest period as defined in the Initialize() method.
|
||||
/// </summary>
|
||||
public DateTime PeriodFinish { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// DateTime (EST) the user requested this backtest.
|
||||
/// </summary>
|
||||
public DateTime DateRequested { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// DateTime (EST) when the backtest was completed.
|
||||
/// </summary>
|
||||
public DateTime DateFinished { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Progress of the backtest as a percentage from 0-1 based on the days lapsed from start-finish.
|
||||
/// </summary>
|
||||
public decimal Progress { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Name of this backtest.
|
||||
/// </summary>
|
||||
public string Name { get; set; } = string.Empty;
|
||||
|
||||
/// <summary>
|
||||
/// Result data object for this backtest
|
||||
/// </summary>
|
||||
public BacktestResult Results { get; set; } = new ();
|
||||
|
||||
/// <summary>
|
||||
/// Processing time of the algorithm (from moment the algorithm arrived on the algorithm node)
|
||||
/// </summary>
|
||||
public double ProcessingTime { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Estimated number of tradeable days in the backtest based on the start and end date or the backtest
|
||||
/// </summary>
|
||||
public int TradeableDates { get; set; }
|
||||
|
||||
/// <summary>
|
||||
/// Default constructor for JSON Serialization
|
||||
/// </summary>
|
||||
public BacktestResultPacket()
|
||||
: base(PacketType.BacktestResult)
|
||||
{
|
||||
PeriodStart = PeriodFinish = DateRequested = DateFinished = DateTime.UtcNow;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Compose the packet from a JSON string:
|
||||
/// </summary>
|
||||
public BacktestResultPacket(string json)
|
||||
: base (PacketType.BacktestResult)
|
||||
{
|
||||
try
|
||||
{
|
||||
var packet = JsonConvert.DeserializeObject<BacktestResultPacket>(json, new JsonSerializerSettings
|
||||
{
|
||||
TypeNameHandling = TypeNameHandling.Auto
|
||||
});
|
||||
CompileId = packet.CompileId;
|
||||
Channel = packet.Channel;
|
||||
PeriodFinish = packet.PeriodFinish;
|
||||
PeriodStart = packet.PeriodStart;
|
||||
Progress = packet.Progress;
|
||||
SessionId = packet.SessionId;
|
||||
BacktestId = packet.BacktestId;
|
||||
Type = packet.Type;
|
||||
UserId = packet.UserId;
|
||||
DateFinished = packet.DateFinished;
|
||||
DateRequested = packet.DateRequested;
|
||||
Name = packet.Name;
|
||||
ProjectId = packet.ProjectId;
|
||||
Results = packet.Results;
|
||||
ProcessingTime = packet.ProcessingTime;
|
||||
TradeableDates = packet.TradeableDates;
|
||||
OptimizationId = packet.OptimizationId;
|
||||
}
|
||||
catch (Exception err)
|
||||
{
|
||||
Log.Trace($"BacktestResultPacket(): Error converting json: {err}");
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
/// <summary>
|
||||
/// Compose result data packet - with tradable dates from the backtest job task and the partial result packet.
|
||||
/// </summary>
|
||||
/// <param name="job">Job that started this request</param>
|
||||
/// <param name="results">Results class for the Backtest job</param>
|
||||
/// <param name="endDate">The algorithms backtest end date</param>
|
||||
/// <param name="startDate">The algorithms backtest start date</param>
|
||||
/// <param name="progress">Progress of the packet. For the packet we assume progess of 100%.</param>
|
||||
public BacktestResultPacket(BacktestNodePacket job, BacktestResult results, DateTime endDate, DateTime startDate, decimal progress = 1m)
|
||||
: this()
|
||||
{
|
||||
try
|
||||
{
|
||||
Progress = Math.Round(progress, 3);
|
||||
SessionId = job.SessionId;
|
||||
PeriodFinish = endDate;
|
||||
PeriodStart = startDate;
|
||||
CompileId = job.CompileId;
|
||||
Channel = job.Channel;
|
||||
BacktestId = job.BacktestId;
|
||||
OptimizationId = job.OptimizationId;
|
||||
Results = results;
|
||||
Name = job.Name;
|
||||
UserId = job.UserId;
|
||||
ProjectId = job.ProjectId;
|
||||
SessionId = job.SessionId;
|
||||
TradeableDates = job.TradeableDates;
|
||||
}
|
||||
catch (Exception err) {
|
||||
Log.Error(err);
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Creates an empty result packet, useful when the algorithm fails to initialize
|
||||
/// </summary>
|
||||
/// <param name="job">The associated job packet</param>
|
||||
/// <returns>An empty result packet</returns>
|
||||
public static BacktestResultPacket CreateEmpty(BacktestNodePacket job)
|
||||
{
|
||||
return new BacktestResultPacket(job, new BacktestResult(new BacktestResultParameters(
|
||||
new Dictionary<string, Chart>(), new Dictionary<int, Order>(), new Dictionary<DateTime, decimal>(),
|
||||
new Dictionary<string, string>(), new SortedDictionary<string, string>(), new Dictionary<string, AlgorithmPerformance>(),
|
||||
new List<OrderEvent>(), new AlgorithmPerformance(), new AlgorithmConfiguration(), new Dictionary<string, string>()
|
||||
)), DateTime.UtcNow, DateTime.UtcNow);
|
||||
}
|
||||
} // End Queue Packet:
|
||||
|
||||
|
||||
/// <summary>
|
||||
/// Backtest results object class - result specific items from the packet.
|
||||
/// </summary>
|
||||
public class BacktestResult : Result
|
||||
{
|
||||
/// <summary>
|
||||
/// Rolling window detailed statistics.
|
||||
/// </summary>
|
||||
public Dictionary<string, AlgorithmPerformance> RollingWindow { get; set; } = new Dictionary<string, AlgorithmPerformance>();
|
||||
|
||||
/// <summary>
|
||||
/// Default Constructor
|
||||
/// </summary>
|
||||
public BacktestResult()
|
||||
{
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Constructor for the result class using dictionary objects.
|
||||
/// </summary>
|
||||
public BacktestResult(BacktestResultParameters parameters) : base(parameters)
|
||||
{
|
||||
RollingWindow = parameters.RollingWindow;
|
||||
}
|
||||
}
|
||||
} // End of Namespace:
|
||||
Reference in New Issue
Block a user