Compartir a través de


función MPI_Group_difference

Crea un nuevo grupo a partir de la diferencia entre dos grupos existentes.

Sintaxis

int MPIAPI MPI_Group_difference(
        MPI_Group group1,
        MPI_Group group2,
  _Out_ MPI_Group *newgroup
);

Parámetros

  • group1
    Primer grupo.

  • group2
    Segundo grupo.

  • newgroup [out]
    Puntero a un identificador que representa un nuevo grupo que contiene todos los elementos del primer grupo que no están presentes en el segundo grupo. La función devuelve MPI_GROUP_EMPTY si el nuevo grupo está vacío.

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_GROUP_DIFFERENCE(GROUP1, GROUP2, NEWGROUP, IERROR)
        INTEGER GROUP1, GROUP2, NEWGROUP, IERROR 

Comentarios

Se trata de una operación local. Los distintos procesos pueden definir grupos distintos. Un proceso puede definir un grupo que no se incluye a sí mismo.

La implementación de MPI no proporciona un mecanismo para crear un grupo desde cero, sino solo desde grupos existentes. El grupo base, en el que se definen todos los demás grupos, se puede recuperar mediante la función MPI_Comm_group . Es el grupo asociado al comunicador inicial MPI_COMM_WORLD.

Requisitos

Producto

Paquete redistribuible de HPC Pack 2012 MS-MPI, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o HPC Pack 2008 Client Utilities

Encabezado

Mpi.h; Mpif.h

Biblioteca

Msmpi.lib

Archivo DLL

Msmpi.dll

Consulte también

Funciones de grupo de MPI

MPI_Comm_group