MPI_Group_range_excl, funkcja
Tworzy nową grupę przez usunięcie procesów z istniejącej grupy.
Składnia
int MPIAPI MPI_Group_range_excl(
MPI_Group group,
int n,
_In_count_(n) int ranges[][3],
_Out_ MPI_Group *newgroup
);
Parametry
Grupa
Istniejąca grupa.n
Liczba zakresów procesów do wykluczenia z nowej grupy.Zakresy
Tablica specyfikacji procesów do wykluczenia z istniejącej grupy. Każdy element tablicy określa zakres procesu w postaci trzech liczb całkowitych pierwszej rangi, ostatniej rangi i kroku.newgroup [out]
Wskaźnik do uchwytu, który reprezentuje nową grupę zawierającą te procesy, które nie zostały wykluczone. Kolejność grupy jest zachowywana.
Wartość zwracana
Zwraca MPI_SUCCESS po powodzeniu. W przeciwnym razie zwracana wartość jest kodem błędu.
W fortran wartość zwracana jest przechowywana w parametrze IERROR .
Fortran
MPI_GROUP_RANGE_EXCL(GROUP, N, RANGES, NEWGROUP, IERROR)
INTEGER GROUP, N, RANGES(3,*), NEWGROUP, IERROR
Uwagi
Każda obliczona ranga musi być prawidłową rangą w istniejącej grupie, a wszystkie obliczone rangi muszą być odrębne; w przeciwnym razie funkcja zwraca błąd.
Jest to operacja lokalna. Różne procesy mogą definiować różne grupy. Proces może definiować grupę, która nie zawiera się.
Implementacja mpI nie zapewnia mechanizmu tworzenia grupy od podstaw, ale tylko z istniejących grup. Grupę bazową, na której zdefiniowano wszystkie inne grupy, można pobrać za pomocą funkcji MPI_Comm_group . Jest to grupa skojarzona z początkowym komunikatorem MPI_COMM_WORLD.
Wymagania
Produkt |
Pakiet redystrybucyjny HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 MS-MPI lub narzędzia klienckie HPC Pack 2008 |
Nagłówek |
Mpi.h; Mpif.h |
Biblioteka |
Msmpi.lib |
DLL |
Msmpi.dll |