Container with one element per geometry TPC. More...

#include <GeometryDataContainers.h>

Inheritance diagram for geo::TPCDataContainer< T >:

Public Types
using	value_type = typename BaseContainer_t::value_type

Public Types inherited from geo::GeoIDdataContainer< T, geo::TPCIDmapper<> >
using	Mapper_t = geo::TPCIDmapper<>
	Type of mapper between IDs and index. More...

using	ID_t = typename Mapper_t::ID_t
	Type used as ID for this container. More...

using	value_type = typename Container_t::value_type

using	reference = typename Container_t::reference

using	const_reference = typename Container_t::const_reference

using	pointer = typename Container_t::pointer

using	const_pointer = typename Container_t::const_pointer

using	iterator = details::GeoIDdataContainerIterator< Mapper_t, BaseIter_t >

using	const_iterator = details::GeoIDdataContainerIterator< Mapper_t, BaseConstIter_t >

using	difference_type = typename Container_t::difference_type

using	size_type = typename Container_t::size_type

using	item_iterator = details::GeoIDdataContainerItemIterator< iterator >
	Special iterator dereferencing to pairs ( ID, value ) (see `items()`). More...

using	item_const_iterator = details::GeoIDdataContainerItemIterator< const_iterator >
	Special iterator dereferencing to pairs ( ID, value ) (see `items()`). More...

Public Member Functions
	TPCDataContainer ()=default
	Default constructor: empty container. More...

	TPCDataContainer (unsigned int nCryo, unsigned int nTPCs)
	Prepares the container with default-constructed data. More...

	TPCDataContainer (unsigned int nCryo, unsigned int nTPCs, value_type const &defValue)
	Prepares the container with copies of the specified default value. More...

Container modification
void	resize (unsigned int nCryo, unsigned int nTPCs)
	Prepares the container with default-constructed data. More...

void	resize (unsigned int nCryo, unsigned int nTPCs, T const &defValue)
	Prepares the container initializing all its data. More...

Container status query
bool	hasCryostat (geo::CryostatID const &cryoid) const
	Returns whether this container hosts data for the specified cryostat. More...

bool	hasTPC (geo::TPCID const &tpcid) const
	Returns whether this container hosts data for the specified TPC. More...

Public Member Functions inherited from geo::GeoIDdataContainer< T, geo::TPCIDmapper<> >
	GeoIDdataContainer ()=default
	Default constructor: container has no room at all. More...

	GeoIDdataContainer (std::initializer_list< unsigned int > dims)
	Prepares the container with default-constructed data. More...

	GeoIDdataContainer (std::initializer_list< unsigned int > dims, value_type const &defValue)
	Prepares the container initializing all its data. More...

reference	operator[] (ID_t const &id)
	Returns the element for the specified geometry element. More...

const_reference	operator[] (ID_t const &id) const
	Returns the element for the specified geometry element (read-only). More...

reference	at (ID_t const &id)

const_reference	at (ID_t const &id) const

reference	first ()
	Returns the element for the first ID (unchecked). More...

const_reference	first () const
	Returns the element for the first ID (unchecked). More...

reference	last ()
	Returns the element for the last ID (unchecked). More...

const_reference	last () const
	Returns the element for the last ID (unchecked). More...

iterator	begin ()
	Returns an iterator to the beginning of the data. More...

const_iterator	begin () const
	Returns a constant iterator to the beginning of the data. More...

iterator	end ()
	Returns an iterator to past the end of the data. More...

const_iterator	end () const
	Returns a constant iterator to past the end of the data. More...

const_iterator	cbegin () const
	Returns a constant iterator to the beginning of the data. More...

const_iterator	cend () const
	Returns a constant iterator to past the end of the data. More...

item_iterator	item_begin ()
	Returns an item iterator to the beginning of the data. More...

item_const_iterator	item_begin () const
	Returns a item constant iterator to the beginning of the data. More...

item_iterator	item_end ()
	Returns an item iterator to past the end of the data. More...

item_const_iterator	item_end () const
	Returns a item constant iterator to past the end of the data. More...

item_const_iterator	item_cbegin () const
	Returns a item constant iterator to the beginning of the data. More...

item_const_iterator	item_cend () const
	Returns a item constant iterator to past the end of the data. More...

auto	items ()
	Returns an object suitable for a range-for loop with `item_iterator`. More...

auto	items () const
	Returns an object suitable for a range-for loop with `item_const_iterator`. More...

