#include <acts/blob/sPHENIX/Core/include/Acts/Utilities/BinUtility.hpp>

Collaboration diagram for Acts::BinUtility:

Public Member Functions
	BinUtility ()
	Constructor for equidistant.

	BinUtility (const Transform3D &tForm)

	BinUtility (const BinningData &bData, const Transform3D &tForm=Transform3D::Identity())

	BinUtility (size_t bins, float min, float max, BinningOption opt=open, BinningValue value=binX, const Transform3D &tForm=Transform3D::Identity())

	BinUtility (std::vector< float > &bValues, BinningOption opt=open, BinningValue value=binPhi, const Transform3D &tForm=Transform3D::Identity())

	BinUtility (const BinUtility &sbu)

BinUtility &	operator= (const BinUtility &sbu)

BinUtility &	operator+= (const BinUtility &gbu)

	~BinUtility ()=default
	Virtual Destructor.

const std::vector< BinningData > &	binningData () const
	return the binning data vector

size_t	bins () const
	Return the total number of bins.

std::array< size_t, 3 >	binTriple (const Vector3D &position) const

size_t	bin (const Vector3D &position, size_t ba=0) const

std::vector< size_t >	neighbourRange (const Vector3D &position, size_t ba=0) const

int	nextDirection (const Vector3D &position, const Vector3D &direction, size_t ba=0) const

size_t	bin (const Vector2D &lposition, size_t ba=0) const

bool	inside (const Vector3D &position) const

bool	inside (const Vector2D &lposition) const

size_t	dimensions () const

size_t	max (size_t ba=0) const

size_t	bins (size_t ba) const

const Transform3D &	transform () const

BinningValue	binningValue (size_t ba=0) const

size_t	serialize (const std::array< size_t, 3 > &bin) const

std::ostream &	toStream (std::ostream &sl) const

Private Attributes
std::vector< BinningData >	m_binningData

Transform3D	m_transform
	vector of BinningData

Transform3D	m_itransform
	shared transform

Detailed Description

The BinUtility class that translated global and local position into a bins of a BinnedArray, most performant is equidistant binning without a transform, however, optionally a transform can be provided, e.g. for binning on shifted object, the transform is usually shared with the geometric object the Array is defined on, for performance reasons, also the inverse transform is stored.

Definition at line 31 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 31 of file BinUtility.hpp

Constructor & Destructor Documentation

Acts::BinUtility::BinUtility ( )

inline

Constructor for equidistant.

Definition at line 34 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 34 of file BinUtility.hpp

References m_binningData.

Acts::BinUtility::BinUtility ( const Transform3D & tForm )

inline

Constructor with only a Transform3D

Parameters

tForm is the local to global transform

Definition at line 44 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 44 of file BinUtility.hpp

References m_binningData.

Acts::BinUtility::BinUtility	(	const BinningData &	bData,
		const Transform3D &	tForm = `Transform3D::Identity()`
	)

inline

Constructor from BinningData directly

Parameters

bData	is the provided binning data
tForm	is the (optional) transform

Definition at line 53 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 53 of file BinUtility.hpp

References m_binningData.

Acts::BinUtility::BinUtility	(	size_t	bins,
		float	min,
		float	max,
		BinningOption	opt = `open`,
		BinningValue	value = `binX`,
		const Transform3D &	tForm = `Transform3D::Identity()`
	)

inline

Constructor for equidistant

Parameters

bins	is the number of bins
min	in the minimal value
max	is the maximal value
opt	is the binning option : open, closed
value	is the binninb value : binX, binY, binZ, etc.
tForm	is the (optional) transform

Definition at line 68 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 68 of file BinUtility.hpp

References m_binningData, and value.

Acts::BinUtility::BinUtility	(	std::vector< float > &	bValues,
		BinningOption	opt = `open`,
		BinningValue	value = `binPhi`,
		const Transform3D &	tForm = `Transform3D::Identity()`
	)

inline

Constructor for arbitrary

Parameters

bValues	is the boundary values of the binning
opt	is the binning option : open, closed
value	is the binninb value : binX, binY, binZ, etc.
tForm	is the (optional) transform

Definition at line 82 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 82 of file BinUtility.hpp

References m_binningData, and value.

Acts::BinUtility::BinUtility ( const BinUtility & sbu )

inline

Copy constructor

Parameters

sbu	is the source bin utility

Definition at line 93 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 93 of file BinUtility.hpp

Acts::BinUtility::~BinUtility ( )

default

Virtual Destructor.

Member Function Documentation

size_t Acts::BinUtility::bin	(	const Vector3D &	position,
		size_t	ba = `0`
	)		const

inline

Bin from a 3D vector (already in binning frame)

Parameters

position	is the 3D position to be evaluated
ba	is the bin dimension

Returns: is the bin value

Definition at line 160 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 160 of file BinUtility.hpp

References m_binningData, and m_itransform.

