Lookup table for a volumetric dataset. This class is used to lookup indices for a large dataset that's organized in a grid. This class is not meant to be used with non-grid like data sets. The grid may be sparse or non uniform and missing data points. More...

#include <VolumetricGridLookupField.hh>

Public Member Functions
	VolumetricGridLookupField (const std::vector< Vector3< T > > &_cloud)
	Constructor.

	VolumetricGridLookupField (const std::vector< Vector3< T > > &_cloud, const std::vector< I > &_indices)
	Constructor.

std::pair< Vector3< T >, Vector3< T > >	Bounds () const
	Get the bounds of this grid field.

template<typename V >
std::optional< V >	EstimateValueUsingTrilinear (const std::vector< InterpolationPoint3D< T > > _interpolators, const Vector3< T > &_pt, const std::vector< V > &_values, const V &_default=V(0)) const
	Estimates the values for a grid given a list of values to interpolate. This method uses Trilinear interpolation.

template<typename V >
std::optional< V >	EstimateValueUsingTrilinear (const Vector3< T > &_pt, const std::vector< V > &_values, const V &_default=V(0)) const
	Estimates the values for a grid given a list of values to interpolate. This method uses Trilinear interpolation.

std::vector< InterpolationPoint3D< T > >	GetInterpolators (const Vector3< T > &_pt, const double _xTol=1e-6, const double _yTol=1e-6, const double _zTol=1e-6) const
	Retrieves the indices of the points that are to be used for interpolation. Separate tolerance values are used for each axis as data may have different magnitudes on each axis.

Detailed Description

template<typename T, typename I = std::size_t>
class gz::math::VolumetricGridLookupField< T, I >

Lookup table for a volumetric dataset. This class is used to lookup indices for a large dataset that's organized in a grid. This class is not meant to be used with non-grid like data sets. The grid may be sparse or non uniform and missing data points.

Constructor & Destructor Documentation

◆ VolumetricGridLookupField() [1/2]

template<typename T , typename I = std::size_t>

VolumetricGridLookupField ( const std::vector< Vector3< T > > & _cloud )

inline

Constructor.

Parameters

[in] _cloud The cloud of points to use to construct the grid.

◆ VolumetricGridLookupField() [2/2]

template<typename T , typename I = std::size_t>

VolumetricGridLookupField	(	const std::vector< Vector3< T > > &	_cloud,
		const std::vector< I > &	_indices
	)

inline

Constructor.

Parameters

[in]	_cloud	The cloud of points to use to construct the grid.
[in]	_indices	A series of indices these points correspond to.

Member Function Documentation

◆ Bounds()

template<typename T , typename I = std::size_t>

std::pair< Vector3< T >, Vector3< T > > Bounds ( ) const

inline

Get the bounds of this grid field.

Returns: A pair of vectors.

◆ EstimateValueUsingTrilinear() [1/2]

template<typename T , typename I = std::size_t>

template<typename V >

std::optional< V > EstimateValueUsingTrilinear	(	const std::vector< InterpolationPoint3D< T > >	_interpolators,
		const Vector3< T > &	_pt,
		const std::vector< V > &	_values,
		const V &	_default = `V(0)`
	)		const

inline

Estimates the values for a grid given a list of values to interpolate. This method uses Trilinear interpolation.

Parameters

[in]	_interpolators	The list of interpolators to use. Retrieved by calling GetInterpolators().
[in]	_pt	The point to estimate for.
[in]	_values	The values to interpolate.
[in]	_default	If a value is not found at a specific point then this value will be used.

Returns: The estimated value for the point. Nullopt if we are outside the field. Default value if in the field but no value is in the index.

◆ EstimateValueUsingTrilinear() [2/2]

template<typename T , typename I = std::size_t>

template<typename V >

std::optional< V > EstimateValueUsingTrilinear	(	const Vector3< T > &	_pt,
		const std::vector< V > &	_values,
		const V &	_default = `V(0)`
	)		const

inline

Estimates the values for a grid given a list of values to interpolate. This method uses Trilinear interpolation.

Parameters

[in]	_pt	The point to estimate for.
[in]	_values	The values to interpolate.
[in]	_default	If a value is not found at a specific point then this value will be used.

Returns: The estimated value for the point.

References VolumetricGridLookupField< T, I >::EstimateValueUsingTrilinear(), and VolumetricGridLookupField< T, I >::GetInterpolators().

Referenced by VolumetricGridLookupField< T, I >::EstimateValueUsingTrilinear().

◆ GetInterpolators()

template<typename T , typename I = std::size_t>

std::vector< InterpolationPoint3D< T > > GetInterpolators	(	const Vector3< T > &	_pt,
		const double	_xTol = `1e-6`,
		const double	_yTol = `1e-6`,
		const double	_zTol = `1e-6`
	)		const

inline

Retrieves the indices of the points that are to be used for interpolation. Separate tolerance values are used for each axis as data may have different magnitudes on each axis.

Parameters

[in]	_pt	The point to get the interpolators for.
[in]	_xTol	The tolerance for the x axis.
[in]	_yTol	The tolerance for the y axis.
[in]	_zTol	The tolerance for the z axis.

Returns: A list of points which are to be used for interpolation. If the point is in the middle of a grid cell then it returns the four corners of the grid cell. If its along a plane then it returns the four corners, if along an edge two points and if coincident with a corner one point. If the data is sparse and missing indices then a nullopt will be returned.

Referenced by VolumetricGridLookupField< T, I >::EstimateValueUsingTrilinear().

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

VolumetricGridLookupField.hh

Gazebo Math

API Reference

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ VolumetricGridLookupField() [1/2]

◆ VolumetricGridLookupField() [2/2]

Member Function Documentation

◆ Bounds()

◆ EstimateValueUsingTrilinear() [1/2]

◆ EstimateValueUsingTrilinear() [2/2]

◆ GetInterpolators()