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

◆ Mng()

Sub Mng ( N As  Long,
X() As  Double,
F As  LongPtr,
G As  LongPtr,
Info As  Long,
Optional Itsum As  LongPtr = NullPtr,
Optional Info2 As  Long,
Optional NFcall As  Long,
Optional NGcall As  Long,
Optional Niter As  Long,
Optional Fval As  Double,
Optional Rtol As  Double = -1,
Optional Atol As  Double = -1,
Optional MaxFcall As  Long = 0,
Optional MaxIter As  Long = 0,
Optional Tuner1 As  Double = -1,
Optional Xctol As  Double = -1,
Optional Xftol As  Double = -1,
Optional Lmax0 As  Double = -1,
Optional Lmaxs As  Double = -1,
Optional Sctol As  Double = -1,
Optional Bias As  Double = -1 
)

多変数非線形関数の最小点 (信頼領域法)

目的
本ルーチンは非線形関数 f(x1, x2, ..., xn) (2階連続的微分可能な実数関数) の局所的最小点(xs1, xs2, ..., xsn) を求める.

目的関数の微分係数の計算には, これを解析的に求めるユーザー定義サブルーチンを使う. ヘッセ行列はセカント法(BFGS法)により求められる. 探索アルゴリズムはダブルドッグレッグ信頼領域法を使用する.
引数
[in]N問題の次数(パラメータ数). (N > 0)
[in,out]X()配列 X(LX - 1) (LX >= N)
[in] 解ベクトルの初期推定値.
[out] 求められた解ベクトル.
[in]F目的関数 f(x1, x2, ..., xn) を求めるユーザー定義サブルーチンで, 次のように定義すること.
Sub F(N As Long, X() As Double, Nf As Long, Fval As Double)
与えられたNおよびX()から関数値を求めFvalに設定する.
Nfは呼び出しカウンタである. 与えられたX()が計算可能範囲外の場合, Nf = 0 に設定して戻ること. それ以外の変数を変更してはならない. X()が同じ場合, FとGに渡されるNfは同じ値を持つ.
End Sub
[in]G目的関数 f(x1, x2, ..., xn) の微分係数を求めるユーザー定義サブルーチンで, 次のように定義すること.
Sub G(N As Long, X() As Double, Nf As Long, Gval() As Double)
与えられたNおよびX()から微分係数df/dX(i)を求め, Gval(i)に設定する(i=0〜N-1).
Nfは呼び出しカウンタである. 与えられたX()が計算可能範囲外の場合, Nf = 0 に設定して戻ること. それ以外の変数を変更してはならない. X()が同じ場合, FとGに渡されるNfは同じ値を持つ.
End Sub
[out]Info= 0: 正常終了. (サブコードをInfo2に返す)
= -1: パラメータ N の誤り. (N < 1)
= -2: パラメータ X() の誤り.
= 7: 特異収束. (近傍のヘッセ行列が特異になった)
= 8: 誤収束. (誤った点での収束と思われる. 目標精度が小さすぎる可能性がある)
= 9: 関数評価回数の最大値を超えた.
= 10: 反復回数の最大値を超えた.
= 63: X()の初期点においてF(X)を求めることができない.
= 65: X()において微分係数を求めることができない.
[in]Itsum(省略可)
計算の途中経過を出力するためのユーザー定義サブルーチンで, 次のように定義すること. (省略時 = NullPtr)
アドレスを与えると(NullPtr以外であれば)反復ごとにサブルーチンが呼び出される.
Sub Itsum(N As Long, X() As Double, NIter As Long, Nf As Long, Ng As Long, Fval As Double)
以下の情報が渡されるのでこれを任意の形式で出力する.
N: 変数の数.
X(): 解ベクトルの現在の推定値.
NIter: 何回目の反復かを示す.
Nf: Fの呼び出し回数.
Ng: Gの呼び出し回数.
Fval: X()におけるFの値.
End Sub
引数の値を変更してはならない.
[out]Info2(省略可)
Info = 0 のときのサブコード.
= 1: X値の収束条件を満たした.
= 2: 関数値相対収束条件を満たした.
= 3: X値および関数値相対収束条件の両方を満たした.
= 4: 関数値絶対収束条件を満たした.
[out]NFcall(省略可)
関数Fの呼び出し回数.
[out]NGcall(省略可)
関数Gの呼び出し回数.
[out]Niter(省略可)
反復回数.
[out]Fval(省略可)
求められた解ベクトルX()における関数値.
[in]Rtol(省略可)
関数値の目標相対精度. (Eps <= Rtol <= 0.1) (省略時 = 1e-10) (Epsはマシンイプシロン)
(Rtol < Eps または Rtol > 0.1 であれば省略時の既定値とみなす)
[in]Atol(省略可)
関数値の目標絶対精度. (省略時 = 1e-20)
(Atol < 0 であれば省略時の既定値とみなす)
[in]MaxFcall(省略可)
関数Fの呼び出し回数の最大値. (省略時 = 200)
(MaxFcall <= 0 であれば省略時の既定値とみなす)
[in]MaxIter(省略可)
反復回数の最大値. (省略時 = 150)
(MaxIter <= 0 であれば省略時の既定値とみなす)
[in]Tuner1(省略可)
誤収束の判定パラメータ. (0 <= Tuner1 <= 0.5) (省略時 = 0.1)
(Tuner1 < 0 または Tuner1 > 0.5 であれば省略時の既定値とみなす)
[in]Xctol(省略可)
X値の収束判定しきい値. (0 <= Xctol <= 1) (省略時 = Eps^(1/2))
(Xctol < 0 または Xctol > 1 であれば省略時の既定値とみなす)
[in]Xftol(省略可)
誤収束の判定しきい値. (0 <= Xftol <= 1) (省略時 = 100*Eps)
(Xftol < 0 または Xftol > 1 であれば省略時の既定値とみなす)
[in]Lmax0(省略可)
スケーリングされた一番始めのステップ長の最大幅. (Lmax0 > 0) (省略時 = 1)
(Lmax0 <= 0 であれば省略時の既定値とみなす)
[in]Lmaxs(省略可)
[in]Sctol(省略可)
LmaxsおよびSctolは特異収束の判定パラメータである. (Lmaxs > 0) (0 <= Sctol <= 1) (省略時: Lmaxs = 1, Sctol = 1e-10)
ステップ長Lmaxsを上限とするステップにおいて予測される関数値の減少が最大でSctol*abs(f)かどうかテストする (fは現在の反復の出発点における関数値).
(Lmaxs <= 0 であれば省略時の既定値とみなす)
(Sctol < 0 であれば省略時の既定値とみなす)
[in]Bias(省略可)
ドッグレッグ信頼領域法で使用するパラメータ. (0 <= Bias <= 1) (省略時 = 0.8)
(Bias < 0 または Bias > 1 であれば省略時の既定値とみなす)
出典
netlib/port
使用例
次の関数の最小点を求める(ローゼンブロック関数).
f(x1, x2) = 100(x2 - x1^2)^2 + (1 - x1)^2
初期値は, (x1, x2) = (-1.2, 1) とする.
Sub FMng(N As Long, X() As Double, Nf As Long, F As Double)
F = 100 * (X(1) - X(0) ^ 2) ^ 2 + (1 - X(0)) ^ 2
End Sub
Sub GMng(N As Long, X() As Double, Nf As Long, G() As Double)
G(0) = -400 * X(0) * (X(1) - X(0) ^ 2) + 2 * X(0) - 2
G(1) = 200 * X(1) - 200 * X(0) ^ 2
End Sub
Sub Ex_Mng()
Const N = 2
Dim X(N - 1) As Double, Info As Long
X(0) = -1.2: X(1) = 1
Call Mng(N, X(), AddressOf FMng, AddressOf GMng, Info)
Debug.Print "X1, X2 =", X(0), X(1)
Debug.Print "Info =", Info
End Sub
Sub Mng(N As Long, X() As Double, F As LongPtr, G As LongPtr, Info As Long, Optional Itsum As LongPtr=NullPtr, Optional Info2 As Long, Optional NFcall As Long, Optional NGcall As Long, Optional Niter As Long, Optional Fval As Double, Optional Rtol As Double=-1, Optional Atol As Double=-1, Optional MaxFcall As Long=0, Optional MaxIter As Long=0, Optional Tuner1 As Double=-1, Optional Xctol As Double=-1, Optional Xftol As Double=-1, Optional Lmax0 As Double=-1, Optional Lmaxs As Double=-1, Optional Sctol As Double=-1, Optional Bias As Double=-1)
多変数非線形関数の最小点 (信頼領域法)
実行結果
X1, X2 = 0.999999999986455 0.999999999971342
Info = 0