Referenced by Acts::Test::BOOST_AUTO_TEST_CASE(), linit(), lmcmnd(), lmidat(), lmsimp(), neighbourRange(), pollinit(), pybook(), pydump(), pyfact(), pyfill(), pyhist(), pynull(), pyoper(), and pyplot().

Here is the caller graph for this function:

size_t Acts::BinUtility::bin	(	const Vector2D &	lposition,
		size_t	ba = `0`
	)		const

inline

Bin from a 2D vector (following local parameters defintitions)

no optional transform applied
USE WITH CARE !!

You need to make sure that the local position is actually in the binning frame of the BinUtility

Parameters

lposition	is the local position to be set
ba	is the bin dimension

Returns: bin calculated from local

Definition at line 225 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 225 of file BinUtility.hpp

References m_binningData.

const std::vector<BinningData>& Acts::BinUtility::binningData ( ) const

inline

return the binning data vector

Definition at line 129 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 129 of file BinUtility.hpp

References m_binningData.

Referenced by Acts::adjustBinUtility(), Acts::Test::BOOST_AUTO_TEST_CASE(), Acts::createGrid2D(), Acts::createGrid3D(), Acts::detail::findLocalTopAndBottomEnd(), operator+=(), Acts::JsonGeometryConverter::surfaceMaterialToJson(), and ActsExamples::RootMaterialWriter::write().

Here is the caller graph for this function:

BinningValue Acts::BinUtility::binningValue ( size_t ba = 0 ) const

inline

The type/value of the binning

Parameters

ba	is the binaccessor

Returns: the binning value of the accessor entry

Definition at line 301 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 301 of file BinUtility.hpp

References m_binningData.

size_t Acts::BinUtility::bins ( ) const

inline

Return the total number of bins.

Definition at line 132 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 132 of file BinUtility.hpp

References bins().

Referenced by Acts::AccumulatedSurfaceMaterial::AccumulatedSurfaceMaterial(), bins(), Acts::Test::BOOST_AUTO_TEST_CASE(), Acts::JsonGeometryConverter::jsonToSurfaceMaterial(), max(), and ActsExamples::RootMaterialWriter::write().

Here is the call graph for this function:

Here is the caller graph for this function:

size_t Acts::BinUtility::bins ( size_t ba ) const

inline

Number of bins

Parameters

ba	is the binaccessor

Returns: size_t is the bins of the accessor entry

Definition at line 284 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 284 of file BinUtility.hpp

References bins(), and m_binningData.

Here is the call graph for this function:

std::array<size_t, 3> Acts::BinUtility::binTriple ( const Vector3D & position ) const

inline

Bin-triple fast access

calculate the bin triple with one transform

Parameters

position is the 3D position to be evaluated

Returns: is the bin value in 3D

transform or not

now get the bins

return the triple

Definition at line 141 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 141 of file BinUtility.hpp

References m_binningData, m_itransform, and Acts::VectorHelpers::position().

Referenced by Acts::Test::BOOST_AUTO_TEST_CASE().

Here is the call graph for this function:

Here is the caller graph for this function:

size_t Acts::BinUtility::dimensions ( ) const

inline

First bin maximal value

Returns: the dimenstion of the binning data

Definition at line 265 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 265 of file BinUtility.hpp

References m_binningData.

Referenced by Acts::Test::BOOST_AUTO_TEST_CASE(), and Acts::JsonGeometryConverter::jsonToVolumeMaterial().

Here is the caller graph for this function:

bool Acts::BinUtility::inside ( const Vector3D & position ) const

inline

Check if bin is inside from Vector2D - optional transform applied

Parameters

position is the global position to be evaluated

Returns: is a boolean check

transform or not

Definition at line 235 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 235 of file BinUtility.hpp

References Acts::BinningData::inside(), m_binningData, m_itransform, and Acts::VectorHelpers::position().

Here is the call graph for this function:

bool Acts::BinUtility::inside ( const Vector2D & lposition ) const

inline

Check if bin is inside from Vector2D - no optional transform applied

Parameters

lposition is the local position to be evaluated

Returns: is a boolean check

Definition at line 252 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 252 of file BinUtility.hpp

References m_binningData.

size_t Acts::BinUtility::max ( size_t ba = 0 ) const

inline

First bin maximal value

Parameters

ba	is the binaccessor

Returns: size_t is the maximal bin of the accessor entry

Definition at line 272 of file BinUtility.hpp.

View newest version in sPHENIX GitHub at line 272 of file BinUtility.hpp

References bins(), and m_binningData.

Referenced by Acts::InterpolatedMaterialMap< Mapper_t >::toStream().

Here is the call graph for this function:

Here is the caller graph for this function:

std::vector<size_t> Acts::BinUtility::neighbourRange	(	const Vector3D &	position,
		size_t	ba = `0`
	)		const

inline

Bin neighbour range this method calls the increment/decreement methods the bin itself is also contained, so if not an edge-case this would be | n | c | p |

Parameters