função MPI_Group_incl
Cria um novo grupo que contém um subconjunto dos processos num grupo existente.
Sintaxe
int MPIAPI MPI_Group_incl(
MPI_Group group,
int n,
_In_count_(n) int *ranks,
_Out_ MPI_Group *newgroup
);
Parâmetros
grupo
O grupo existente.n
O número de elementos no parâmetro ranks e o tamanho do novo grupo.classificações
Os processos a incluir no novo grupo.newgroup [out]
Um ponteiro para um identificador que representa o novo grupo, que contém os processos incluídos pela ordem em que são especificados no parâmetro ranks .
Valor devolvido
Devolve MPI_SUCCESS com êxito. Caso contrário, o valor devolvido é um código de erro.
Em Fortran, o valor devolvido é armazenado no parâmetro IERROR .
Fortran
MPI_GROUP_INCL(GROUP, N, RANKS, NEWGROUP, IERROR)
INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR
Observações
Esta função pode ser utilizada para reordenar os elementos de um grupo.
Esta é uma operação local. Diferentes processos podem definir grupos distintos. Um processo pode definir um grupo que não se inclui a si próprio.
A implementação do MPI não fornece um mecanismo para criar um grupo do zero, mas apenas a partir de grupos existentes. O grupo base, no qual todos os outros grupos são definidos, pode ser obtido com a função MPI_Comm_group . É o grupo que está associado ao MPI_COMM_WORLD do comunicador inicial.
Requisitos
Produto |
HHPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package ou HPC Pack 2008 Client Utilities |
Cabeçalho |
Mpi.h; Mpif.h |
Biblioteca |
Msmpi.lib |
DLL |
Msmpi.dll |