Brute-force記述子マッチャー。詳細...

#include <opencv2/features.hpp>

Collaboration diagram for cv::BFMatcher:

公開メンバ関数
	BFMatcher (int normType=NORM_L2, bool crossCheck=false)
	Brute-forceマッチャーのコンストラクタ（廃止予定）。BFMatcher.create() を使用すること

virtual	~BFMatcher ()

virtual CV_NODISCARD_STD Ptr< DescriptorMatcher >	clone (bool emptyTrainData=false) const CV_OVERRIDE
	マッチャーを複製する。

virtual bool	isMaskSupported () const CV_OVERRIDE
	記述子マッチャーが許容マッチのマスキングをサポートしている場合は true を返す。

Public Member Functions inherited from cv::DescriptorMatcher
virtual	~DescriptorMatcher ()

virtual void	add (InputArrayOfArrays descriptors)
	CPU(trainDescCollectionis) または GPU(utrainDescCollectionis) の記述子コレクションを学習するために記述子を追加する。

virtual void	clear () CV_OVERRIDE
	学習用記述子コレクションをクリアする。

virtual bool	empty () const CV_OVERRIDE
	両方のコレクションに学習用記述子が存在しない場合は true を返す。

const std::vector< Mat > &	getTrainDescriptors () const
	学習用記述子コレクション trainDescCollection への定数リンクを返す。

void	knnMatch (InputArray queryDescriptors, InputArray trainDescriptors, std::vector< std::vector< DMatch > > &matches, int k, InputArray mask=noArray(), bool compactResult=false) const
	クエリ集合の各記述子に対して、上位 k 件の最良マッチを探索する。

void	knnMatch (InputArray queryDescriptors, std::vector< std::vector< DMatch > > &matches, int k, InputArrayOfArrays masks=noArray(), bool compactResult=false)

void	match (InputArray queryDescriptors, InputArray trainDescriptors, std::vector< DMatch > &matches, InputArray mask=noArray()) const
	クエリ集合の各記述子に対して、最良のマッチを探索する。

void	match (InputArray queryDescriptors, std::vector< DMatch > &matches, InputArrayOfArrays masks=noArray())

void	radiusMatch (InputArray queryDescriptors, InputArray trainDescriptors, std::vector< std::vector< DMatch > > &matches, float maxDistance, InputArray mask=noArray(), bool compactResult=false) const
	各クエリ記述子に対して、指定された距離以内にある学習用記述子を探索する。

void	radiusMatch (InputArray queryDescriptors, std::vector< std::vector< DMatch > > &matches, float maxDistance, InputArrayOfArrays masks=noArray(), bool compactResult=false)

virtual void	read (const FileNode &) CV_OVERRIDE
	ファイルストレージからアルゴリズムの引数を読み込む。

void	read (const String &fileName)

virtual void	train ()
	記述子マッチャーを学習する。

void	write (const Ptr< FileStorage > &fs, const String &name) const

void	write (const String &fileName) const

virtual void	write (FileStorage &) const CV_OVERRIDE
	アルゴリズムの引数をファイルストレージに保存する。

void	write (FileStorage &fs, const String &name) const

Public Member Functions inherited from cv::Algorithm
	Algorithm ()

virtual	~Algorithm ()

virtual String	getDefaultName () const

virtual void	save (const String &filename) const

void	write (FileStorage &fs, const String &name) const

静的公開メンバ関数
static Ptr< BFMatcher >	create (int normType=NORM_L2, bool crossCheck=false)
	Brute-forceマッチャーのcreateメソッド。

Static Public Member Functions inherited from cv::DescriptorMatcher
static Ptr< DescriptorMatcher >	create (const DescriptorMatcher::MatcherType &matcherType)

static Ptr< DescriptorMatcher >	create (const String &descriptorMatcherType)
	指定した型の記述子マッチャーをデフォルトのパラメータで（デフォルトコンストラクタを使って）生成する。

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)
	ファイルノードからアルゴリズムを読み込む。

限定公開メンバ関数
virtual void	knnMatchImpl (InputArray queryDescriptors, std::vector< std::vector< DMatch > > &matches, int k, InputArrayOfArrays masks=noArray(), bool compactResult=false) CV_OVERRIDE

virtual void	radiusMatchImpl (InputArray queryDescriptors, std::vector< std::vector< DMatch > > &matches, float maxDistance, InputArrayOfArrays masks=noArray(), bool compactResult=false) CV_OVERRIDE

Protected Member Functions inherited from cv::DescriptorMatcher
void	checkMasks (InputArrayOfArrays masks, int queryDescriptorsCount) const

Protected Member Functions inherited from cv::Algorithm
void	writeFormat (FileStorage &fs) const

限定公開変数類
bool	crossCheck

int	normType

Protected Attributes inherited from cv::DescriptorMatcher
std::vector< Mat >	trainDescCollection
	学習画像から得た記述子のコレクション。

std::vector< UMat >	utrainDescCollection

Additional Inherited Members
Public Types inherited from cv::DescriptorMatcher
enum	MatcherType { FLANNBASED = 1 , BRUTEFORCE = 2 , BRUTEFORCE_L1 = 3 , BRUTEFORCE_HAMMING = 4 , BRUTEFORCE_HAMMINGLUT = 5 , BRUTEFORCE_SL2 = 6 }

