función MPI_Group_range_excl
Crea un nuevo grupo quitando procesos de un grupo existente.
Sintaxis
int MPIAPI MPI_Group_range_excl(
MPI_Group group,
int n,
_In_count_(n) int ranges[][3],
_Out_ MPI_Group *newgroup
);
Parámetros
group
Grupo existente.n
Número de intervalos de procesos que se van a excluir del nuevo grupo.Gamas
Matriz de especificaciones de procesos que se van a excluir del grupo existente. Cada elemento de la matriz especifica un intervalo de proceso en forma de tres enteros para el primer rango, la última clasificación y el intervalo.newgroup [out]
Puntero a un identificador que representa el nuevo grupo que contiene los procesos que no se han excluido. Se conserva el orden del grupo.
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_RANGE_EXCL(GROUP, N, RANGES, NEWGROUP, IERROR)
INTEGER GROUP, N, RANGES(3,*), NEWGROUP, IERROR
Comentarios
Cada clasificación calculada debe ser una clasificación válida en el grupo existente y todas las clasificaciones calculadas deben ser distintas; de lo contrario, la función devuelve un error.
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 |