MPI_Group_range_incl (Fungsi MPI_Group_range_incl)

Konstruktor grup yang digunakan untuk menentukan grup baru dengan menambahkan set peringkat tambahan ke grup yang sudah ada.

Sintaks

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

Parameter

• grup
  Grup yang ada.

• n
  Jumlah triplet dalam rentang array.

• Rentang
  Array spesifikasi proses untuk disertakan dalam grup baru. Setiap elemen array menentukan rentang proses dalam bentuk tiga bilangan bulat untuk peringkat pertama, peringkat terakhir, dan langkah.

• newgroup [out]
  Penunjuk ke handel yang mewakili grup baru. Grup baru berisi kumpulan peringkat tambahan. Urutan ditentukan oleh rentang.

Menampilkan nilai

Mengembalikan MPI_SUCCESS pada keberhasilan. Jika tidak, nilai yang dikembalikan adalah kode kesalahan.

Di Fortran, nilai yang dikembalikan disimpan dalam parameter IERROR .

Fortran

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

Keterangan

Jika rentang terdiri dari kembung (pertama1 , last1, stride1) , ..., (firstn, lastn, striden), kemudian newgroup terdiri dari urutan proses dalam grup dengan peringkat pertama1, first1 + stride1, ..., RoundDown((last1 - first1)/stride1)*stride1, ..., firstn, firstn + striden, ..., RoundDown((lastn - firstn)/striden)*striden.

Setiap peringkat komputasi harus peringkat yang valid dalam grup baru, dan semua peringkat komputasi harus berbeda. Jika tidak, fungsi mengembalikan kesalahan.

Catatan

Perhatikan bahwa Anda dapat mengatur [i] pertama yang lebih besar dari last[i], dan stride[i] bisa negatif, tetapi tidak boleh nol.

 

Ini adalah operasi lokal. Proses yang berbeda dapat menentukan grup yang berbeda. Proses dapat menentukan grup yang tidak menyertakan dirinya sendiri.

Implementasi MPI tidak menyediakan mekanisme untuk membangun grup dari awal, tetapi hanya dari grup yang ada. Grup dasar, di mana semua grup lain didefinisikan, dapat diambil dengan menggunakan fungsi MPI_Comm_group . Ini adalah grup yang terkait dengan MPI_COMM_WORLD komunikator awal.

Persyaratan

Produk	Paket HPC Pack 2012 MS-MPI Redistributable, HpC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package atau HPC Pack 2008 Client Utilities
Header	Mpi.h; Mpif.h
Pustaka	Msmpi.lib
DLL	Msmpi.dll

Lihat juga

Fungsi Grup MPI

MPI_Group_incl

MPI_Comm_group