MPI_Iscatterv関数

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

構文

int MPIAPI MPI_Iscatterv(
  _In_opt_  const void         *sendbuf,
  _In_opt_  const int          sendcounts[],
  _In_opt_  const int          displs[],
  _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 はグループサイズです。ルートプロセスに対応するセグメントは移動されません。
sendcounts[] [in, optional]
各プロセスに送信する要素の数。 sendcounts[i] が 0 の場合、そのプロセスのメッセージのデータ部分は空です。

このパラメーターは、ルート以外のすべてのプロセスでは無視されます。
displs[] [in, optional]
各コミュニケータープロセスに送信するデータの場所。配列内の各位置は、 sendbuf 配列の対応する要素に対する相対位置です。

sendbuf、sendcounts、displs パラメーター配列では、各配列の n番目の要素は、n番目のコミュニケータープロセスに送信されるデータを参照します。

このパラメーターは、ルートプロセスでのみ重要です。
sendtype [in]
バッファー内の各要素のデータ型。

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

戻り値

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

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

Fortran

    MPI_ISCATTERV(SENDBUF, SENDCOUNTS, DISPLS, SENDTYPE, RECVBUF, RECVCOUNT, RECVTYPE, ROOT, COMM, REQUEST, IERROR)
        <type> SENDBUF(*), RECVBUF(*)
        INTEGER SENDCOUNTS(*), DISPLS(*), SENDTYPE, RECVCOUNT, RECVTYPE, ROOT, COMM, REQUEST, IERROR