Dela via


funktionen MPI_Allreduce

Kombinerar värden från alla processer och distribuerar resultatet tillbaka till alla processer.

Syntax

int MPIAPI MPI_Allreduce(
  _In_opt_  const void         *sendbuf,
  _Out_opt_       void         *recvbuf,
  _In_            int          count,
  _In_            MPI_Datatype datatype,
  _In_            MPI_Op       op,
  _In_            MPI_Comm     comm
);

Parametrar

  • sendbuf [in, valfritt]
    Pekaren till de data som ska skickas till alla processer i gruppen. Antalet och datatypen för elementen i bufferten anges i parametrarna count och datatype.

    Om kommaparametern refererar till en intracommunicator kan du ange ett alternativ på plats genom att ange MPI_IN_PLACE i alla processer. I det här fallet tas indata vid varje process från mottagarbufferten, där de ersätts av utdata.

  • 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]
    MPI_Datatype för varje element i bufferten. Den här parametern måste vara kompatibel med åtgärden enligt vad som anges i op-parametern .

  • op [in]
    Den MPI_Op hantera som anger den globala minskningsåtgärd som ska utföras. Handtaget kan indikera en inbyggd eller programdefinierad åtgärd. En lista över fördefinierade åtgärder finns i MPI_Op.

  • comm [in]
    MPI_Comm communicator-handtaget.

Returvärde

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

I Fortran lagras returvärdet i parametern IERROR .

Fortran

    MPI_ALLREDUCE(SENDBUF, RECVBUF, COUNT, DATATYPE, OP, COMM, IERROR)
        <type> SENDBUF(*), RECVBUF(*)
        INTEGER COUNT, DATATYPE, OP, COMM, IERROR

Kommentarer

Om kommunikation är en intercommunicator lagras resultatet av minskningen av data som tillhandahålls av processer i grupp A vid varje process i grupp B och vice versa. Båda grupperna bör ange argument för antal och datatyper som anger samma typsignatur.

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

Krav

Produkt

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package eller HPC Pack 2008 Client Utilities

Huvud

Mpi.h; Mpif.h

Bibliotek

Msmpi.lib

DLL

Msmpi.dll

Se även

Kollektiva MPI-funktioner

MPI_Reduce

MPI_Datatype

MPI_Op