A class that represents a two dimensional K-d Tree (2-d Tree). More...

#include <Index.h>

Public Types
typedef KdTreeNode::kdData	kdData
	Export data type. More...

typedef KdTreeNode::kdDataItem	kdDataItem
	Export data item type. More...

typedef KdTreeNode::kdDataTag	kdDataTag
	Export data type. More...

typedef KdTreeNode::kdKey	kdKey
	Export key type. More...

Public Member Functions
void	buildOptimized (std::vector< std::pair< kdKey, kdData > > &dataSet)
	It inserts the data in the tree and and keeps it balanced: the kdsort algorithm must be called before. More...

void	clear ()
	It clears all tree nodes. More...

const te::gm::Envelope &	getMBR () const
	It gets the minimum bounding box of all elements in the tree. More...

	Index (const te::gm::Envelope &mbr)
	Constructor. More...

void	insert (const kdKey &key, const kdData &item)
	It inserts the data with a given key in tree. More...

bool	isEmpty () const
	It returns true if the tree is empty and false otherwise. More...

void	search (const te::gm::Envelope &e, std::vector< KdTreeNode * > &report) const
	Range search query. More...

void	setMBR (const te::gm::Envelope &mbr)
	It sets the minimum bounding box of all elements in the tree. More...

const std::size_t &	size () const
	It returns the number of tree nodes. More...

	~Index ()
	Destructor. More...

Private Member Functions
KdTreeNode *	buildOptimized (std::vector< std::pair< kdKey, kdData > > &dataSet, const std::size_t &first, const std::size_t &last)
	It builds the tree recursively. More...

void	erase (KdTreeNode *node)
	It Erases a node from the tree and all nodes below it. More...

	Index (const Index &rhs)
	No copy constructor allowed. More...

void	insertData (KdTreeNode *&node, const kdData &data, const kd_node_m_dataset_tag &)
	It inserts data for set nodes, i.e., nodes that may stores many element. More...

void	insertData (KdTreeNode *&node, const kdData &data, const kd_node_m_datasingle_tag &)
	It inserts data for single nodes, i.e. nodes that stores only one element. More...

Index &	operator= (const Index &rhs)
	No assignment operator allowed. More...

void	search (const te::gm::Envelope &e, KdTreeNode node, const char &level, std::vector< KdTreeNode > &report) const
	Recursive range query. More...

Private Attributes
te::gm::Envelope	m_mbr
	Minimum bounding box of all nodes. More...

KdTreeNode *	m_root
	Pointer to the root node. More...

std::size_t	m_size
	The size of the K-d Tree (number of nodes). More...

Detailed Description

template<class KdTreeNode>
class te::sam::kdtree::Index< KdTreeNode >

A class that represents a two dimensional K-d Tree (2-d Tree).

Note: This type of tree stores the data into nodes (not only in the leafs node).; This tree may be built by two ways: 1) Inserting each element in the tree. In this case the tree can becomes unbalanced, but in practical cases this is not the expected, and is the best way to construct the tree (faster way). 2) Passing a container with pairs (key/data-item) and using the method buildOptimized after calling kdsort. The tree built this way is almost balanced but will be construct in time O(N log N). Warning: In this case items with the same key will be stores in different nodes!; This type of tree may be of special interest of EXTENT SEARCH QUERIES.; If the node type is kd_node_data_single_tag than NodeData and NodeDataItem are the same types. And if one entry with the same key already exist, so they will be overwrite.; If the node type is kd_node_data_set_tag than NodeData mus have a method called push_back(NodeDataItem) that permits to store elements with the same key in the node.

Definition at line 67 of file Index.h.

Member Typedef Documentation

◆ kdData

template<class KdTreeNode >

typedef KdTreeNode::kdData te::sam::kdtree::Index< KdTreeNode >::kdData

Export data type.

Definition at line 75 of file Index.h.

◆ kdDataItem

template<class KdTreeNode >

typedef KdTreeNode::kdDataItem te::sam::kdtree::Index< KdTreeNode >::kdDataItem

Export data item type.

Definition at line 78 of file Index.h.

◆ kdDataTag

template<class KdTreeNode >

