MPI_Iscatterv 함수

아티클
01/16/2024

구문

int MPIAPI MPI_Iscatterv(
  _In_opt_  const void         *sendbuf,
  _In_opt_  const int          sendcounts[],
  _In_opt_  const int          displs[],
  _In_            MPI_Datatype sendtype,
  _Out_opt_        void        *recvbuf,
  _In_            int          recvcount,
  _In_            MPI_Datatype recvtype,
  _In_            int          root,
  _In_            MPI_Comm     comm,
  _Out_           MPI_Request  *request
);

매개 변수

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

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

comm 매개 변수가 통신 내를 참조하는 경우 루트 프로세스에서 MPI_IN_PLACE 지정하여 현재 위치 옵션을 지정할 수 있습니다. recvcount 및 recvtype 매개 변수는 무시됩니다. 분산된 벡터는 여전히 n 세그먼트를 포함하는 것으로 간주됩니다. 여기서 n 은 그룹 크기입니다. 루트 프로세스에 해당하는 세그먼트는 이동되지 않습니다.
sendcounts[] [in, optional]
각 프로세스에 보낼 요소 수입니다. sendcounts[i]가 0이면 해당 프로세스에 대한 메시지의 데이터 부분이 비어 있습니다.

이 매개 변수는 루트가 아닌 모든 프로세스에 대해 무시됩니다.
displs[] [in, optional]
각 통신기 프로세스에 보낼 데이터의 위치입니다. 배열의 각 위치는 sendbuf 배열의 해당 요소를 기준으로 합니다.

sendbuf, sendcounts 및 displs 매개 변수 배열에서 각 배열의 n번째 요소는 n번째 통신기 프로세스로 보낼 데이터를 참조합니다.

이 매개 변수는 루트 프로세스에서만 중요합니다.
sendtype [in]
버퍼에 있는 각 요소의 데이터 형식입니다.

이 매개 변수는 루트가 아닌 모든 프로세스에 대해 무시됩니다.
recvbuf [out, optional]
각 프로세스에서 수신되는 데이터를 포함하는 버퍼에 대한 포인터입니다. 버퍼에 있는 요소의 수와 데이터 형식은 recvcount 및 recvtype 매개 변수에 지정됩니다.
recvcount [in]
수신 버퍼의 요소 수입니다. 개수가 0이면 메시지의 데이터 부분이 비어 있습니다.
recvtype [in]
수신 버퍼에 있는 요소의 데이터 형식입니다.
root [in]
지정된 전달자 내의 전송 프로세스에서 순위입니다.
comm [in]
MPI_Comm 커뮤니케이터 핸들입니다.
request [out]
통신 작업을 나타내는 MPI_Request 핸들입니다.

반환 값

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

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

Fortran

    MPI_ISCATTERV(SENDBUF, SENDCOUNTS, DISPLS, SENDTYPE, RECVBUF, RECVCOUNT, RECVTYPE, ROOT, COMM, REQUEST, IERROR)
        <type> SENDBUF(*), RECVBUF(*)
        INTEGER SENDCOUNTS(*), DISPLS(*), SENDTYPE, RECVCOUNT, RECVTYPE, ROOT, COMM, REQUEST, IERROR

설명

비차단 호출은 별도의 완료 호출에서 완료되어야 하는 집단 감소 작업을 시작합니다. 작업이 시작되면 참여 프로세스에서 계산 또는 기타 통신과 독립적으로 작업이 진행될 수 있습니다. 이러한 방식으로 비차단 감소 작업은 "백그라운드"에서 실행하여 감소 작업의 가능한 동기화 효과를 완화할 수 있습니다.

모든 완료 호출(예: MPI_Wait) 은 비차단 감소 작업에 대해 지원됩니다.