PARCEL SYCL v1.2 / API リファレンス 利用者ガイド API リファレンス 検索 ダウンロード English

8 ソルバ共通の事項

 C++ のソルバクラスに共通の事項 (精度のテンプレート引数, 設定と例外, 定数の名前) を示す. 記号と用語は共通事項の「記号と用語」に示す.

8.1 クラステンプレート引数 (演算精度)

 ソルバクラスはすべて, 演算ごとの計算精度を次のテンプレート引数で指定する. 省略時はいずれも parcel_double である.

引数 説明 既定値
Tspmv 疎行列ベクトル積 (SpMV) の計算精度 parcel_double
Tprecon 前処理の計算精度 parcel_double
Taxpy ベクトル演算 (axpy (y←αx+yy \leftarrow \alpha x + y) 等) の計算精度 parcel_double
Tdot 縮約演算 (内積・ノルム) の計算精度 parcel_double
template< class Tspmv = parcel_double, class Tprecon = parcel_double,
          class Taxpy = parcel_double, class Tdot   = parcel_double >
class pcg;      // pbicgstab, pgmres, pcagmres, power, inverse_power, ks_arnoldi も同じ

 7 つのソルバクラスはすべてこの 4 引数を持つ.

8.2 solver() のテンプレート引数 (データ精度)

 solver() 関数のテンプレート引数では, 各データを保持する精度を指定する. ソルバ固有の引数は各クラスの項に示す. 実引数から推論できる引数は省略でき, 推論できない引数の既定は parcel_double である. したがって精度をすべて倍精度にする場合は parcel::krylov::pcg<> s; s.solver(A, x, b); と書ける (固有値ソルバも s.solver(A, ev, evec)). 明示する場合は先頭から順に与える.

引数 説明 既定値
Tmat 係数行列のデータ精度 (parcel::matrix<Tmat> の型と一致させる) 実引数から推論
Tvecx / Tvecb 解ベクトル / 右辺ベクトルのデータ精度 (線形ソルバ) 実引数から推論
Teigen_val / Teigen_vec 固有値 / 固有ベクトルのデータ精度 (固有値ソルバ) 実引数から推論
Tvec ソルバ内部のベクトルのデータ精度 (ks_arnoldi には無い) parcel_double
Tprecon_mat 前処理行列のデータ精度 parcel_double (ks_arnoldi は Teigen_vec)
Tprecon_vec 前処理ベクトルのデータ精度 parcel_double (ks_arnoldi は Teigen_vec)

8.3 設定の扱いと例外

関数 受け付ける値
set_tolerance(), set_linsolve_tolerance() 有限の正の値 (0 以下, NaN,Inf は不可)
set_max_iteration(), set_linsolve_max_iteration(), set_linsolve_restart(), ks_arnoldi::set_ks_max_restart() 1 以上
set_precon_algo(), set_linsolve_precon_algo() PRECON_NONE, PRECON_POINTJACOBI, PRECON_BLOCKJACOBI, PRECON_JACOBI
set_jacobi(), set_linsolve_jacobi() 1 以上
set_blockjacobi(), set_linsolve_blockjacobi() 1 以上 (担当行数以下であることは検査しない)
set_linsolve_algo() LINSOLVE_PGMRES, LINSOLVE_PCG
pgmres::set_restart() 1 以上
pgmres::set_qr_algo() QR_CGS, QR_MGS
pcagmres::set_restart() ss, tt とも 1 以上
pcagmres::set_qr_algo() QR_CGS, QR_MGS, QR_CHOLESKYQR, QR_CAGMRES_CHOLESKYQR
pcagmres::set_explicit_q() CAGMRES_Q_AUTO, CAGMRES_Q_EXPLICIT, CAGMRES_Q_IMPLICIT
ks_arnoldi::set_ks_subspace() 1≤nev≤kkeep<m1 \leq nev \leq k_{keep} < m
ks_arnoldi::set_qr_algo() QR_CGS, QR_MGS

8.4 定数

 設定関数に渡す定数と収束状態の定数は次の名前空間にある. 型はいずれも const PARCEL_INT である. 値の意味は共通事項の定数と収束状態に示す.

名前空間 定数 (値) 用いる関数
parcel:: PRECON_NONE (0), PRECON_POINTJACOBI (1), PRECON_BLOCKJACOBI (2), PRECON_JACOBI (4) set_precon_algo(), set_linsolve_precon_algo()
parcel::qr:: QR_CGS (0), QR_MGS (1), QR_CHOLESKYQR (2), QR_CAGMRES_CHOLESKYQR (202) pgmres::set_qr_algo(), pcagmres::set_qr_algo(), ks_arnoldi::set_qr_algo()
parcel::krylov:: LINSOLVE_PGMRES (0), LINSOLVE_PCG (1) set_linsolve_algo()
parcel::krylov:: CAGMRES_Q_AUTO (0), CAGMRES_Q_EXPLICIT (1), CAGMRES_Q_IMPLICIT (2) set_explicit_q()
parcel::krylov:: CONVERGED_RTOL (1), ITERATING (0), DIVERGED_ITS (-1), DIVERGED_NANORINF (-2), DIVERGED_BREAKDOWN (-3) get_converged_reason(), converged_reason_name()