MPI_Cart_create, funkcja

2023-12-27

Tworzy nowy komunikator, do którego dołączono informacje o topologii.

Składnia

int MPIAPI MPI_Cart_create(
        MPI_Comm              comm_old,
        int                   ndims,
        _In_count_(ndims) int *dims,
        _In_count_(ndims) int *periods,
        int                   reorder,
  _Out_ MPI_Comm              *comm_cart
);

Parametry

comm_old
Komunikator wejściowy.
ndims
Liczba wymiarów siatki kartezjańskiej.
Przyciemnia
Tablica liczb całkowitych o rozmiarze ndims określających liczbę procesów w każdym wymiarze.
Okresy
Tablica logiczna rozmiaru ndims określająca, czy siatka jest okresowa (true), czy nie (false) w każdym wymiarze.
Zmienić kolejność
Klasyfikacja może być zmieniana (prawda) lub nie (fałsz).
comm_cart [out]
Komunikator z nową topologią kartezjańską.

Wartość zwracana

Zwraca MPI_SUCCESS powodzenia. W przeciwnym razie wartość zwracana jest kodem błędu.

W fortran wartość zwracana jest przechowywana w parametrze IERROR .

Fortran

    MPI_CART_CREATE(COMM_OLD, NDIMS, DIMS, PERIODS, REORDER, COMM_CART, IERROR)
        INTEGER COMM_OLD, NDIMS, DIMS(*), COMM_CART, IERROR
        LOGICAL PERIODS(*), REORDER

Wymagania

Produkt	Pakiet redystrybucyjny PROGRAMU HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny PAKIETU HPC Pack 2008 MS-MPI lub narzędzia klienckie PAKIETU HPC Pack 2008
Nagłówek	Mpi.h; Mpif.h
Biblioteka	Msmpi.lib
DLL	Msmpi.dll

Zobacz też

Funkcje topologii procesów MPI