iMA()やiRSI()は、通貨ペアと時間軸を指定して、
価格データから移動平均やRSIを計算する関数です。
ですが、「他のインジケーターの計算結果」や、
「自分で計算した配列」にも同じ移動平均・RSIを適用したい場面があります。
この記事では、価格データを直接取得しない
iMAOnArray()・iRSIOnArray()の使い方を解説します。
・iMA/iRSIとiMAOnArray/iRSIOnArrayの役割の違い
・『配列を直接渡す』関数ならではの引数構成
・既刊iForceの値をさらに平滑化するサンプルコード
・totalに0を渡す意味とshiftの数え方の落とし穴
iMA・iRSIとiMAOnArray・iRSIOnArrayの違い
まず、2系統の関数の役割分担を整理します。
iMA・iRSIは「価格」しか計算対象にできない
既刊iRSI系記事で解説した通り、
iMA()・iRSI()は通貨ペア名・時間軸・適用価格(Close等)を指定し、
MT4が内部で管理する価格データに対して計算します。
OnArray版は「配列」そのものを受け取る
・iMAOnArray/iRSIOnArrayは通貨ペア名も時間軸も指定しない
・引数に渡した配列の中身をそのまま計算対象にする
・価格の配列を渡せば通常のiMA/iRSIとほぼ同じ結果になる
つまり、価格の配列だけでなく、
既刊iforce-mt4.mdのようなオシレーターの出力値を配列に保存し、
その配列をiMAOnArray()に渡せば、
「オシレーターをさらに平滑化する」という応用ができます。
この性質がどんな場面で役立つか
価格以外のデータの傾向を見たい場面、
たとえば複数ペアの強弱スコアや自作の指標値を
平滑化・RSI化したいときに、
MA・RSIの計算ロジックを自分で書き直す必要がなくなります。
iMAOnArrayのシグネチャ
公式リファレンスで引数の意味を確認します。
シグネチャ
公式リファレンス(iMAOnArray)によると、シグネチャは次の通りです。
double iMAOnArray( double array[], //計算対象の配列 int total, //配列の要素数(0なら配列全体) int ma_period, //移動平均の期間 int ma_shift, //MAシフト int ma_method, //計算方法(SMA/EMA等) int shift //何個前のインデックスを取得するか );
totalに0を渡す意味
・totalに0を渡すと配列全体を計算対象にする
・要素数の一部だけ使いたい場合は正確な件数を渡す
・配列の実際のサイズより大きい値を渡すと範囲外エラーの原因になる
iRSIOnArrayのシグネチャ
RSI版の引数も、同じ考え方で確認します。
シグネチャ
公式リファレンス(iRSIOnArray)によると、シグネチャは次の通りです。
double iRSIOnArray( double array[], //計算対象の配列 int total, //配列の要素数(0なら配列全体) int period, //RSIの計算期間 int shift //何個前のインデックスを取得するか );
iMAOnArrayとの引数構成の違い
iRSIOnArray()にはma_method・ma_shiftに相当する引数がなく、
iMAOnArray()より引数が2つ少ない点に注意してください。
RSIの計算方法自体には選択肢がないため、
このような差になっています。
実際に動くコード全体:iForceの値を平滑化するインジケーター
既刊iForce記事のゼロクロス判定は、
1本単位の値を見るためノイズに反応しやすい設計でした。
ここではiForceの値を配列に保存し、
iMAOnArray()で平滑化したラインを追加で表示します。
//+------------------------------------------------------------------+
//| ForceSmoothedOnArray.mq4 |
//| Copyright 2026, FX-EA System Project Creator |
//| https://creator.fx-ea-system-project.com/ |
//+------------------------------------------------------------------+
#property strict
#property indicator_separate_window
#property indicator_buffers 2
#property indicator_plots 2
input int InpForcePeriod = 13; //iForceの計算期間
input int InpSmoothPeriod = 5; //平滑化の移動平均期間
double ForceBuffer[];
double SmoothedBuffer[];
//+------------------------------------------------------------------+
int OnInit()
{
SetIndexBuffer(0, ForceBuffer);
SetIndexBuffer(1, SmoothedBuffer);
SetIndexStyle(0, DRAW_LINE, STYLE_DOT, 1, clrGray);
SetIndexStyle(1, DRAW_LINE, STYLE_SOLID, 2, clrBlue);
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[])
{
if(rates_total < InpForcePeriod + InpSmoothPeriod)
return(0);
int start = (prev_calculated > 0) ? rates_total - prev_calculated : rates_total - InpForcePeriod - 1;
//1. まずiForceの値を1本ずつ計算してバッファに保存する
for(int i = start; i >= 0; i--)
ForceBuffer[i] = iForce(NULL, 0, InpForcePeriod, MODE_SMA, PRICE_CLOSE, i);
//2. 保存した配列をそのままiMAOnArrayに渡して平滑化する
for(int i = start; i >= 0; i--)
SmoothedBuffer[i] = iMAOnArray(ForceBuffer, 0, InpSmoothPeriod, 0, MODE_SMA, i);
return(rates_total);
}
//+------------------------------------------------------------------+
ForceBuffer自体はインジケーターバッファのため、
価格配列と同じ`AS_SERIES`の並び順を持ち、
iMAOnArray()にそのまま渡せます。
MetaEditorでの実行手順
- MetaEditorで新規カスタムインディケータ「ForceSmoothedOnArray」を作成し、上のコードを貼り付ける
- F7キーでコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
- チャートにドラッグし、サブウィンドウに点線(元のiForce)と実線(平滑化後)の2本が表示されることを確認する
- InpSmoothPeriodを変えて、平滑化の強さが変わることを確認する
なぜ一度バッファに保存してから渡すのか
iMAOnArray()は配列を直接受け取る関数のため、
iForce()の呼び出し結果を1度配列に保存してから、
その配列を渡すという2段階の処理になります。
iMA()のように「時間軸と期間だけ指定すれば完結する」関数とは、
この2段階構成が最大の違いです。
よくあるエラーと注意点
実装でつまずきやすいポイントをまとめます。
shiftの数え方を配列のインデックスと混同する
・shiftは配列の添字(インデックス)ではなく『何個前か』を表す
・AS_SERIESの配列ではshift=0が最新、1が1個前になる
・渡す配列の並び順がAS_SERIESかどうかを必ず確認する
totalの値が配列の実サイズと合っていない
totalに配列の実際のサイズより大きい値を渡すと、
範囲外の要素を読もうとしてエラーの原因になります。
ArraySize()で取得した値、または0(配列全体)を渡してください。
価格データをそのまま渡すならiMA/iRSIで十分
価格データだけを対象にするなら、
OnArray版を使う必要はなく、
既刊のiMA()・iRSI()をそのまま使う方がシンプルです。
よくある質問
iMAOnArray・iRSIOnArrayについて、よく検索される疑問に回答します。
MQL5にもOnArray版の関数はありますか?
MQL5にはiMAOnArray/iRSIOnArrayという同名の関数はありません。
MQL5では既刊CopyBuffer等でデータを配列に取得した後、
自分で計算ロジックを実装する設計に変わっています。
iBandsOnArray等、他の指標にも同じ仕組みがありますか?
はい、iATROnArrayやiBandsOnArray等、
複数のテクニカル指標関数にOnArray版が用意されています。
引数の考え方(配列・total・期間・shift)は共通です。
配列の要素数が少ないとどうなりますか?
ma_periodやperiodに対して配列の要素数が少なすぎる場合、
正しい計算結果が得られないか、0が返ることがあります。
十分な本数のデータを先に配列へ保存してください。
【MQL4】iMAOnArray・iRSIOnArrayで『価格以外の配列』にインジケーターを適用する方法について解説してみた(iMA・iRSIとの違い):まとめ
iMAOnArray()・iRSIOnArray()は、
通貨ペアや時間軸を指定する通常のiMA()・iRSI()とは違い、
価格以外の任意の配列にも同じ計算を適用できる関数です。
既刊iForceのようなオシレーターの出力値を、
いったん配列に保存してから渡すという2段階の設計を覚えておけば、
自作の指標を平滑化する場面に応用できます。
くわしい自動化の開示方針は編集方針ページもご覧ください。
コメント