Shape Context 記述子およびマッチングアルゴリズムの実装。詳細...

#include <opencv2/shape/shape_distance.hpp>

Collaboration diagram for cv::ShapeContextDistanceExtractor:

公開メンバ関数
virtual int	getAngularBins () const =0

virtual float	getBendingEnergyWeight () const =0

virtual Ptr< HistogramCostExtractor >	getCostExtractor () const =0

virtual float	getImageAppearanceWeight () const =0

virtual void	getImages (OutputArray image1, OutputArray image2) const =0

virtual float	getInnerRadius () const =0

virtual int	getIterations () const =0

virtual float	getOuterRadius () const =0

virtual int	getRadialBins () const =0

virtual bool	getRotationInvariant () const =0

virtual float	getShapeContextWeight () const =0

virtual float	getStdDev () const =0

virtual Ptr< ShapeTransformer >	getTransformAlgorithm () const =0

virtual void	setAngularBins (int nAngularBins)=0
	形状マッチングのパイプラインで使用される Shape Context 記述子の角度方向のビン数を設定する。

virtual void	setBendingEnergyWeight (float bendingEnergyWeight)=0
	形状距離の最終値における Bending Energy の重みを設定する。Bending Energy の定義は、形状の位置合わせに用いる変換に依存する。形状距離の最終値は、shape context 距離、画像の見た目の距離 (image appearance distance)、および Bending Energy をユーザー定義の線形結合したものである。

virtual void	setCostExtractor (Ptr< HistogramCostExtractor > comparer)=0
	shape context 記述子のコスト行列を構築するために使用するアルゴリズムを設定する。

virtual void	setImageAppearanceWeight (float imageAppearanceWeight)=0
	形状距離の最終値における Image Appearance コストの重みを設定する。Image Appearance コストは、対応する画像点周辺のガウシアンウィンドウ内における輝度差の二乗和として定義される。形状距離の最終値は、shape context 距離、画像の見た目の距離、および Bending Energy をユーザー定義の線形結合したものである。この値を 0 以外の数値に設定する場合は、各形状に対応する画像を設定することが必須である。

virtual void	setImages (InputArray image1, InputArray image2)=0
	各形状に対応する画像を設定する。これらの画像は Image Appearance コストの計算に使用される。

virtual void	setInnerRadius (float innerRadius)=0
	shape context 記述子の内側半径を設定する。

virtual void	setIterations (int iterations)=0

virtual void	setOuterRadius (float outerRadius)=0
	shape context 記述子の外側半径を設定する。

virtual void	setRadialBins (int nRadialBins)=0
	形状マッチングのパイプラインで使用される Shape Context 記述子の動径方向のビン数を設定する。

virtual void	setRotationInvariant (bool rotationInvariant)=0

virtual void	setShapeContextWeight (float shapeContextWeight)=0
	形状距離の最終値における shape context 距離の重みを設定する。2 つの形状間の shape context 距離は、最良マッチング点における shape context マッチングコストの対称な総和として定義される。形状距離の最終値は、shape context 距離、画像の見た目の距離、および Bending Energy をユーザー定義の線形結合したものである。

virtual void	setStdDev (float sigma)=0
	Image Appearance コストのためのガウシアンウィンドウの標準偏差の値を設定する。

virtual void	setTransformAlgorithm (Ptr< ShapeTransformer > transformer)=0
	形状の位置合わせに使用するアルゴリズムを設定する。

Public Member Functions inherited from cv::ShapeDistanceExtractor
virtual float	computeDistance (InputArray contour1, InputArray contour2)=0
	輪郭で定義された2つの形状の間の形状距離を計算する。

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

詳細説明

Shape Context 記述子およびマッチングアルゴリズムの実装。

Belongie らによって "Shape Matching and Object Recognition Using Shape Contexts" (PAMI 2002) で提案された。この実装は汎用的な枠組みでパッケージ化されており、オリジナルのパイプラインに対する一般的なバリエーションを実装できるようにしている。

メンバ関数詳解

◆ getAngularBins()

virtual int cv::ShapeContextDistanceExtractor::getAngularBins ( ) const

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.getAngularBins(		) ->	retval

