cv::linemod::Detector 类参考

使用 LINE 模板匹配算法和任意一组模态的对象检测器。 更多…

#include <opencv2/rgbd/linemod.hpp>

cv::linemod::Detector 的协作图

公共成员函数
	Detector ()
	空构造函数，使用 read() 初始化。
	Detector (const std::vector< Ptr< Modality > > &modalities, const std::vector< int > &T_pyramid)
	构造函数。
int	addSyntheticTemplate (const std::vector< Template > &templates, const String &class_id)
	添加由外部方法计算的新对象模板。
int	addTemplate (const std::vector< Mat > &sources, const String &class_id, const Mat &object_mask, Rect *bounding_box=NULL)
	添加新的对象模板。
std::vector< String >	classIds () const
const std::vector< Ptr< Modality > > &	getModalities () const
	获取此检测器使用的模态。
int	getT (int pyramid_level) const
	获取 pyramid_level 处的采样步长 T。
const std::vector< Template > &	getTemplates (const String &class_id, int template_id) const
	获取由 template_id 标识的模板金字塔。
void	match (const std::vector< Mat > &sources, float threshold, std::vector< Match > &matches, const std::vector< String > &class_ids=std::vector< String >(), OutputArrayOfArrays quantized_images=noArray(), const std::vector< Mat > &masks=std::vector< Mat >()) const
	通过模板匹配检测对象。
int	numClasses () const
int	numTemplates () const
int	numTemplates (const String &class_id) const
int	pyramidLevels () const
	获取此检测器使用的金字塔级别数。
void	read (const FileNode &fn)
String	readClass (const FileNode &fn, const String &class_id_override="")
void	readClasses (const std::vector< String > &class_ids, const String &format="templates_%s.yml.gz")
void	write (FileStorage &fs) const
void	writeClass (const String &class_id, FileStorage &fs) const
void	writeClasses (const String &format="templates_%s.yml.gz") const

受保护类型
typedef std::vector< Mat >	LinearMemories
typedef std::vector< std::vector< LinearMemories > >	LinearMemoryPyramid
typedef std::vector< Template >	TemplatePyramid
typedef std::map< String, std::vector< TemplatePyramid > >	TemplatesMap

受保护成员函数
void	matchClass (const LinearMemoryPyramid &lm_pyramid, const std::vector< Size > &sizes, float threshold, std::vector< Match > &matches, const String &class_id, const std::vector< TemplatePyramid > &template_pyramids) const

受保护属性
TemplatesMap	class_templates
std::vector< Ptr< Modality > >	modalities
int	pyramid_levels
std::vector< int >	T_at_level

详细描述

使用 LINE 模板匹配算法和任意一组模态的对象检测器。

成员类型定义文档

LinearMemories

std::vector<Mat> cv::linemod::Detector::LinearMemories

受保护的

LinearMemoryPyramid

std::vector< std::vector<LinearMemories> > cv::linemod::Detector::LinearMemoryPyramid

受保护的

TemplatePyramid

std::vector<Template> cv::linemod::Detector::TemplatePyramid

受保护的

TemplatesMap

std::map<String, std::vector<TemplatePyramid> > cv::linemod::Detector::TemplatesMap

受保护的

构造函数和析构函数文档

Detector() [1/2]

cv::linemod::Detector::Detector

(

)

Python
	cv.linemod.Detector(		) ->	<linemod_Detector 对象>
	cv.linemod.Detector(	modalities, T_pyramid	) ->	<linemod_Detector 对象>

空构造函数，使用 read() 初始化。

Detector() [2/2]

cv::linemod::Detector::Detector	(	const std::vector< Ptr< Modality > > &	modalities,
		const std::vector< int > &	T_pyramid )

Python
	cv.linemod.Detector(		) ->	<linemod_Detector 对象>
	cv.linemod.Detector(	modalities, T_pyramid	) ->	<linemod_Detector 对象>

构造函数。

参数

modalities	使用的模态（颜色梯度、深度法线……）。
T_pyramid	每一层金字塔的采样步长 T 的值。金字塔的层数为 T_pyramid.size()。

成员函数文档

addSyntheticTemplate()

int cv::linemod::Detector::addSyntheticTemplate	(	const std::vector< Template > &	templates,
		const String &	class_id )

Python
	cv.linemod.Detector.addSyntheticTemplate(	templates, class_id	) ->	retval

添加由外部方法计算的新对象模板。

addTemplate()

int cv::linemod::Detector::addTemplate	(	const std::vector< Mat > &	sources,
		const String &	class_id,
		const Mat &	object_mask,
		Rect *	bounding_box = NULL )

Python
	cv.linemod.Detector.addTemplate(	sources, class_id, object_mask	) ->	retval, bounding_box

添加新的对象模板。

参数

	sources	源图像，每个模态一个。
	class_id	对象类别 ID。
	object_mask	分离对象和背景的掩码。
[输出]	bounding_box	可以选择返回提取特征的边界框。

