função MPI_Group_range_incl

Um construtor de grupo usado para definir um novo grupo adicionando conjuntos adicionais de classificações a um grupo existente.

Sintaxe

int MPIAPI MPI_Group_range_incl(
        MPI_Group         group,
        int               n,
        _In_count_(n) int ranges[][3],
  _Out_ MPI_Group         *newgroup
);

Parâmetros

• grupo
  O grupo existente.

• n
  O número de trigêmeos em intervalos de matriz.

• Intervalos
  Uma matriz de especificações de processos a serem incluídos no novo grupo. Cada elemento da matriz especifica um intervalo de processo na forma de três inteiros para a primeira classificação, a última classificação e o passo a passo.

• newgroup [out]
  Um ponteiro para um identificador que representa o novo grupo. O novo grupo contém os conjuntos adicionais de classificações. A ordem é definida por intervalos.

Retornar valor

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

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

Fortran

    MPI_GROUP_RANGE_INCL(GROUP, N, RANGES, NEWGROUP, IERROR)
        INTEGER GROUP, N, RANGES(3,*), NEWGROUP, IERROR

Comentários

Se os intervalos consistirem nos trigêmeos (primeiro1 , último1, stride1) , ..., (firstn, lastn, striden), o newgroup consistirá na sequência de processos em grupo com classificações primeiro1, first1 + stride1, ..., RoundDown((last1 - first1)/stride1)*stride1, ..., firstn, firstn + striden, ..., RoundDown((lastn - firstn)/striden)*striden.

Cada classificação computada deve ser uma classificação válida no novo grupo e todas as classificações computadas devem ser distintas. Caso contrário, a função retornará um erro.

Observação

Observe que você pode definir primeiro[i] maior que last[i], e stride[i] pode ser negativo, mas não pode ser zero.

 

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

A implementação de 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 do HPC Pack 2012 MS-MPI, Pacote Redistribuível HPC Pack 2008 R2 MS-MPI, Pacote Redistribuível do 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_Group_incl

MPI_Comm_group