typedef KdTreeNode::kdDataTag te::sam::kdtree::Index< KdTreeNode >::kdDataTag

Export data type.

Definition at line 81 of file Index.h.

◆ kdKey

template<class KdTreeNode >

typedef KdTreeNode::kdKey te::sam::kdtree::Index< KdTreeNode >::kdKey

Export key type.

Definition at line 72 of file Index.h.

Constructor & Destructor Documentation

◆ Index() [1/2]

template<class KdTreeNode >

te::sam::kdtree::Index< KdTreeNode >::Index ( const te::gm::Envelope & mbr )

inline

Constructor.

Definition at line 84 of file Index.h.

◆ ~Index()

template<class KdTreeNode >

te::sam::kdtree::Index< KdTreeNode >::~Index ( )

inline

Destructor.

Definition at line 92 of file Index.h.

◆ Index() [2/2]

template<class KdTreeNode >

te::sam::kdtree::Index< KdTreeNode >::Index ( const Index< KdTreeNode > & rhs )

private

No copy constructor allowed.

Parameters

rhs	The other index.

Member Function Documentation

◆ buildOptimized() [1/2]

template<class KdTreeNode >

void te::sam::kdtree::Index< KdTreeNode >::buildOptimized ( std::vector< std::pair< kdKey, kdData > > & dataSet )

inline

It inserts the data in the tree and and keeps it balanced: the kdsort algorithm must be called before.

Definition at line 136 of file Index.h.

Referenced by te::sam::kdtree::Index< te::sam::kdtree::Node >::buildOptimized().

◆ buildOptimized() [2/2]

template<class KdTreeNode >

KdTreeNode* te::sam::kdtree::Index< KdTreeNode >::buildOptimized	(	std::vector< std::pair< kdKey, kdData > > &	dataSet,
		const std::size_t &	first,
		const std::size_t &	last
	)

inlineprivate

It builds the tree recursively.

Definition at line 180 of file Index.h.

◆ clear()

template<class KdTreeNode >

void te::sam::kdtree::Index< KdTreeNode >::clear ( )

inline

It clears all tree nodes.

Definition at line 98 of file Index.h.

Referenced by te::sam::kdtree::Index< te::sam::kdtree::Node >::~Index().

◆ erase()

template<class KdTreeNode >

void te::sam::kdtree::Index< KdTreeNode >::erase ( KdTreeNode * node )

inlineprivate

It Erases a node from the tree and all nodes below it.

Definition at line 152 of file Index.h.

Referenced by te::sam::kdtree::Index< te::sam::kdtree::Node >::clear(), and te::sam::kdtree::Index< te::sam::kdtree::Node >::erase().

◆ getMBR()

template<class KdTreeNode >

const te::gm::Envelope& te::sam::kdtree::Index< KdTreeNode >::getMBR ( ) const

inline

It gets the minimum bounding box of all elements in the tree.

Definition at line 127 of file Index.h.

◆ insert()

template<class KdTreeNode >

void te::sam::kdtree::Index< KdTreeNode >::insert	(	const kdKey &	key,
		const kdData &	item
	)

inline

It inserts the data with a given key in tree.

Definition at line 223 of file Index.h.

◆ insertData() [1/2]

template<class KdTreeNode >

void te::sam::kdtree::Index< KdTreeNode >::insertData	(	KdTreeNode *&	node,
		const kdData &	data,
		const kd_node_m_dataset_tag &
	)

inlineprivate

It inserts data for set nodes, i.e., nodes that may stores many element.

Definition at line 171 of file Index.h.

◆ insertData() [2/2]

template<class KdTreeNode >

void te::sam::kdtree::Index< KdTreeNode >::insertData	(	KdTreeNode *&	node,
		const kdData &	data,
		const kd_node_m_datasingle_tag &
	)

inlineprivate

It inserts data for single nodes, i.e. nodes that stores only one element.

Definition at line 164 of file Index.h.

◆ isEmpty()

template<class KdTreeNode >

bool te::sam::kdtree::Index< KdTreeNode >::isEmpty ( ) const

inline

It returns true if the tree is empty and false otherwise.

Definition at line 115 of file Index.h.

