cv::ShapeContextDistanceExtractor クラス

Implementation of the Shape Context descriptor and matching algorithm [詳解]

#include <shape_distance.hpp>

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

公開メンバ関数
virtual CV_WRAP void	setAngularBins (int nAngularBins)=0
	形状マッチングパイプラインで使用されるShape Context Descriptorの角度ビン数を設定します。[【詳解】（英語］
virtual CV_WRAP int	getAngularBins () const =0
virtual CV_WRAP void	setRadialBins (int nRadialBins)=0
	形状マッチングパイプラインで使用される形状コンテキスト記述子の放射状ビンの数を設定する。[【詳解】（英語］
virtual CV_WRAP int	getRadialBins () const =0
virtual CV_WRAP void	setInnerRadius (float innerRadius)=0
	形状コンテキスト記述子の内側半径を設定します。[【詳解】（英語］
virtual CV_WRAP float	getInnerRadius () const =0
virtual CV_WRAP void	setOuterRadius (float outerRadius)=0
	シェイプコンテキスト記述子の外半径を設定します。[【詳解】（英語］
virtual CV_WRAP float	getOuterRadius () const =0
virtual CV_WRAP void	setRotationInvariant (bool rotationInvariant)=0
virtual CV_WRAP bool	getRotationInvariant () const =0
virtual CV_WRAP void	setShapeContextWeight (float shapeContextWeight)=0
	形状距離の最終値における形状コンテキスト距離の重みを設定する。2つの形状間の形状コンテキスト距離は、ベストマッチングポイント上の形状コンテキストマッチングコストの対称和として定義される。シェイプディスタンスの最終値は、シェイプコンテクストディスタンス、イメージアピアランスディスタンス、および曲げエネルギーのユーザー定義の線形結合です。[【詳解】（英語］
virtual CV_WRAP float	getShapeContextWeight () const =0
virtual CV_WRAP void	setImageAppearanceWeight (float imageAppearanceWeight)=0
	形状距離の最終値における画像出現コストの重みを設定する。画像外観コストは，対応する画像点の周囲のガウス窓における輝度差の二乗の総和として定義される．形状距離の最終値は、形状コンテキスト距離、画像外観距離、および曲げエネルギーのユーザー定義の線形結合です。この値が0とは異なる数値に設定された場合、各形状に対応する画像の設定が必須となる。[【詳解】（英語］
virtual CV_WRAP float	getImageAppearanceWeight () const =0
virtual CV_WRAP void	setBendingEnergyWeight (float bendingEnergyWeight)=0
	形状距離の最終値に曲げエネルギーの重みを設定する。曲げエネルギーの定義は、形状の整列にどのような変換が使用されているかに依存する。形状距離の最終値は、形状コンテキスト距離、画像外観距離、曲げエネルギーのユーザー定義の線形結合である。[【詳解】（英語］
virtual CV_WRAP float	getBendingEnergyWeight () const =0
virtual CV_WRAP void	setImages (InputArray image1, InputArray image2)=0
	各形状に対応する画像を設定します。この画像は、画像出現コストの計算に使用されます。[【詳解】（英語］
virtual CV_WRAP void	getImages (OutputArray image1, OutputArray image2) const =0
virtual CV_WRAP void	setIterations (int iterations)=0
virtual CV_WRAP int	getIterations () const =0
virtual CV_WRAP void	setCostExtractor (Ptr< HistogramCostExtractor > comparer)=0
	形状コンテキスト記述子のコスト行列の構築に使用されるアルゴリズムを設定します。[【詳解】（英語］
virtual CV_WRAP Ptr< HistogramCostExtractor >	getCostExtractor () const =0
virtual CV_WRAP void	setStdDev (float sigma)=0
	画像外観コストのガウス窓の標準偏差の値を設定します。[【詳解】（英語］
virtual CV_WRAP float	getStdDev () const =0
virtual CV_WRAP void	setTransformAlgorithm (Ptr< ShapeTransformer > transformer)=0
	形状の整列に使用するアルゴリズムを設定します。[【詳解】（英語］
virtual CV_WRAP Ptr< ShapeTransformer >	getTransformAlgorithm () const =0
基底クラス cv::ShapeDistanceExtractor に属する継承公開メンバ関数
virtual CV_WRAP float	computeDistance (InputArray contour1, InputArray contour2)=0
	輪郭で定義される2つの形状間の形状距離を計算します．[【詳解】（英語］
基底クラス cv::Algorithm に属する継承公開メンバ関数
virtual CV_WRAP void	clear ()
	アルゴリズムの状態をクリアする[【詳解】（英語］
virtual void	write (FileStorage &fs) const
	アルゴリズムのパラメーターをファイルストレージに格納[【詳解】（英語］
CV_WRAP void	write (const Ptr< FileStorage > &fs, const String &name=String()) const
	これはオーバーロードされたメンバ関数です。利便性のために用意されています。元の関数との違いは引き数のみです。
virtual CV_WRAP void	read (const FileNode &fn)
	アルゴリズム・パラメータをファイル・ストレージから読み込みます。[【詳解】（英語］
virtual CV_WRAP bool	empty () const
	が空の場合はtrueを返します。Algorithmが空の場合は真を返します。[【詳解】（英語］
virtual CV_WRAP void	save (const String &filename) const
virtual CV_WRAP String	getDefaultName () const

その他の継承メンバ
基底クラス 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

詳解

図形コンテクスト記述子とマッチングアルゴリズムの実装

Belongieらが "Shape Matching and Object Recognition Using Shape Contexts" (PAMI 2002)で提案したShape Context記述子とマッチングアルゴリズムの実装です。この実装は、オリジナルのパイプラインの一般的なバリエーションの実装を可能にするために、汎用的なスキームでパッケージ化されています。

関数詳解

setAngularBins()

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

pure virtual

形状マッチングパイプラインで使用されるShape Context Descriptorの角度ビン数を設定します。

引数

nAngularBins

形状コンテキスト記述子の角度ビンの数。

setBendingEnergyWeight()

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

pure virtual

形状距離の最終値に曲げエネルギーの重みを設定する。曲げエネルギーの定義は、形状の整列にどのような変換が使用されているかに依存する。形状距離の最終値は、形状コンテキスト距離、画像外観距離、曲げエネルギーのユーザー定義の線形結合である。

引数

bendingEnergyWeight

最終的な距離の値における曲げエネルギーの重みです。

setCostExtractor()

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

pure virtual

形状コンテキスト記述子のコスト行列の構築に使用されるアルゴリズムを設定します。

引数

comparer

へのスマートポインタHistogramCostExtractor, ディスクリプタ間のコスト行列を定義するアルゴリズム．

setImageAppearanceWeight()

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

pure virtual

形状距離の最終値における画像出現コストの重みを設定する。画像外観コストは，対応する画像点の周囲のガウス窓における輝度差の二乗の総和として定義される．形状距離の最終値は、形状コンテキスト距離、画像外観距離、および曲げエネルギーのユーザー定義の線形結合です。この値が0とは異なる数値に設定された場合、各形状に対応する画像の設定が必須となる。

引数

imageAppearanceWeight

最終的な距離値における出現コストの重みを設定します。

setImages()

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

pure virtual

各形状に対応する画像を設定します。この画像は、画像出現コストの計算に使用されます。

引数

image1	輪郭1で定義された形状に対応する画像です。
image2	輪郭2で定義された形状に対応する画像。

setInnerRadius()

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

pure virtual

形状コンテキスト記述子の内側半径を設定します。

引数

innerRadius

内側の半径の値です。

setOuterRadius()

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

pure virtual

シェイプコンテキスト記述子の外半径を設定します。

引数

outerRadius

外側の半径を設定します。

setRadialBins()

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

pure virtual

形状マッチングパイプラインで使用される形状コンテキスト記述子の放射状ビンの数を設定する。

引数

nRadialBins

形状コンテキスト記述子の放射状ビンの数を設定する。

setShapeContextWeight()

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

pure virtual

形状距離の最終値における形状コンテキスト距離の重みを設定する。2つの形状間の形状コンテキスト距離は、ベストマッチングポイント上の形状コンテキストマッチングコストの対称和として定義される。シェイプディスタンスの最終値は、シェイプコンテクストディスタンス、イメージアピアランスディスタンス、および曲げエネルギーのユーザー定義の線形結合です。

引数

shapeContextWeight

最終的な距離値における形状コンテキスト距離の重みを設定します。

setStdDev()

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

pure virtual

画像外観コストのガウス窓の標準偏差の値を設定します。

引数

sigma

標準偏差を設定します。

setTransformAlgorithm()

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

pure virtual

形状の整列に使用するアルゴリズムを設定します。

引数

transformer

へのスマートポインタShapeTransformer, 整列変換を定義するアルゴリズム。

---

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

• shape_distance.hpp