MPI_Group_range_incl función
Constructor de grupo que se usa para definir un nuevo grupo agregando conjuntos adicionales de clasificaciones a un grupo existente.
Sintaxis
int MPIAPI MPI_Group_range_incl(
MPI_Group group,
int n,
_In_count_(n) int ranges[][3],
_Out_ MPI_Group *newgroup
);
Parámetros
group
El grupo existente.n
Número de tripletos en intervalos de matrices.Gamas
Matriz de especificaciones de procesos que se van a incluir en el nuevo grupo. Cada elemento de la matriz especifica un intervalo de proceso en forma de tres enteros para la primera clasificación, la última clasificación y el intervalo.newgroup [out]
Puntero a un identificador que representa el nuevo grupo. El nuevo grupo contiene los conjuntos adicionales de rangos. El orden se define por intervalos.
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_INCL(GROUP, N, RANGES, NEWGROUP, IERROR)
INTEGER GROUP, N, RANGES(3,*), NEWGROUP, IERROR
Comentarios
Si los intervalos constan de los tripletes (primer1 , last1, stride1) , ..., (firstn, lastn, striden), entonces newgroup consta de la secuencia de procesos en grupo con las clasificaciones first1, first1 + stride1, ..., RoundDown((last1 - first1)/stride1)*stride1, ..., firstn, firstn + striden, ..., RoundDown((lastn - firstn)/striden)*striden.
Cada clasificación calculada debe ser una clasificación válida en el nuevo grupo y todas las clasificaciones calculadas deben ser distintas. De lo contrario, la función devuelve un error.
Nota
Tenga en cuenta que puede establecer primero[i] mayor que last[i] y stride[i] puede ser negativo, pero no puede ser cero.
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 |