C#のアドベントカレンダー24日目に参加させていただきます。
この記事は、別のアドベントカレンダー「ひとりアドベントカレンダー C#による投資検証ライブラリMagicalNuts」に書き溜めた23日分の記事をまとめたものです。
qiita.com
もの凄い長いので、ご興味の沸いたところだけでも読んでいただければと思います。GitHubやNuGetでも公開済みです。
github.com
www.nuget.org
MagicalNutsとは？
MagicalNutsはC#による投資検証ライブラリです。使い方次第で、次のようなアプリケーションを実装できます。
C#の取り回しのしやすさを活かし、痒い所に手が届く投資環境を作りたい方の１つの選択肢になれればと思います。MagicalNutsは10個のパッケージで構成されていますので、必要なものを選択してご利用ください。
目次
依存関係
免責事項
MagicalNutsはxUnitを用いた単体テストを可能な限り取り入れておりますが、未検証機能や不具合を含んでいる可能性がございます。MagicalNutsを投資活動にご利用にされる場合は、利用者様の方でも十分な検証をお願いいたします。
MagicalNutsは有価証券への投資を勧誘することを目的としておらず、また何らかの保証・約束をするものではございません。投資に関する決定は利用者様ご自身のご判断において行っていただきますようお願いいたします。MagicalNutsのご利用に起因するいかなる損害につきましても、作者は責任を負いかねます。
MagicalNuts.Primitive
ロウソク足や銘柄情報など、他のパッケージでも使用する基本的なクラスを含むパッケージです。
Candle
Candleはロウソク足を表すクラスです。
<summary>
</summary>
public class Candle
{
<summary>
</summary>
public DateTime DateTime { get; set; }
<summary>
</summary>
public decimal Open { get; set; }
<summary>
</summary>
public decimal High { get; set; }
<summary>
</summary>
public decimal Low { get; set; }
<summary>
</summary>
public decimal Close { get; set; }
<summary>
</summary>
public decimal Volume { get; set; }
<summary>
</summary>
public decimal TradingValue => Close * Volume;
}
いわゆるOHLCVで、これといって特筆すべきところはないと思いますが、１点だけ挙げるなら数値変数の型にdecimalを使用しているところです。
当初はdoubleを使っていたのですが、特に為替や米国株の株価を扱う際に、どうしても小数点以下の誤差が出てしまうことがあり、MagicalNutsでは基本的に小数を扱う際はdecimalで統一しています。decimalはdoubleに比べてデータサイズが大きく、処理時間もかかると思いますが、数値の正確性を優先しました。
MagicalNutsの各種機能を使用する場合、このCandleの配列やリスト、CandleCollectionやその派生クラスのインスタンスをご用意いただくことになります。
Stock
Stockは銘柄情報を表すクラスです。
<summary>
</summary>
public class Stock
{
<summary>
</summary>
public string Code { get; set; }
<summary>
</summary>
public string Name { get; set; }
<summary>
</summary>
public int Unit { get; set; }
<summary>
</summary>
public int MarketType { get; set; }
}
CodeとNameは自明かもしれませんが、Code = "7203"、Name = "トヨタ自動車"というように銘柄コードと銘柄名を入れます。NameはMagicalNuts内では特に使用していないのですが、MagicalNutsを使ったアプリケーションを実装する際にあった方が良いと思うので入れています。
単元数のUnitは日本株で言えば100を入れます。ミニ株であれば、証券会社によって違うと思いますが10や1、米国株であれば1を入れておきます。
市場の種類MarketTypeは、米国など日本市場以外のマーケットを扱うことを想定して用意しましたが、日本株のみを扱う場合は0で良いですし、デフォルトでそうなります。
Calendar
Calendarは市場の営業日、非営業日を判定する基底クラスです。
<summary>
</summary>
public class Calendar
{
<summary>
</summary>
<returns></returns>
public virtual async Task<bool> SetUpAsync()
{
return true;
}
<summary>
</summary>
<param name="dt"></param>
<returns></returns>
public virtual bool IsHoliday(DateTime dt)
{
return (dt.DayOfWeek == DayOfWeek.Saturday || dt.DayOfWeek == DayOfWeek.Sunday);
}
<summary>
</summary>
<param name="dt"></param>
<param name="days"></param>
<returns></returns>
public DateTime GetBusinessDayBefore(DateTime dt, int days)
{
for (int i = 0; i < days; i++)
{
dt = GetFirstBusinessDayToBefore(dt.AddDays(-1));
}
return dt;
}
<summary>
</summary>
<param name="dt"></param>
<param name="days"></param>
<returns></returns>
public DateTime GetBusinessDayAfter(DateTime dt, int days)
{
for (int i = 0; i < days; i++)
{
dt = GetFirstBusinessDayToAfter(dt.AddDays(1));
}
return dt;
}
<summary>
</summary>
<param name="dt"></param>
<returns></returns>
public DateTime GetFirstBusinessDayToBefore(DateTime dt)
{
while (IsHoliday(dt))
{
dt = dt.AddDays(-1);
}
return dt;
}
<summary>
</summary>
<param name="dt"></param>
<returns></returns>
public DateTime GetFirstBusinessDayToAfter(DateTime dt)
{
while (IsHoliday(dt))
{
dt = dt.AddDays(1);
}
return dt;
}
}
非営業日を判定するメソッドはIsHoliday()ですが、このクラスでは週末の判定だけしかしないので、これを継承したクラスでIsHoliday()をoverrideする必要があります。ShareholderIncentiveSampleではSampleCalendarを実装し、週末に加えて祝日まで判定しています。
public class SampleCalendar : Calendar
{
private readonly string[] datestrs =
{
"2020-01-01", "2020-01-02", "2020-01-03", "2020-01-13", "2020-02-11", "2020-02-24", "2020-03-20","2020-04-29", "2020-05-04", "2020-05-05",
"2020-05-06", "2020-07-23", "2020-07-24", "2020-08-10", "2020-09-21", "2020-09-22", "2020-11-03", "2020-11-23", "2020-12-31"
};
private List<DateTime> Holidays = null;
public override async Task<bool> SetUpAsync()
{
Holidays = new List<DateTime>();
foreach (string datestr in datestrs)
{
Holidays.Add(DateTime.Parse(datestr));
}
return true;
}
public override bool IsHoliday(DateTime dt)
{
return dt.DayOfWeek == DayOfWeek.Saturday || dt.DayOfWeek == DayOfWeek.Sunday
|| Holidays.Where(holiday => holiday.Date == dt).Count() > 0;
}
}
SampleCalendarでは、SetUpAsync()であらかじめ用意していた祝日を表す文字列の配列からDateTimeのリストを作り、overrideしたIsHoliday()でそれらを使った休祝日判定を行っています。尚、このクラスでは、2020年の祝日しか判定していませんのでご注意ください。
MagicalNutsではMagicalNuts.ShareholderIncentiveパッケージがCalendarの継承クラスを要求しますし、MagicalNuts.BackTestパッケージでも売買戦略によっては必要になってくると思います。
MovingAverageCalculator
MovingAverageCalculatorは移動平均を計算するクラスで、４種類の計算方法に対応しています。
<summary>
</summary>
public enum MovingAverageMethod
{
Sma,
Ema,
Smma,
Lwma
}
enum名はメタトレーダーのプログラミング言語MQLに準拠しています。MovingAverageCalculatorはどこからでも参照でき、次のように使います。
Candle[] candles = ...
calculator = new MovingAverageCalculator();
decimal ma = calculator.Get(candles.GetRange(0, 25).Select(candle => candle.Close).ToArray(), MovingAverageMethod.Sma);
以下dataには、移動平均の計算期間分の価格が入っているものとします。
public decimal GetSma(decimal[] data)
{
return data.Average();
}
名前のとおり、単純に価格の平均を返します。
public decimal GetEma(decimal[] data)
{
decimal a = 2.0m / (decimal)(data.Length + 1);
if (PreviousMovingAverage == null) PreviousMovingAverage = GetSma(data);
else PreviousMovingAverage = a * data[0] + (1 - a) * PreviousMovingAverage.Value;
return PreviousMovingAverage.Value;
}
前日の指数移動平均PreviousMovingAverageを使って計算します。初回は前日の指数移動平均がないので、単純移動平均で代替します。指数移動平均は最新の価格を過去の価格より重要視する、つまり最新の価格により敏感に反応する移動平均です。aは最新とそれ以外の価格の重みを計算するための係数です。
public decimal GetSmma(decimal[] data)
{
decimal a = 1.0m / (decimal)data.Length;
if (PreviousMovingAverage == null) PreviousMovingAverage = GetSma(data);
else PreviousMovingAverage = a * data[0] + (1 - a) * PreviousMovingAverage.Value;
return PreviousMovingAverage.Value;
}
平滑移動平均は指数移動平均とaの計算が異なるだけです。最新とそれ以外の価格の重みの計算が違うということですね。
MovingAverageMethod.Ema（指数移動平均）とMovingAverageMethod.Smma（平滑移動平均）は前日の移動平均を覚えておくメンバー変数を使用しますので、calculatorを使い回さずに都度newするようにしてください。
public decimal GetLwma(decimal[] data)
{
decimal sum1 = 0, sum2 = 0;
for (int i = 0; i < data.Length; i++)
{
sum1 += (data.Length - i) * data[i];
sum2 += i + 1;
}
return sum1 / sum2;
}
最新の価格を重要視するという意味では前述の２つの移動平均と同じですが、過去に行けば行くほど重要度を下げるという計算をしています。
MathEx
MathExは小数点以下の切り上げ、切り下げをするクラスです。
<summary>
</summary>
public static class MathEx
{
<summary>
</summary>
<param name="value"></param>
<param name="digits"></param>
<returns></returns>
public static decimal Ceiling(decimal value, int digits)
{
decimal multi = (decimal)Math.Pow(10, digits);
if (value >= 0) return Math.Ceiling(value * multi) / multi;
return Math.Floor(value * multi) / multi;
}
<summary>
</summary>
<param name="value"></param>
<param name="digits"></param>
<returns></returns>
public static decimal Floor(decimal value, int digits)
{
decimal multi = (decimal)Math.Pow(10, digits);
if (value >= 0) return Math.Floor(value * multi) / multi;
return Math.Ceiling(value * multi) / multi;
}
}
C#組み込みのSystem.Mathクラスには小数点以下の四捨五入はあるのですが、切り上げと切り下げがないのでそれらを追加したクラスです。スタティッククラスなので、インスタンスの生成なしにどこからでも使用可能です。
PluginManager
PluginManagerは、Visual Studioのソリューション内の、指定されたクラスやインターフェイスを継承したクラスを検知し、その生成までをサポートするクラスです。BackTestSampleでは、バックテストに使う売買戦略や手数料計算機を、ドロップダウンリスト（C#ではコンボボックス）から選択することができます。
Form1の、この部分の実装を見てみましょう。
private List<IStrategy> Strategies = null;
private List<IFeeCalculator> FeeCalculators = null;
Strategies = new PluginManager<IStrategy>().Plugins;
FeeCalculators = new PluginManager<IFeeCalculator>().Plugins;
comboBoxStrategy.Items.AddRange(Strategies.Select(strategy => strategy.Name).ToArray());
comboBoxFee.Items.AddRange(FeeCalculators.Select(fee => fee.Name).ToArray());
PluginManagerはジェネリッククラスで、インターフェイスや基底クラスの型を指定すると、ソリューション内でそれを継承したクラスを集めてきてくれます。（コンストラクタにDLLの入ったフォルダパスを渡すことで、DLL内で実装されているクラスまで集める機能も実装しているのですが未検証です。）Pluginsプロパティで、それらのインスタンスのリストを得ることが可能です。
MagicalNuts.UI.Base
他のUIパッケージでも使用する基本的な描画用クラスを含むパッケージです。
ControlExtensions
ControlExtensionsは、C#組み込みのSystem.Windows.Forms.Controlにメソッドを追加するクラスです。
<summary>
</summary>
public static class ControlExtensions
{
<summary>
</summary>
<param name="me"></param>
<param name="baseCtrl"></param>
public static void AlignLeft(this Control me, Control baseCtrl)
{
me.Left = baseCtrl.Left + baseCtrl.Width + baseCtrl.Margin.Right + me.Margin.Left;
}
<summary>
</summary>
<param name="me"></param>
<param name="baseCtrl"></param>
public static void AlignTop(this Control me, Control baseCtrl)
{
me.Top = baseCtrl.Top + baseCtrl.Height + baseCtrl.Margin.Bottom + me.Margin.Top;
}
<summary>
</summary>
<param name="me"></param>
<param name="zoom"></param>
public static void CopyToClipboard(this Control me, double zoom)
{
Bitmap bmp = new Bitmap(me.Width, me.Height);
me.DrawToBitmap(bmp, new Rectangle(0, 0, me.Width, me.Height));
Bitmap canvas = new Bitmap((int)(me.Width * zoom), (int)(me.Height * zoom));
Graphics g = Graphics.FromImage(canvas);
g.DrawImage(bmp, 0, 0, (int)(bmp.Width * zoom), (int)(bmp.Height * zoom));
Clipboard.SetImage(canvas);
g.Dispose();
canvas.Dispose();
bmp.Dispose();
}
}
コントロールの左寄せと上寄せ、クリップボードへのキャプチャコピーを実装しています。これらを使う場合はusingした上で、
using MagicalNuts.UI.Base;
Label label1 = new Label();
label1.Left = label1.Margin.Left;
Label label2 = new Label();
label2.AlignLeft(label1);
というように使います。この例では、label1の右隣に「左揃え」でlabel2を配置しています。
StockIncrementalTextBox
StockIncrementalTextBoxはインクリメンタルサーチを備えたテキストボックスです。銘柄選択を用途として想定しており、次のイメージのように動作します。
サンプルとしてIncrementalTextBoxSampleを用意しており、最も基本的な使い方としては、Stockの配列を用意してSetCandidates()に渡すだけです。
StockIncrementalTextBox incrementalTextBox = new StockIncrementalTextBox();
Stock[] Stocks = ...
incrementalTextBox1.SetCandidates(Stocks);
ただ、SetCandidates()は内部で辞書を生成するため、大量の検索対象を渡した場合、処理が重くなります。複数のStockIncrementalTextBoxを配置し、それぞれのSetCandidates()をコールすると、その数だけ処理時間が増大してしまいます。そこで、先に辞書を作っておいて、それを各StockIncrementalTextBoxに設定して高速化を図ることができます。
Dictionary<string, List<IncrementalTextBox.ListViewCandidate>> dict = await IncrementalTextBox.GetCandidateListViewItemDictionaryAsync(
Stocks, StockIncrementalTextBox.StockKeysForDictionary, StockIncrementalTextBox.StockMatch);
incrementalTextBox2.CandidateListViewItemDictionary = dict;
incrementalTextBox3.CandidateListViewItemDictionary = dict;
StockIncrementalTextBoxの検索対象はStockクラスに限定していますが、その基底クラスIncrementalTextBoxは投資検証に特化したクラスではないので、どんな種類のWindowsフォームアプリケーションでも使用できます。
IncrementalTextBox1 incrementalTextBox = new IncrementalTextBox();
string[] candidates = new string[] { "apple", "banana", "orange", "grape", "peach", "strawberry" };
incrementalTextBox1.SetCandidates(candidates);
MagicalNuts.AveragePriceMove、MagicalNuts.UI.AveragePriceMove
MagicalNuts.AveragePriceMoveは平均値動きの推移を計算するパッケージです。
「平均値動きの推移」は、正確には「前年最終売買日の終値を100%として指数化した過去10年間の値動きの平均値の推移」で、私はそれを略して平均値動きの推移と呼んでいます。これを、どんな銘柄に対してでも計算できるようにしたのがMagicalNuts.AveragePriceMoveです。
私はこれを株主優待イベント投資で使っています。株主優待イベント投資は、株主優待権利獲得を目的とした買いによる株価上昇を狙う投資手法ですが、私は投資対象選択の条件の１つに次を挙げています。
年間を通じて権利付き最終日に向けた動きだけがある
例えば、下図は３月末優待のシダックス（4837）の平均値動きの推移ですが、株主優待権利付き最終日に向けた値動き以外は、年間で目立った動きが無いことがわかります。この場合、３月末に向けた株価上昇は株主優待の権利獲得を目的としている可能性が高いと判断できるため、このような条件を入れています。
MagicalNuts.AveragePriceMoveはこの平均値動きの推移を計算するパッケージで、MagicalNuts.UI.AveragePriceMoveはその計算結果をグラフ化するパッケージです。AveragePriceMoveSampleというサンプルを用意していますので、そちらをご覧いただければと思いますが、使い方は簡単です。
まず、日足の株価データをCandleの配列として用意します。
Candle[] candles = ...
これをAveragePriceMove.ControllerのGetAveragePriceMove()に渡すと、平均値動きの推移の計算結果を得ることができます。
var result = Controller.GetAveragePriceMove(candles, PriceType.Close, new DateTime(2021, 1, 1), 10);
３つめの引数で渡した日時の前年末（この場合は2020年末）までの平均値動きの推移を計算します。計算期間は４つめの引数で指定（この場合は10年）します。あとはこれを、MagicalNuts.UI.AveragePriceMoveのAveragePriceMoveChartでグラフ化します。
AveragePriceMoveChart chart = new AveragePriceMoveChart();
...
chart.SetAveragePriceMove(result);
ここでは省いていますが、System.Windows.Forms.Formなどへのchartの登録は必要です。また、複数銘柄の平均値動きの推移を同時にグラフ化することも可能です。SetAveragePriceMove()は可変長引数を受け取るようになっていますので、表示したい銘柄分の平均値動きの推移を渡してください。
chart.SetAveragePriceMove(result1, result2);
次の図は２銘柄分のグラフですが、３銘柄以上の同時表示も可能です。
計算例
平均値動きの推移は、次のような方法で計算されます。
- 過去10年間の終値の前日からの増減率を計算
- 同月同日の増減率の平均を計算
- 前年最終売買日から順に前日の平均増減率に当日の平均増減率を乗算して平均値動きの推移を計算
ちょっとわかりにくいと思うので、2017年から2021年までの５年間の、1月4日から1月8日までの５日間を例にとって実際に計算してみます。まず、日々の終値が次のとおりだったとします。
| |
2017 |
2018 |
2019 |
2020 |
2021 |
| 前年最終売買日 |
1,518.61 |
1,817.56 |
1,494.09 |
1,721.36 |
1,804.68 |
| 1月4日 |
1,554.48 |
1,863.82 |
1,471.16 |
|
1,794.59 |
| 1月5日 |
1,555.68 |
1,880.34 |
|
|
1,791.22 |
| 1月6日 |
1,553.32 |
|
|
1,697.49 |
1,796.18 |
| 1月7日 |
|
|
1,512.53 |
1,725.05 |
1,826.30 |
| 1月8日 |
|
|
1,518.43 |
1,701.40 |
1,854.94 |
これを前日からの増減率（％）に変換します。
| |
2017 |
2018 |
2019 |
2020 |
2021 |
平均 |
| 1月4日 |
102.36 |
102.55 |
98.47 |
|
99.44 |
100.70 |
| 1月5日 |
100.08 |
100.89 |
|
|
99.81 |
100.26 |
| 1月6日 |
99.85 |
|
|
98.61 |
100.28 |
99.58 |
| 1月7日 |
|
|
102.81 |
101.62 |
101.68 |
102.04 |
| 1月8日 |
|
|
100.39 |
98.63 |
101.57 |
100.20 |
一番右の列がそれぞれの日付の平均値です。休日分は省いて計算します。これを前日の平均値に乗算していくと次のように平均値動きが得られます。
| |
平均値動き |
| 1月4日 |
100.70 |
| 1月5日 |
100.96 |
| 1月6日 |
99.84 |
| 1月7日 |
101.61 |
| 1月8日 |
102.24 |
こうして得られた平均値動きをグラフにしたものが平均値動きの推移というわけです。
私は各年の同月同日の終値から平均を出しましたが、他の計算方法として、１月の第１営業日の平均、第２営業日の平均というように、同月第〇営業日で平均を出すというやり方も考えられます。ですが、どちらにしても平均値動きの推移は値動きの傾向を見るためのものなので、その意味では大差ないものと考え、私は上記のような方法で計算しています。
MagicalNuts.ShareholderIncentive、MagicalNuts.UI.ShareholderIncentive
MagicalNuts.ShareholderIncentiveは株主優待イベント投資において、権利付き最終日の何日前に買って何日前に売ると期待値が高いのかを検証するパッケージです。サンプルとしてShareholderIncentiveSampleを用意しており、MagicalNuts.ShareholderIncentiveとMagicalNuts.UI.ShareholderIncentiveを使って、下図のようなアプリケーションを実装しています。
画面上部に権利付き最終日前後の値動き、左下に指数化された過去の株価とその平均、右下に権利付き最終日の〇日前に買って〇日前に売った場合の期待値を高い順に表示しています。それぞれMagicalNuts.UI.ShareholderIncentiveパッケージのLastDayPriceMoveChart、HistoricalDataGridView、EntryExitExpectedValueGridViewクラスが該当します。
MagicalNuts.ShareholderIncentiveの使い方を説明していきます。まず、Candleの配列を用意します。
Candle[] candles = ...
次に、株主優待権利確定日の情報を持つDateOfRightAllotmentのインスタンスを用意します。
DateOfRightAllotment dra = new DateOfRightAllotment("1718", 6);
この例ですと、銘柄コードは1718（美樹工業）で、６月末優待ということになります。6月20日のように日付まで決まっている銘柄であれば、
DateOfRightAllotment dra = new DateOfRightAllotment("3191", 6, 20);
のように指定します。また、権利付き最終日の決定のため、MagicalNuts.Primitive.Calendarを継承したクラスが必要です。これは明日解説しますが、簡単に言えば市場の営業日、非営業日を判断するクラスです。前述のサンプルではSampleCalendarを実装しています。
SampleCalendar calendar = new SampleCalendar();
await calendar.SetUpAsync();
ここまで準備が整ったらController.GetHistoricalData()を使い、権利付き最終日を100として指数化した株価を取得します。
Controller controller = new Controller();
Arguments args = new Arguments(dra, 2020, 10, candles.ToArray(), calendar);
HistoricalData hd = controller.GetHistoricalData(args);
Argumentsは指数化処理の設定をするクラスで、ここでは2020年までの過去10年間を指数化するように指定しています。この計算結果hdを使って、権利付き最終日の〇日前に買って〇日前に売った場合の期待値を取得します。
List<EntryExitExpectedValue> eeevs = controller.GetEntryExitExpectedValues(hd).ToList();
eeevs.Sort(EntryExitExpectedValue.Compare);
EntryExitExpectedValue.Compareは、EntryExitExpectedValueのリストを期待値の降順にソートするメソッドです。最後に、MagicalNuts.UI.ShareholderIncentiveパッケージを使ってグラフや表にします。
entryExitExpectedValueGridView.SetupColumns();
historicalDataGridView.SetHistoricalData(hd);
entryExitExpectedValueGridView.DataSource = eeevs;
chart.SetHistoricalData(hd);
以上の手順で、前掲のようなアプリケーションを実装できます。
計算例
株主優待を実施している銘柄では、その権利が発生する権利付き最終日に向けて株価が上昇する傾向があります。権利付き最終日の翌日、権利落ち日に株価は急落します。株主優待イベント投資は、この株価上昇の始めに買い、権利付き最終日までのどこかで売って、このトレンドに乗ることを狙う投資手法です。
株主優待イベント投資を実践する場合、権利付き最終日に向けた値動きを集計し、権利付き最終日の何日前に買って何日前に売ると期待値が高いのかを検証します。具体的には、以下の手順で計算します。
- 権利付き最終日前後、例えば前80日、後40日の過去10年間の終値を用意
- それらを権利付き最終日の終値を100とした数値に指数化
- 日ごとの平均値を算出
例えば、2018年から2020までの３年間の、権利付き最終日とその前５日間の終値が次のようだったとします。
| |
2018 |
2019 |
2020 |
| 5日前 |
5,260 |
3,675 |
3,890 |
| 4日前 |
5,340 |
3,680 |
3,890 |
| 3日前 |
5,310 |
3,700 |
3,915 |
| 2日前 |
5,310 |
3,780 |
3,925 |
| 1日前 |
5,240 |
3,840 |
3,980 |
| 権利付き最終日 |
5,280 |
3,890 |
3,985 |
これらを、権利付き最終日を100として指数化します。
| |
2018 |
2019 |
2020 |
平均 |
| 5日前 |
99.62 |
94.47 |
97.62 |
97.24 |
| 4日前 |
101.14 |
94.60 |
97.62 |
97.78 |
| 3日前 |
100.57 |
95.12 |
98.24 |
97.98 |
| 2日前 |
100.57 |
97.17 |
98.49 |
98.74 |
| 1日前 |
99.24 |
98.71 |
99.87 |
99.28 |
| 権利付き最終日 |
100 |
100 |
100 |
100 |
一番右の列が日ごとの平均値で、この数値が一番低い日に買って、一番高い日で売るのが最も期待値の高いトレードになるということですね。
MagicalNuts.Indicator
移動平均やボリンジャーバンド、ATR、MACDなど、MagicalNuts.UI.TradingChartで表示するインジケーターや、MagicalNuts.BackTestの売買戦略で使用するインジケーターの実装に必要なパッケージです。インジケーターの実装には、Indicator.IndicatorCandleCollectionを使用しますので、まずはその基底クラスPrimitive.CandleCollectionを見てみましょう。
<summary>
</summary>
<typeparam name="T"></typeparam>
public class CandleCollection<T> : List<Candle>
{
<summary>
</summary>
public T Additional { get; }
<summary>
</summary>
<param name="candles"></param>
<param name="add"></param>
public CandleCollection(List<Candle> candles, T add)
{
Clear();
AddRange(candles);
Additional = add;
}
<summary>
</summary>
<param name="i"></param>
<returns></returns>
public CandleCollection<T> Shift(int i)
{
return new CandleCollection<T>(GetRange(i, Count - i), Additional);
}
}
要は、何らかの付加情報を持ったCandleのリストということですね。
１つ注意が必要なことがありまして、コンストラクタに渡すCandleのリストは時系列の降順になっている必要があります。つまり、最新のロウソク足が最初にあって、添え字が大きくなるにつれて過去のロウソク足へと遡っていくようにソートしておく必要があるということです。ちょっと迷ったのですが、Primitive.CandleCollectionではソート順を保証せず、利用箇所での処理速度を優先することにしました。時系列の降順になっている理由は、インジケーターや売買戦略の実装で、メタトレーダーのMQLやトレードステーションのEasyLanguageの書き方を踏襲するためです。
これを継承したIndicator.IndicatorCandleCollectionは、メンバー変数Additionalに別名Codeを与えており、要は銘柄コードを持ったCandleのリストとご理解いただければ良いと思います。
<summary>
</summary>
public class IndicatorCandleCollection : CandleCollection<string>
{
<summary>
</summary>
public string Code => Additional;
}
このIndicatorCandleCollectionをインジケーターが使用します。インジケーターはIIndicatorインターフェイスを実装します。
<summary>
</summary>
public interface IIndicator
{
<summary>
</summary>
<returns></returns>
Task SetUpAsync();
<summary>
</summary>
<param name="candles"></param>
<returns></returns>
decimal[] GetValues(IndicatorCandleCollection candles);
}
SetUpAsync()とGetValues()の２つのメソッドを実装することになります。SetUpAsync()でインジケーターの計算に必要なデータのロードなどを行い、GetValues()でインジケーターの計算を行います。
GetValues()はIndicatorCandleCollectionを引数で受け取り、これを使ってインジケーターの値を計算して返します。戻り値はdecimal[]となっており、インジケーターの値は複数になっても構いません。TradingChartSample.SampleIndicatorは25日移動平均のサンプルです。そのGetValues()の実装を見てみましょう。
public int Period = 25;
public decimal[] GetValues(IndicatorCandleCollection candles)
{
if (candles.Count < Period) return null;
decimal ma = candles.GetRange(0, Period).Select(candle => candle.Close).Average();
return new decimal[] { ma };
}
ロウソク足の数が25日分揃っていない場合は移動平均を計算できないのでnullを返しています。揃っている場合はcandlesから先頭25個分の終値を取得して、それらの平均値を返しています。
例えば2021年12月10日の移動平均を計算する場合は、その日のロウソク足がcandles[0]に入っているcandlesがSampleIndicatorに渡され、その翌日12月11日の場合は、その日のロウソク足がcandles[0]に入っているcandlesが渡されます。前述のとおり、時系列の降順にソートされたcandlesであることを前提に、candles[0]から必要な期間のロウソク足を参照してインジケーターを計算するとお考えいただければ良いと思います。この実装は、MQLやEasyLanguageの経験がある方には違和感ないものと思います。
MagicalNuts.UI.TradingChart
MagicalNuts.UI.TradingChartは、株価チャートやインジケーターを表示するパッケージです。
日足のロウソク足と出来高を表示するのは非常に簡単です。
Candle[] candles = ...
TradingChart chart = new TradingChart();
...
chart.SetUp();
chart.SetDailyCandles(null, candles);
日足のCandleのリストを用意して、TradingChart.SetUp()とTradingChart.SetDailyCandles()を呼びだすだけで下図のような株価チャートを実装できます。
週足、月足、年足への変更も非常に簡単で、TradingChart.CandlePeriodを設定するだけです。
chart.CandlePeriod = CandlePeriod.Weekly;
chart.CandlePeriod = CandlePeriod.Monthly;
chart.CandlePeriod = CandlePeriod.Yearly;
また、チャートの拡縮にも対応しており、画面内のロウソク足の数を設定するイメージでTradingChart.ScreenCandlesNumを設定します。デフォルトは200で、減少させれば拡大、増加させれば縮小されます。
chart.ScreenCandlesNum = 250;
米国株や為替のチャートを表示をする場合に、グラフの軸目盛の小数点以下の桁数を設定する機能もあります。その場合は、TradingChart.SetDailyCandles()の第３引数に表示したい小数点以下の桁数を渡してください。
chart.SetDailyCandles(null, candles, 2);
これで、小数点以下２桁までを表示することができます。サンプルとしてTradingChartSampleを用意していますので、詳細はそちらをご覧ください。
インジケーターの表示
MagicalNuts.UI.TradingChartでインジケーターをチャートに表示するには、IPlotterインターフェイスを実装します。
<summary>
</summary>
public interface IPlotter : IPropertyHolder
{
<summary>
</summary>
Series[] SeriesArray { get; }
<summary>
</summary>
<param name="mainChartArea"></param>
<returns></returns>
SubChartArea[] SetChartArea(MainChartArea mainChartArea);
<summary>
</summary>
<returns></returns>
Task SetUpAsync();
<summary>
</summary>
<param name="code"></param>
<param name="candles"></param>
void Plot(string code, List<Candle> candles);
}
下２つは、SetUpAsync()が準備処理、Plot()がグラフのプロット処理です。
C#のSystem.Windows.Forms.DataVisualization.Charting.Chartを使ったグラフプロットの経験がある方はご存じだと思いますが、一番上のSeriesArrayはプロットした一連のデータを持ったSeriesクラスの配列です。SetChartArea()はMainChartAreaとSubChartAreaの理解が必要ですので、TradingChartSampleの画面を見てみましょう。
上図は縦方向に３つの領域に分かれており、一番上は価格チャートと出来高、ボリンジャーバンドがプロットされた領域、２番目はATRがプロットされた領域、３番目はMACDがプロットされた領域です。一番上の価格チャートがプロットされた領域がMainChartAreaで、下２つの価格チャート以外の領域がSubChartAreaです。
MagicalNutsでは、チャートにインジケーターをプロットするクラスをプロッターと呼びます。TradingChartSampleにSamplePlotterを実装しましたので、そのSetChartArea()を見てみましょう。
private Series Series = new Series();
public override SubChartArea[] SetChartArea(MainChartArea mainChartArea)
{
Series.ChartArea = mainChartArea.Name;
return null;
}
まず、使用するSeriesをメンバー変数に持ちます。SetChartArea()にはチャートからMainChartAreaが引数として渡されるので、メンバーのSeriesの描画対象領域として設定し、このプロッターはSubChartAreaを使用しないのでnullを返しています。
SubChartAreaを使うMagicalNuts.UI.TradingChart.Plotter.AtrPlotterのSetChartArea()を見てみましょう。
private Series Series = new Series();
private ChartArea ChartArea = null;
public override SubChartArea[] SetChartArea(MainChartArea mainChartArea)
{
SubChartArea subChartArea = new SubChartArea();
Series.ChartArea = subChartArea.Name;
ChartArea = subChartArea;
return new SubChartArea[] { subChartArea };
}
プロット先となるSubChartAreaを作ってSeriesに設定し、その存在をチャートに教えるために返しています。ここでは例示しませんが、MainChartAreaとSubChartAreaを同時に使用するプロッターも実装可能です。
ほとんどのプロッターはIIndicatorを継承したインジケーターを、チャートにプロットするために実装されると思います。その場合、IPlotterを直接実装するのではなく、IndicatorPlotterという抽象クラスを継承するのが便利です。次に、説明に必要な箇所のみを抜粋したIndicatorPlotterを掲載します。
<summary>
</summary>
<typeparam name="T"></typeparam>
public abstract class IndicatorPlotter<T> : IPlotter where T : IIndicator, new()
{
<summary>
</summary>
public T Indicator { get; private set; }
<summary>
</summary>
public IndicatorPlotter()
{
Indicator = new T();
}
<summary>
</summary>
<param name="code"></param>
<param name="candles"></param>
public void Plot(string code, List<Candle> candles)
{
PlotIndicator(candles);
}
<summary>
</summary>
<param name="candles"></param>
public abstract void PlotIndicator(IndicatorCandleCollection candles);
<summary>
</summary>
<returns></returns>
public virtual async Task SetUpAsync()
{
await Indicator.SetUpAsync();
}
<summary>
</summary>
<param name="x"></param>
<returns></returns>
protected IndicatorCandleCollection GetCandleCollection(int x)
{
return new IndicatorCandleCollection(Candles.Shift(Candles.Count - x - 1), Candles.Code);
}
<summary>
</summary>
<param name="decimals"></param>
<returns></returns>
protected static double[] ConvertDecimalToDoubleArray(decimal[] decimals)
{
return decimals.Select(d => (double)d).ToArray();
}
}
IndicatorPlotterはジェネリッククラスで、これを継承する場合、プロットするインジケータークラスの型を指定します。継承クラスの実装は、PlotIndicator()メソッドに注力することになります。TradingChartSample.SamplePlotterの実装を見てみましょう。
public class SamplePlotter : IndicatorPlotter<SampleIndicator>
{
private Series Series = null;
public override string Name => "サンプル";
public override object Properties => Indicator;
public override Series[] SeriesArray => new Series[] { Series };
public SamplePlotter()
{
Series = new Series();
Series.ChartType = SeriesChartType.Line;
Series.YAxisType = AxisType.Secondary;
}
public override SubChartArea[] SetChartArea(MainChartArea mainChartArea)
{
Series.ChartArea = mainChartArea.Name;
return null;
}
public override void PlotIndicator(IndicatorCandleCollection candles)
{
for (int x = 0; x < candles.Count; x++)
{
decimal[] data = Indicator.GetValues(GetCandleCollection(x));
if (data == null) continue;
Series.Points.Add(new DataPoint(x, ConvertDecimalToDoubleArray(data)));
}
}
}
このクラスはSampleIndicatorをプロットするので、IndicatorPlotterにSampleIndicatorを指定しています。（実際には、SampleIndicatorを継承したSampleIndicatorExを指定していますが、ここでは簡単のためSampleIndicatorとしています。）
PlotIndicator()にはcandles.Count回のfor文があります。まず、x時点の最新のCandleを先頭として過去に遡っていくCandleCollectionをGetCandleCollection()で取得しています。それをIndicator（ここではSampleIndicator）のGetValues()に渡し、移動平均値を取得しています。最後に、それをDataPointにしてSeries.Pointsに追加しています。MagicalNutsでは小数のほとんどをdecimalで扱いますが、DataPointはdoubleなので、その変換のためにConvertDecimalToDoubleArray()を使用しています。
以上で、SampleIndicatorの移動平均線をチャートにプロットすることができます。
インジケーター等の設定ヘルパー
次のようなものはハードコーディングするのではなく、都度設定できた方が良いですよね。
- 移動平均インジケーターの計算日数
- インジケーターをチャートにプロットする色
- バックテストの初期資産
MagicalNutsにはインジケーターなどの設定を補助する仕組みがあります。その最も基本的なインターフェイスがIPropertyHolderです。
<summary>
</summary>
public interface IPropertyHolder
{
<summary>
</summary>
string Name { get; }
<summary>
</summary>
object Properties { get; }
}
各種設定のことを「プロパティ」と言っており、都度設定したい項目を持つクラスがIPropertyHolderを実装します。前述のIPlotterはIPropertyHolderを継承しています。
public interface IPlotter : IPropertyHolder
IPropertyHolderの実装はIndicatorPlotterに委譲されていますが、これは抽象クラスなので、IndicatorPlotterを継承したSamplePlotterの関係個所を見てみましょう。
public class SamplePlotter : IndicatorPlotter<SampleIndicatorEx>
{
public override string Name => "サンプル";
public override object Properties => Indicator;
}
Nameは"サンプル"を返し、PropertiesはIndicatorを返しています。Indicatorは何だったかと言うとSampleIndicatorExです。（先程は簡単のためSampleIndicatorと説明しました。）
public class SampleIndicatorEx : SampleIndicator
{
[Category("プロット")]
[DisplayName("色")]
[Description("色を設定します。")]
[DefaultValue(typeof(Color), "144, 30, 38")]
public Color Color { get; set; } = Color.FromArgb(144, 30, 38);
}
チャートにプロットする色Colorをプロパティに持っています。SampleIndicatorExはSampleIndicatorを継承しており、SampleIndicatorはPeriodというプロパティを持っています。
[Category("サンプル")]
[DisplayName("期間")]
[Description("期間を設定します。")]
public int Period { get; set; } = 25;
ここまでをまとめると、SamplePlotter.Propertiesは、
- インジケーターをチャートにプロットする色
- 移動平均インジケーターの計算日数
を設定可能ということになります。
最後に、これらの設定UIのヘルパーとしてMagicalNuts.UI.BaseパッケージにPropertyEditFormを用意しています。使用例は次のとおりです。
TradingChart chart = new TradingChart();
...
SamplePlotter plotter = new SamplePlotter();
PropertyEditForm form = new PropertyEditForm(plotter);
if (form.ShowDialog() != DialogResult.OK) return null;
await plotter.SetUpAsync();
chart.AddPlotter(plotter);
詳細はTradingChartSampleをご覧いただければと思いますが、次のような設定UIを簡単に実装することができます。
MagicalNuts.BackTest、MagicalNuts.UI.BackTest
MagicalNuts.BackTestは売買戦略のバックテストを行うパッケージで、MagicalNuts.UI.BackTestはバックテスト結果をグラフ化したり、表を表示するパッケージです。
売買戦略の実装
売買戦略はIStrategyを実装する必要があります。
<summary>
</summary>
public interface IStrategy : IPropertyHolder
{
<summary>
</summary>
int ReferenceCandlesNum { get; }
<summary>
</summary>
<returns></returns>
Task SetUpAsync();
<summary>
</summary>
<param name="state"></param>
<param name="orders"></param>
void GetOrders(BackTestStatus state, List<Order> orders);
}
ReferenceCandlesNumは参照する過去のロウソク足の数を入れておきます。例えば、25日移動平均を利用する売買戦略であれば、25を返すようにしておけば良いです。SetUpAsync()は準備処理です。
GetOrders()に具体的な売買処理を実装します。GetOrders()はstateとordersの２つを引数に取り、簡単に言えば、state内のロウソク足やその他情報を見て、注文をordersに追加するイメージです。BackTestSampleにDonchianChannelBreakOutという売買戦略を実装していますので、それを見ていきましょう。
DonchianChannelBreakOutはドンチアン・チャネル・ブレイクアウトを実装したものです。これは、「価格が過去20日間の最高値を上抜けしたら買い、過去20日間の最安値を下抜けしたら空売りする」という売買戦略です。これを実装したのがDonchianChannelBreakOutです。
- 注意
- DonchianChannelBreakOutは説明のための売買戦略です。この売買戦略では資産を毀損する可能性が高いため、決して実際の売買には採用しないでください。
public class DonchianChannelBreakOut : IStrategy
{
private DonchianChannelBreakOutProperties _Properties = null;
public DonchianChannelBreakOut()
{
_Properties = new DonchianChannelBreakOutProperties();
_Properties.InitialAssets = 1000000;
}
public string Name => "ドンチアンチャネルブレイクアウト";
public object Properties => _Properties;
public int ReferenceCandlesNum => Math.Max(_Properties.HighPeriod + 1, _Properties.LowPeriod + 1);
public async Task SetUpAsync()
{
}
public void GetOrders(BackTestStatus state, List<Order> orders)
{
if (state.Candles.Count < ReferenceCandlesNum) return;
decimal high_1 = state.Candles.GetRange(1, _Properties.HighPeriod).Select(candle => candle.High).Max();
decimal low_1 = state.Candles.GetRange(1, _Properties.LowPeriod).Select(candle => candle.Low).Min();
decimal lots = state.Candles.Stock.Unit;
if (state.Candles[0].Close > high_1 && state.LastActiveLongPosition == null)
{
Position position = state.LastActiveShortPosition;
if (position != null) orders.Add(Order.GetBuyMarketOrder(position));
orders.Add(Order.GetBuyMarketOrder(state.Candles.Stock, lots));
}
if (state.Candles[0].Close < low_1 && state.LastActiveShortPosition == null)
{
Position position = state.LastActiveLongPosition;
if (position != null) orders.Add(Order.GetSellMarketOrder(position));
orders.Add(Order.GetSellMarketOrder(state.Candles.Stock, lots));
}
}
}
今日の終値が、前日までの過去20日間の最高値を上回ったら単元買い、前日までの過去20日間の最安値を下回ったら単元売り、という売買戦略を実装しています。同時に立てるポジションは１つだけで、いわゆる途転システムになります。
また、IStrategyがIPropertyHolderを継承しているため、前述の設定ヘルパー用にNameとPropertiesを返す必要があります。後者では、メンバー変数の_Propertiesが返っており、その型はDonchianChannelBreakOutPropertiesです。その実装を見てみましょう。
public class DonchianChannelBreakOutProperties : StrategyProperties
{
[Category("ドンチアンチャネルブレイクアウト")]
[DisplayName("高値の期間")]
[Description("高値の期間を設定します。")]
public int HighPeriod { get; set; } = 20;
[Category("ドンチアンチャネルブレイクアウト")]
[DisplayName("安値の期間")]
[Description("安値の期間を設定します。")]
public int LowPeriod { get; set; } = 20;
}
基底クラスのStrategyPropertiesは初期資産額の設定を持ちますから、DonchianChannelBreakOutPropertiesは、
の３つの値を設定できることになります。
バックテストの実行
バックテストを実行するにはまず、Argumentsというバックテストの設定を持つクラスのインスタンスを作る必要があります。そのコンストラクタを見てみましょう。
<summary>
</summary>
<param name="strategy"></param>
<param name="candles"></param>
<param name="begin"></param>
<param name="end"></param>
<param name="fc"></param>
<param name="cs"></param>
public Arguments(IStrategy strategy, BackTestCandleCollection candles, DateTime begin, DateTime end, IFeeCalculator fc, CurrencyStore cs)
: this(strategy, new BackTestCandleCollection[] { candles }, begin, end, fc, cs)
{
}
引数を表にまとめます。
| 引数 |
型 |
内容 |
| strategy |
IStrategy |
売買戦略 |
| candles |
BackTestCandleCollection |
ロウソク足のリスト |
| begin |
DateTime |
バックテスト開始日 |
| end |
DateTime |
バックテスト終了日 |
| fc |
IFeeCalculator |
手数料計算機 |
| cs |
CurrencyStore |
為替ストア |
最後の２つは省略可能で、手数料計算機は後述します。為替ストアは米国株など、株価は日本円以外だが資産は日本円で扱うバックテストのための仕組みですが、現時点では検証が不十分なため、動作保証外とさせていただきます。先頭４つが必須の設定となり、例えば、次のように設定します。
IStrategy strategy = new DonchianChannelBreakOut();
await strategy.SetUpAsync();
Candle[] candles = ...
DateTime begin = new DateTime(2011, 1, 1);
DateTime end = new DateTime(2020, 12, 31);
Arguments args = new Arguments(strategy, new BackTestCandleCollection(candles.ToList(), new Stock("N225")), begin, end);
これで、ロウソク足の配列candlesに対し、2011年1月1日から2020年12月31日までの10年間で、売買戦略DonchianChannelBreakOutのバックテストを行う設定になります。注意点としては、ロウソク足のリストを必ず降順で渡すことです。作成したArgumentsのインスタンスをController.BackTestAsync()に渡せば、バックテストを実行できます。
Controller controller = new Controller();
BackTestResult result = await controller.BackTestAsync<BackTestResult>(args);
BackTestAsync()から、バックテスト結果を表すBackTestResultのインスタンスが得られます。MagicalNuts.UI.BackTestを使うと、BackTestResultを使って資産推移グラフ、ポジション履歴、バックテスト結果を表示することができます。それぞれHistoricalAssetsChart、PositionGridView、BackTestResultGridViewが該当します。
private HistoricalAssetsChart chart = new HistoricalAssetsChart();
private PositionGridView positionGridView = new PositionGridView();
private BackTestResultGridView backTestResultGridView = new BackTestResultGridView();
...
chart.SetHistoricalAssetsList(result.HistoricalAssetsArray);
positionGridView.SetupColumns();
positionGridView.DataSource = result.Positions;
backTestResultGridView.SetupColumns();
backTestResultGridView.DataSource = new BackTestResult[] { result };
詳細はBackTestSampleのForm1.BackTestSingle()をご覧ください。
手数料の実装
手数料を考慮したバックテストを行うには、MagicalNuts.BackTestパッケージのIFeeCalculatorを実装します。
<summary>
</summary>
public interface IFeeCalculator : IPropertyHolder
{
<summary>
</summary>
<param name="state"></param>
<param name="price"></param>
<param name="lots"></param>
<param name="currency"></param>
<returns></returns>
decimal GetEntryFee(BackTestStatus state, decimal price, decimal lots, decimal currency);
<summary>
</summary>
<param name="state"></param>
<param name="price"></param>
<param name="lots"></param>
<param name="currency"></param>
<returns></returns>
decimal GetExitFee(BackTestStatus state, decimal price, decimal lots, decimal currency);
<summary>
</summary>
<param name="state"></param>
<returns></returns>
decimal GetMonthlyFee(BackTestStatus state);
<summary>
</summary>
<param name="state"></param>
<returns></returns>
decimal GetYearlyFee(BackTestStatus state);
}
MagicalNutsではIFeeCalculatorを手数料計算機のインターフェイスとしており、次の４種類の手数料を実装可能です。
- エントリー時の手数料
- イグジット時の手数料
- 月次手数料
- 年次手数料
一般的には前者２つを使うことが多いと思います。「月次手数料」はSBIネオモバイル証券など月間約定代金をもとに手数料が計算される場合、「年次手数料」は投資信託の信託報酬など年間コストがかかる場合を想定しています。
BackTestSampleのFeeCalculatorFixedクラスの実装を見てみましょう。
public class FeeCalculatorFixed : IFeeCalculator
{
private FeeFixedProperties _Properties = null;
public FeeCalculatorFixed()
{
_Properties = new FeeFixedProperties();
}
public string Name => "定額";
public object Properties => _Properties;
public decimal GetEntryFee(BackTestStatus state, decimal price, decimal lots, decimal currency)
{
return _Properties.Fee;
}
public decimal GetExitFee(BackTestStatus state, decimal price, decimal lots, decimal currency)
{
return _Properties.Fee;
}
public decimal GetMonthlyFee(BackTestStatus state)
{
return 0;
}
public decimal GetYearlyFee(BackTestStatus state)
{
return 0;
}
}
実際に返される手数料は_Properties.Feeとなっています。_Propertiesの型はFeeFixedPropertiesです。
public class FeeFixedProperties
{
[Category("定額")]
[DisplayName("定額手数料")]
[Description("定額手数料を設定します。")]
public decimal Fee { get; set; } = 500;
}
つまり、FeeCalculatorFixedはデフォルトではエントリー時に500円、イグジット時に500円の往復1,000円を手数料として返します。その金額は設定UIで変更可能です。
ちなみに、バックテスト時に手数料計算機を指定しなかった場合は「手数料なし」となります。この場合は、MagicalNuts.BackTestに実装されているFeeCalculatorNoneが手数料計算機として使われます。FeeCalculatorNoneはすべての手数料をゼロで返すクラスです。
IFeeCalculatorのメソッドはエントリーやイグジット時の価格と株数、BackTestStatusのインスタンスを受け取りますので、約定金額や月間の取引量に応じた手数料も計算可能だと思います。
MagicalNuts.BackTestではドルコスト平均法のバックテストも可能です。BackTestSampleに、ドルコスト平均法による売買戦略DollarCostAveragingを実装しました。
public class DollarCostAveragingProperties : StrategyProperties
{
[Category("ドルコスト平均法")]
[DisplayName("毎月の買い付け日")]
[Description("毎月の買い付け日を設定します。")]
public int DayOfEveryMonth { get; set; } = 1;
[Category("ドルコスト平均法")]
[DisplayName("毎月の買い付け額")]
[Description("毎月の買い付け額を設定します。")]
public decimal BuyAmount { get; set; } = 50000;
}
public class DollarCostAveraging : IStrategy
{
private DollarCostAveragingProperties _Properties = null;
public DollarCostAveraging()
{
_Properties = new DollarCostAveragingProperties();
_Properties.InitialAssets = 0;
}
public async Task SetUpAsync()
{
}
public string Name => "ドルコスト平均法";
public object Properties => _Properties;
public int ReferenceCandlesNum => 0;
public void GetOrders(BackTestStatus state, List<Order> orders)
{
DateTime dt = state.DateTime;
dt = new DateTime(dt.Year, dt.Month, _Properties.DayOfEveryMonth);
if (state.DateTime != dt) return;
decimal lots = Math.Floor(_Properties.BuyAmount / state.Candles[0].Close);
state.AdditionalInvest(Math.Ceiling(state.Candles[0].Close * lots));
orders.Add(Order.GetBuyMarketOrder(state.Candles.Stock, lots));
}
}
GetOrders()では、今日が毎月の買い付け日（デフォルトでは毎月１日）かどうかを確認し、そうでなければ何もせずに抜けます。買い付け日であった場合は、毎月の購入金額（デフォルトでは５万円）から買い付け株数を計算して買い注文を出しています。ドルコスト平均法では毎月の入金が必要ですが、それはBackTestStatus.AdditionalInvest()を使うことでシミュレーション可能です。
また、ドルコスト平均法のバックテストでは、IFeeCalculatorを使った投資信託のコストシミュレーションも可能です。BackTestSampleのFeeCalculatorYearlyCostの実装を見てみましょう。（説明に必要な箇所のみを抜粋しています。）
public class FeeYearlyPercentProperties
{
[Category("年経費率")]
[DisplayName("年経費率")]
[Description("年経費率を設定します。")]
public decimal CostRate { get; set; } = 0.001m;
}
public class FeeCalculatorYearlyCost : IFeeCalculator
{
private FeeYearlyPercentProperties _Properties = new FeeYearlyPercentProperties();
public decimal GetYearlyFee(BackTestStatus state)
{
return Math.Ceiling(state.MarketAssets * _Properties.CostRate);
}
}
BackTestSampleには、日経平均株価に対するドルコスト平均法のバックテストが実装されています。次のグラフはその資産推移です。
複数銘柄を対象とした売買戦略
MagicalNuts.BackTestパッケージは、複数銘柄を対象としたバックテスト機能も持っています。前述した単独銘柄用の売買戦略DonchianChannelBreakOutでは、最新の終値を取得するには次のようにしていました。
state.Candles[0].Close
このあたりのBackTestStatusの実装を確認してみましょう。
<summary>
</summary>
public StrategyCandleCollection[] StockCandles { get; set; }
<summary>
</summary>
public StrategyCandleCollection Candles
{
get
{
if (StockCandles == null || StockCandles.Length == 0) return null;
return StockCandles[0];
}
set
{
StockCandles = new StrategyCandleCollection[] { value };
}
}
メンバー変数に複数銘柄用のStrategyCandleCollection[]を持っていて、単独銘柄用にStrategyCandleCollection[]の先頭にアクセスするCandlesを提供しています。つまり、MagicalNuts.BackTestは複数銘柄用が基本実装となっていて、単独銘柄用に便利なアクセサーを用意しているという設計です。
BackTestSampleに複数銘柄用の売買戦略DonchianChannelBreakOutMultiがありますので、GetOrders()とその関係個所を見てみましょう。
public class DonchianChannelBreakOutMulti : IStrategy
{
private DonchianChannelBreakOut SingleStrategy = null;
public DonchianChannelBreakOutMulti()
{
SingleStrategy = new DonchianChannelBreakOut();
}
public void GetOrders(BackTestStatus state, List<Order> orders)
{
List<Order>[] stock_orders_array = new List<Order>[state.StockCandles.Length];
Parallel.For(0, state.StockCandles.Length, i =>
{
stock_orders_array[i] = new List<Order>();
if (state.StockCandles[i].Count < SingleStrategy.ReferenceCandlesNum) return;
SingleStrategy.GetOrders(state.GetBackTestStatusForSingleStrategy(state.StockCandles[i]), stock_orders_array[i]);
});
foreach (List<Order> stock_orders in stock_orders_array)
{
orders.AddRange(stock_orders);
}
}
}
複数銘柄用の売買戦略の場合、イチから実装することも可能ですが、既に実装済みの単独銘柄用の売買戦略を使い回すこともできます。DonchianChannelBreakOutMultiはstate.StockCandles.Length分のFor文を回し、単独銘柄用のDonchianChannelBreakOutに１銘柄ずつStrategyCandleCollectionを渡しています。その際、BackTestStatus.GetBackTestStatusForSingleStrategy()を使って、複数銘柄用のBackTestStatusから単独銘柄用のBackTestStatusを作り出すことが可能です。
ちなみに、DonchianChannelBreakOutMultiではParallelクラスによる並列処理を実装しています。C#は処理の並列化が簡単なところも大きな魅力の１つだと思います。（並列化は管理の難易度が高いので、きちんと理解した上で使用されることをおすすめします。）
BackTestSampleは複数銘柄といっても２つだけですが、これを例えば、東証一部やマザーズ、もっと言えば日本の全上場株式を対象にすれば、かなり大がかりなバックテストを実現することも可能となります。
バックテスト結果とその拡張
MagicalNuts.BackTestを使ったバックテストの流れは次のとおりです。
- バックテストの設定クラス
Argumentsのインスタンスを用意
Controller.BackTestAsync()にArgumentsのインスタンスを渡してバックテスト実行- バックテスト結果
BackTestResultのインスタンスを得る
こうして得られたBackTestResultのメンバー変数は次のとおりです。
| メンバー変数 |
説明 |
| InitialAssets |
初期資産 |
| AdditionalInvestment |
追加投資額 |
| Profit |
総利益 |
| Loss |
総損失 |
| Return |
総損益 |
| AverageProfitRate |
平均利益率 |
| AverageLossRate |
平均損失率 |
| AverageReturnRate |
平均損益率 |
| StandardDeviationReturnRate |
損益率の標準偏差 |
| WinTradeNum |
総勝ち数 |
| LoseTradeNum |
総負け数 |
| MaxConsecutiveWinTradeNum |
最大連勝数 |
| MaxConsecutiveLoseTradeNum |
最大連敗数 |
| MaxDrawdown |
最大ドローダウン |
| MaxDrawdownRate |
最大ドローダウン率 |
| MinMarketAssets |
最小時価資産 |
| WinRate |
勝率 |
| ExpectedReturn |
期待損益 |
| AverageHoldDays |
平均保持日数 |
| ProfitFactor |
プロフィットファクター |
ここでは各項目の詳細な説明はしませんが、他のシステムトレードソフトでも使われている一般的な項目を採用しました。
場合によっては、他の項目をバックテスト結果に追加したいケースも出てくると思います。その場合はまず、BackTestResultを継承したクラス（ここではBackTestResultEx）を用意します。
public class BackTestResultEx : BackTestResult
{
public decimal Extra { get; set; }
}
Controller.BackTestAsync()はジェネリックメソッドになっているので、呼び出し時にBackTestResultExを指定すると、バックテスト結果をBackTestResultExで受け取ることができます。
BackTestResultEx result = await controller.BackTestAsync<BackTestResultEx>(args);
result.Extra = ...
Controller.BackTestAsync()はBackTestResultEx.Extraを計算しませんので、ご自身でBackTestResultの内容から算出する必要があります。また、Controller.BackTestAsync()から呼ばれるController.GetBackTestResult()はオーバーライド可能なジェネリックメソッドになっているので、Controllerを継承したControllerExなどを実装して、GetBackTestResult()でBackTestResultEx.Extraを計算することも可能です。
public class ControllerEx : Controller
{
protected override T GetBackTestResult<T>()
{
BackTestResultEx result = base.GetBackTestResult<BackTestResultEx>();
result.Extra = ...
return (T)(BackTestResult)result;
}
}