返回值

Template ID，如果未能提取有效的模板，则返回 -1。

classIds()

std::vector< String > cv::linemod::Detector::classIds

(

)

const

Python
	cv.linemod.Detector.classIds(		) ->	retval

getModalities()

const std::vector< Ptr< Modality > > & cv::linemod::Detector::getModalities ( ) const

inline

Python
	cv.linemod.Detector.getModalities(		) ->	retval

获取此检测器使用的模态。

不允许添加/删除模态，但您可以使用 dynamic_cast 将其转换为调整参数。

getT()

int cv::linemod::Detector::getT ( int pyramid_level ) const

inline

Python
	cv.linemod.Detector.getT(	pyramid_level	) ->	retval

获取 pyramid_level 处的采样步长 T。

getTemplates()

const std::vector< Template > & cv::linemod::Detector::getTemplates	(	const String &	class_id,
		int	template_id ) const

Python
	cv.linemod.Detector.getTemplates(	class_id, template_id	) ->	retval

获取由 template_id 标识的模板金字塔。

例如，对于 2 个模态（梯度、法线）和两个金字塔层（L0、L1），顺序为（GradientL0、NormalL0、GradientL1、NormalL1）。

match()

void cv::linemod::Detector::match	(	const std::vector< Mat > &	sources,
		float	threshold,
		std::vector< Match > &	matches,
		const std::vector< String > &	class_ids = std::vector< String >(),
		OutputArrayOfArrays	quantized_images = noArray(),
		const std::vector< Mat > &	masks = std::vector< Mat >() ) const

Python
	cv.linemod.Detector.match(	sources, threshold[, class_ids[, quantized_images[, masks]]]	) ->	matches, quantized_images

通过模板匹配检测对象。

在最低的金字塔层全局匹配，然后在向上遍历金字塔的过程中局部细化。

参数

	sources	源图像，每个模态一个。
	threshold	相似度阈值，0 到 100 之间的百分比。
[输出]	matches	Template 匹配，按相似度得分排序。
	class_ids	如果非空，则只搜索所需的物体类别。
[输出]	quantized_images	可以选择返回向量<Mat> 量化的图像。
	masks	匹配过程中要考虑的掩码。掩码应为 CV_8UC1，其中 255 表示有效像素。如果非空，向量大小必须与 sources 相同。每个元素必须为空或与其对应的源大小相同。

此函数的调用图如下所示

matchClass()

void cv::linemod::Detector::matchClass ( const LinearMemoryPyramid & lm_pyramid, const std::vector< Size > & sizes, float threshold, std::vector< Match > & matches, const String & class_id, const std::vector< TemplatePyramid > & template_pyramids ) const

受保护的

numClasses()

int cv::linemod::Detector::numClasses ( ) const

inline

Python
	cv.linemod.Detector.numClasses(		) ->	retval

numTemplates() [1/2]

int cv::linemod::Detector::numTemplates

(

)

const

Python
	cv.linemod.Detector.numTemplates(		) ->	retval
	cv.linemod.Detector.numTemplates(	class_id	) ->	retval

numTemplates() [2/2]

int cv::linemod::Detector::numTemplates

(

const String &

class_id

)

const

Python
	cv.linemod.Detector.numTemplates(		) ->	retval
	cv.linemod.Detector.numTemplates(	class_id	) ->	retval

pyramidLevels()

int cv::linemod::Detector::pyramidLevels ( ) const

inline

Python
	cv.linemod.Detector.pyramidLevels(		) ->	retval

获取此检测器使用的金字塔级别数。

read()

void cv::linemod::Detector::read

(

const FileNode &

fn

)

Python
	cv.linemod.Detector.read(	fn	) ->	None

readClass()

String cv::linemod::Detector::readClass	(	const FileNode &	fn,
		const String &	class_id_override = "" )

readClasses()

void cv::linemod::Detector::readClasses	(	const std::vector< String > &	class_ids,
		const String &	format = "templates_%s.yml.gz" )

Python
	cv.linemod.Detector.readClasses(	class_ids[, format]	) ->	None

write()

void cv::linemod::Detector::write

(

FileStorage &

fs

)

const

writeClass()

void cv::linemod::Detector::writeClass	(	const String &	class_id,
		FileStorage &	fs ) const

writeClasses()

void cv::linemod::Detector::writeClasses

(

const String &

format = "templates_%s.yml.gz"

)

const

Python
	cv.linemod.Detector.writeClasses(	[, format]	) ->	None

成员数据文档

class_templates

TemplatesMap cv::linemod::Detector::class_templates

受保护的

modalities

std::vector< Ptr<Modality> > cv::linemod::Detector::modalities

受保护的

pyramid_levels

int cv::linemod::Detector::pyramid_levels

受保护的

T_at_level

std::vector<int> cv::linemod::Detector::T_at_level

受保护的

---

此类的文档是从以下文件生成的：

• opencv2/rgbd/linemod.hpp