MPI_Iallgather関数

[アーティクル]
12/27/2023

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

構文

int MPIAPI MPI_Iallgather(
  _In_opt_  const void         *sendbuf,
  _In_             int         sendcount,
  _In_            MPI_Datatype sendtype,
  _Out_opt_       void         *recvbuf,
  _In_            int          recvcount,
  _In_            MPI_Datatype recvtype,
  _In_            MPI_Comm     comm,
  _Out_           MPI_Request  *request
);

パラメーター

sendbuf [in, optional]
グループ内のすべてのプロセスに送信されるデータへのポインター。バッファー内の要素の数値とデータ型は、 sendcount パラメーターと sendtype パラメーターで指定されます。バッファー内の各要素は、グループ内のプロセスに対応します。

comm パラメーターがコマンド内を参照している場合は、すべてのプロセスで MPI_IN_PLACE を指定することでインプレースオプションを指定できます。 sendcount パラメーターと sendtype パラメーターは無視されます。各プロセスは、対応する受信バッファー要素にデータを入力します。 n番目のプロセスは、受信バッファーの n番目の要素にデータを送信します。
sendcount [in]
sendbuf パラメーターで指定されたバッファー内の要素の数。 sendcount が 0 の場合、メッセージのデータ部分は空です。
sendtype [in]
送信バッファー内の要素の MPI データ型。
recvbuf [out, optional]
各プロセスから受信したデータを含むバッファーへのポインター。バッファー内の要素の数値とデータ型は、 recvcount パラメーターと recvtype パラメーターで指定されます。
recvcount [in]
受信バッファー内の要素の数。カウントが 0 の場合、メッセージのデータ部分は空です。
recvtype [in]
受信バッファー内の要素の MPI データ型。
comm [in]
MPI_Comm コミュニケーターハンドル。
request [out]
通信操作を表す MPI_Request ハンドル。

戻り値

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

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

Fortran

    MPI_IALLGATHER(SENDBUF, SENDCOUNT, SENDTYPE, RECVBUF, RECVCOUNT, RECVTYPE, COMM, REQUEST, IERROR)
        <type> SENDBUF(*), RECVBUF(*)
        INTEGER SENDCOUNT, SENDTYPE, RECVCOUNT, RECVTYPE, COMM, REQUEST, IERROR

注釈

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

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