XLPack 7.0
XLPack 数値計算ライブラリ (Excel VBA) リファレンスマニュアル
読み取り中…
検索中…
一致する文字列を見つけられません

◆ Dsysvx()

Sub Dsysvx ( Fact As  String,
Uplo As  String,
N As  Long,
A() As  Double,
Af() As  Double,
IPiv() As  Long,
B() As  Double,
X() As  Double,
RCond As  Double,
FErr() As  Double,
BErr() As  Double,
Info As  Long,
Optional Nrhs As  Long = 1 
)

(エキスパートドライバ) 連立一次方程式 AX = B の解 (対称行列)

目的
本ルーチンは対角ピボット分解を用いて次の連立一次方程式を解く.
A * X = B
ここで, Aはn×n対称行列, また, XおよびBはn×nrhs行列である.
解の誤差限界および推定条件数も求められる.
解説
以下の手順で計算が行われる.

  1. Fact = "N"の場合, 対角ピボット法を用いて次のようにAを分解する.
    A = U * D * U^T (Uplo = "U"の場合)
    A = L * D * L^T (Uplo = "L"の場合)
    ここで, U(またはL)は置換行列と対角要素が1の上(または下)三角行列の積, そして, Dは1×1または2×2対角ブロックよりなる対称なブロック対角行列である.

  2. Dのある第i対角要素が0であればDは特異であり, Info = iで戻る. そうでなければ, 行列Aの分解形を用いて条件数を推定する. 条件数の逆数がマシンイプシロンより小さければ警告としてInfo = n+1を返すが, 引き続き下記のように解Xを求め誤差限界を計算する.

  3. Aの分解形を用いて連立方程式を解きXを求める.

  4. 計算された解行列に反復改良を適用して精度向上を図り, その誤差限界および後退誤差推定値を計算する.
引数
[in]Fact行列Aの分解形を入力するかどうかを指定.
= "F": Af()とIPiv()にAの分解形を入力する. Af()とIPiv()は変更されない.
= "N": A()をAf()にコピーしてから分解する.
[in]Uplo= "U": Aの上三角部分を格納.
= "L": Aの下三角部分を格納.
[in]N連立方程式の数, すなわち, 行列Aの行および列数. (N >= 0) (N = 0 の場合, 処理を行わずに戻る)
[in]A()配列 A(LA1 - 1, LA2 - 1) (LA1 >= N, LA2 >= N)
N×N対称行列 A. Uploに従い上三角部分あるいは下三角部分が参照される.
[in,out]Af()配列 Af(LAf1 - 1, LAf2 - 1) (LAf1 >= N, LAf2 >= N)
[in] Fact = "F"の場合, Dsytrfにより求められた, 分解 A = U*D*U^T または A = L*D*L^T よりUまたはLを得るために使われるブロック対角行列Dおよび乗数.
[out] Fact = "N"の場合, 分解 A = U*D*U^T または A = L*D*L^T よりUまたはLを得るために使われるブロック対角行列Dおよび乗数.
[in,out]IPiv()配列 IPiv(LIPiv - 1) (LIPiv >= N)
[in] Fact = "F"の場合, Dsytrfにより求められた行および列の交換とDのブロック構造の情報を入力する.
  IPiv(k-1) > 0であれば, 第k行および列が第IPiv(k-1)行および列と交換され, Dの第k対角が1×1対角ブロックであることを表す.
  Uplo = "U"でIPiv(k-1) = IPiv(k-2) < 0 であれば, 第k-1行および列が第-IPiv(k-1)行および列と交換され, Dの第k-1対角が2×2対角ブロックであることを表す.
  Uplo = "L"でIPiv(k-1) = IPiv(k) < 0であれば, 第k+1行および列が第-IPiv(k-1)行および列と交換され, Dの第k対角が2×2対角ブロックであることを表す.
