構造解析と形状記述子

詳細説明

列挙型
enum	cv::cuda::MomentsOrder {   cv::cuda::FIRST_ORDER_MOMENTS = 1 ,   cv::cuda::SECOND_ORDER_MOMENTS = 2 ,   cv::cuda::THIRD_ORDER_MOMENTS = 3 }
	画像モーメントの次数。 詳細...

関数
Moments	cv::cuda::convertSpatialMoments (Mat spatialMoments, const MomentsOrder order, const int momentsType)
	cuda::spatialMoments から返される空間画像モーメントを cv::Moments に変換する。
Moments	cv::cuda::moments (InputArray src, const bool binaryImage=false, const MomentsOrder order=MomentsOrder::THIRD_ORDER_MOMENTS, const int momentsType=CV_64F)
	ラスタライズされた形状について、3次までのすべてのモーメントを計算する。
int	cv::cuda::numMoments (const MomentsOrder order)
	最大の画像モーメント次数 order 以下の画像モーメントの数を返す。
void	cv::cuda::spatialMoments (InputArray src, OutputArray moments, const bool binaryImage=false, const MomentsOrder order=MomentsOrder::THIRD_ORDER_MOMENTS, const int momentsType=CV_64F, Stream &stream=Stream::Null())
	ラスタライズされた形状の3次までのすべての空間モーメントを計算する。

列挙型詳解

MomentsOrder

enum cv::cuda::MomentsOrder

#include <opencv2/cudaimgproc.hpp>

画像モーメントの次数。

引数

FIRST_ORDER_MOMENTS	1次モーメント
SECOND_ORDER_MOMENTS	2次モーメント。
THIRD_ORDER_MOMENTS	3次モーメント。

列挙値
FIRST_ORDER_MOMENTS
SECOND_ORDER_MOMENTS
THIRD_ORDER_MOMENTS

関数詳解

convertSpatialMoments()

Moments cv::cuda::convertSpatialMoments	(	Mat	spatialMoments,
		const MomentsOrder	order,
		const int	momentsType )

#include <opencv2/cudaimgproc.hpp>

cuda::spatialMoments から返される空間画像モーメントを cv::Moments に変換する。

引数

spatialMoments	cuda::spatialMoments から返される空間モーメント。
order	cuda::spatialMoments で画像モーメントを計算する際に使用する次数。
momentsType	cuda::spatialMoments で画像モーメントを計算する際に使用する精度。

戻り値

cv::Moments.

参照

cuda::spatialMoments, cuda::moments, cuda::convertSpatialMoments, cuda::numMoments, cuda::MomentsOrder

moments()

Moments cv::cuda::moments	(	InputArray	src,
		const bool	binaryImage = false,
		const MomentsOrder	order = MomentsOrder::THIRD_ORDER_MOMENTS,
		const int	momentsType = CV_64F )

#include <opencv2/cudaimgproc.hpp>

ラスタライズされた形状の3次までの全モーメントを計算する。

この関数はラスタライズされた形状の3次までのモーメントを計算する。結果は構造体 cv::Moments に返される。

引数

src	ラスター画像（シングルチャンネルの2次元配列）。
binaryImage	true の場合、すべての非ゼロの画像ピクセルが1として扱われる。
order	計算する最大モーメントの次数。低次のモーメントほど計算量が少なくて済む。
momentsType	モーメントを計算する際に使用する精度。使用可能な型は CV_32F と CV_64F であり、CV_32F の性能は CV_64F より1桁大きい。画像が小さい場合、CV_32F の精度は CV_64F と同等またはきわめて近くなることがある。

覚え書き

最大の性能を得るには、非同期版の cuda::spatialMoments() を使用すること。本バージョンは内部で GpuMat と HostMem の両方を確保および解放し、それぞれデバイス上で計算を行い結果をホストへダウンロードする。コストの高い HostMem の確保は回避できないが、GpuMat のデバイス確保は BufferPool を使うことで回避できる。例えば次のようにする。

setBufferPoolUsage(true);
setBufferPoolConfig(getDevice(), numMoments(order) * ((momentsType == CV_64F) ? sizeof(double) : sizeof(float)), 1);

例については opencv_contrib_source_code/modules/cudaimgproc/test/test_moments.cpp 内の CUDA_TEST_P(Moments, Accuracy) テストを参照のこと。

戻り値

cv::Moments.

参照

cuda::spatialMoments, cuda::convertSpatialMoments, cuda::numMoments, cuda::MomentsOrder

numMoments()

int cv::cuda::numMoments

(

const MomentsOrder

order

)

#include <opencv2/cudaimgproc.hpp>

最大の画像モーメント次数 order 以下の画像モーメントの個数を返す。

引数

order

計算する最大モーメントの次数。低次のモーメントほど計算量が少なくて済む。

戻り値

画像モーメントの個数。

参照

cuda::spatialMoments, cuda::moments, cuda::MomentsOrder

spatialMoments()

void cv::cuda::spatialMoments	(	InputArray	src,
		OutputArray	moments,
		const bool	binaryImage = false,
		const MomentsOrder	order = MomentsOrder::THIRD_ORDER_MOMENTS,
		const int	momentsType = CV_64F,
		Stream &	stream = Stream::Null() )

#include <opencv2/cudaimgproc.hpp>

ラスタライズされた形状の3次までの全空間モーメントを計算する。

cuda::moments() の非同期版で、ラスタライズされた形状の3次までの空間モーメント（中心モーメントや正規化モーメントではない）のみを計算する。各モーメントは1次元の moments 配列に列要素として返される。

引数

	src	ラスター画像（シングルチャンネルの2次元配列）。
[out]	moments	各列の要素に空間画像モーメントを1つずつ含む1次元配列。
	binaryImage	true の場合、すべての非ゼロの画像ピクセルが1として扱われる。
	order	計算する最大モーメントの次数。低次のモーメントほど計算量が少なくて済む。
	momentsType	モーメントを計算する際に使用する精度。使用可能な型は CV_32F と CV_64F であり、CV_32F の性能は CV_64F より1桁大きい。画像が小さい場合、CV_32F の精度は CV_64F と同等またはきわめて近くなることがある。
	stream	非同期版のための Stream。

覚え書き

最大の性能を得るには、所望の order までのすべての画像モーメントを格納できるだけの正しい型と十分なサイズを持つ1次元の GpuMat を moments 用に事前に確保しておくこと。例えば、order === MomentsOrder::SECOND_ORDER_MOMENTS かつ momentsType == CV_32F の場合、moments は次のように確保できる。

GpuMat momentsDevice(1,numMoments(MomentsOrder::SECOND_ORDER_MOMENTS),CV_32F)

中心モーメントおよび正規化モーメントは、moments 配列をダウンロードして cuda::convertSpatialMoments ヘルパー関数を使うことで、ホスト側で容易に計算できる。例えば次のようにする。

HostMem spatialMomentsHostMem(1, numMoments(MomentsOrder::SECOND_ORDER_MOMENTS), CV_32F);
spatialMomentsDevice.download(spatialMomentsHostMem, stream);
stream.waitForCompletion();
Mat spatialMoments = spatialMomentsHostMem.createMatHeader();
cv::Moments cvMoments = convertSpatialMoments<float>(spatialMoments, order);

例については opencv_contrib_source_code/modules/cudaimgproc/test/test_moments.cpp 内の CUDA_TEST_P(Moments, Async) テストを参照のこと。

参照

cuda::moments, cuda::convertSpatialMoments, cuda::numMoments, cuda::MomentsOrder