[1] で説明されているSLIC (Simple Linear Iterative Clustering) スーパーピクセルアルゴリズムを実装したクラス。続き...

#include <opencv2/ximgproc/slic.hpp>

Collaboration diagram for cv::ximgproc::SuperpixelSLIC:

公開メンバ関数
virtual void	enforceLabelConnectivity (int min_element_size=25)=0
	ラベルの連結性を強制する。

virtual void	getLabelContourMask (OutputArray image, bool thick_line=true) const =0
	SuperpixelSLIC オブジェクトに格納されたスーパーピクセルセグメンテーションのマスクを返す。

virtual void	getLabels (OutputArray labels_out) const =0
	画像のセグメンテーションラベリングを返す。

virtual int	getNumberOfSuperpixels () const =0
	SuperpixelSLIC オブジェクトで計算・格納されたセグメンテーションにおける実際のスーパーピクセル数を計算する。

virtual void	iterate (int num_iterations=10)=0
	SuperpixelSLIC オブジェクトに初期化された引数を用いて、与えられた画像のスーパーピクセルセグメンテーションを計算する。

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

詳細説明

[1] で説明されているSLIC (Simple Linear Iterative Clustering) スーパーピクセルアルゴリズムを実装したクラス。

SLIC (Simple Linear Iterative Clustering) は、ピクセルのチャンネルと画像平面空間を用いてピクセルをクラスタリングし、コンパクトでほぼ均一なスーパーピクセルを効率的に生成する。アプローチが単純であるため非常に使いやすく、スーパーピクセル数を指定する単一の引数だけで動作し、アルゴリズムの効率性により非常に実用的である。SLICクラスにはいくつかの最適化が用意されている。SLICOは「Zero parameter SLIC」を意味し、[1] で説明されているベースラインSLICの最適化版である。MSLICは「Manifold SLIC」を意味し、[175] で説明されているベースラインSLICの最適化版である。

メンバ関数詳解

◆ enforceLabelConnectivity()

virtual void cv::ximgproc::SuperpixelSLIC::enforceLabelConnectivity ( int min_element_size = 25 )

pure virtual

Python:
	cv.ximgproc.SuperpixelSLIC.enforceLabelConnectivity(	[, min_element_size]	) ->	None

ラベルの連結性を強制する。

引数

min_element_size より大きなスーパーピクセルに吸収されるべき最小の要素サイズ（パーセント単位）。得られた平均スーパーピクセルサイズに対して、有効な値は 0-100 の範囲であるべきで、25 は4分の1未満のサイズのスーパーピクセルが吸収されるべきことを意味し、これがデフォルトである。

小さすぎるコンポーネントをマージし、それまでに見つかった隣接ラベルをそのコンポーネントに割り当てる関数。この関数を呼び出すと、最終的なスーパーピクセル数が変わる場合がある。

◆ getLabelContourMask()

virtual void cv::ximgproc::SuperpixelSLIC::getLabelContourMask	(	OutputArray	image,
		bool	thick_line = true ) const

pure virtual

Python:
	cv.ximgproc.SuperpixelSLIC.getLabelContourMask(	[, image[, thick_line]]	) ->	image

SuperpixelSLIC オブジェクトに格納されたスーパーピクセルセグメンテーションのマスクを返す。

引数

image	戻り値: CV_8U1 の画像マスク。-1 はそのピクセルがスーパーピクセルの境界であることを示し、0 はそれ以外を示す。
thick_line	false の場合、境界の幅は1ピクセルのみとなり、それ以外の場合は境界上のすべてのピクセルがマスクされる。

スーパーピクセルセグメンテーションの境界を返す関数。

◆ getLabels()

virtual void cv::ximgproc::SuperpixelSLIC::getLabels ( OutputArray labels_out ) const

pure virtual

Python:
	cv.ximgproc.SuperpixelSLIC.getLabels(	[, labels_out]	) ->	labels_out

画像のセグメンテーションラベリングを返す。

各ラベルは1つのスーパーピクセルを表し、各ピクセルは1つのスーパーピクセルラベルに割り当てられる。

引数

labels_out 戻り値: スーパーピクセルセグメンテーションのラベルを含む CV_32SC1 の整数配列。ラベルは [0, getNumberOfSuperpixels()] の範囲にある。

スーパーピクセルセグメンテーションのラベルを持つ画像を返す関数。ラベルは [0, getNumberOfSuperpixels()] の範囲内である。

◆ getNumberOfSuperpixels()

virtual int cv::ximgproc::SuperpixelSLIC::getNumberOfSuperpixels ( ) const

pure virtual

Python:
	cv.ximgproc.SuperpixelSLIC.getNumberOfSuperpixels(		) ->	retval

SuperpixelSLIC オブジェクトで計算・格納されたセグメンテーションにおける実際のスーパーピクセル数を計算する。

◆ iterate()

virtual void cv::ximgproc::SuperpixelSLIC::iterate ( int num_iterations = 10 )

pure virtual

Python:
	cv.ximgproc.SuperpixelSLIC.iterate(	[, num_iterations]	) ->	None

SuperpixelSLIC オブジェクトに初期化された引数を用いて、与えられた画像のスーパーピクセルセグメンテーションを計算する。

この関数は、createSuperpixelSLIC() でアルゴリズムを初期化する必要なく再び呼び出せる。これにより、アルゴリズムの全構造体のメモリ確保にかかる計算コストを節約できる。

引数

num_iterations 反復回数。数を多くすると結果が改善される。

createSuperpixelSLIC() 関数で初期化された引数を用いて、画像のスーパーピクセルセグメンテーションを計算する関数。アルゴリズムはスーパーピクセルのグリッドから開始し、エッジ境界の更新を提案することで境界を改善する。

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

opencv2/ximgproc/slic.hpp

公開メンバ関数

Additional Inherited Members

詳細説明

メンバ関数詳解

◆ enforceLabelConnectivity()

◆ getLabelContourMask()

◆ getLabels()

◆ getNumberOfSuperpixels()

◆ iterate()