スパンモデルとは、元証券ディーラーの、マーフィーこと柾木利彦氏が考案したインジケーターで、一目均衡表（詳細は「こちら」を参照してください。）をベースとし、これに変更を加えたものです。
具体的には、一目均衡表に以下のような変更を加えています。
- 転換線と基準線を非表示とする。
- 先行スパン１と先行スパン２で形成される雲を、26日先にずらさずに表示させる。
MetaTrader4（MT4）では、一目均衡表は「Ichimoku Kinko Hyo」として標準で搭載されています。
しかし、標準で搭載されている一目均衡表においては、転換線と基準線を非表示とすることは、各線の表示色を「None」とすることで可能ですが、雲の表示をシフト（ずらす）させるパラメーターが存在しないので、スパンモデルを表示させることができません。
そこで、MT4においてスパンモデル（Span Model.mq4）を表示させるためのプログラミング方法について解説します。
なお、一目均衡表の計算式は、以下のとおりです。
- 転換線
（過去９日間の最高値＋過去９日間の最安値）÷２
→過去９日間の中間値 - 基準線
（過去26日間の最高値＋過去26日間の最安値）÷２
→過去26日間の中間値 - 先行スパン１
（転換線の値＋基準線の値）÷２
→26日先に描画
なお、MT4では、先行スパンAに相当します。 - 先行スパン２
（過去52日間の最高値＋過去52日間の最安値）÷２
→26日先に描画
なお、MT4では、先行スパンBに相当します。 - 遅行スパン
当日の終値
→26日前に描画
Span Model
１．全体像
MT4でインジケーターを作成するには、以下の手順に従ってプログラムを書いていくことになります。
- #property命令を記述する。
- インジケーターバッファーの宣言を行う。
- 変数の宣言を行う。
- init()関数内にインジケーターの基本的な設定を記述する。
- start()関数内に具体的な処理内容を記述する。
以下がサンプルコードになります。ダウンロードして記事を読み進めてください。
２．#property命令の記述
#property命令とは、インジケーターの色、ラインの太さ、インジケーターを表示する場所などの、プログラム全体にかかわる設定を行うものです。
#property命令の詳細については「こちら」を参照してください。
「Span Model.mq4」における、#property命令を記述した部分の解釈を示すと、以下のようになります。
⑴ チャートウィンドウに表示させる
#property indicator_chart_window命令によって、「Span Model.mq4」はチャートウィンドウに表示されます。
⑵ ５種類のデータを表示させる
「Span Model.mq4」は、以下の５つのデータを表示させます。
- 先行スパンＡ（ラインで表示）
- 先行スパンＢ（ラインで表示）
- 先行スパンＡ（ヒストグラムで表示）
- 先行スパンＢ（ヒストグラムで表示）
- 遅行線
したがって、#property indicator_buffers命令には、「５」を指定します。
⑶ 色を指定する
「Span Model.mq4」で表示させる５つのデータの表示色を指定します。
- #property indicator_color1 SandyBrown
１番目のインジケーターとしてラインで表示される先行スパンＡを指定する（後述の５．⑵を参照）ので、#property indicator_color命令には「１」を指定し、表示色を「SandyBrown」に指定しています。 - #property indicator_color2 BlueViolet
２番目のインジケーターとしてラインで表示される先行スパンＢを指定する（後述の５．⑵を参照）ので、#property indicator_color命令には「２」を指定し、表示色を「BlueViolet」に指定しています。 - #property indicator_color3 SandyBrown
３番目のインジケーターとしてヒストグラムで表示される先行スパンＡを指定する（後述の５．⑵を参照）ので、#property indicator_color命令には「３」を指定し、表示色を「SandyBrown」に指定しています。 - #property indicator_color4 BlueViolet
４番目のインジケーターとしてヒストグラムで表示される先行スパンＢを指定する（後述の５．⑵を参照）ので、#property indicator_color命令には「４」を指定し、表示色を「BlueViolet」に指定しています。 - #property indicator_color5 Magenta
５番目のインジケーターとして遅行線を指定する（後述の５．⑵を参照）ので、#property indicator_color命令には「５」を指定し、表示色を「Magenta」に指定しています。
３．インジケーターバッファーの宣言
インジケーターバッファーとは、インジケーターの計算に使用するデータを格納しておく配列のことをいいます。
配列の詳細については「こちら」を参照してください。
「Span Model.mq4」における、インジケーターバッファーを宣言した部分の解釈を示すと、以下のようになります。
⑴ double Span_A_L[];
ラインで表示される先行スパンＡの値を格納していく配列です。
⑵ double Span_B_L[];
ラインで表示される先行スパンＢの値を格納していく配列です。
⑶ double Span_A_H[];
ヒストグラムで表示される先行スパンＡの値を格納していく配列です。
⑷ double Span_B_H[];
ヒストグラムで表示される先行スパンＢの値を格納していく配列です。
⑸ double Delay[];
遅行線の値を格納していく配列です。
⑹ double Change[];
転換線の値を格納していく配列です。
⑺ double Standard[];
基準線の値を格納していく配列です。
４．変数の宣言
「変数」の詳細については「こちら」を参照してください。
「Span Model.mq4」においては、以下の項目をパラメーターとして指定します。
- 転換線の計算期間
- 基準線の計算期間
- 先行スパンＢの計算期間
上記項目は、インジケーターをチャートに適用した際に任意の値に設定することができるようにするため、以下に示すように、「外部変数」（詳細については「こちら」を参照してください。）として宣言します。
- extern int Change_Period
転換線の計算期間 - extern int Standard_Period
基準線の計算期間 - extern int Span_B_Period
先行スパンＢの計算期間
５．基本設定の記述
「Span Model.mq4」におけるinit()関数内に記述したコードについて解説します。
Initialization-Function-Span-Model
⑴ IndicatorBuffers()とは
IndicatorBuffers()は、MQL4であらかじめ定義されている関数で、インジケーターの計算に使用するバッファーの個数を指定するものです。
IndicatorBuffers()関数の詳細については「こちら」を参照してください。
⑵ SetIndexBuffer()とは
SetIndexBuffer()とは、MQL4であらかじめ定義されている関数で、各インジケーターバッファーを、インジケーターバッファー領域（データを一時的に蓄えるデータ領域）に割り当てるものです。
SetIndexBuffer()関数の詳細については「こちら」を参照してください。
⑶ SetIndexLabel()とは
SetIndexLabel()とは、MQL4であらかじめ定義されている関数で、データウィンドウにインジケーターの描画線の説明を表示させるものです。
SetIndexLabel()関数の詳細については「こちら」を参照してください。
⑷ SetIndexStyle()とは
SetIndexStyle()とは、MQL4であらかじめ定義されている関数で、インジケーターの描画スタイル（線orヒストグラム、色など）を設定するものです。
SetIndexStyle()関数の詳細については「こちら」を参照してください。
⑸ SetIndexShift()とは
SetIndexShift()とは、MQL4であらかじめ定義されている関数で、インジケーターの描画位置のシフト（ずらす）を設定するものです。
SetIndexShift()関数の詳細については「こちら」を参照してください。
⑹ SetIndexDrawBegin()とは
SetIndexDrawBegin()とは、MQL4であらかじめ定義されている関数で、インジケーターの描画を開始するバーの位置を指定するものです。
SetIndexDrawBegin()関数の詳細については「こちら」を参照してください。
６．具体的な処理内容
「Span Model.mq4」のstart()関数内に記述したコードについて解説します。
⑴ int limit = ……について
「limt」という変数を、「Bars－IndicatorCounted()」を初期値として宣言しています。
当該コードの詳細については「こちら」を参照してください。
⑵ カウンタ変数の宣言
for()文（詳細は「こちら」を参照してください。）を使用して転換線、基準線、雲、遅行線の計算を行うので、あらかじめカウンタ変数（for()文による繰り返し処理を行う回数を格納する変数）として、int型の変数「i」を宣言しています。
⑶ 転換線の値の計算
スパンモデルにおける雲を形成している先行スパンＡの値は、以下の計算式により算出されます。
（転換線の値＋基準線の値）÷２
したがって、先行スパンＡの値を算出するためには、あらかじめ転換線の値を算出しておく必要があります。
そして、転換線の値は、以下の計算式により算出されます。
（過去９日間の最高値＋過去９日間の最安値）÷２
ア for()文による繰り返し処理
for()文の詳細については「こちら」を参照してください。
イ 過去９日間の最高値の算出
- iHighest()関数（詳細は「こちら」を参照してください。）を使用して、過去９日間（＝変数「Change_Peirod」で指定済み）の最高値を示現したバーのインデックスを取得する。
- 当該値を配列High[]（詳細は「こちら」を参照してください。）に格納して、過去９日間の最高値を取得する。
ウ 過去９日間の最安値の算出
- iLowest()関数（詳細は「こちら」を参照してください。）を使用して、過去９日間（＝変数「Change_Peirod」で指定済み）の最安値を示現したバーのインデックスを取得する。
- 当該値を配列Low[]（詳細は「こちら」を参照してください。）に格納して、過去９日間の最高値を取得する。
⑶ 基準線の値の計算
スパンモデルにおける雲を形成している先行スパンＡの値は、以下の計算式により算出されます。
（転換線の値＋基準線の値）÷２
したがって、先行スパンＡの値を算出するためには、あらかじめ基準線の値を算出しておく必要があります。
そして、基準線の値は、以下の計算式により算出されます。
（過去26日間の最高値＋過去26日間の最安値）÷２
これは、転換線の値を算出する際の、「過去９日間」を「過去26日間」に変更したものにすぎません。
そこで、上記⑵と同様の処理を、iHighest()関数及びiLowest()関数の第４引数を「Change_Period」から「Standard_Period」に変更して行っています。
⑷ 雲の値の計算
ア 先行スパンＡの値の計算（ライン）
先行スパンＡの値は、以下の計算式により算出されます。
（転換線の値＋基準線の値）÷２
そこで、上記⑵及び⑶で算出した転換線の値（配列Change[]に格納済み）と基準線の値（配列Standard[]に格納済み）を用いて、以下のように記述して、先行スパンＡの値を配列Span_A_L[]に格納しています。
Span_A_L[i] = (Change[i] + Standard[i]) / 2;
イ 先行スパンＢの値の計算（ライン）
先行スパンＢの値は、以下の計算式により算出されます。
（過去52日間の最高値＋過去52日間の最安値）÷２
そこで、上記上記⑵及び⑶と同様に、以下のように記述して、先行スパンＢの値を配列Span_B_L[]に格納しています。
Span_B_L[i] = (High[iHighest(NULL,0,MODE_HIGH,Span_B_Period,i)] + Low[iLowest(NULL,0,MODE_LOW,Span_B_Period,i)]) / 2;
ウ 先行スパンＡの値の計算（ヒストグラム）
上記アと同様です。
エ 先行スパンＢの値の計算（ヒストグラム）
上記イと同様です。
なお、上記ウ及びエの処理を行うことによって、同一の場所に先行スパンＡの値を表すヒストグラムと、先行スパンＢの値を表すヒストグラムが描画されることになりますが、それによって雲が描画されることになる原理については、「こちら」を参照してください。
⑸ 遅行線の値の計算
遅行線は、各バーの終値を結んだ線を、26日分前にずらして描画しているにすぎません。
したがって、以下のように記述して、遅行線の値を配列Delay[]に格納しています。
Delay[i] = Close[i];
- 配列Close[]の詳細については「こちら」を参照してください。