◆ getBendingEnergyWeight()

virtual float cv::ShapeContextDistanceExtractor::getBendingEnergyWeight ( ) const

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.getBendingEnergyWeight(		) ->	retval

◆ getCostExtractor()

virtual Ptr< HistogramCostExtractor > cv::ShapeContextDistanceExtractor::getCostExtractor ( ) const

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.getCostExtractor(		) ->	retval

◆ getImageAppearanceWeight()

virtual float cv::ShapeContextDistanceExtractor::getImageAppearanceWeight ( ) const

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.getImageAppearanceWeight(		) ->	retval

◆ getImages()

virtual void cv::ShapeContextDistanceExtractor::getImages	(	OutputArray	image1,
		OutputArray	image2 ) const

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.getImages(	[, image1[, image2]]	) ->	image1, image2

◆ getInnerRadius()

virtual float cv::ShapeContextDistanceExtractor::getInnerRadius ( ) const

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.getInnerRadius(		) ->	retval

◆ getIterations()

virtual int cv::ShapeContextDistanceExtractor::getIterations ( ) const

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.getIterations(		) ->	retval

◆ getOuterRadius()

virtual float cv::ShapeContextDistanceExtractor::getOuterRadius ( ) const

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.getOuterRadius(		) ->	retval

◆ getRadialBins()

virtual int cv::ShapeContextDistanceExtractor::getRadialBins ( ) const

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.getRadialBins(		) ->	retval

◆ getRotationInvariant()

virtual bool cv::ShapeContextDistanceExtractor::getRotationInvariant ( ) const

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.getRotationInvariant(		) ->	retval

◆ getShapeContextWeight()

virtual float cv::ShapeContextDistanceExtractor::getShapeContextWeight ( ) const

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.getShapeContextWeight(		) ->	retval

◆ getStdDev()

virtual float cv::ShapeContextDistanceExtractor::getStdDev ( ) const

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.getStdDev(		) ->	retval

◆ getTransformAlgorithm()

virtual Ptr< ShapeTransformer > cv::ShapeContextDistanceExtractor::getTransformAlgorithm ( ) const

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.getTransformAlgorithm(		) ->	retval

◆ setAngularBins()

virtual void cv::ShapeContextDistanceExtractor::setAngularBins ( int nAngularBins )

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.setAngularBins(	nAngularBins	) ->	None

形状マッチングのパイプラインで使用される Shape Context 記述子の角度方向のビン数を設定する。

引数

nAngularBins シェイプコンテキスト記述子における角度ビンの数。

◆ setBendingEnergyWeight()

virtual void cv::ShapeContextDistanceExtractor::setBendingEnergyWeight ( float bendingEnergyWeight )

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.setBendingEnergyWeight(	bendingEnergyWeight	) ->	None

形状距離の最終値における Bending Energy の重みを設定する。Bending Energy の定義は、形状の位置合わせに用いる変換に依存する。形状距離の最終値は、shape context 距離、画像の見た目の距離、および Bending Energy をユーザー定義の線形結合したものである。

引数

bendingEnergyWeight 最終的な距離値における曲げエネルギー（Bending Energy）の重み。

◆ setCostExtractor()

virtual void cv::ShapeContextDistanceExtractor::setCostExtractor ( Ptr< HistogramCostExtractor > comparer )

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.setCostExtractor(	comparer	) ->	None

shape context 記述子のコスト行列を構築するために使用するアルゴリズムを設定する。

引数

comparer 記述子間のコスト行列を定義するアルゴリズムである HistogramCostExtractor へのスマートポインタ。

◆ setImageAppearanceWeight()

virtual void cv::ShapeContextDistanceExtractor::setImageAppearanceWeight ( float imageAppearanceWeight )

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.setImageAppearanceWeight(	imageAppearanceWeight	) ->	None

形状距離の最終値における Image Appearance コストの重みを設定する。Image Appearance コストは、対応する画像点周辺のガウシアンウィンドウ内における輝度差の二乗和として定義される。形状距離の最終値は、shape context 距離、画像の見た目の距離、および Bending Energy をユーザー定義の線形結合したものである。この値を 0 以外の数値に設定する場合は、各形状に対応する画像を設定することが必須である。

