cv::MinProblemSolver クラス

すべてのソルバーの基本インターフェース。 続き...

#include <opencv2/core/optim.hpp>

Collaboration diagram for cv::MinProblemSolver:

クラス
class	Function
	最適化される関数を表す。詳細...

公開メンバ関数
virtual Ptr< Function >	getFunction () const =0
	最適化対象の関数のゲッター。
virtual TermCriteria	getTermCriteria () const =0
	このアルゴリズムに対して以前に設定された終了条件のゲッター。
virtual double	minimize (InputOutputArray x)=0
	実際にアルゴリズムを実行し、最小化を行う。
virtual void	setFunction (const Ptr< Function > &f)=0
	最適化対象の関数のセッター。
virtual void	setTermCriteria (const TermCriteria &termcrit)=0
	ソルバの終了条件を設定する。
Public Member Functions inherited from cv::Algorithm
	Algorithm ()
virtual	~Algorithm ()
virtual void	clear ()
	アルゴリズムの状態をクリアする。
virtual bool	empty () const
	Algorithm が空の場合（たとえば開始直後や読み込みに失敗した後）に true を返す。
virtual String	getDefaultName () const
virtual void	read (const FileNode &fn)
	ファイルストレージからアルゴリズムの引数を読み込む。
virtual void	save (const String &filename) const
virtual void	write (FileStorage &fs) const
	アルゴリズムの引数をファイルストレージに保存する。
void	write (FileStorage &fs, const String &name) const

Additional Inherited Members
Static Public Member Functions inherited from cv::Algorithm
template<typename _Tp >
static Ptr< _Tp >	load (const String &filename, const String &objname=String())
	ファイルからアルゴリズムを読み込む。
template<typename _Tp >
static Ptr< _Tp >	loadFromString (const String &strModel, const String &objname=String())
	文字列からアルゴリズムを読み込む。
template<typename _Tp >
static Ptr< _Tp >	read (const FileNode &fn)
	ファイルノードからアルゴリズムを読み込む。
Protected Member Functions inherited from cv::Algorithm
void	writeFormat (FileStorage &fs) const

詳細説明

すべてのソルバーの基本インターフェース。

メンバ関数詳解

getFunction()

virtual Ptr< Function > cv::MinProblemSolver::getFunction ( ) const

pure virtual

最適化対象の関数のゲッター。

最適化対象の関数は Function インターフェースで表現される。このインターフェースでは、関数を評価するために導関数を実装する calc(double*) と getDim() のメソッドが必要となる。

戻り値

Function インターフェースを実装するオブジェクトへのスマートポインタ。最適化対象の関数を表す。まだ関数が与えられていなければ空になることがある。

getTermCriteria()

virtual TermCriteria cv::MinProblemSolver::getTermCriteria ( ) const

pure virtual

このアルゴリズムに対して以前に設定された終了条件のゲッター。

戻り値

現在使用されている終了条件のディープコピー。

minimize()

virtual double cv::MinProblemSolver::minimize ( InputOutputArray x )

pure virtual

実際にアルゴリズムを実行し、最小化を行う。

唯一の入力引数は開始シンプレックスの重心（おおまかに言えば、どこから開始するかを指示する）を決定する。それ以外（終了条件、初期ステップ、最小化する関数）は、このメソッドを呼び出す前にセッターで設定しておく必要がある。設定しない場合は（必ずしも妥当とは限らない）デフォルト値が使用される。

引数

x	初期点。初期シンプレックスの重心となる。アルゴリズムが終了すると、アルゴリズムが停止した点、すなわち最小値の可能性がある点に設定される。

戻り値

見つかった点における関数の値。

setFunction()

virtual void cv::MinProblemSolver::setFunction ( const Ptr< Function > & f )

pure virtual

最適化対象の関数のセッター。

デフォルト値は使用できないため、minimize() を呼び出す前に少なくとも一度は呼び出す必要がある*。

引数

f	最適化する新しい関数。

setTermCriteria()

virtual void cv::MinProblemSolver::setTermCriteria ( const TermCriteria & termcrit )

pure virtual

ソルバーの終了条件を設定する。

このメソッドはデフォルト値が妥当であるため、minimize() を最初に呼び出す前に呼び出す必要はない。

Algorithm は、実行した関数評価の回数が termcrit.maxCount を超えたとき、シンプレックスの頂点における関数値が termcrit.epsilon の範囲内に収まったとき、またはシンプレックスが小さくなり termcrit.epsilon を辺とするボックスに収まるようになったとき、のいずれか早いほうで停止する。

引数

termcrit

使用する終了条件。cv::TermCriteria 構造体で表される。

---

このクラス詳解は次のファイルから抽出されました:

• opencv2/core/optim.hpp