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での実行手順

  1. MetaEditorで新規カスタムインディケータ「ForceSmoothedOnArray」を作成し、上のコードを貼り付ける
  2. F7キーでコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
  3. チャートにドラッグし、サブウィンドウに点線(元のiForce)と実線(平滑化後)の2本が表示されることを確認する
  4. 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段階の設計を覚えておけば、

自作の指標を平滑化する場面に応用できます。

くわしい自動化の開示方針は編集方針ページもご覧ください。

関連記事