#include <lm_filter_bank.h>

Public Member Functions
std::vector< TextonFeature >	clusterTextons (std::vector< std::vector< TextonFeature > > samples, int k, int attempts=3)
std::vector< int >	extractDescriptor (cv::Mat &frame)
std::vector< TextonFeature >	extractRawFeature (cv::Mat &frame, bool use_all_pixels=false)
float	featureDist (TextonFeature f1, TextonFeature f2)
std::vector< TextonFeature >	getCenters () const
int	getNumCenters () const
	LMFilterBank (int orientations=6, int elongated_scales=1, int gaussian_scales=1, int num_extract_scales=2, int support=7)
int	quantizeFeature (TextonFeature feat)
bool	readTextonCenters (std::string file_name)
void	saveTextonCenters (std::vector< TextonFeature > centers, std::string file_name)
cv::Mat	textonQuantizeImage (cv::Mat &frame)
void	visualizeKernels (void)
Protected Member Functions
cv::Mat	createElongatedFilter (float scale, int phase_x, int phase_y, cv::Mat pts_1, cv::Mat pts_2, int sup)
void	generateFilters (void)
cv::Mat	getDOGFilter (int ksize, float sigma, float alpha=3.0)
cv::Mat	getGaussianDeriv (float sigma, float mu, cv::Mat x, int ord)
cv::Mat	normalize (cv::Mat &f)
cv::Mat	upSampleResponse (cv::Mat &down_convolved, int s, cv::Size size0)
Protected Attributes
std::vector< cv::Mat >	bars_
std::vector< TextonFeature >	centers_
std::vector< cv::Mat >	dogs_
std::vector< cv::Mat >	edges_
std::vector< cv::Mat >	gaussians_
int	n_e_scales_
int	n_extract_scales_
int	n_filters_
int	n_g_scales_
int	n_orientations_
int	support_

Detailed Description

Definition at line 51 of file lm_filter_bank.h.

Constructor & Destructor Documentation

cpl_visual_features::LMFilterBank::LMFilterBank	(	int	orientations = `6`,
		int	elongated_scales = `1`,
		int	gaussian_scales = `1`,
		int	num_extract_scales = `2`,
		int	support = `7`
	)

Cunstroctor for LMFilterBank class. Implementing the one used in: Leung and Malik. "Representing and recognizing the visual appearance of materials using three-dimensional textons." IJCV, 2001.

Definition at line 50 of file lm_filter_bank.cpp.

Member Function Documentation

vector< TextonFeature > cpl_visual_features::LMFilterBank::clusterTextons	(	std::vector< std::vector< TextonFeature > >	samples,
		int	k,
		int	attempts = `3`
	)

Method to cluster raw extracted feauters into textons

Parameters:

samples
k	The number of texton centers to find

Returns:: The texton centers.

Definition at line 306 of file lm_filter_bank.cpp.

Mat cpl_visual_features::LMFilterBank::createElongatedFilter	(	float	scale,
		int	phase_x,
		int	phase_y,
		cv::Mat	pts_1,
		cv::Mat	pts_2,
		int	sup
	)		`[protected]`

Definition at line 360 of file lm_filter_bank.cpp.

vector< int > cpl_visual_features::LMFilterBank::extractDescriptor ( cv::Mat & frame )

Extracts a histogram of the texture descriptors over the given image patch

Parameters:

frame The image patch over which to extract the quantized descriptor

Returns:: The quantized texture descriptor

Definition at line 255 of file lm_filter_bank.cpp.

vector< TextonFeature > cpl_visual_features::LMFilterBank::extractRawFeature	(	cv::Mat &	frame,
		bool	use_all_pixels = `false`
	)

Extract a texture feature from the given image using the filter bank.

Parameters:

frame The image to extract the texture feature

Returns:: A vector of length frame.rows*frame.cols of TextonFeatures for each pixel

Definition at line 134 of file lm_filter_bank.cpp.

float cpl_visual_features::LMFilterBank::featureDist	(	TextonFeature	f1,
		TextonFeature	f2
	)

Determine the distance between two feature vectors.

Parameters:

f1	The first feature vector
f2	The second feature vector

Returns:: The distance between the two vectors in feature space

Definition at line 452 of file lm_filter_bank.cpp.

void cpl_visual_features::LMFilterBank::generateFilters ( void ) [protected]

Definition at line 60 of file lm_filter_bank.cpp.

std::vector<TextonFeature> cpl_visual_features::LMFilterBank::getCenters ( ) const [inline]

Definition at line 153 of file lm_filter_bank.h.

Mat cpl_visual_features::LMFilterBank::getDOGFilter	(	int	ksize,
		float	sigma,
		float	alpha = `3.0`
	)		`[protected]`

Definition at line 403 of file lm_filter_bank.cpp.

Mat cpl_visual_features::LMFilterBank::getGaussianDeriv	(	float	sigma,
		float	mu,
		cv::Mat	x,
		int	ord
	)		`[protected]`

Definition at line 371 of file lm_filter_bank.cpp.

int cpl_visual_features::LMFilterBank::getNumCenters ( ) const [inline]

Definition at line 158 of file lm_filter_bank.h.

Mat cpl_visual_features::LMFilterBank::normalize ( cv::Mat & f ) [protected]

Definition at line 444 of file lm_filter_bank.cpp.

int cpl_visual_features::LMFilterBank::quantizeFeature ( TextonFeature feat )

Method to take a raw filter response feature and quantize it to the correct texton value.

Parameters:

feat	A raw texton feature.

Returns:: The label (index) of the nearest texton center.

Definition at line 288 of file lm_filter_bank.cpp.

bool cpl_visual_features::LMFilterBank::readTextonCenters ( std::string file_name )

Read the cluster centers into memory that have previously been saved to disk using the method saveTextonCenters. These centers will be stored internally in the lm_filter_bank instance

Parameters:

file_name The location of the cluster center files

Definition at line 538 of file lm_filter_bank.cpp.