Maximally stable extremal region extractor [詳解]

#include <features2d.hpp>

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

公開メンバ関数
virtual CV_WRAP void	detectRegions (InputArray image, CV_OUT std::vector< std::vector< Point > > &msers, CV_OUT std::vector< Rect > &bboxes)=0
	MSER領域の検出[【詳解】（英語］

virtual CV_WRAP void	setDelta (int delta)=0

virtual CV_WRAP int	getDelta () const =0

virtual CV_WRAP void	setMinArea (int minArea)=0

virtual CV_WRAP int	getMinArea () const =0

virtual CV_WRAP void	setMaxArea (int maxArea)=0

virtual CV_WRAP int	getMaxArea () const =0

virtual CV_WRAP void	setPass2Only (bool f)=0

virtual CV_WRAP bool	getPass2Only () const =0

virtual CV_WRAP String	getDefaultName () const CV_OVERRIDE

基底クラス cv::Feature2D に属する継承公開メンバ関数
virtual CV_WRAP void	detect (InputArray image, CV_OUT std::vector< KeyPoint > &keypoints, InputArray mask=noArray())
	画像（第1のバージョン）または画像セット（第2のバージョン）からキーポイントを検出します。[【詳解】（英語］

virtual CV_WRAP void	detect (InputArrayOfArrays images, CV_OUT std::vector< std::vector< KeyPoint > > &keypoints, InputArrayOfArrays masks=noArray())

virtual CV_WRAP void	compute (InputArray image, CV_OUT CV_IN_OUT std::vector< KeyPoint > &keypoints, OutputArray descriptors)
	画像（第1の形式）または画像集合（第2の形式）から検出されるキーポイントの集合に対するディスクリプタを計算します．[【詳解】（英語］

virtual CV_WRAP void	compute (InputArrayOfArrays images, CV_OUT CV_IN_OUT std::vector< std::vector< KeyPoint > > &keypoints, OutputArrayOfArrays descriptors)

virtual CV_WRAP void	detectAndCompute (InputArray image, InputArray mask, CV_OUT std::vector< KeyPoint > &keypoints, OutputArray descriptors, bool useProvidedKeypoints=false)

virtual CV_WRAP int	descriptorSize () const

virtual CV_WRAP int	descriptorType () const

virtual CV_WRAP int	defaultNorm () const

CV_WRAP void	write (const String &fileName) const

CV_WRAP void	read (const String &fileName)

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

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

virtual CV_WRAP bool	empty () const CV_OVERRIDE
	検出器オブジェクトが空の場合は，trueを返します．[【詳解】（英語］

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

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

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

virtual CV_WRAP void	save (const String &filename) const

静的公開メンバ関数
static CV_WRAP Ptr< MSER >	create (int delta=5, int min_area=60, int max_area=14400, double max_variation=0.25, double min_diversity=.2, int max_evolution=200, double area_threshold=1.01, double min_margin=0.003, int edge_blur_size=5)
	MSER検出器のフルコンストラクタ[【詳解】（英語］

基底クラス 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

詳解

最大限に安定した極値領域抽出器

このクラスは，MSER 抽出アルゴリズムのすべてのパラメータをカプセル化します (wiki記事).

MSERには2つの異なる実装があります：1つはグレー画像用，もう1つはカラー画像用です
灰色画像のアルゴリズムは[nister2008linear] から引用しています。この論文では union-find 法よりも高速であるとしていますが、私の centrino L7200 1.2GHz ラップトップでは実際に 1.5~2m/s の速度が得られました。
カラー画像のアルゴリズムは、以下から引用しています。[forssen2007maximally] から引用しています。カラー画像のアルゴリズムは [forssen2007maximally]から引用していますが、グレー画像よりもはるかに遅いはずです（3〜4倍）。
(Python) MSER検出器の完全な使用例はsamples/python/mser.pyにあります。

関数詳解

◆ create()

static CV_WRAP Ptr< MSER > cv::MSER::create	(	int	delta = `5`,
		int	min_area = `60`,
		int	max_area = `14400`,
		double	max_variation = `0.25`,
		double	min_diversity = `.2`,
		int	max_evolution = `200`,
		double	area_threshold = `1.01`,
		double	min_margin = `0.003`,
		int	edge_blur_size = `5`
	)

static

MSER検出器のフルコンストラクタ

引数

delta	を比較します。 $(size_{i}-size_{i-delta})/size_{i-delta}$
min_area	minAreaよりも小さい領域を削除します。
max_area	maxAreaよりも大きい領域を削除します。
max_variation	子領域と同じ大きさの領域を除去する
min_diversity	カラー画像の場合，min_diversity以下の多様性を持つMSERをカットするためのトレースバック
max_evolution	カラー画像の場合，進化のステップ
area_threshold	カラー画像の場合，再初期化の原因となる領域の閾値
min_margin	カラー画像において，小さすぎるマージンを無視する
edge_blur_size	カラー画像で、エッジをぼかすための開口部の大きさを決める

◆ detectRegions()

virtual CV_WRAP void cv::MSER::detectRegions	(	InputArray	image,
		CV_OUT std::vector< std::vector< Point > > &	msers,
		CV_OUT std::vector< Rect > &	bboxes
	)

pure virtual

MSER領域の検出

引数

image	入力画像 (8UC1, 8UC3 または 8UC4, 3x3 以上であること)
msers	結果として得られる点群のリスト
bboxes	結果として得られるバウンディングボックス

◆ getDefaultName()

virtual CV_WRAP String cv::MSER::getDefaultName ( ) const

virtual

algorithm string identifier を返す。この文字列は，オブジェクトをファイルや文字列に保存する際に，最上位のxml/ymlノードタグとして使用されます．

cv::Feature2Dを再実装します。

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

features2d.hpp

公開メンバ関数

静的公開メンバ関数

その他の継承メンバ

詳解

関数詳解

◆ create()

◆ detectRegions()

◆ getDefaultName()