Static Protected Member Functions inherited from cv::DescriptorMatcher
static CV_NODISCARD_STD Mat	clone_op (Mat m)

static bool	isMaskedOut (InputArrayOfArrays masks, int queryIdx)

static bool	isPossibleMatch (InputArray mask, int queryIdx, int trainIdx)

詳細説明

Brute-force記述子マッチャー。

第1集合の各記述子について、このマッチャーは第2集合のすべての記述子を試して最も近い記述子を探索する。この記述子マッチャーは、記述子集合の許容マッチのマスキングをサポートする。

構築子と解体子の詳解

◆ BFMatcher()

cv::BFMatcher::BFMatcher	(	int	normType = NORM_L2,
		bool	crossCheck = false )

Python:
	cv.BFMatcher(	[, normType[, crossCheck]]	) ->	<BFMatcher object>

Brute-forceマッチャーのコンストラクタ（廃止予定）。BFMatcher.create() を使用すること

◆ ~BFMatcher()

virtual cv::BFMatcher::~BFMatcher ( )

inlinevirtual

メンバ関数詳解

◆ clone()

virtual CV_NODISCARD_STD Ptr< DescriptorMatcher > cv::BFMatcher::clone ( bool emptyTrainData = false ) const

virtual

マッチャーを複製する。

引数

emptyTrainData emptyTrainData が false の場合、このメソッドはオブジェクトのディープコピー、すなわちパラメータと学習データの両方をコピーしたものを作成する。emptyTrainData が true の場合は、現在のパラメータを保持しつつ学習データを空にしたオブジェクトのコピーを作成する。

cv::DescriptorMatcher を実装する。

◆ create()

static Ptr< BFMatcher > cv::BFMatcher::create	(	int	normType = NORM_L2,
		bool	crossCheck = false )

static

Python:
	cv.BFMatcher.create(	[, normType[, crossCheck]]	) ->	retval
	cv.BFMatcher_create(	[, normType[, crossCheck]]	) ->	retval

Brute-forceマッチャーのcreateメソッド。

引数

normType NORM_L1、NORM_L2、NORM_HAMMING、NORM_HAMMING2 のいずれか。L1 および L2 ノルムは SIFT やSURF記述子に適した選択肢であり、NORM_HAMMING は ORB、BRISK、BRIEF とともに使用すべきである。NORM_HAMMING2 は WTA_K==3 または 4 の場合に ORB とともに使用すべきである(ORB::ORB コンストラクタの説明を参照)。

crossCheck false の場合、これは各クエリ記述子に対して k 最近傍を探索する際の BFMatcher のデフォルトの挙動となる。crossCheck==true の場合、k=1 の knnMatch() メソッドは、i 番目のクエリ記述子に対してマッチャーのコレクション内の j 番目の記述子が最近傍であり、かつその逆も成り立つようなペア (i,j) のみを返す。すなわち BFMatcher は整合性のあるペアのみを返す。この手法は、十分な数のマッチがある場合に、外れ値を最小限に抑えながら通常は最良の結果をもたらす。これは D. Lowe が SIFT の論文で用いた比率テストの代替である。

◆ isMaskSupported()

virtual bool cv::BFMatcher::isMaskSupported ( ) const

inlinevirtual

記述子マッチャーが許容マッチのマスキングをサポートしている場合は true を返す。

cv::DescriptorMatcher を実装する。

◆ knnMatchImpl()

virtual void cv::BFMatcher::knnMatchImpl	(	InputArray	queryDescriptors,
		std::vector< std::vector< DMatch > > &	matches,
		int	k,
		InputArrayOfArrays	masks = noArray(),
		bool	compactResult = false )

protectedvirtual

実際のマッチングは、以下の2つのメソッドによってのみ実装される。これらのメソッドは、クラスオブジェクトがすでに学習済みであることを前提とする。public な match メソッドは、train() を呼び出した後にこれらのメソッドを呼び出す。

cv::DescriptorMatcher を実装する。

◆ radiusMatchImpl()

virtual void cv::BFMatcher::radiusMatchImpl	(	InputArray	queryDescriptors,
		std::vector< std::vector< DMatch > > &	matches,
		float	maxDistance,
		InputArrayOfArrays	masks = noArray(),
		bool	compactResult = false )

protectedvirtual

cv::DescriptorMatcher を実装する。

メンバ変数詳解

◆ crossCheck

bool cv::BFMatcher::crossCheck

protected

◆ normType

int cv::BFMatcher::normType

protected

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

opencv2/features.hpp

公開メンバ関数

静的公開メンバ関数

限定公開メンバ関数

限定公開変数類

Additional Inherited Members

詳細説明

構築子と解体子の詳解

◆ BFMatcher()

◆ ~BFMatcher()

メンバ関数詳解

◆ clone()

◆ create()

◆ isMaskSupported()

◆ knnMatchImpl()

◆ radiusMatchImpl()

メンバ変数詳解

◆ crossCheck

◆ normType