5 parcel::comm
SYCL版PARCEL用の MPI コミュニケータクラスである. MPI コミュニケータと sycl::queue の組を保持する.
5.1 コンストラクタ
概要 MPI コミュニケータと SYCL キューから parcel::comm を作る.
書式
parcel::comm::comm(MPI_Comm comm, sycl::queue *q); // MPI ありのビルド (既定)
parcel::comm::comm(sycl::queue *q); // MPI なしのビルド (-DPARCEL_MPI=0)引数
| 名前 | 入出力 | 型 | 説明 | 既定値 |
|---|---|---|---|---|
comm |
入力 | MPI_Comm |
MPI コミュニケータ. MPI_COMM_WORLD 以外も指定できる. MPI なしのビルドでは引数に無い |
なし |
q |
入力 | sycl::queue * |
計算に使う SYCL キュー | なし |
前提条件 MPI_Init() の後に呼ぶ (内部で MPI_Comm_size / MPI_Comm_rank を呼ぶ). q は行列・ベクトルと同じ in-order キュー (sycl::property::queue::in_order を付けて作ったもの) とする. comm のキューは検査しない (袖通信の同期に使う). in-order の検査は, 行列のキューに対して set_crsMat() と各ソルバの solver() が行う.
MPI 集団操作ではない. comm に属する全ランクで作る.
注意 MPI ありのビルド (既定) では, 1 プロセスで実行する場合も必要である. MPI なしのビルド (-DPARCEL_MPI=0. 利用者ガイドの「MPI なしのビルド」) では parcel::comm comm(&q); で作る. このとき mpi_rank() / rank() は 0, mpi_size() / size() は 1 を返し, barrier() は何もしない. mpi_comm() は無い. parcel::matrix::set_crsMat() はこのオブジェクトへのポインタを保持するので, 行列とソルバを使い終わるまで破棄してはならない.
関連項目 set_crsMat()
例
sycl::queue q{sycl::default_selector_v, sycl::property::queue::in_order{}};
parcel::comm comm(MPI_COMM_WORLD, &q);5.2 mpi_rank() / mpi_size() / mpi_comm() / rank() / size()
概要 ランク番号, プロセス数, MPI コミュニケータを返す. rank() / size() は mpi_rank() / mpi_size() の別名である.
書式
int mpi_rank(); // int rank();
int mpi_size(); // int size();
MPI_Comm mpi_comm();戻り値 コンストラクタに渡したコミュニケータでのランク番号 (0 始まり), プロセス数, コミュニケータ. MPI なしのビルドでは mpi_rank() は 0, mpi_size() は 1 で, mpi_comm() は無い.
MPI 局所操作.
例
const int myrank = comm.mpi_rank(), nproc = comm.mpi_size();