XLPack 6.1
C/C++ API リファレンスマニュアル
読み取り中…
検索中…
一致する文字列を見つけられません

◆ _dspev()

void _dspev ( char  jobz,
char  uplo,
int  n,
double  ap[],
double  w[],
int  ldz,
double  z[],
double  work[],
int *  info 
)

(シンプルドライバ) 固有値・固有ベクトル (対称行列) (圧縮形式)

目的
本ルーチンは圧縮形式の実対称行列 A のすべての固有値, および, 必要により固有ベクトルを求める. 固有値および固有ベクトルはQL法またはQR法により求める.
引数
[in]jobz= 'N': 固有値のみ求める.
= 'V': 固有値と固有ベクトルを求める.
[in]uplo= 'U': A の上三角部分を格納する.
= 'L': A の下三角部分を格納する.
[in]n行列Aの行および列数. (n >= 0) (n = 0 の場合, 処理を行わずに戻る)
[in,out]ap[]配列 ap[lap] (lap >= n(n + 1)/2)
[in] 対称行列 A の上または下三角部分. 1次元配列に列ごとに圧縮されており, A のj列が配列 ap に次のように格納される
uplo = 'U': ap[i + j*(j + 1)/2] = A(i, j). ただし, 0 <= i <= j <= n - 1.
uplo = 'L': ap[(i + j*(2*n - j - 1)/2] = A(i, j). ただし, 0 <= j < = i <= n - 1.
[out] ap[]は三重対角形への変換中に生成される値で上書きされる. uplo = 'U' の場合, 三重対角行列 T の対角要素および上副対角要素により A の対応する要素を上書きする. uplo = 'L' の場合, T の対角要素および下副対角要素により A の対応する要素を上書きする.
[out]w[]配列 w[lw] (lw >= n)
info = 0 の場合, 求められた固有値(昇順).
[in]ldz二次元配列 z[][] の整合寸法. (ldz >= 1 (jobz = 'N'), ldz >= max(1, n) (jobz = 'V'))
[out]z[][]配列 z[lz][ldz] (lz >= n)
jobz = 'V': info = 0 の場合, z[][] に正規直交固有ベクトルが入る. w[i] に関連する固有ベクトルがi行に入る.
jobz = 'N': z[][] は参照されない.
[out]work[]配列 work[lwork] (lwork >= 3*n)
作業領域.
[out]info= 0: 正常終了
= -1: 入力パラメータ jobz の誤り (jobz != 'V' および 'N')
= -2: 入力パラメータ uplo の誤り (uplo != 'U' および 'L')
= -3: 入力パラメータ n の誤り (n < 0)
= -6: 入力パラメータ ldz の誤り (ldzが小さすぎる)
= i > 0: 収束しなかった. 中間結果の3重対角形の非対角要素のうち i 個が 0 にならなかった.
出典
LAPACK