a46a551c03
* Improve information tracked in regression's {algorithm}.{lang}.details.log
The details.log file aims at providing a diff-able document that quickly and
easily provides actionable information. Since many regression algorithms use
the algorithm's debug/error messaging facilities to log various pieces of algo
state. This document also support a configuration option: regression-high-fidelity-logging'
that logs EVERY piece of data, again, with the aim of providing an easily diff-able
documenbt to quickly highlight actionable information. I may have missed omse key
pieces of information here, but now that the entire QC knows about this regression
tool, if additional information is required then hopefully it's easy enough at this
point to extend the RegressionResultHandler to suit our needs.
The RegressionResultHandler was initially implemented to provide a concise log of
all orders. This was achieved by simply using the Order.ToString method. While
testing/investigating OptionExerciseOrder behavior, it became evident that more
information was required to properly identify the source of potential failures or
differences between previous regression test runs. This change adds logging for
almost every IResultHandler method and additionally attempts to capture the
actual portfolio impact of every OrderEvent. This is accomplished by logging
the portfolio's TotalPortfolioValue, Cash properties and the security's
SecurityHolding.Quantity property.
This change also standardizes the timestamps used to folloow the ISO-8601 format.
When using the RegressionResultHandler, it is highly recommeded to also disable
'forward-console-message' configuration option to ensure algorithm Debug/Error
message logging is done synchronously to ensure correct ordering with respect to
log messages via Log.Debug/Trace/Error.
* Fix typo in options OrderTests test case name
* Update SymbolRepresentation.GenerationOptionTickerOSI to extension method
Far more convenient as an extension method
* Improve R# default code formatting rules
Many of these rule changes focus on improving the readability of code,
with a particular emphasis on multi-line constructs, chained method calls
and multi-line method invocations/declarations.
* Add braces, use string interpolation and limit long lines
* Refactor OptionExerciseOrder.Quantity to indicate change in #contracts
For all other order types, the Order.Quantity indicates the change in the algorithm's
holdings upon order execution for the order's symbol. For OptionExerciseOrder, this
convention was broken. It appears as though only exercise was initially implemented,
in which case only long positions were supported and a code comment indicated that
only positive values of quantity were acceptable, indicating the number of contracts
to exercise. At a later date, assignment simulation was added and utilized a negative
order quantity. This caused some major inconsistencies in how models view exercise
orders compared to all other order types. This change brings OptionExerciseOrder.Quantity
into alignment with the other order types by making it represent the change in holdings
quantity upon order execution.
This change was originally going to be much larger, but in order to minimize risks and to
make for an easier review experience, the additional changes will be committed separately
and pushed in their own PR. Some of the issues identified include:
* Manual Exercise (especially for OTM) is not covered
* Margin Calculations (in particular taking into account opposing contracts held)
* IBrokerage.OptionPositionAssigned is raised for exercise (later filtered by tx handler)
Fixes OptionPortfolioModelTests to use exercise model to properly model exercise of
non-account quote currency option contract.
* Include Order.Tag/OrderEvent.Message in their ToString, Fix default tag values
There was inconsistencies in what we were checking for. The order constructors
default the tag parameter to an empty string but Order.CreateOrder checks for
a null string. Additionally, the order constructors (limit,stopmarket,stoplimit)
would check for an empty string and if so, apply a default order tag.
This change cleans these checks up using string.IsNullOrEmpty and also removes the
check from Order.CreateOrder since we're passing the tag into the various order
constructors.
167 lines
7.2 KiB
C#
167 lines
7.2 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 System;
|
|
using System.Reflection;
|
|
using QuantConnect.Brokerages;
|
|
using QuantConnect.Securities;
|
|
|
|
namespace QuantConnect.Tests
|
|
{
|
|
/// <summary>
|
|
/// Provides symbol instancs for unit tests
|
|
/// </summary>
|
|
public static class Symbols
|
|
{
|
|
|
|
public static readonly Symbol SPY = CreateEquitySymbol("SPY");
|
|
public static readonly Symbol AAPL = CreateEquitySymbol("AAPL");
|
|
public static readonly Symbol MSFT = CreateEquitySymbol("MSFT");
|
|
public static readonly Symbol ZNGA = CreateEquitySymbol("ZNGA");
|
|
public static readonly Symbol FXE = CreateEquitySymbol("FXE");
|
|
public static readonly Symbol LODE = CreateEquitySymbol("LODE");
|
|
public static readonly Symbol IBM = CreateEquitySymbol("IBM");
|
|
public static readonly Symbol GOOG = CreateEquitySymbol("GOOG");
|
|
|
|
public static readonly Symbol USDJPY = CreateForexSymbol("USDJPY");
|
|
public static readonly Symbol EURUSD = CreateForexSymbol("EURUSD");
|
|
public static readonly Symbol EURGBP = CreateForexSymbol("EURGBP");
|
|
public static readonly Symbol GBPUSD = CreateForexSymbol("GBPUSD");
|
|
public static readonly Symbol GBPJPY = CreateForexSymbol("GBPJPY");
|
|
|
|
public static readonly Symbol BTCUSD = CreateCryptoSymbol("BTCUSD");
|
|
public static readonly Symbol LTCUSD = CreateCryptoSymbol("LTCUSD");
|
|
public static readonly Symbol ETHUSD = CreateCryptoSymbol("ETHUSD");
|
|
public static readonly Symbol BTCEUR = CreateCryptoSymbol("BTCEUR");
|
|
public static readonly Symbol ETHBTC = CreateCryptoSymbol("ETHBTC");
|
|
|
|
public static readonly Symbol DE10YBEUR = CreateCfdSymbol("DE10YBEUR", Market.FXCM);
|
|
public static readonly Symbol DE30EUR = CreateCfdSymbol("DE30EUR", Market.FXCM);
|
|
public static readonly Symbol XAGUSD = CreateCfdSymbol("XAGUSD", Market.FXCM);
|
|
public static readonly Symbol XAUUSD = CreateCfdSymbol("XAUUSD", Market.FXCM);
|
|
|
|
public static readonly Symbol SPY_Option_Chain = CreateOptionsCanonicalSymbol("SPY");
|
|
public static readonly Symbol SPY_C_192_Feb19_2016 = CreateOptionSymbol("SPY", OptionRight.Call, 192m, new DateTime(2016, 02, 19));
|
|
public static readonly Symbol SPY_P_192_Feb19_2016 = CreateOptionSymbol("SPY", OptionRight.Put, 192m, new DateTime(2016, 02, 19));
|
|
|
|
public static readonly Symbol Fut_SPY_Feb19_2016 = CreateFutureSymbol(Futures.Indices.SP500EMini, new DateTime(2016, 02, 19));
|
|
public static readonly Symbol Fut_SPY_Mar19_2016 = CreateFutureSymbol(Futures.Indices.SP500EMini, new DateTime(2016, 03, 19));
|
|
|
|
public static readonly Symbol ES_Future_Chain = CreateFuturesCanonicalSymbol(Futures.Indices.SP500EMini);
|
|
public static readonly Symbol Future_ESZ18_Dec2018 = CreateFutureSymbol(Futures.Indices.SP500EMini, new DateTime(2018, 12, 21));
|
|
public static readonly Symbol Future_CLF19_Jan2019 = CreateFutureSymbol("CL", new DateTime(2018, 12, 19));
|
|
|
|
/// <summary>
|
|
/// Can be supplied in TestCase attribute
|
|
/// </summary>
|
|
public enum SymbolsKey
|
|
{
|
|
SPY,
|
|
AAPL,
|
|
MSFT,
|
|
ZNGA,
|
|
FXE,
|
|
USDJPY,
|
|
EURUSD,
|
|
BTCUSD,
|
|
EURGBP,
|
|
GBPUSD,
|
|
DE10YBEUR,
|
|
SPY_C_192_Feb19_2016,
|
|
SPY_P_192_Feb19_2016,
|
|
Fut_SPY_Feb19_2016,
|
|
Fut_SPY_Mar19_2016
|
|
}
|
|
|
|
/// <summary>
|
|
/// Convert key into symbol instance
|
|
/// </summary>
|
|
/// <param name="key">the symbol key</param>
|
|
/// <returns>The matching symbol instance</returns>
|
|
/// <remarks>Using reflection minimizes maintenance but is slower at runtime.</remarks>
|
|
public static Symbol Lookup(SymbolsKey key)
|
|
{
|
|
return (Symbol)typeof(Symbols).GetField(key.ToString(), BindingFlags.Public | BindingFlags.Static).GetValue(null);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets a symbol matching the specified <paramref name="type"/>
|
|
/// </summary>
|
|
public static Symbol GetBySecurityType(SecurityType type)
|
|
{
|
|
switch (type)
|
|
{
|
|
case SecurityType.Equity: return SPY;
|
|
case SecurityType.Option: return SPY_C_192_Feb19_2016;
|
|
case SecurityType.Forex: return EURUSD;
|
|
case SecurityType.Future: return Future_CLF19_Jan2019;
|
|
case SecurityType.Cfd: return XAGUSD;
|
|
case SecurityType.Crypto: return BTCUSD;
|
|
default:
|
|
throw new NotImplementedException($"Symbols.GetBySecurityType({type}) is not implemented.");
|
|
}
|
|
}
|
|
|
|
private static Symbol CreateForexSymbol(string symbol)
|
|
{
|
|
return Symbol.Create(symbol, SecurityType.Forex, Market.Oanda);
|
|
}
|
|
|
|
private static Symbol CreateEquitySymbol(string symbol)
|
|
{
|
|
return Symbol.Create(symbol, SecurityType.Equity, Market.USA);
|
|
}
|
|
private static Symbol CreateFutureSymbol(string symbol, DateTime expiry)
|
|
{
|
|
string market;
|
|
if (!SymbolPropertiesDatabase.FromDataFolder().TryGetMarket(symbol, SecurityType.Future, out market))
|
|
{
|
|
market = DefaultBrokerageModel.DefaultMarketMap[SecurityType.Future];
|
|
}
|
|
return Symbol.CreateFuture(symbol, market, expiry);
|
|
}
|
|
|
|
private static Symbol CreateCfdSymbol(string symbol, string market)
|
|
{
|
|
return Symbol.Create(symbol, SecurityType.Cfd, market);
|
|
}
|
|
|
|
private static Symbol CreateOptionSymbol(string symbol, OptionRight right, decimal strike, DateTime expiry)
|
|
{
|
|
return Symbol.CreateOption(symbol, Market.USA, OptionStyle.American, right, strike, expiry);
|
|
}
|
|
|
|
private static Symbol CreateCryptoSymbol(string symbol)
|
|
{
|
|
return Symbol.Create(symbol, SecurityType.Crypto, Market.GDAX);
|
|
}
|
|
|
|
private static Symbol CreateOptionsCanonicalSymbol(string underlying)
|
|
{
|
|
return Symbol.Create(underlying, SecurityType.Option, Market.USA, "?" + underlying);
|
|
}
|
|
|
|
private static Symbol CreateFuturesCanonicalSymbol(string ticker)
|
|
{
|
|
string market;
|
|
if (!SymbolPropertiesDatabase.FromDataFolder().TryGetMarket(ticker, SecurityType.Future, out market))
|
|
{
|
|
market = DefaultBrokerageModel.DefaultMarketMap[SecurityType.Future];
|
|
}
|
|
return Symbol.Create(ticker, SecurityType.Future, market, "/" + ticker);
|
|
}
|
|
}
|
|
}
|