MPI_Iallgather función

Artículo
12/27/2023

Recopila datos de todos los miembros de un grupo y envía los datos a todos los miembros del grupo de forma no bloqueada.

Sintaxis

int MPIAPI MPI_Iallgather(
  _In_opt_  const void         *sendbuf,
  _In_             int         sendcount,
  _In_            MPI_Datatype sendtype,
  _Out_opt_       void         *recvbuf,
  _In_            int          recvcount,
  _In_            MPI_Datatype recvtype,
  _In_            MPI_Comm     comm,
  _Out_           MPI_Request  *request
);

Parámetros

sendbuf [in, opcional]
Puntero a los datos que se van a enviar a todos los procesos del grupo. El número y el tipo de datos de los elementos del búfer se especifican en los parámetros sendcount y sendtype . Cada elemento del búfer corresponde a un proceso del grupo.

Si el parámetro comm hace referencia a un intracomunicador, puede especificar una opción local especificando MPI_IN_PLACE en todos los procesos. Los parámetros sendcount y sendtype se omiten. Cada proceso escribe datos en el elemento de búfer de recepción correspondiente. El nºproceso envía datos al nºelemento del búfer de recepción.
sendcount [in]
Número de elementos del búfer especificado en el parámetro sendbuf . Si sendcount es cero, la parte de datos del mensaje está vacía.
sendtype [in]
Tipo de datos MPI de los elementos del búfer de envío.
recvbuf [out, optional]
Puntero a un búfer que contiene los datos que se reciben de cada proceso. El número y el tipo de datos de los elementos del búfer se especifican en los parámetros recvcount y recvtype .
recvcount [in]
Número de elementos del búfer de recepción. Si el recuento es cero, la parte de datos del mensaje está vacía.
recvtype [in]
El tipo de datos MPI de los elementos del búfer de recepción.
comm [in]
Identificador del comunicador MPI_Comm.
request [out]
Identificador de MPI_Request que representa la operación de comunicación.

Valor devuelto

Devuelve MPI_SUCCESS si se realiza correctamente. De lo contrario, el valor devuelto es un código de error.

En Fortran, el valor devuelto se almacena en el parámetro IERROR .

Fortran

    MPI_IALLGATHER(SENDBUF, SENDCOUNT, SENDTYPE, RECVBUF, RECVCOUNT, RECVTYPE, COMM, REQUEST, IERROR)
        <type> SENDBUF(*), RECVBUF(*)
        INTEGER SENDCOUNT, SENDTYPE, RECVCOUNT, RECVTYPE, COMM, REQUEST, IERROR

Comentarios

Una llamada sin bloqueo inicia una operación de reducción colectiva que debe completarse en una llamada de finalización independiente. Una vez iniciada, la operación puede avanzar independientemente de cualquier cálculo u otra comunicación en los procesos participantes. De esta manera, las operaciones de reducción sin bloqueo pueden mitigar los posibles efectos de sincronización de las operaciones de reducción mediante su ejecución en "segundo plano".

Todas las llamadas de finalización (por ejemplo, MPI_Wait) se admiten para las operaciones de reducción de no bloqueo.