n-ary multi-dimensional array iterator. [詳解]

#include <mat.hpp>

公開メンバ関数
	NAryMatIterator ()
	デフォルトコンストラクタ

	NAryMatIterator (const Mat arrays, uchar ptrs, int narrays=-1)
	任意のn次元の行列を受け取るフルコンストラクタ

	NAryMatIterator (const Mat *arrays, Mat planes, int narrays=-1)
	任意のn次元の行列を受け取るフルコンストラクタ

void	init (const Mat *arrays, Mat planes, uchar **ptrs, int narrays=-1)
	独立したイテレータの初期化方法

NAryMatIterator &	operator++ ()
	反復された行列の次の平面に進む

NAryMatIterator	operator++ (int)
	反復された各行列の次の平面に進む（後置インクリメント演算子）．

公開変数類
const Mat **	arrays
	反復された配列．

Mat *	planes
	現在の平面

uchar **	ptrs
	データポインター

int	narrays
	配列の数

size_t	nplanes
	イテレータが通過する超平面の数．

size_t	size
	各セグメントのサイズ（要素数）．

限定公開変数類
int	iterdepth

size_t	idx

詳解

n-aryの多次元配列イテレータ．

このクラスを使って，多次元配列に対する単項，二項，そして一般的にはn-aryの要素単位の演算を実装します。n-ary 関数の引数には，連続した配列もあれば，そうでないものもあります．各配列に対して従来の MatIterator を使うことは可能ですが，小さな操作の後にすべてのイテレータをインクリメントするのは，大きなオーバーヘッドになります．この場合はNAryMatIteratorを使って，複数の行列を同時にイテレートすることを考えてみてください．ただし，それらの行列が同じジオメトリ（次元数，すべての次元サイズが同じ）である場合に限ります．各反復においてit.planes[0],it.planes[1],...は対応する行列のスライスになります。

以下の例は，正規化された閾値付きの3次元カラーヒストグラムを計算する方法を示しています．

void
computeNormalizedColorHist(const
Mat& image, Mat& hist,
int
N,
double
minProb)
{

const
int
histSize[] = {N, N, N};

// make sure that the histogram has a proper size and type

hist.create(3, histSize, CV_32F);

// and clear it

hist = Scalar(0);

// the loop below assumes that the image

// is a 8-bit 3-channel. check it.

CV_Assert(image.type() == CV_8UC3);

MatConstIterator_<Vec3b> it = image.begin<Vec3b>(),

it_end = image.end<Vec3b>();

for( ; it != it_end; ++it )

{

const
Vec3b& pix = *it;

hist.at<float>(pix[0]*N/256, pix[1]*N/256, pix[2]*N/256) += 1.f;

}

minProb *= image.rows*image.cols;

// initialize iterator (the style is different from STL).

// after initialization the iterator will contain

// the number of slices or planes the iterator will go through.

// it simultaneously increments iterators for several matrices

// supplied as a null terminated list of pointers

const
Mat*
arrays[] = {&hist, 0};

Mat
planes[1];

NAryMatIterator
itNAry(arrays,
planes, 1);

double
s = 0;

// iterate through the matrix. on each iteration

// itNAry.planes[i] (of type Mat) will be set to the current plane

// of the i-th n-dim matrix passed to the iterator constructor.

for(int
p = 0; p < itNAry.nplanes; p++, ++itNAry)

{

threshold(itNAry.planes[0], itNAry.planes[0], minProb, 0,
THRESH_TOZERO);

s += sum(itNAry.planes[0])[0];

}

s = 1./s;

itNAry =
NAryMatIterator(arrays,
planes, 1);

for(int
p = 0; p < itNAry.nplanes; p++, ++itNAry)

itNAry.planes[0] *= s;
}

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

mat.hpp

公開メンバ関数

公開変数類

限定公開変数類

詳解