記述子の集合から bag of visual words の語彙を学習するための抽象基底クラス。続き...

#include <opencv2/features2d.hpp>

Collaboration diagram for cv::BOWTrainer:

公開メンバ関数
	BOWTrainer ()

virtual	~BOWTrainer ()

void	add (const Mat &descriptors)
	学習用セットに記述子を追加する。

virtual void	clear ()

virtual Mat	cluster () const =0

virtual Mat	cluster (const Mat &descriptors) const =0
	学習用記述子をクラスタリングする。

int	descriptorsCount () const
	学習用セットに格納されている全記述子の数を返す。

const std::vector< Mat > &	getDescriptors () const
	記述子の学習用セットを返す。

限定公開変数類
std::vector< Mat >	descriptors

int	size

詳細説明

記述子の集合から bag of visual words の語彙を学習するための抽象基底クラス。

詳細については、例えば Gabriella Csurka, Christopher R. Dance, Lixin Fan, Jutta Willamowski, Cedric Bray による Visual Categorization with Bags of Keypoints（2004年）を参照のこと。 :

構築子と解体子の詳解

◆ BOWTrainer()

cv::BOWTrainer::BOWTrainer ( )

◆ ~BOWTrainer()

virtual cv::BOWTrainer::~BOWTrainer ( )

virtual

メンバ関数詳解

◆ add()

void cv::BOWTrainer::add ( const Mat & descriptors )

Python:
	cv.BOWTrainer.add(	descriptors	) ->	None

学習セットに記述子を追加する。

引数

descriptors 学習セットに追加する記述子。記述子行列の各行が1つの記述子である。

語彙を構築するため、学習セットは clustermethod を使ってクラスタリングされる。

◆ clear()

virtual void cv::BOWTrainer::clear ( )

virtual

Python:
	cv.BOWTrainer.clear(		) ->	None

◆ cluster() [1/2]

virtual Mat cv::BOWTrainer::cluster ( ) const

pure virtual

Python:
	cv.BOWTrainer.cluster(		) ->	retval
	cv.BOWTrainer.cluster(	descriptors	) ->	retval

これは利便性のために提供されているオーバーロードされたメンバ関数である。上記の関数とは、受け取る引数のみが異なる。

cv::BOWKMeansTrainer で実装されている。

◆ cluster() [2/2]

virtual Mat cv::BOWTrainer::cluster ( const Mat & descriptors ) const

pure virtual

Python:
	cv.BOWTrainer.cluster(		) ->	retval
	cv.BOWTrainer.cluster(	descriptors	) ->	retval

学習用記述子をクラスタリングする。

引数

descriptors クラスタリングする記述子。記述子行列の各行が1つの記述子である。記述子は内部の学習用記述子セットには追加されない。

語彙はクラスタ中心から構成される。したがって、このメソッドは語彙を返す。メソッドの第1のバリアントでは、オブジェクトに格納された学習用記述子がクラスタリングされる。第2のバリアントでは、入力された記述子がクラスタリングされる。

cv::BOWKMeansTrainer で実装されている。

◆ descriptorsCount()

int cv::BOWTrainer::descriptorsCount ( ) const

Python:
	cv.BOWTrainer.descriptorsCount(		) ->	retval

学習セットに格納されている全記述子の数を返す。

◆ getDescriptors()

const std::vector< Mat > & cv::BOWTrainer::getDescriptors ( ) const

Python:
	cv.BOWTrainer.getDescriptors(		) ->	retval

記述子の学習セットを返す。

メンバ変数詳解

◆ descriptors

std::vector<Mat> cv::BOWTrainer::descriptors

protected

◆ size

int cv::BOWTrainer::size