[out] Fact = "N"の場合, Dsytrfにより求められた行および列の交換とDのブロック構造の情報を返す.
[in]B()配列 B(LB1 - 1, LB2 - 1) (LB1 >= max(1, N), LB2 >= Nrhs) (2次元配列) または B(LB - 1) (LB >= max(1, N), Nrhs = 1) (1次元配列)
N×Nrhs右辺行列 B.
[out]X()配列 X(LX1 - 1, LX2 - 1) (LX1 >= max(1, N), LX2 >= Nrhs) (2次元配列) または X(LX - 1) (LX >= max(1, N), Nrhs = 1) (1次元配列)
Info = 0 または Info = N+1 の場合, N×Nrhs解行列 X.
[out]RCond行列Aの(1/条件数)の推定値. RCondがマシンイプシロンより小さければ(特に RCond = 0 であれば), 実用精度において行列は特異である. これは Info > 0 を返すことにより通知される.
[out]FErr()配列 FErr(LFErr - 1) (LFErr >= Nrhs)
各解ベクトルX(j)(解行列Xの第j列)の前進誤差限界. X(j)に対応する真の解をXtrueとするとき, FErr(j-1)は, (X(j) - Xtrue)の要素の最大絶対値をX(j)の要素の最大絶対値で割った値の上限の推定値である. この推定値はRCondの推定値と同程度の信頼性があり, ほぼ常に真の誤差よりも大きめに推定される.
[out]BErr()配列 BErr(LBErr - 1) (LBErr >= Nrhs)
各解ベクトルX(j)の要素に関する後退相対誤差. (すなわち, X(j)を真の解にするためのAまたはBの任意の要素の相対変化の最小値)
[out]Info= 0: 正常終了.
= -1: パラメータ Fact の誤り. (Fact <> "F", "N"および"E")
= -2: パラメータ Uplo の誤り. (Uplo <> "U"および"L")
= -3: パラメータ N の誤り. (N < 0)
= -4: パラメータ A() の誤り.
= -5: パラメータ Af() の誤り.
= -6: パラメータ IPiv() の誤り.
= -7: パラメータ B() の誤り.
= -8: パラメータ X() の誤り.
= -10: パラメータ FErr() の誤り.
= -11: パラメータ BErr() の誤り.
= -13: パラメータ Nrhs の誤り. (Nrhs < 0)
= i (0 < i <= N): Dのi番目の要素が0である. 分解は完了したが, Dが特異であり, 解と誤差限界は計算できなかった. RCond = 0 を返す.
= N+1: Dは非特異であるが, RCondがマシンイプシロンより小さく, これは実用精度において行列が特異であることを意味する. しかしながら, RCondの値が示すよりも計算値の精度が良いことがあるため, 解と誤差限界は計算される.
[in]Nrhs(省略可)
右辺の数, すなわち, 行列Bの列数. (Nrhs >= 0) (Nrhs = 0 の場合, 処理を行わずに戻る) (省略時 = 1)
出典
LAPACK
使用例
連立一次方程式 Ax = B を解き, 同時にAの条件数の逆数の推定値(RCond)を求める. ただし,
( 2.2 -0.11 -0.32 ) ( -1.5660 )
A = ( -0.11 2.93 0.81 ), B = ( -2.8425 )
( -0.32 0.81 -2.37 ) ( -1.1765 )
とする.
Sub Ex_Dsysvx()
Const N = 3
Dim A(N - 1, N - 1) As Double, Af(N - 1, N - 1) As Double, IPiv(N - 1) As Long
Dim B(N - 1) As Double, X(N - 1) As Double
Dim FErr(0) As Double, BErr(0) As Double
Dim RCond As Double, Info As Long
A(0, 0) = 2.2
A(1, 0) = -0.11: A(1, 1) = 2.93
A(2, 0) = -0.32: A(2, 1) = 0.81: A(2, 2) = 2.37:
B(0) = -1.566: B(1) = -2.8425: B(2) = -1.1765
Call Dsysvx("N", "L", N, A(), Af(), IPiv(), B(), X(), RCond, FErr(), BErr(), Info)
Debug.Print "X =", X(0), X(1), X(2)
Debug.Print "RCond =", RCond
Debug.Print "Info =", Info
End Sub
Sub Dsysvx(Fact As String, Uplo As String, N As Long, A() As Double, Af() As Double, IPiv() As Long, B() As Double, X() As Double, RCond As Double, FErr() As Double, BErr() As Double, Info As Long, Optional Nrhs As Long=1)
(エキスパートドライバ) 連立一次方程式 AX = B の解 (対称行列)
実行結果
X = -0.8 -0.92 -0.29
RCond = 0.446791078068956
Info = 0