引数

imageAppearanceWeight 最終的な距離値における外観コストの重み。

◆ setImages()

virtual void cv::ShapeContextDistanceExtractor::setImages	(	InputArray	image1,
		InputArray	image2 )

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.setImages(	image1, image2	) ->	None

各形状に対応する画像を設定する。これらの画像は Image Appearance コストの計算に使用される。

引数

image1	contours1 で定義された形状に対応する画像。
image2	contours2 で定義された形状に対応する画像。

◆ setInnerRadius()

virtual void cv::ShapeContextDistanceExtractor::setInnerRadius ( float innerRadius )

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.setInnerRadius(	innerRadius	) ->	None

shape context 記述子の内側半径を設定する。

引数

innerRadius 内側半径の値。

◆ setIterations()

virtual void cv::ShapeContextDistanceExtractor::setIterations ( int iterations )

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.setIterations(	iterations	) ->	None

◆ setOuterRadius()

virtual void cv::ShapeContextDistanceExtractor::setOuterRadius ( float outerRadius )

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.setOuterRadius(	outerRadius	) ->	None

shape context 記述子の外側半径を設定する。

引数

outerRadius 外側半径の値。

◆ setRadialBins()

virtual void cv::ShapeContextDistanceExtractor::setRadialBins ( int nRadialBins )

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.setRadialBins(	nRadialBins	) ->	None

形状マッチングのパイプラインで使用される Shape Context 記述子の動径方向のビン数を設定する。

引数

nRadialBins shape context 記述子における動径方向のビン数。

◆ setRotationInvariant()

virtual void cv::ShapeContextDistanceExtractor::setRotationInvariant ( bool rotationInvariant )

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.setRotationInvariant(	rotationInvariant	) ->	None

◆ setShapeContextWeight()

virtual void cv::ShapeContextDistanceExtractor::setShapeContextWeight ( float shapeContextWeight )

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.setShapeContextWeight(	shapeContextWeight	) ->	None

形状距離の最終値における shape context 距離の重みを設定する。2 つの形状間の shape context 距離は、最良マッチング点における shape context マッチングコストの対称な総和として定義される。形状距離の最終値は、shape context 距離、画像の見た目の距離、および Bending Energy をユーザー定義の線形結合したものである。

引数

shapeContextWeight 最終的な距離値における shape context 距離の重み。

◆ setStdDev()

virtual void cv::ShapeContextDistanceExtractor::setStdDev ( float sigma )

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.setStdDev(	sigma	) ->	None

Image Appearance コストのためのガウシアンウィンドウの標準偏差の値を設定する。

引数

sigma 標準偏差。

◆ setTransformAlgorithm()

virtual void cv::ShapeContextDistanceExtractor::setTransformAlgorithm ( Ptr< ShapeTransformer > transformer )

pure virtual

Python:
	cv.ShapeContextDistanceExtractor.setTransformAlgorithm(	transformer	) ->	None

形状の位置合わせに使用するアルゴリズムを設定する。

引数

transformer ShapeTransformer へのスマートポインタ。位置合わせ変換を定義するアルゴリズムである。

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

opencv2/shape/shape_distance.hpp

公開メンバ関数

Additional Inherited Members

詳細説明

メンバ関数詳解

◆ getAngularBins()

◆ getBendingEnergyWeight()

◆ getCostExtractor()

◆ getImageAppearanceWeight()

◆ getImages()

◆ getInnerRadius()

◆ getIterations()

◆ getOuterRadius()

◆ getRadialBins()

◆ getRotationInvariant()

◆ getShapeContextWeight()

◆ getStdDev()

◆ getTransformAlgorithm()

◆ setAngularBins()

◆ setBendingEnergyWeight()

◆ setCostExtractor()

◆ setImageAppearanceWeight()

◆ setImages()

◆ setInnerRadius()

◆ setIterations()

◆ setOuterRadius()

◆ setRadialBins()

◆ setRotationInvariant()

◆ setShapeContextWeight()

◆ setStdDev()

◆ setTransformAlgorithm()