MPI_Group_range_excl関数
既存のグループからプロセスを削除して、新しいグループを作成します。
構文
int MPIAPI MPI_Group_range_excl(
MPI_Group group,
int n,
_In_count_(n) int ranges[][3],
_Out_ MPI_Group *newgroup
);
パラメーター
group
既存のグループ。n
新しいグループから除外するプロセスの範囲の数。範囲
既存のグループから除外するプロセスの仕様の配列。 配列の各要素は、最初のランク、最後のランク、ストライドの 3 つの整数の形式でプロセスの範囲を指定します。newgroup [out]
除外されなかったプロセスを含む新しいグループを表すハンドルへのポインター。 グループの順序は保持されます。
戻り値
成功 したMPI_SUCCESS を返します。 それ以外の場合、戻り値はエラー コードです。
Fortran では、戻り値は IERROR パラメーターに格納されます。
Fortran
MPI_GROUP_RANGE_EXCL(GROUP, N, RANGES, NEWGROUP, IERROR)
INTEGER GROUP, N, RANGES(3,*), NEWGROUP, IERROR
注釈
計算された各ランクは、既存のグループ内の有効なランクである必要があり、計算されたすべてのランクは個別である必要があります。それ以外の場合、関数はエラーを返します。
これはローカル操作です。 異なるプロセスで個別のグループを定義できます。 プロセスは、それ自体を含まないグループを定義できます。
MPI 実装では、グループを最初から構築するメカニズムは提供されず、既存のグループからのみ作成できます。 他のすべてのグループが定義されている基本グループは、 MPI_Comm_group 関数を使用して取得できます。 初期コミュニケーター MPI_COMM_WORLDに関連付けられているグループです。
要件
製品 |
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 |