Parallel version of hash grid-based 3-D point searcher. More...

#include <Core/Searcher/PointParallelHashGridSearcher3.h>

Inheritance diagram for CubbyFlow::PointParallelHashGridSearcher3:

Classes
class	Builder
	Front-end to create PointParallelHashGridSearcher3 objects step by step. More...

Public Member Functions
	PointParallelHashGridSearcher3 (const Size3 &resolution, double gridSpacing)
	Constructs hash grid with given resolution and grid spacing. More...

	PointParallelHashGridSearcher3 (size_t resolutionX, size_t resolutionY, size_t resolutionZ, double gridSpacing)
	Constructs hash grid with given resolution and grid spacing. More...

	PointParallelHashGridSearcher3 (const PointParallelHashGridSearcher3 &other)
	Copy constructor. More...

void	Build (const ConstArrayAccessor1< Vector3D > &points) override
	Builds internal acceleration structure for given points list. More...

void	ForEachNearbyPoint (const Vector3D &origin, double radius, const ForEachNearbyPointFunc &callback) const override

bool	HasNearbyPoint (const Vector3D &origin, double radius) const override

const std::vector< size_t > &	Keys () const
	Returns the hash key list. More...

const std::vector< size_t > &	StartIndexTable () const
	Returns the start index table. More...

const std::vector< size_t > &	EndIndexTable () const
	Returns the end index table. More...

const std::vector< size_t > &	SortedIndices () const
	Returns the sorted indices of the points. More...

size_t	GetHashKeyFromBucketIndex (const Point3I &bucketIndex) const

Point3I	GetBucketIndex (const Vector3D &position) const

PointNeighborSearcher3Ptr	Clone () const override
	Creates a new instance of the object with same properties than original. More...

PointParallelHashGridSearcher3 &	operator= (const PointParallelHashGridSearcher3 &other)
	Assignment operator. More...

void	Set (const PointParallelHashGridSearcher3 &other)
	Copy from the other instance. More...

void	Serialize (std::vector< uint8_t > *buffer) const override
	Serializes the neighbor searcher into the buffer. More...

void	Deserialize (const std::vector< uint8_t > &buffer) override
	Deserializes the neighbor searcher from the buffer. More...

Public Member Functions inherited from CubbyFlow::PointNeighborSearcher3
	PointNeighborSearcher3 ()
	Default constructor. More...

virtual	~PointNeighborSearcher3 ()
	Destructor. More...

virtual std::string	TypeName () const =0
	Returns the type name of the derived class. More...

Static Public Member Functions
static Builder	GetBuilder ()
	Returns builder fox PointParallelHashGridSearcher3. More...

Additional Inherited Members
Public Types inherited from CubbyFlow::PointNeighborSearcher3
using	ForEachNearbyPointFunc = std::function< void(size_t, const Vector3D &)>

Detailed Description

Parallel version of hash grid-based 3-D point searcher.

This class implements parallel version of 3-D point searcher by using hash grid for its internal acceleration data structure. Each point is recorded to its corresponding bucket where the hashing function is 3-D grid mapping.

Constructor & Destructor Documentation

◆ PointParallelHashGridSearcher3() [1/3]

CubbyFlow::PointParallelHashGridSearcher3::PointParallelHashGridSearcher3	(	const Size3 &	resolution,
		double	gridSpacing
	)

Constructs hash grid with given resolution and grid spacing.

This constructor takes hash grid resolution and its grid spacing as its input parameters. The grid spacing must be 2x or greater than search radius.

Parameters

[in]	resolution	The resolution.
[in]	gridSpacing	The grid spacing.

◆ PointParallelHashGridSearcher3() [2/3]

CubbyFlow::PointParallelHashGridSearcher3::PointParallelHashGridSearcher3	(	size_t	resolutionX,
		size_t	resolutionY,
		size_t	resolutionZ,
		double	gridSpacing
	)

Constructs hash grid with given resolution and grid spacing.

This constructor takes hash grid resolution and its grid spacing as its input parameters. The grid spacing must be 2x or greater than search radius.

Parameters

[in]	resolutionX	The resolution x.
[in]	resolutionY	The resolution y.
[in]	resolutionZ	The resolution z.
[in]	gridSpacing	The grid spacing.

◆ PointParallelHashGridSearcher3() [3/3]

CubbyFlow::PointParallelHashGridSearcher3::PointParallelHashGridSearcher3 ( const PointParallelHashGridSearcher3 & other )

Copy constructor.

Member Function Documentation

◆ Build()

void CubbyFlow::PointParallelHashGridSearcher3::Build ( const ConstArrayAccessor1< Vector3D > & points )

overridevirtual

Builds internal acceleration structure for given points list.

This function builds the hash grid for given points in parallel.

Parameters

[in] points The points to be added.

Implements CubbyFlow::PointNeighborSearcher3.

◆ Clone()

PointNeighborSearcher3Ptr CubbyFlow::PointParallelHashGridSearcher3::Clone ( ) const

overridevirtual

Creates a new instance of the object with same properties than original.

Returns: Copy of this object.

Implements CubbyFlow::PointNeighborSearcher3.

