インジケーター
MT5 インジケーターの構築: バッファー、OnCalculate、信頼性の高い再計算

説明できる値から始める
便利なカスタム インジケーターには、魅力的な色を付ける前に正確な契約が必要です。この例では、現在の終値が最後の N バーの最高値から最高値から最低値までの範囲内のどこに位置するかをレポートします。 0 から 100 までの数値を 1 つ生成するか、ウィンドウが不完全な場合は空の値を生成します。命令は送信されません。これにより、計算、表示、検証を個別の責任として学習するのに適しています。
契約を明示的に作成します。チャート シンボルと時間枠を使用し、計算されるバーを含め、レンジを確立するために終値ではなく高値と安値を使用し、フラット ウィンドウの場合は 50 を返します。終値が自身のバーの高値と安値の範囲外にある場合は、調査すべき入力が一貫していないため、出力を黙ってクランプする理由にはなりません。これらの決定はインジケーターの名前よりも重要です。
計算は 100 × (終値 − 最低安値) / (最高値 − 最低安値) です。これは範囲位置の指導例であり、平滑化された確率的インジケーターを再現すると主張するものではありません。後でスムージングを追加する場合は、数式とそのウォームアップ要件をバージョン管理します。
計算と描画のコントラクトを分けてください
1 つのデータ バッファーと 1 つの折れ線プロットを使用します。端末はバインドされたバッファのサイズを所有します。コードは値を提供します。バインド後およびループで使用される入力配列に対して、最も古いものから順のインデックス付けを明示的に選択します。次に、インデックス i は高値、安値、終値にわたる同じバーを参照します。この規則を位置ベースの CopyBuffer リクエストと混合しないでください。位置 0 は現在のバーを意味します。
最初の N-1 セルには完全なウィンドウがありません。それらに EMPTY_VALUE を与え、プロットの空の値プロパティを同じセンチネルに設定します。ゼロは有効な範囲位置の結果であり、「準備ができていません」と重複することはできません。 PLOT_DRAW_BEGIN はプレゼンテーションを制御しますが、使用できないセルを明示的に初期化すると、データ コントラクトの検査も容易になります。
インジケーター バッファーのインデックスは 0 から始まりますが、indicator_type1 などの宣言サフィックスは最初のプロットを参照します。データ バッファーとプロットの両方を文書化します。これらは交換可能な識別子ではありません。
完全な教育実装
MetaEditor でカスタム インジケーターを作成し、次のオリジナルの例をソースとして使用します。このコードでは、再計算された各バーに対して透過的な O(N) スキャンを意図的に使用しています。これは、端末で検査してコンパイルするためのリファレンス実装であり、コンパイルされた配信パッケージやベンチマーク要求ではありません。
#property indicator_separate_window
#property indicator_buffers 1
#property indicator_plots 1
#property indicator_label1 "Range position"
#property indicator_type1 DRAW_LINE
#property indicator_color1 clrRoyalBlue
#property indicator_minimum 0
#property indicator_maximum 100
input int Period = 14;
double RangePosition[];
int OnInit()
{
if(Period < 2) return INIT_PARAMETERS_INCORRECT;
if(!SetIndexBuffer(0, RangePosition, INDICATOR_DATA))
return INIT_FAILED;
ArraySetAsSeries(RangePosition, false);
PlotIndexSetInteger(0, PLOT_DRAW_BEGIN, Period - 1);
PlotIndexSetDouble(0, PLOT_EMPTY_VALUE, EMPTY_VALUE);
IndicatorSetInteger(INDICATOR_DIGITS, 2);
return INIT_SUCCEEDED;
}
int OnCalculate(const int rates_total,
const int prev_calculated,
const datetime &time[],
const double &open[],
const double &high[],
const double &low[],
const double &close[],
const long &tick_volume[],
const long &volume[],
const int &spread[])
{
ArraySetAsSeries(high, false);
ArraySetAsSeries(low, false);
ArraySetAsSeries(close, false);
bool reset = (prev_calculated <= 0 || prev_calculated > rates_total);
if(reset) ArrayInitialize(RangePosition, EMPTY_VALUE);
if(rates_total < Period) return 0;
int start = reset ? Period - 1 : MathMax(Period - 1, prev_calculated - 1);
for(int i = start; i < rates_total; ++i)
{
double hi = high[i], lo = low[i];
for(int j = i - Period + 1; j < i; ++j)
{
hi = MathMax(hi, high[j]);
lo = MathMin(lo, low[j]);
}
RangePosition[i] = (hi == lo) ? 50.0 :
100.0 * (close[i] - lo) / (hi - lo);
}
return rates_total;
}
4 つの再計算ケースを理解します。
最初のロード時に、すべての完全なウィンドウを計算します。同じバーの別のティック中に、最後のバーを再計算します。その高値、安値、終値は変化する可能性があります。新しいバーが到着すると、以前の最後のバーを再計算し、新しいバーを計算します。履歴変更後に端末が prev_calculated をリセットすると、古いプレフィックスを信頼するのではなく、結果を再構築します。このリセット動作については、OnCalculate リファレンスで説明しています。
rates_total を返すと、次の呼び出しに処理された量がわかります。現在のバーが最終的なものになるわけではありません。クローズドバー値を必要とするコンシューマは、適切なクローズドタイムスタンプを選択します。このコントラクトでは、未終了のローソク足の間にプロットされた最後のポイントが移動することが想定されています。
ウィンドウから出ていくバーも処理しない限り、キャッシュされた最高値のみを維持して最適化しないでください。単調なキューは作業を減らすことができますが、履歴のリセット、等高値、および現在の足のリビジョンはすべて明示的な処理が必要になります。より高速なアルゴリズムを導入する場合は、この単純なバージョンを数値のオラクルとして保持してください。
小さな数値テストデータで検証します
N=3 で最も古いバーから順に使用します。高値を [12,13,14,15]、安値を [8,9,10,11]、終値を [10,12,13,11] とします。最初の 2 つの出力は空です。インデックス 2 の範囲は 8 ~ 14 で、結果は 83.333333 になります。インデックス 3 では、ウィンドウは 9 ~ 15 の範囲に進み、結果は 33.333333 になります。これらは合成算術の例であり、市場結果ではありません。
次に、最後の終値のみを 11 から 14 に変更します。最後の出力のみが 83.333333 に変更されます。すべての価格が等しいフラット 3 バー ウィンドウでは 50 が生成されます。入力期間 1 をテストし、初期化でそれが拒否されることを確認します。 3 つ未満のバーをテストし、インジケーターが製造されたゼロ信号を示していないことを確認します。
同じテストデータ上でフル パスと増分パスを比較します。次に、古いバーを先頭に追加して、新しい計算を強制します。変更されたウォームアップ領域を考慮して、タイムスタンプによって出力を比較します。視覚的に滑らかな線だけでは、これらのプロパティを確立するには十分ではありません。
空白または誤解を招くプロットを診断する
何も表示されない場合は、初期化結果、利用可能なバー、プロット タイプ、空の値の設定、およびエキスパート/ジャーナル メッセージを確認してください。データ ウィンドウを使用して、スタイルによって非表示になっている有効な値と、計算されていないセルを区別します。契約にはその範囲があるため、ここでは 0 ~ 100 の固定スケールが適切です。
後で EA リーダーを追加するときは、バッファ 0 が売買シグナルではなく数値範囲のポジションであることを文書化してください。選択したバーのタイムスタンプを各値とともに記録します。失敗したコピーは、欠落した観測値のままでなければなりません。これにより、表示のバグ、データ準備の問題、取引ルールの決定が 1 つのあいまいな「インジケーターが機能しない」レポートにまとめられることがなくなります。
練習用ファイル
これらのCSVファイルは学習用の合成データであり、実際の市場データや投資結果ではありません。
この記事のMQ5サンプルは、MT5でのコンパイルや実行の検証を行っていません。
