void	fill (value_type value)
	Sets all elements to the specified `value` (copied). More...

void	reset ()
	Sets all the elements to a default-constructed `value_type`. More...

Op	apply (Op &&op)
	Applies an operation on all elements. More...

decltype(auto)	apply (Op &&op) const
	Applies an operation on all elements. More...

void	resize (std::initializer_list< unsigned int > dims)
	Prepares the container with default-constructed data. More...

void	resize (std::initializer_list< unsigned int > dims, value_type const &defValue)
	Prepares the container initializing all its data. More...

void	resizeAs (geo::GeoIDdataContainer< OT, Mapper_t > const &other)
	Prepares the container with default-constructed data. More...

void	resizeAs (geo::GeoIDdataContainer< OT, Mapper_t > const &other, value_type const &defValue)
	Prepares the container initializing all its data. More...

void	clear ()
	Makes the container empty, with no usable storage space. More...

size_type	size () const
	Returns the number of elements in the container. More...

size_type	capacity () const
	Returns the number of elements the container has memory for. More...

bool	empty () const
	Returns whether the container has no elements (`false` by assumptions). More...

unsigned int	dimSize () const
	Dimensions of the `Level` dimension of this container. More...

bool	hasElement (GeoID const &id) const
	Returns whether this container hosts data for the specified ID. More...

GeoID	firstID () const
	Returns the ID of the first element with GeoID type. More...

GeoID	lastID () const
	Returns the ID of the last covered element with GeoID type. More...

Mapper_t const &	mapper () const
	Returns the mapper object used to convert ID's and container positions. More...

Private Types
using	BaseContainer_t = geo::GeoIDdataContainer< T, geo::TPCIDmapper<>>

Additional Inherited Members
Static Public Member Functions inherited from geo::GeoIDdataContainer< T, geo::TPCIDmapper<> >
static constexpr unsigned int	dimensions ()
	Dimensions of the ID of this container. More...

Detailed Description

template<typename T>
class geo::TPCDataContainer< T >

Container with one element per geometry TPC.

Template Parameters

T	type of the contained datum

See also: geo::GeometryCore::makeTPCData

The container is of fixed size and can't be neither resized nor freed before destruction.

This example creates a "map" of tracks starting on each TPC:

auto const* geom = lar::providerFrom<geo::GeometryCore>();
geo::TPCDataContainer<std::vector<recob::Track const*>> TracksPerTPC
  (geom->NCryostats(), geom->MaxTPCs());
for (recob::Track const& track: tracks) {
  geo::TPCGeo const* tpc = geom->PositionToTPCptr(track.Start());
  if (tpc) TracksPerTPC[tpc->ID()].push_back(tpc);
} // for

Assumptions

The following assumptions should be considered unchecked, and the behavior when they are violated undefined (but note that in debug mode some of them might be actually checked):

the container assumes the same number of TPCs in each cryostat. While this is not effectively a necessary condition, keep in mind that this container has no notion whether a given TPC actually exists in the geometry or not
at least one element is expected to be present

Definition at line 39 of file GeometryDataContainers.h.

Member Typedef Documentation

template<typename T>

using geo::TPCDataContainer< T >::BaseContainer_t = geo::GeoIDdataContainer<T, geo::TPCIDmapper<>>

private

Definition at line 553 of file GeometryDataContainers.h.

template<typename T>

using geo::TPCDataContainer< T >::value_type = typename BaseContainer_t::value_type

Definition at line 557 of file GeometryDataContainers.h.

Constructor & Destructor Documentation

template<typename T>

geo::TPCDataContainer< T >::TPCDataContainer ( )

default

Default constructor: empty container.

See also: resize()

The container starts with no room for any data. The only guarantee is that empty() is true and size() is 0. Use resize() before anything else.

template<typename T>

geo::TPCDataContainer< T >::TPCDataContainer	(	unsigned int	nCryo,
		unsigned int	nTPCs
	)

inline

Prepares the container with default-constructed data.

Parameters

nCryo	number of cryostats
nTPCs	number of TPCs

The container is sized to host data for nCryo cryostats, each with nTPCs TPCs. Each element in the container is default-constructed.

Definition at line 577 of file GeometryDataContainers.h.

578 : BaseContainer_t({ nCryo, nTPCs })

579 {}

geo::TPCDataContainer::BaseContainer_t

geo::GeoIDdataContainer< T, geo::TPCIDmapper<>> BaseContainer_t

