Files
quantconnect--lean/Optimizer.Launcher/ConsoleLeanOptimizer.cs
Adalyat Nazirov a4f66628fd Lean Optimization interface in QCAlgorithm (#4923)
* initial commit

* run parametrized algorithm with command line parameters

* skeleton: top level structure

* OptimizationNodePacket scheme

* pass parameters as HashSet

* run Lean and read results

* call method on optimization completion

* refactor public interfaces

- close ParameterSet collection; allow only get operations
- explicit method to start LeanOptimizer

* synchronize RunLean method; the result could come in before the backtest id is set in the collections

* another portion of refactoring and interface changes

* comments

* comments & tests for Extremum, Minimization and Maximization classes

* unify optimization paramater values (min, max, step) & mode GridSearch tests

- swap min&max if necessary
- iterate left => right (negate step value if necessary) & provide default step value if step == 0
- no StackOverflow Exception
- parameterSet Id should be global for current generator and retain between steps
- test signle point boundary (min == max)

* BruteForceStrategy tests

* more comments

* Update Optimizer assembly information

- Update Optimizer projects assembly information to match behavior of
  the other projects

* Tweaks

- Adding comments
- Replace OnComplete for Ended event
- Replace Abort for Dispose
- ConsoleLeanOptimizer will keep track of running processes
- Each backtest will store results in a separated directory, so they
  don't fight for the log.txt file.
- Adding cmdline option for lean to close automatically
- Adding concurrent execution backtest limit
- Console optimizer will start Lean minimized
- Escape spaces in Json path

* remove parameter set generator abstraction layer

we don't need this flexibility now.

* refactor public methods; Step shouldn't be public

* constraints: wip

* define contract

* comparison operators and tests

* specify JsonProperty values

* Move SafeMultiply100 to extensions

* Throw exception on failed Optimizer.Start

* constraints: wip

* change finish & dispose process

* minor fixes

- handle force lean abort
- notify consumer if target has been reached

* target & constraints; adapt unit tests

* Minor Tweaks and fixes

- Some logging improvements
- Remove Public since not required

* Ignore empty ParameterValue

* simplify condition

* avoid reinitialization

* reduce type; force immutable

* unit tests for constraints  and target value

* parse & normalize percent values, i.e. 20% => 0.2

* fixup

* Target & Constraint & OptimizationNodePacket unit tests

* Add more json unit tests

- Adding more json conversion unit tests. Fix bug for Extremum which
  wasn't using the converter.

* LeanOptimizer tests

* Estimation results

* User thread safe counters

* LeanOptimizer unit tests; push OptimizationResult on Ended event

* more unit tests

* Minor tweaks

-Estimate ToString in a single line.
-Typos and missing header file

* Add base SendUpdate method

- Add base SendUpdate method for LeanOptimizer

* fix LeanOptimizer test; rely on internal Update rather than timer

* Add OptimizationStatus

- Add missing commments and OptimizationStatus

* EulerSearch implementation: wip

* OptimizationParameter custom converter

* change the type

* make step optional

* change folder structure

* enumerate optimization parameter using IEnumerable & IEnumerator

* unit tests: parameters & objectives

* unit tests: strategies

* remove redundant TODO

* change Euler search boundaries

* more Euler tests

* prevent race condition

* Add account/read endpoint

- Adding account/read endpoint. Adding unit test

* Add status check before running lean

* Minor self review

- Adding missing comments, minor changes

* remove array parameters

* minor changes

- tidy up config file, rename variable
- accept min less or equal than max

* move OptimizationParameter methods to strategies

* Minor improvements for BaseResultHandler derivates

* minor changes

- strict requirements for Step and MinStep values
- strategy specific settigs

* Add TotalRuntime to estimate

Co-authored-by: Martin Molinero <martin.molinero1@gmail.com>
2020-12-02 20:10:40 -03:00

156 lines
6.3 KiB
C#

/*
* 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 QuantConnect.Util;
using System;
using System.Collections.Concurrent;
using System.Diagnostics;
using System.IO;
using QuantConnect.Optimizer.Parameters;
using Log = QuantConnect.Logging.Log;
namespace QuantConnect.Optimizer.Launcher
{
/// <summary>
/// Optimizer implementation that launches Lean as a local process
/// </summary>
public class ConsoleLeanOptimizer : LeanOptimizer
{
private readonly string _leanLocation;
private readonly string _rootResultDirectory;
private readonly string _extraLeanArguments;
private readonly ConcurrentDictionary<string, Process> _processByBacktestId;
/// <summary>
/// Creates a new instance
/// </summary>
/// <param name="nodePacket">The optimization node packet to handle</param>
public ConsoleLeanOptimizer(OptimizationNodePacket nodePacket) : base(nodePacket)
{
_processByBacktestId = new ConcurrentDictionary<string, Process>();
_rootResultDirectory = Configuration.Config.Get("results-destination-folder",
Path.Combine(Directory.GetCurrentDirectory(), $"opt-{nodePacket.OptimizationId}"));
Directory.CreateDirectory(_rootResultDirectory);
_leanLocation = Configuration.Config.Get("lean-binaries-location",
Path.Combine(Directory.GetCurrentDirectory(), "../../../Launcher/bin/Debug/QuantConnect.Lean.Launcher.exe"));
var closeLeanAutomatically = Configuration.Config.GetBool("optimizer-close-automatically", true);
_extraLeanArguments = $"--close-automatically {closeLeanAutomatically}";
var algorithmTypeName = Configuration.Config.Get("algorithm-type-name");
if (!string.IsNullOrEmpty(algorithmTypeName))
{
_extraLeanArguments += $" --algorithm-type-name \"{algorithmTypeName}\"";
}
var algorithmLanguage = Configuration.Config.Get("algorithm-language");
if (!string.IsNullOrEmpty(algorithmLanguage))
{
_extraLeanArguments += $" --algorithm-language \"{algorithmLanguage}\"";
}
var algorithmLocation = Configuration.Config.Get("algorithm-location");
if (!string.IsNullOrEmpty(algorithmLocation))
{
_extraLeanArguments += $" --algorithm-location \"{algorithmLocation}\"";
}
}
/// <summary>
/// Handles starting Lean for a given parameter set
/// </summary>
/// <param name="parameterSet">The parameter set for the backtest to run</param>
/// <returns>The new unique backtest id</returns>
protected override string RunLean(ParameterSet parameterSet)
{
var backtestId = Guid.NewGuid().ToString();
// start each lean instance in its own directory so they store their logs & results, else they fight for the log.txt file
var resultDirectory = Path.Combine(_rootResultDirectory, backtestId);
Directory.CreateDirectory(resultDirectory);
// Use ProcessStartInfo class
var startInfo = new ProcessStartInfo
{
FileName = _leanLocation,
WorkingDirectory = Directory.GetParent(_leanLocation).FullName,
Arguments = $"--results-destination-folder \"{resultDirectory}\" --algorithm-id \"{backtestId}\" --parameters {parameterSet} {_extraLeanArguments}",
WindowStyle = ProcessWindowStyle.Minimized
};
var process = new Process
{
StartInfo = startInfo,
EnableRaisingEvents = true
};
_processByBacktestId[backtestId] = process;
process.Exited += (sender, args) =>
{
if (Disposed)
{
// handle abort
return;
}
_processByBacktestId.TryRemove(backtestId, out process);
var backtestResult = $"{backtestId}.json";
var resultJson = Path.Combine(_rootResultDirectory, backtestId, backtestResult);
NewResult(File.Exists(resultJson) ? File.ReadAllText(resultJson) : null, backtestId);
process.DisposeSafely();
};
process.Start();
return backtestId;
}
/// <summary>
/// Stops lean process
/// </summary>
/// <param name="backtestId">Specified backtest id</param>
protected override void AbortLean(string backtestId)
{
Process process;
if (_processByBacktestId.TryRemove(backtestId, out process))
{
process.Kill();
process.DisposeSafely();
}
}
/// <summary>
/// Sends an update of the current optimization status to the user
/// </summary>
protected override void SendUpdate()
{
// end handler will already log a nice message on end
if (Status != OptimizationStatus.Ended && Status != OptimizationStatus.Aborted)
{
var currentEstimate = GetCurrentEstimate();
var message = $"ConsoleLeanOptimizer.SendUpdate(): {currentEstimate}";
var currentBestBacktest = Strategy.Solution;
if (currentBestBacktest != null)
{
message += $". Best id:'{currentBestBacktest.BacktestId}'. {OptimizationTarget}. Parameters ({currentBestBacktest.ParameterSet})";
}
Log.Trace(message);
}
}
}
}