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

16 parcel::krylov::inverse_power

16.1 inverse_power (クラス)

概要 逆べき乗法. AA (set_precon_spectrum(true) 時は AK−1AK^{-1}) の絶対値最小の固有対を求める. 各反復で内部線形ソルバが Ay=xAy = x を解く.

書式

template< class Tspmv = parcel_double, class Tprecon = parcel_double,
          class Taxpy = parcel_double, class Tdot    = parcel_double >
class inverse_power : public eigen_param;

注意 固有のメンバ関数は無い. 内部線形ソルバは固有値ソルバ共通のメンバ関数 set_linsolve_* で設定する (既定値は共通事項の設定). set_tolerance() / set_max_iteration() は外側の固有値反復に対する値である (既定 1.0e-8 / 10000). 収束判定と破綻の扱いはソルバごとの収束判定に示す.

16.2 solver()

概要 絶対値最小の固有値と固有ベクトルを求める.

書式

template< class Tmat, class Teigen_val, class Teigen_vec, class Tvec = parcel_double,
          class Tprecon_mat = parcel_double, class Tprecon_vec = parcel_double >
void solver(parcel::matrix<Tmat> &Mat,
            parcel::vector<Teigen_val> &EigenValue, parcel::vector<Teigen_vec> &EigenVec);

引数 power の solver() と同じである.

前提条件 共通の前提条件 (in-order キュー, 登録済みの行列, ベクトルのキューと長さ) を満たすこと. 内部の線形ソルバも同じキューを使う. AA が正則であること. 絶対値最小の固有値が実数であること. set_linsolve_algo(LINSOLVE_PCG) では AA が対称 (正定値または負定値) であること. 後の 3 つは検査しない.

戻り値 なし.

MPI 集団操作. 全ランクが同じ設定で呼ぶ.

注意 絶対値最小の固有値が複素共役対になる非対称行列では Rayleigh 商が収束しない. その場合は ks_arnoldi の shift-invert を σ=0\sigma = 0 で使う.

関連項目 get_linsolve_failures(), 固有値ソルバの章

例

parcel::krylov::inverse_power<> ip;
ip.solver(A, lam, v);