◆ operator=()

template<class KdTreeNode >

Index& te::sam::kdtree::Index< KdTreeNode >::operator= ( const Index< KdTreeNode > & rhs )

private

No assignment operator allowed.

Parameters

rhs	The other index.

Returns: A reference for this.

◆ search() [1/2]

template<class KdTreeNode >

void te::sam::kdtree::Index< KdTreeNode >::search	(	const te::gm::Envelope &	e,
		KdTreeNode *	node,
		const char &	level,
		std::vector< KdTreeNode * > &	report
	)		const

inlineprivate

Recursive range query.

Definition at line 309 of file Index.h.

References te::gm::Envelope::m_llx, te::gm::Envelope::m_lly, te::gm::Envelope::m_urx, and te::gm::Envelope::m_ury.

◆ search() [2/2]

template<class KdTreeNode >

void te::sam::kdtree::Index< KdTreeNode >::search	(	const te::gm::Envelope &	e,
		std::vector< KdTreeNode * > &	report
	)		const

inline

Range search query.

Definition at line 143 of file Index.h.

Referenced by te::sam::kdtree::Index< te::sam::kdtree::Node >::search().

◆ setMBR()

template<class KdTreeNode >

void te::sam::kdtree::Index< KdTreeNode >::setMBR ( const te::gm::Envelope & mbr )

inline

It sets the minimum bounding box of all elements in the tree.

Definition at line 121 of file Index.h.

◆ size()

template<class KdTreeNode >

const std::size_t& te::sam::kdtree::Index< KdTreeNode >::size ( ) const

inline

It returns the number of tree nodes.

Definition at line 109 of file Index.h.

Member Data Documentation

◆ m_mbr

template<class KdTreeNode >

te::gm::Envelope te::sam::kdtree::Index< KdTreeNode >::m_mbr

private

Minimum bounding box of all nodes.

Definition at line 218 of file Index.h.

Referenced by te::sam::kdtree::Index< te::sam::kdtree::Node >::getMBR(), and te::sam::kdtree::Index< te::sam::kdtree::Node >::setMBR().

◆ m_root

template<class KdTreeNode >

KdTreeNode* te::sam::kdtree::Index< KdTreeNode >::m_root

private

Pointer to the root node.

Definition at line 217 of file Index.h.

Referenced by te::sam::kdtree::Index< te::sam::kdtree::Node >::buildOptimized(), te::sam::kdtree::Index< te::sam::kdtree::Node >::clear(), te::sam::kdtree::Index< te::sam::kdtree::Node >::isEmpty(), and te::sam::kdtree::Index< te::sam::kdtree::Node >::search().

◆ m_size

template<class KdTreeNode >

std::size_t te::sam::kdtree::Index< KdTreeNode >::m_size

private

The size of the K-d Tree (number of nodes).

Definition at line 219 of file Index.h.

Referenced by te::sam::kdtree::Index< te::sam::kdtree::Node >::buildOptimized(), te::sam::kdtree::Index< te::sam::kdtree::Node >::clear(), and te::sam::kdtree::Index< te::sam::kdtree::Node >::size().

The documentation for this class was generated from the following file:

/home/castejon/castejon_files/develop/terralib5/git_release/src/terralib/sam/kdtree/Index.h

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

template<class KdTreeNode> class te::sam::kdtree::Index< KdTreeNode >

Member Typedef Documentation

◆ kdData

◆ kdDataItem

◆ kdDataTag

◆ kdKey

Constructor & Destructor Documentation

◆ Index() [1/2]

◆ ~Index()

◆ Index() [2/2]

Member Function Documentation

◆ buildOptimized() [1/2]

◆ buildOptimized() [2/2]

◆ clear()

◆ erase()

◆ getMBR()

◆ insert()

◆ insertData() [1/2]

◆ insertData() [2/2]

◆ isEmpty()

◆ operator=()

◆ search() [1/2]

◆ search() [2/2]

◆ setMBR()

◆ size()

Member Data Documentation

◆ m_mbr

◆ m_root

◆ m_size

template<class KdTreeNode>
class te::sam::kdtree::Index< KdTreeNode >