"Dual TV L1" Optical Flow Algorithm. [詳解]

#include <optflow.hpp>

cv::DenseOpticalFlowを継承しています。

公開メンバ関数
virtual CV_WRAP double	getTau () const =0
	数値計算スキームのタイムステップ[【詳解】（英語］

virtual CV_WRAP void	setTau (double val)=0
	数値計算スキームのタイムステップ[【詳解】（英語］

virtual CV_WRAP double	getLambda () const =0
	データ項の重みパラメータ，アタッチメントパラメータ[【詳解】（英語］

virtual CV_WRAP void	setLambda (double val)=0
	データ項の重みパラメータ，アタッチメントパラメータ[【詳解】（英語］

virtual CV_WRAP double	getTheta () const =0
	(u-v)^2の重み付けパラメータ，タイトネスパラメータ[【詳解】（英語］

virtual CV_WRAP void	setTheta (double val)=0
	(u-v)^2の重み付けパラメータ，タイトネスパラメータ[【詳解】（英語］

virtual CV_WRAP double	getGamma () const =0
	追加の照明変動項の係数[【詳解】（英語］

virtual CV_WRAP void	setGamma (double val)=0
	追加の照明変動項の係数[【詳解】（英語］

virtual CV_WRAP int	getScalesNumber () const =0
	画像のピラミッドを作成するためのスケールの数[【詳解】（英語］

virtual CV_WRAP void	setScalesNumber (int val)=0
	画像のピラミッドを作成するためのスケールの数[【詳解】（英語］

virtual CV_WRAP int	getWarpingsNumber () const =0
	スケールごとのワープの数[【詳解】（英語］

virtual CV_WRAP void	setWarpingsNumber (int val)=0
	スケールごとのワープの数[【詳解】（英語］

virtual CV_WRAP double	getEpsilon () const =0
	精度と実行時間のトレードオフである，数値計算スキームで使用される停止基準の閾値[【詳解】（英語］

virtual CV_WRAP void	setEpsilon (double val)=0
	精度と実行時間のトレードオフである，数値計算スキームで使用される停止基準の閾値[【詳解】（英語］

virtual CV_WRAP int	getInnerIterations () const =0
	数値計算スキームで使用される内側の反復回数（異常値フィルタリング間[【詳解】（英語］

virtual CV_WRAP void	setInnerIterations (int val)=0
	数値計算スキームで使用される内側の反復回数（異常値フィルタリング間[【詳解】（英語］

virtual CV_WRAP int	getOuterIterations () const =0
	数値計算スキームで使用される外側の反復回数（内側ループの数[【詳解】（英語］

virtual CV_WRAP void	setOuterIterations (int val)=0
	数値計算スキームで使用される外側の反復回数（内側ループの数[【詳解】（英語］

virtual CV_WRAP bool	getUseInitialFlow () const =0
	初期流量の使用[【詳解】（英語］

virtual CV_WRAP void	setUseInitialFlow (bool val)=0
	初期流量の使用[【詳解】（英語］

virtual CV_WRAP double	getScaleStep () const =0
	スケール間のステップ（＜1）[【詳解】（英語］

virtual CV_WRAP void	setScaleStep (double val)=0
	スケール間のステップ（＜1）[【詳解】（英語］

virtual CV_WRAP int	getMedianFiltering () const =0
	中央値フィルタのカーネルサイズ（1＝フィルタなし）（3または5）[【詳解】（英語］

virtual CV_WRAP void	setMedianFiltering (int val)=0
	中央値フィルタのカーネルサイズ（1＝フィルタなし）（3または5）[【詳解】（英語］

基底クラス cv::DenseOpticalFlow に属する継承公開メンバ関数
virtual CV_WRAP void	calc (InputArray I0, InputArray I1, InputOutputArray flow)=0
	オプティカルフローを計算します。[【詳解】（英語］

virtual CV_WRAP void	collectGarbage ()=0
	すべての内部バッファを解放します。[【詳解】（英語］

基底クラス cv::Algorithm に属する継承公開メンバ関数
virtual CV_WRAP void	clear ()
	アルゴリズムの状態をクリアする[【詳解】（英語］

virtual void	write (FileStorage &fs) const
	アルゴリズムのパラメーターをファイルストレージに格納[【詳解】（英語］

CV_WRAP void	write (const Ptr< FileStorage > &fs, const String &name=String()) const
	これはオーバーロードされたメンバ関数です。利便性のために用意されています。元の関数との違いは引き数のみです。

virtual CV_WRAP void	read (const FileNode &fn)
	アルゴリズム・パラメータをファイル・ストレージから読み込みます。[【詳解】（英語］

virtual CV_WRAP bool	empty () const
	が空の場合はtrueを返します。Algorithmが空の場合は真を返します。[【詳解】（英語］

virtual CV_WRAP void	save (const String &filename) const

virtual CV_WRAP String	getDefaultName () const

静的公開メンバ関数
static CV_WRAP Ptr< DualTVL1OpticalFlow >	create (double tau=0.25, double lambda=0.15, double theta=0.3, int nscales=5, int warps=5, double epsilon=0.01, int innnerIterations=30, int outerIterations=10, double scaleStep=0.8, double gamma=0.0, int medianFiltering=5, bool useInitialFlow=false)
	cv::DualTVL1OpticalFlow のインスタンスを作成します．

基底クラス cv::Algorithm に属する継承静的公開メンバ関数
template<typename _Tp >
static Ptr< _Tp >	read (const FileNode &fn)
	ファイル・ノードからアルゴリズムを読み込む[【詳解】（英語］

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())
	文字列からアルゴリズムを読み込む[【詳解】（英語］

その他の継承メンバ
基底クラス cv::Algorithm に属する継承限定公開メンバ関数
void	writeFormat (FileStorage &fs) const

詳解

"Dual TV L1" Optical Flow Algorithm.

このクラスは、[Zach2007]で説明されている "Dual TV L1 "オプティカルフローのアルゴリズムを実装しています。[Zach2007]で説明されているおよび[Javier2012]で説明されている. 以下は、アルゴリズムを制御するクラスの重要なメンバで、クラスのインスタンスを構築した後に設定することができます。

member double tau 数値計算のタイムステップ．
member double lambda データ項の重みパラメータ，アタッチメントパラメータ．これは最も関連性の高いパラメータで、出力の滑らかさを決定します。このパラメータが小さければ小さいほど、得られる解は滑らかになります。このパラメータは，画像の動きの範囲に依存するため，その値は各画像シーケンスに合わせる必要があります．
member double theta (u - v)\^2の重み付けパラメータ、タイトネスパラメータです。これは、アタッチメントと正則化項の間のリンクとして機能します。理論的には，両部分の対応関係を維持するために，小さな値を持つべきです．このメソッドは、このパラメータの大きな値の範囲で安定しています。
member int nscales 画像のピラミッドを作るのに使われるスケールの数。
member int warps 1つのスケールあたりのワープの回数。I1(x+u0) と grad( I1(x+u0) ) がスケールごとに計算される回数を表します。これは、手法の安定性を保証するパラメータです。また、実行時間にも影響しますので、速度と精度の妥協点でもあります。
member double epsilon Stopping criterion threshold 数値スキームで使用されており，精度と実行時間のトレードオフになっています．小さな値であれば、収束が遅くなることを犠牲にしても、より正確な解が得られます。
member int iterations 数値計算スキームで使用される停止基準の反復回数。

C. Zach, T. Pock, H. Bischof, "A Duality Based Approach for Realtime TV-L1 Optical Flow". Javier Sanchez, Enric Meinhardt-Llopis, Gabriele Facciolo. "TV-L1 Optical Flow Estimation".

関数詳解

◆ getEpsilon()

virtual CV_WRAP double cv::optflow::DualTVL1OpticalFlow::getEpsilon ( ) const

pure virtual

精度と実行時間のトレードオフである，数値計算スキームで使用される停止基準の閾値

参照: setEpsilon

◆ getGamma()

virtual CV_WRAP double cv::optflow::DualTVL1OpticalFlow::getGamma ( ) const

pure virtual

追加の照明変動項の係数

参照: setGamma

◆ getInnerIterations()

virtual CV_WRAP int cv::optflow::DualTVL1OpticalFlow::getInnerIterations ( ) const

pure virtual

数値計算スキームで使用される内側の反復回数（異常値フィルタリング間

参照: setInnerIterations

◆ getLambda()

virtual CV_WRAP double cv::optflow::DualTVL1OpticalFlow::getLambda ( ) const

pure virtual

データ項の重みパラメータ，アタッチメントパラメータ

参照: setLambda

◆ getMedianFiltering()

virtual CV_WRAP int cv::optflow::DualTVL1OpticalFlow::getMedianFiltering ( ) const

pure virtual

中央値フィルタのカーネルサイズ（1＝フィルタなし）（3または5）

参照: setMedianFiltering

◆ getOuterIterations()

virtual CV_WRAP int cv::optflow::DualTVL1OpticalFlow::getOuterIterations ( ) const

pure virtual

数値計算スキームで使用される外側の反復回数（内側ループの数

参照: setOuterIterations

◆ getScalesNumber()

virtual CV_WRAP int cv::optflow::DualTVL1OpticalFlow::getScalesNumber ( ) const

pure virtual

画像のピラミッドを作成するためのスケールの数

参照: setScalesNumber

◆ getScaleStep()

virtual CV_WRAP double cv::optflow::DualTVL1OpticalFlow::getScaleStep ( ) const

pure virtual

スケール間のステップ（＜1）

参照: setScaleStep

◆ getTau()

virtual CV_WRAP double cv::optflow::DualTVL1OpticalFlow::getTau ( ) const

pure virtual

数値計算スキームのタイムステップ

参照: setTau

◆ getTheta()

virtual CV_WRAP double cv::optflow::DualTVL1OpticalFlow::getTheta ( ) const

pure virtual

(u-v)^2の重み付けパラメータ，タイトネスパラメータ

参照: setTheta

◆ getUseInitialFlow()

virtual CV_WRAP bool cv::optflow::DualTVL1OpticalFlow::getUseInitialFlow ( ) const

pure virtual

初期流量の使用

参照: setUseInitialFlow

◆ getWarpingsNumber()

virtual CV_WRAP int cv::optflow::DualTVL1OpticalFlow::getWarpingsNumber ( ) const

pure virtual

スケールごとのワープの数

参照: setWarpingsNumber

◆ setEpsilon()

virtual CV_WRAP void cv::optflow::DualTVL1OpticalFlow::setEpsilon ( double val )

pure virtual

精度と実行時間のトレードオフである，数値計算スキームで使用される停止基準の閾値

参照: getEpsilon

◆ setGamma()

virtual CV_WRAP void cv::optflow::DualTVL1OpticalFlow::setGamma ( double val )

pure virtual

追加の照明変動項の係数

参照: getGamma

◆ setInnerIterations()

virtual CV_WRAP void cv::optflow::DualTVL1OpticalFlow::setInnerIterations ( int val )

pure virtual

数値計算スキームで使用される内側の反復回数（異常値フィルタリング間

参照: getInnerIterations

◆ setLambda()

virtual CV_WRAP void cv::optflow::DualTVL1OpticalFlow::setLambda ( double val )

pure virtual

データ項の重みパラメータ，アタッチメントパラメータ

参照: getLambda

◆ setMedianFiltering()

virtual CV_WRAP void cv::optflow::DualTVL1OpticalFlow::setMedianFiltering ( int val )

pure virtual

中央値フィルタのカーネルサイズ（1＝フィルタなし）（3または5）

参照: getMedianFiltering

◆ setOuterIterations()

virtual CV_WRAP void cv::optflow::DualTVL1OpticalFlow::setOuterIterations ( int val )

pure virtual

数値計算スキームで使用される外側の反復回数（内側ループの数

参照: getOuterIterations

◆ setScalesNumber()

virtual CV_WRAP void cv::optflow::DualTVL1OpticalFlow::setScalesNumber ( int val )

pure virtual

画像のピラミッドを作成するためのスケールの数

参照: getScalesNumber

◆ setScaleStep()

virtual CV_WRAP void cv::optflow::DualTVL1OpticalFlow::setScaleStep ( double val )

pure virtual

スケール間のステップ（＜1）

参照: getScaleStep

◆ setTau()

virtual CV_WRAP void cv::optflow::DualTVL1OpticalFlow::setTau ( double val )

pure virtual

数値計算スキームのタイムステップ

参照: getTau

◆ setTheta()

virtual CV_WRAP void cv::optflow::DualTVL1OpticalFlow::setTheta ( double val )

pure virtual

(u-v)^2の重み付けパラメータ，タイトネスパラメータ

参照: getTheta

◆ setUseInitialFlow()

virtual CV_WRAP void cv::optflow::DualTVL1OpticalFlow::setUseInitialFlow ( bool val )

pure virtual

初期流量の使用

参照: getUseInitialFlow

◆ setWarpingsNumber()

virtual CV_WRAP void cv::optflow::DualTVL1OpticalFlow::setWarpingsNumber ( int val )

pure virtual

スケールごとのワープの数

参照: getWarpingsNumber

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

optflow.hpp

公開メンバ関数

静的公開メンバ関数

その他の継承メンバ

詳解

関数詳解

◆ getEpsilon()

◆ getGamma()

◆ getInnerIterations()

◆ getLambda()

◆ getMedianFiltering()

◆ getOuterIterations()

◆ getScalesNumber()

◆ getScaleStep()

◆ getTau()

◆ getTheta()

◆ getUseInitialFlow()

◆ getWarpingsNumber()

◆ setEpsilon()

◆ setGamma()

◆ setInnerIterations()

◆ setLambda()

◆ setMedianFiltering()

◆ setOuterIterations()

◆ setScalesNumber()

◆ setScaleStep()

◆ setTau()

◆ setTheta()

◆ setUseInitialFlow()

◆ setWarpingsNumber()