función MPI_Group_incl
Crea un nuevo grupo que contiene un subconjunto de los procesos de un grupo existente.
Sintaxis
int MPIAPI MPI_Group_incl(
MPI_Group group,
int n,
_In_count_(n) int *ranks,
_Out_ MPI_Group *newgroup
);
Parámetros
group
Grupo existente.n
El número de elementos del parámetro de clasificación y el tamaño del nuevo grupo.Filas
Los procesos que se incluirán en el nuevo grupo.newgroup [out]
Puntero a un identificador que representa el nuevo grupo, que contiene los procesos incluidos en el orden en que se especifican en el parámetro de clasificació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_GROUP_INCL(GROUP, N, RANKS, NEWGROUP, IERROR)
INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR
Comentarios
Esta función se puede usar para reordenar los elementos de un grupo.
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 |
HhPC Pack 2012 MS-MPI Redistributable Package, 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 |