Função MPI_Group_incl

Cria um novo grupo que contém um subconjunto dos processos em um 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.

• Fileiras
  Os processos a serem incluídos no novo grupo.

• newgroup [out]
  Um ponteiro para um identificador que representa o novo grupo, que contém os processos incluídos na ordem em que eles são especificados no parâmetro ranks .

Retornar valor

Retorna MPI_SUCCESS em caso de êxito. Caso contrário, o valor retornado será um código de erro.

Em Fortran, o valor retornado é armazenado no parâmetro IERROR .

Fortran

    MPI_GROUP_INCL(GROUP, N, RANKS, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANKS(*), NEWGROUP, IERROR

Comentários

Essa função pode ser usada para reordenar os elementos de um grupo.

Essa é uma operação local. Processos diferentes podem definir grupos distintos. Um processo pode definir um grupo que não se inclui.

A implementação do MPI não fornece um mecanismo para criar um grupo do zero, mas apenas de grupos existentes. O grupo base, no qual todos os outros grupos são definidos, pode ser recuperado usando a função MPI_Comm_group . É o grupo associado ao MPI_COMM_WORLD do comunicador inicial.

Requisitos

Produto	Pacote Redistribuível HHPC Pack 2012 MS-MPI, Pacote Redistribuível HPC Pack 2008 R2 MS-MPI Pacote Redistribuível, Pacote Redistribuível HPC Pack 2008 MS-MPI ou Utilitários de Cliente HPC Pack 2008
parâmetro	Mpi.h; Mpif.h
Biblioteca	Msmpi.lib
DLL	Msmpi.dll

Confira também

Funções de grupo de MPI

MPI_Comm_group