MPI_Iscatter関数

[アーティクル]
09/28/2023

1 つのメンバーからグループのすべてのメンバーに非ブロッキングの方法でデータを分散します。この関数は、 MPI_Igather関数によって実行される演算の逆関数を実行します。

構文

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

パラメーター

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

このパラメーターは、ルート以外のすべてのプロセスでは無視されます。

comm パラメーターがコマンド内を参照している場合は、ルートプロセスで MPI_IN_PLACE を指定することでインプレースオプションを指定できます。 recvcount パラメーターと recvtype パラメーターは無視されます。分散ベクトルは、 n 個のセグメントを含んでいると見なされます。 ここで、n はグループサイズです。ルートプロセスに対応するセグメントは移動されません。
sendcount [in]
送信バッファー内の要素の数。 sendcount が 0 の場合、メッセージのデータ部分は空です。

このパラメーターは、ルート以外のすべてのプロセスでは無視されます。
sendtype [in]
バッファー内の各要素のデータ型。

このパラメーターは、ルート以外のすべてのプロセスでは無視されます。
recvbuf [out, optional]
各プロセスで受信されるデータを含むバッファーへのハンドル。バッファー内の要素の数値とデータ型は、 recvcount パラメーターと recvtype パラメーターで指定されます。
recvcount [in]
受信バッファー内の要素の数。カウントが 0 の場合、メッセージのデータ部分は空です。
recvtype [in]
受信バッファー内の要素の MPI データ型。
root [in]
指定したコミュニケーター内の受信プロセスのランク。
comm [in]
MPI_Comm コミュニケーターハンドル。
request [out]
通信操作を表す MPI_Request ハンドル。

戻り値

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

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

Fortran

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

注釈

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

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