The class splits a binary space partitioning tree node according to the median distance to the vantage point. More...

#include <vantage_point_split.hpp>

Classes
struct	SplitInfo
	A struct that contains an information about the split. More...

Public Types
typedef MatType::elem_type	ElemType
	The matrix element type.

typedef BoundType::MetricType	MetricType
	The bounding shape type.

Static Public Member Functions
static bool	SplitNode (const BoundType &bound, MatType &data, const size_t begin, const size_t count, SplitInfo &splitInfo)
	Split the node according to the distance to a vantage point. More...

static size_t	PerformSplit (MatType &data, const size_t begin, const size_t count, const SplitInfo &splitInfo)
	Perform the split process according to the information about the split. More...

static size_t	PerformSplit (MatType &data, const size_t begin, const size_t count, const SplitInfo &splitInfo, std::vector< size_t > &oldFromNew)
	Perform the split process according to the information about the split and return the list of changed indices. More...

template<typename VecType >
static bool	AssignToLeftNode (const VecType &point, const SplitInfo &splitInfo)
	Indicates that a point should be assigned to the left subtree. More...

Detailed Description

template<typename BoundType, typename MatType = arma::mat, size_t MaxNumSamples = 100>
class mlpack::tree::VantagePointSplit< BoundType, MatType, MaxNumSamples >

The class splits a binary space partitioning tree node according to the median distance to the vantage point.

Thus points that are closer to the vantage point belong to the left subtree and points that are farther from the vantage point belong to the right subtree.

Member Function Documentation

◆ AssignToLeftNode()

template<typename BoundType , typename MatType = arma::mat, size_t MaxNumSamples = 100>

template<typename VecType >

static bool mlpack::tree::VantagePointSplit< BoundType, MatType, MaxNumSamples >::AssignToLeftNode	(	const VecType &	point,
		const SplitInfo &	splitInfo
	)

inlinestatic

Indicates that a point should be assigned to the left subtree.

This method returns true if a point should be assigned to the left subtree, i.e., if the distance from the point to the vantage point is less then the median value. Otherwise it returns false.

Parameters

point	The point that is being assigned.
splitInfo	An information about the split.

◆ PerformSplit() [1/2]

template<typename BoundType , typename MatType = arma::mat, size_t MaxNumSamples = 100>

static size_t mlpack::tree::VantagePointSplit< BoundType, MatType, MaxNumSamples >::PerformSplit	(	MatType &	data,
		const size_t	begin,
		const size_t	count,
		const SplitInfo &	splitInfo
	)

inlinestatic

Perform the split process according to the information about the split.

This will order the dataset such that points that belong to the left subtree are on the left of the split column, and points from the right subtree are on the right side of the split column.

Parameters

data	The dataset used by the binary space tree.
begin	Index of the starting point in the dataset that belongs to this node.
count	Number of points in this node.
splitInfo	The information about the split.

◆ PerformSplit() [2/2]

template<typename BoundType , typename MatType = arma::mat, size_t MaxNumSamples = 100>

static size_t mlpack::tree::VantagePointSplit< BoundType, MatType, MaxNumSamples >::PerformSplit	(	MatType &	data,
		const size_t	begin,
		const size_t	count,
		const SplitInfo &	splitInfo,
		std::vector< size_t > &	oldFromNew
	)

inlinestatic

Perform the split process according to the information about the split and return the list of changed indices.

This will order the dataset such that points that belong to the left subtree are on the left of the split column, and points from the right subtree are on the right side of the split column.

Parameters

data	The dataset used by the binary space tree.
begin	Index of the starting point in the dataset that belongs to this node.
count	Number of points in this node.
splitInfo	The information about the split.
oldFromNew	Vector which will be filled with the old positions for each new point.

◆ SplitNode()

template<typename BoundType , typename MatType , size_t MaxNumSamples>

bool mlpack::tree::VantagePointSplit< BoundType, MatType, MaxNumSamples >::SplitNode	(	const BoundType &	bound,
		MatType &	data,
		const size_t	begin,
		const size_t	count,
		SplitInfo &	splitInfo
	)

static

Split the node according to the distance to a vantage point.

Parameters

bound	The bound used for this node.
data	The dataset used by the binary space tree.
begin	Index of the starting point in the dataset that belongs to this node.
count	Number of points in this node.
splitInfo	An information about the split. This information contains the vantage point and the median distance to the vantage point.

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

src/mlpack/core/tree/binary_space_tree/vantage_point_split.hpp
src/mlpack/core/tree/binary_space_tree/vantage_point_split_impl.hpp

Classes

Public Types

Static Public Member Functions

Detailed Description

template<typename BoundType, typename MatType = arma::mat, size_t MaxNumSamples = 100> class mlpack::tree::VantagePointSplit< BoundType, MatType, MaxNumSamples >

Member Function Documentation

◆ AssignToLeftNode()

◆ PerformSplit() [1/2]

◆ PerformSplit() [2/2]

◆ SplitNode()

template<typename BoundType, typename MatType = arma::mat, size_t MaxNumSamples = 100>
class mlpack::tree::VantagePointSplit< BoundType, MatType, MaxNumSamples >