◆ Deserialize()

void CubbyFlow::PointParallelHashGridSearcher3::Deserialize ( const std::vector< uint8_t > & buffer )

overridevirtual

Deserializes the neighbor searcher from the buffer.

Implements CubbyFlow::Serializable.

◆ EndIndexTable()

const std::vector<size_t>& CubbyFlow::PointParallelHashGridSearcher3::EndIndexTable ( ) const

Returns the end index table.

The end index table maps the hash grid bucket index to starting index of the sorted point list. Assume the hash key list looks like:

[5|8|8|10|10|10]

Then startIndexTable and endIndexTable should be like:

[.....|0|...|1|..|3|..]
[.....|1|...|3|..|6|..]
      ^5    ^8   ^10

So that endIndexTable[i] - startIndexTable[i] is the number points in i-th table bucket.

Returns: The end index table.

◆ ForEachNearbyPoint()

void CubbyFlow::PointParallelHashGridSearcher3::ForEachNearbyPoint	(	const Vector3D &	origin,
		double	radius,
		const ForEachNearbyPointFunc &	callback
	)		const

overridevirtual

Invokes the callback function for each nearby point around the origin within given radius.

Parameters

[in]	origin	The origin position.
[in]	radius	The search radius.
[in]	callback	The callback function.

Implements CubbyFlow::PointNeighborSearcher3.

◆ GetBucketIndex()

Point3I CubbyFlow::PointParallelHashGridSearcher3::GetBucketIndex ( const Vector3D & position ) const

Gets the bucket index from a point.

Parameters

[in] position The position of the point.

Returns: The bucket index.

◆ GetBuilder()

static Builder CubbyFlow::PointParallelHashGridSearcher3::GetBuilder ( )

static

Returns builder fox PointParallelHashGridSearcher3.

◆ GetHashKeyFromBucketIndex()

size_t CubbyFlow::PointParallelHashGridSearcher3::GetHashKeyFromBucketIndex ( const Point3I & bucketIndex ) const

Returns the hash value for given 3-D bucket index.

Parameters

[in] bucketIndex The bucket index.

Returns: The hash key from bucket index.

◆ HasNearbyPoint()

bool CubbyFlow::PointParallelHashGridSearcher3::HasNearbyPoint	(	const Vector3D &	origin,
		double	radius
	)		const

overridevirtual

Returns true if there are any nearby points for given origin within radius.

Parameters

[in]	origin	The origin.
[in]	radius	The radius.

Returns: True if has nearby point, false otherwise.

Implements CubbyFlow::PointNeighborSearcher3.

◆ Keys()

const std::vector<size_t>& CubbyFlow::PointParallelHashGridSearcher3::Keys ( ) const

Returns the hash key list.

The hash key list maps sorted point index i to its hash key value. The sorting order is based on the key value itself.

Returns: The hash key list.

◆ operator=()

PointParallelHashGridSearcher3& CubbyFlow::PointParallelHashGridSearcher3::operator= ( const PointParallelHashGridSearcher3 & other )

Assignment operator.

◆ Serialize()

void CubbyFlow::PointParallelHashGridSearcher3::Serialize ( std::vector< uint8_t > * buffer ) const

overridevirtual

Serializes the neighbor searcher into the buffer.

Implements CubbyFlow::Serializable.

◆ Set()

void CubbyFlow::PointParallelHashGridSearcher3::Set ( const PointParallelHashGridSearcher3 & other )

Copy from the other instance.

◆ SortedIndices()

const std::vector<size_t>& CubbyFlow::PointParallelHashGridSearcher3::SortedIndices ( ) const

Returns the sorted indices of the points.

When the hash grid is built, it sorts the points in hash key order. But rather than sorting the original points, this class keeps the shuffled indices of the points. The list this function returns maps sorted index i to original index j.

Returns: The sorted indices of the points.

◆ StartIndexTable()

const std::vector<size_t>& CubbyFlow::PointParallelHashGridSearcher3::StartIndexTable ( ) const

Returns the start index table.

The start index table maps the hash grid bucket index to starting index of the sorted point list. Assume the hash key list looks like:

[5|8|8|10|10|10]

Then startIndexTable and endIndexTable should be like:

[.....|0|...|1|..|3|..]
[.....|1|...|3|..|6|..]
      ^5    ^8   ^10

So that endIndexTable[i] - startIndexTable[i] is the number points in i-th table bucket.

Returns: The start index table.

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

Core/Searcher/PointParallelHashGridSearcher3.h

Classes

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ PointParallelHashGridSearcher3() [1/3]

◆ PointParallelHashGridSearcher3() [2/3]

◆ PointParallelHashGridSearcher3() [3/3]

Member Function Documentation

◆ Build()

◆ Clone()

◆ Deserialize()

◆ EndIndexTable()

◆ ForEachNearbyPoint()

◆ GetBucketIndex()

◆ GetBuilder()

◆ GetHashKeyFromBucketIndex()

◆ HasNearbyPoint()

◆ Keys()

◆ operator=()

◆ Serialize()

◆ Set()

◆ SortedIndices()

◆ StartIndexTable()