funktionen MPI_Ireduce

Artikel
12/27/2023

Utför en global reduce-åtgärd (till exempel summa, maximum eller logisk och) för alla medlemmar i en grupp på ett icke-blockerande sätt.

Syntax

int MPIAPI MPI_Ireduce(
  _In_      void         *sendbuf,
  _Out_opt_ void         *recvbuf,
  _In_      int          count,
  _In_      MPI_Datatype datatype,
  _In_      MPI_Op       op,
  _In_      int          root,
  _In_      MPI_Comm     comm,
  _Out_     MPI_Request  *request
);

Parametrar

sendbuf [in]
Pekaren till en buffert som innehåller data från den här rangordningen som ska användas i reduceringen. Bufferten består av antal efterföljande element i MPI_Datatype som anges av datatypshandtaget . Meddelandelängden anges i termer av antal element, inte antal byte.
recvbuf [ut, valfritt]
Pekaren till en buffert för att ta emot resultatet av reduce-åtgärden. Den här parametern är bara viktig i rotprocessen.
count [in]
Antalet element som ska skickas från den här processen.
datatype [in]
Det MPI_Datatype hantera som representerar datatypen för varje element i sendbuf.
op [in]
Den MPI_Op hantera som anger den globala minskningsåtgärd som ska utföras. Handtaget kan indikera en inbyggd åtgärd eller en programdefinierad åtgärd. En lista över fördefinierade åtgärder finns i avsnittet MPI_Op .
root [in]
Rangordningen för den mottagande processen inom MPI_Commkommatecken.
comm [in]
MPI_Comm communicator-handtaget.
begäran [ut]
Den MPI_Request hantera som representerar kommunikationsåtgärden..

Returvärde

Returnerar MPI_SUCCESS vid lyckat resultat. Annars är returvärdet en felkod.

I Fortran lagras returvärdet i parametern IERROR .

Fortran

    MPI_IREDUCE(SENDBUF, RECVBUF, COUNT, DATATYPE, OP, ROOT, COMM, REQUEST, IERROR) 
        <type> SENDBUF(*), RECVBUF(*) 
        INTEGER COUNT, DATATYPE, OP, ROOT, COMM, REQUEST, IERROR

Kommentarer

Ett icke-blockerande anrop initierar en kollektiv minskningsåtgärd som måste slutföras i ett separat slutförandeanrop. När åtgärden har initierats kan den fortsätta oberoende av beräkningen eller annan kommunikation i deltagande processer. På så sätt kan icke-blockerande minskningsåtgärder minimera möjliga synkroniseringseffekter av minskningsåtgärder genom att köra dem i "bakgrunden".

Alla slutförandeanrop (t.ex. MPI_Wait) stöds för icke-blockerande minskningsåtgärder.