次の方法で共有

MPI_Allgather関数

  • [アーティクル]

グループのすべてのメンバーからデータを収集し、グループのすべてのメンバーにデータを送信します。 MPI_Allgather関数はMPI_Gather関数に似ていますが、ルートのみにではなく、すべてのプロセスにデータを送信する点が除きます。 MPI_Allgatherの使用規則は、MPI_Gatherの規則に対応します。

構文

int MPIAPI MPI_Allgather(
  _In_  void         *sendbuf,
  _In_  int          sendcount,
  _In_  MPI_Datatype sendtype,
  _Out_ void         *recvbuf,
        int          recvcount,
        MPI_Datatype recvtype,
        MPI_Comm     comm
);

パラメーター

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

    comm パラメーターがコマンド内を参照している場合は、すべてのプロセスで MPI_IN_PLACEを指定することでインプレース オプションを指定できます。 sendcount パラメーターと sendtype パラメーターは無視されます。 各プロセスは、対応する受信バッファー要素にデータを入力します。 n番目のプロセスは、受信バッファーの n番目の要素にデータを送信します。

  • sendcount [in]
    sendbuf パラメーターで指定されたバッファー内の要素の数。 sendcount が 0 の場合、メッセージのデータ部分は空です。

  • sendtype [in]
    送信バッファー内の要素の MPI データ型。

  • recvbuf [out]
    各プロセスから受信したデータを含むバッファーへのポインター。 バッファー内の要素の数値とデータ型は、 recvcount パラメーターと recvtype パラメーターで指定されます。

  • recvcount
    受信バッファー内の要素の数。 カウントが 0 の場合、メッセージのデータ部分は空です。

  • recvtype
    受信バッファー内の要素の MPI データ型。

  • comm
    MPI_Comm コミュニケーター ハンドル。

戻り値

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

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

Fortran

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

注釈

プロセスの sendtype パラメーターに関連付けられている型シグネチャは、他のプロセスの recvtype パラメーターに関連付けられている型シグネチャと等しい必要があります。

comm パラメーターがコマンド内を参照している場合、 の呼び出しの結果は、すべてのプロセスが に対root = 0 , ..., n-1して MPI_ALLGATHER(...) n 個の 呼び出しをMPI_Gather(sendbuf,sendcount,sendtype,recvbuf,recvcount,recvtype,root,comm)実行した場合と同じになります。

comm パラメーターが相互通信子を参照している場合、1 つのグループの各プロセス (グループ A など) は、sendcount パラメーターで指定されたデータ項目の数を提供します。 このデータは連結され、結果は他のグループ、グループ B の各プロセスに格納されます。逆に、グループ B のプロセスのデータの連結は、グループ A の各プロセスに格納されます。グループ A の送信バッファー パラメーターは、グループ B の受信バッファー パラメーターと一致している必要があります。その逆も同様です。

グループ A のプロセスによって送信されるアイテムの数は、グループ B のプロセスによって送信されるアイテムの数と等しい必要はありません。特に、逆方向の通信に sendcount == 0 を指定することで、データを 1 方向にのみ移動できます。

要件

製品

HPC Pack 2012 MS-MPI 再頒布可能パッケージ、HPC Pack 2008 R2 MS-MPI 再頒布可能パッケージ、HPC Pack 2008 MS-MPI 再頒布可能パッケージまたは HPC Pack 2008 クライアント ユーティリティ

ヘッダー

 Mpi.h;Mpif.h

ライブラリ

 Msmpi.lib

[DLL]

 Msmpi.dll

こちらもご覧ください

MPI 集合関数

MPI_Datatype

MPI_Allgather