기존 그룹에 있는 프로세스의 하위 집합을 포함하는 새 그룹을 만듭니다.
구문
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 연결된 그룹입니다.
요구 사항
제품 |
HHPC 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 |