그룹의 모든 멤버에서 데이터를 수집하고 그룹의 모든 멤버에게 데이터를 보냅니다. 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 데이터 형식입니다.통신
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 매개 변수가 통신 내를 참조하는 경우 에 대한 호출 MPI_ALLGATHER(...) 결과는 모든 프로세스가 에 대해 root = 0 , ..., n-1n개 호출을 MPI_Gather(sendbuf,sendcount,sendtype,recvbuf,recvcount,recvtype,root,comm) 실행한 것처럼 표시됩니다.
comm 매개 변수가 상호 통신자를 참조하는 경우 하나의 그룹(예: 그룹 A)의 각 프로세스는 sendcount 매개 변수에 지정된 데이터 항목 수를 기여합니다. 이 데이터는 연결되고 결과는 다른 그룹 B의 각 프로세스에 저장됩니다. 반대로 그룹 B에 있는 프로세스의 데이터의 연결은 그룹 A의 각 프로세스에 저장됩니다. 그룹 A의 송신 버퍼 매개 변수는 그룹 B의 수신 버퍼 매개 변수와 일치해야 하며 그 반대의 경우도 마찬가지입니다.
그룹 A의 프로세스에서 보내는 항목의 수는 그룹 B의 프로세스에서 보낸 항목 수와 같을 필요가 없습니다. 특히 통신의 sendcount == 0을 역방향으로 지정하여 데이터를 한 방향으로만 이동할 수 있습니다.
요구 사항
제품 |
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 |