Definition: GeometryDataContainers.h:553

template<typename T>

geo::TPCDataContainer< T >::TPCDataContainer	(	unsigned int	nCryo,
		unsigned int	nTPCs,
		value_type const &	defValue
	)

inline

Prepares the container with copies of the specified default value.

Parameters

nCryo	number of cryostats
nTPCs	number of TPCs
defValue	the value to be replicated

The container is sized to host data for nCryo cryostats, each with nTPCs TPCs. Each element in the container is a copy of defValue.

auto const* geom = lar::providerFrom<geo::GeometryCore>();
geo::TPCDataContainer<unsigned int> PlanesPerTPC
  (geom->NCryostats(), geom->MaxTPCs(), 3U);
for (geo::TPCGeo const& TPC: geom->IterateTPC())
  assert(PlanesPerTPC[TPC.ID()] == TPC.Nplanes());

Definition at line 598 of file GeometryDataContainers.h.

599 : BaseContainer_t({ nCryo, nTPCs }, defValue)

600 {}

geo::TPCDataContainer::BaseContainer_t

geo::GeoIDdataContainer< T, geo::TPCIDmapper<>> BaseContainer_t

Definition: GeometryDataContainers.h:553

Member Function Documentation

template<typename T>

bool geo::TPCDataContainer< T >::hasCryostat ( geo::CryostatID const & cryoid ) const

inline

Returns whether this container hosts data for the specified cryostat.

Definition at line 652 of file GeometryDataContainers.h.

653 { return BaseContainer_t::hasElement(cryoid); }

geo::GeoIDdataContainer::hasElement

bool hasElement(GeoID const &id) const

Returns whether this container hosts data for the specified ID.

Definition: GeometryDataContainers.h:1279

template<typename T>

bool geo::TPCDataContainer< T >::hasTPC ( geo::TPCID const & tpcid ) const

inline

Returns whether this container hosts data for the specified TPC.

Definition at line 656 of file GeometryDataContainers.h.

657 { return BaseContainer_t::hasElement(tpcid); }

geo::GeoIDdataContainer::hasElement

bool hasElement(GeoID const &id) const

Returns whether this container hosts data for the specified ID.

Definition: GeometryDataContainers.h:1279

template<typename T>

void geo::TPCDataContainer< T >::resize	(	unsigned int	nCryo,
		unsigned int	nTPCs
	)

inline

Prepares the container with default-constructed data.

Parameters

nCryo	number of cryostats
nTPCs	number of TPCs

See also: clear(), fill()

The container is sized to host data for nCryo cryostats, each with nTPCs TPCs. Each element in the container is default-constructed.

Existing data is not touched, but it may be rearranged in a non-straightforward way.

Definition at line 619 of file GeometryDataContainers.h.

620 { BaseContainer_t::resize({ nCryo, nTPCs }); }

geo::GeoIDdataContainer::resize

void resize(std::initializer_list< unsigned int > dims)

Prepares the container with default-constructed data.

Definition: GeometryDataContainers.h:1468

template<typename T>

void geo::TPCDataContainer< T >::resize	(	unsigned int	nCryo,
		unsigned int	nTPCs,
		T const &	defValue
	)

inline

Prepares the container initializing all its data.

Parameters

nCryo	number of cryostats
nTPCs	number of TPCs
defValue	the value copied to fill all entries in the container

See also: clear(), fill()

The container is sized to host data for nCryo cryostats, each with nTPCs TPCs. Each element in the container is a copy of defValue.

auto const* geom = lar::providerFrom<geo::GeometryCore>();
geo::TPCDataContainer<unsigned int> countPerPlane
countPerPlane.resize(geom->NCryostats(), geom->MaxTPCs(), 0U);

Existing data is not touched, but it may be rearranged in a non-straightforward way.

Definition at line 640 of file GeometryDataContainers.h.

641 { BaseContainer_t::resize({ nCryo, nTPCs }, defValue); }

geo::GeoIDdataContainer::resize

void resize(std::initializer_list< unsigned int > dims)

Prepares the container with default-constructed data.

Definition: GeometryDataContainers.h:1468

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

larcorealg/larcorealg/Geometry/GeometryDataContainers.h

Public Types

Public Member Functions

Private Types

Additional Inherited Members

Detailed Description

template<typename T> class geo::TPCDataContainer< T >

Assumptions

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

template<typename T>
class geo::TPCDataContainer< T >