MPI_Allreduce関数

すべてのプロセスの値を結合し、結果をすべてのプロセスに分散します。

構文

int MPIAPI MPI_Allreduce(
  _In_opt_  const void         *sendbuf,
  _Out_opt_       void         *recvbuf,
  _In_            int          count,
  _In_            MPI_Datatype datatype,
  _In_            MPI_Op       op,
  _In_            MPI_Comm     comm
);

パラメーター

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

  comm パラメーターがコマンド内を参照している場合は、すべてのプロセスで MPI_IN_PLACE を指定することで、インプレース オプションを指定できます。 この場合、入力データは受信バッファーから各プロセスで取得され、出力データに置き換えられます。

• recvbuf [out, optional]
  削減操作の結果を受け取るバッファーへのポインター。 このパラメーターは、ルート プロセスでのみ重要です。

• count [in]
  このプロセスから送信する要素の数。

• datatype [in]
  バッファー内の各要素の MPI_Datatype 。 このパラメーターは、 op パラメーターで指定された操作と互換性がある必要があります。

• op [in]
  実行するグローバルな削減操作を示すMPI_Op ハンドル。 ハンドルは、組み込み操作またはアプリケーション定義操作を示すことができます。 定義済みの操作の一覧については、「 MPI_Op」を参照してください。

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

戻り値

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

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

Fortran

    MPI_ALLREDUCE(SENDBUF, RECVBUF, COUNT, DATATYPE, OP, COMM, IERROR)
        <type> SENDBUF(*), RECVBUF(*)
        INTEGER COUNT, DATATYPE, OP, COMM, IERROR

注釈

comm が相互通信器の場合、グループ A のプロセスによって提供されるデータの減少の結果は、グループ B の各プロセスに格納され、その逆も同様です。 どちらのグループも、同じ型シグネチャを指定する count 引数と datatype 引数を指定する必要があります。

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

要件

こちらもご覧ください

MPI 集合関数

MPI_Reduce

MPI_Datatype

MPI_Op