MPI_Group_incl関数

既存のグループ内のプロセスのサブセットを含む新しいグループを作成します。

構文

int MPIAPI MPI_Group_incl(
        MPI_Group         group,
        int               n,
        _In_count_(n) int *ranks,
  _Out_ MPI_Group         *newgroup
);

パラメーター

• group
  既存のグループ。

• n
  ranks パラメーター内の要素の数と、新しいグループのサイズ。

• ランク
  新しいグループに含めるプロセス。

• newgroup [out]
  ranks パラメーターで指定された順序で含まれるプロセスを含む、新しいグループを表すハンドルへのポインター。

戻り値

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

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

Fortran

    MPI_GROUP_INCL(GROUP, N, RANKS, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR

注釈

この関数は、グループの要素の順序を変更するために使用できます。

これはローカル操作です。 異なるプロセスで個別のグループを定義できます。 プロセスは、それ自体を含まないグループを定義できます。

MPI 実装では、グループを最初から構築するメカニズムは提供されず、既存のグループからのみ作成できます。 他のすべてのグループが定義されている基本グループは、 MPI_Comm_group 関数を使用して取得できます。 初期コミュニケーター MPI_COMM_WORLDに関連付けられているグループです。

要件

こちらもご覧ください

MPI グループ関数

MPI_Comm_group