다음을 통해 공유

MPI_Scatterv 함수

  • 아티클

한 멤버의 데이터를 그룹의 모든 멤버에 분산합니다. MPI_Scatterv 함수는 MPI_Gatherv 함수에서 수행하는 작업의 역방향을 수행합니다.

구문

int MPIAPI MPI_Scatterv(
  _In_  void         *sendbuf,
  _In_  int          *sendcounts,
  _In_  int          *displs,
        MPI_Datatype sendtype,
  _Out_ void         *recvbuf,
        int          recvcount,
        MPI_Datatype recvtype,
        int          root,
        MPI_Comm     comm
);

매개 변수

  • sendbuf [in]
    루트 프로세스에서 보낼 데이터가 포함된 버퍼에 대한 포인터입니다.

    sendbuf 매개 변수는 루트가 아닌 모든 프로세스에 대해 무시됩니다.

    comm 매개 변수가 명령 내 매개 변수를 참조하는 경우 루트 프로세스에서 MPI_IN_PLACE 지정하여 현재 위치 옵션을 지정할 수 있습니다. recvcount 및 recvtype 매개 변수는 무시됩니다. 분산된 벡터는 여전히 n 세그먼트를 포함하는 것으로 간주됩니다. 여기서 n 은 그룹 크기입니다. 루트 프로세스에 해당하는 세그먼트는 이동되지 않습니다.

  • sendcounts [in]
    각 프로세스에 보낼 요소의 수입니다. sendcount[i]가 0이면 해당 프로세스에 대한 메시지의 데이터 부분이 비어 있습니다.

    sendcount 매개 변수는 루트가 아닌 모든 프로세스에 대해 무시됩니다.

  • displs [in]
    각 통신기 프로세스에 보낼 데이터의 위치입니다. 배열의 각 위치는 sendbuf 배열의 해당 요소를 기준으로 합니다.

    sendbuf, sendcounts 및 displs 매개 변수 배열에서 각 배열의 n번째 요소는 n번째 전달자 프로세스로 전송될 데이터를 참조합니다.

    이 매개 변수는 루트 프로세스에서만 중요합니다.

  • sendtype
    버퍼에 있는 각 요소의 MPI 데이터 형식입니다.

    sendcount 매개 변수는 루트가 아닌 모든 프로세스에 대해 무시됩니다.

  • recvbuf [out]
    각 프로세스에서 수신되는 데이터가 포함된 버퍼에 대한 포인터입니다. 버퍼에 있는 요소의 수와 데이터 형식은 recvcount 및 recvtype 매개 변수에 지정됩니다.

  • recvcount
    수신 버퍼의 요소 수입니다. 개수가 0이면 메시지의 데이터 부분이 비어 있습니다.

  • recvtype
    수신 버퍼에 있는 요소의 데이터 형식입니다.

  • root
    지정된 통신기 내의 전송 프로세스의 순위입니다.

  • 통신
    MPI_Comm 통신기 핸들입니다.

반환 값

성공에 대한 MPI_SUCCESS 반환합니다. 그렇지 않으면 반환 값이 오류 코드입니다.

Fortran에서 반환 값은 IERROR 매개 변수에 저장됩니다.

Fortran

    MPI_SCATTERV(SENDBUF, SENDCOUNT, DISPLS, SENDTYPE, RECVBUF, RECVCOUNT, RECVTYPE, ROOT, COMM, IERROR)
        <type> SENDBUF(*), RECVBUF(*)
        INTEGER SENDCOUNT, SENDTYPE, DISPLS(*), RECVCOUNT(*), RECVTYPE, ROOT, COMM, IERROR

설명

MPI_Scatterv 함수는 sendcounts 배열에 지정된 다양한 데이터 수를 각 프로세스로 보낼 수 있도록 하여 MPI_Scatter 함수의 기능을 확장합니다.

개수, 형식 및 변위 사양으로 인해 루트의 위치를 두 번 이상 읽지 않아야 합니다.

모든 함수 매개 변수는 루트 프로세스에서 중요하며 recvbuf, recvcount, recvtype, root 및 comm 매개 변수만 다른 프로세스에서 중요합니다. 루트 및 comm 매개 변수는 모든 프로세스에서 동일해야 합니다.

sendcount에 지정된 형식 서명과 루트 프로세스의 sendtype 매개 변수는 recvcount에 지정된 형식 서명과 같아야 하며 모든 프로세스에 대한 recvtype 매개 변수는 같아야 합니다. 따라서 전송되는 데이터의 양은 모든 프로세스 쌍 간에 수신되는 데이터 양과 같아야 합니다. 발신자와 수신자 간의 고유 형식 맵은 여전히 허용됩니다.

comm이 인트라 커미토리인 경우 결과는 루트가 n 송신 작업을 MPI_Send(sendbuf + displs[i]*extent(sendtype), sendcounts[i], sendtype, I, …)실행한 것처럼 되며 각 프로세스는 수신 MPI_Recv(recvbuf, recvcount, recvtype, i,…)을 실행합니다.

comm 매개 변수가 상호 통신자를 참조하는 경우 호출에는 루트 프로세스를 정의하는 하나의 그룹 A 그룹이 있는 상호 통신기의 모든 프로세스가 포함됩니다. 다른 그룹 B의 모든 프로세스는 루트 매개 변수, 즉 그룹 A의 루트 프로세스 순위에서 동일한 값을 설정합니다. 루트 프로세스는 루트 매개 변수에 MPI_ROOT 값을 설정합니다. 그룹 A의 다른 모든 프로세스는 루트 매개 변수에 MPI_PROC_NULL 값을 설정합니다. 데이터는 루트 프로세스에서 그룹 B의 모든 프로세스로 브로드캐스트됩니다. 그룹 B에 있는 프로세스의 버퍼 매개 변수는 루트 프로세스의 버퍼 매개 변수와 일치해야 합니다.

요구 사항

제품

HPC 팩 2012 MS-MPI 재배포 가능 패키지, HPC 팩 2008 R2 MS-MPI 재배포 가능 패키지, HPC Pack 2008 MS-MPI 재배포 가능 패키지 또는 HPC 팩 2008 클라이언트 유틸리티

헤더

 Mpi.h; Mpif.h

라이브러리

 Msmpi.lib

DLL

 Msmpi.dll

추가 정보

MPI 집합 함수

MPI_Datatype

MPI_Gather

MPI_Gatherv

MPI_Scatter