MPI_Igatherv関数

[アーティクル]
11/01/2024

非ブロッキングの方法で、グループのすべてのメンバーから 1 つのメンバーに変数データを収集します。

構文

int MPIAPI MPI_Igatherv(
  _In_opt_  const void         *sendbuf,
  _In_            int          sendcount,
  _In_            MPI_Datatype sendtype,
  _Out_opt_       void         *recvbuf,
  _In_opt_  const int          recvcounts[],
  _In_opt_  const int          displs[],
  _In_            MPI_Datatype recvtype,
  _In_            int          root,
  _In_            MPI_Comm     comm,
  _Out_           MPI_Request  *request
);

パラメーター

sendbuf [in, optional]
ルートプロセスに送信されるデータを含むバッファーへのハンドル。

comm パラメーターがコマンド内を参照している場合は、すべてのプロセスで MPI_IN_PLACEを指定することでインプレースオプションを指定できます。 sendcount パラメーターと sendtype パラメーターは無視されます。各プロセスは、対応する受信バッファー要素にデータを入力します。 n番目のプロセスは、受信バッファーの n番目の要素にデータを送信します。ルートプロセスによって送信されるデータは、受信バッファー内の正しい場所にあると見なされます。
sendcount [in]
送信バッファー内の要素の数。 sendcount が 0 の場合、メッセージのデータ部分は空です。
sendtype [in]
バッファー内の各要素のデータ型。
recvbuf [out, optional]
ルートプロセスによって送信されるデータを含む、各プロセスから受信したデータを含むルートプロセス上のバッファーへのハンドル。このパラメーターは、ルートプロセスでのみ重要です。 recvbuf パラメーターは、ルート以外のすべてのプロセスでは無視されます。
recvcounts[] [in, optional]
各プロセスから受け取る要素の数。配列内の各要素は、送信プロセスのランクに対応します。カウントが 0 の場合、メッセージのデータ部分は空です。このパラメーターは、ルートプロセスでのみ重要です。
displs[] [in, optional]
各コミュニケータープロセスからのデータの recvbuf パラメーターに対する相対位置。プロセス j から受信したデータは、sendbuf ポインターからルートプロセスオフセット displs[j] 要素の受信バッファーに配置されます。

recvbuf、recvcounts、displs パラメーター配列では、各配列の n番目の要素は、n番目のコミュニケータープロセスから受信したデータを参照します。

このパラメーターは、ルートプロセスでのみ重要です。
recvtype [in]
バッファー内の各要素のデータ型。このパラメーターは、ルートプロセスでのみ重要です。
root [in]
指定したコミュニケーター内の受信プロセスのランク。
comm [in]
MPI_Comm コミュニケーターハンドル。
request [out]
通信操作を表す MPI_Request ハンドル。

戻り値

成功 したMPI_SUCCESS を返します。それ以外の場合、戻り値はエラーコードです。

Fortran では、戻り値は IERROR パラメーターに格納されます。

Fortran

    MPI_IGATHERV(SENDBUF, SENDCOUNT, SENDTYPE, RECVBUF, RECVCOUNTS, DISPLS, RECVTYPE,
    ROOT, COMM, REQUEST, IERROR)
        <type> SENDBUF(*), RECVBUF(*)
        INTEGER SENDCOUNT, SENDTYPE, RECVCOUNTS(*), DISPLS(*), RECVTYPE, ROOT, COMM, REQUEST, IERROR

注釈

非ブロッキング呼び出しは、個別の完了呼び出しで完了する必要がある集合的な削減操作を開始します。開始されると、参加プロセスでの計算やその他の通信とは無関係に操作が進行する可能性があります。このように、非ブロッキング削減操作では、"バックグラウンド" で実行することで、削減操作の同期効果を軽減できます。

非ブロッキング削減操作では、すべての完了呼び出し ( MPI_Wait など) がサポートされます。