recob::HitCollectionCreator Class Reference

A class handling a collection of hits and its associations. More...

#include <HitCreator.h>

Inheritance diagram for recob::HitCollectionCreator:

Public Member Functions
size_t	size () const
	Returns the number of hits currently in the collection. More...
void	reserve (size_t new_size)
	Prepares the collection to host at least new_size hits. More...
void	put_into (art::Event &)
	Moves the data into an event. More...
void	put_into ()
	Moves the data into the event. More...
std::vector< recob::Hit > const &	peek () const
	Returns a read-only reference to the current list of hits. More...
Constructors
	HitCollectionCreator (art::Event &event, std::string instance_name="", bool doWireAssns=true, bool doRawDigitAssns=true)
	Constructor: sets instance name and whether to build associations. More...
	HitCollectionCreator (art::Event &event, bool doWireAssns, bool doRawDigitAssns)
	Constructor: no product instance name. More...
Addition of hits
void	emplace_back (recob::Hit &&hit, art::Ptr< recob::Wire > const &wire=art::Ptr< recob::Wire >(), art::Ptr< raw::RawDigit > const &digits=art::Ptr< raw::RawDigit >())
	Adds the specified hit to the data collection. More...
void	emplace_back (recob::Hit const &hit, art::Ptr< recob::Wire > const &wire=art::Ptr< recob::Wire >(), art::Ptr< raw::RawDigit > const &digits=art::Ptr< raw::RawDigit >())
	Adds the specified hit to the data collection. More...
void	emplace_back (HitCreator &&hit, art::Ptr< recob::Wire > const &wire=art::Ptr< recob::Wire >(), art::Ptr< raw::RawDigit > const &digits=art::Ptr< raw::RawDigit >())
	Adds the specified hit to the data collection. More...
void	emplace_back (recob::Hit &&hit, art::Ptr< raw::RawDigit > const &digits)
	Adds the specified hit to the data collection. More...
void	emplace_back (HitCreator &&hit, art::Ptr< raw::RawDigit > const &digits)
	Adds the specified hit to the data collection. More...
void	emplace_back (HitCreator const &hit, art::Ptr< raw::RawDigit > const &digits)
	Adds the specified hit to the data collection. More...
Public Member Functions inherited from recob::HitAndAssociationsWriterBase
size_t	size () const
	Returns the number of hits currently in the collection. More...
void	put_into (art::Event &)
	Moves the data into the event. More...
void	put_into ()
	Moves the data into the event. More...
std::vector< recob::Hit > const &	peek () const
	Returns a read-only reference to the current list of hits. More...

Protected Types
using	HitPtr_t = HitAndAssociationsWriterBase::HitPtr_t
Protected Types inherited from recob::HitAndAssociationsWriterBase
using	HitPtr_t = art::Ptr< recob::Hit >
	Type of art pointer to Hit. More...

Protected Member Functions
HitPtr_t	CreatePtrToLastHit () const
	Creates an art pointer to the hit with the last index. More...
void	CreateAssociationsToLastHit (art::Ptr< recob::Wire > const &wire, art::Ptr< raw::RawDigit > const &digits)
	Creates associations between the last hit and the specified pointers. More...
Protected Member Functions inherited from recob::HitAndAssociationsWriterBase
	HitAndAssociationsWriterBase (art::Event &event, std::string instance_name, bool doWireAssns, bool doRawDigitAssns)
	Constructor: sets instance name and whether to build associations. More...
HitPtr_t	CreatePtr (size_t index) const
	Creates an art pointer to the hit with the specified index. More...

Additional Inherited Members
Static Public Member Functions inherited from recob::HitAndAssociationsWriterBase
static void	declare_products (art::ProducesCollector &collector, std::string instance_name="", bool doWireAssns=true, bool doRawDigitAssns=true)
	Declares the hit products we are going to fill. More...
Protected Attributes inherited from recob::HitAndAssociationsWriterBase
std::string	prod_instance
	Tame of the instance for data products. More...
std::unique_ptr< std::vector < recob::Hit > >	hits
	Collection of hits. More...
std::unique_ptr< art::Assns < recob::Wire, recob::Hit > >	WireAssns
	Associations with wires. More...
std::unique_ptr< art::Assns < raw::RawDigit, recob::Hit > >	RawDigitAssns
	Associations with raw digits. More...
art::Event *	event = nullptr
	Pointer to the event we are using. More...
art::PtrMaker< recob::Hit >	hitPtrMaker
	Tool to create hit pointers,. More...

Detailed Description

A class handling a collection of hits and its associations.

---

Instead of creating a collection of hits, one for its association with wires and one for its association with raw digits, one can push hits into this object, and then move it into the event.

Definition at line 508 of file HitCreator.h.

Member Typedef Documentation

using recob::HitCollectionCreator::HitPtr_t = HitAndAssociationsWriterBase::HitPtr_t

protected

Definition at line 669 of file HitCreator.h.

Constructor & Destructor Documentation

recob::HitCollectionCreator::HitCollectionCreator	(	art::Event &	event,
		std::string	instance_name = "",
		bool	doWireAssns = true,
		bool	doRawDigitAssns = true
	)

Constructor: sets instance name and whether to build associations.

Parameters

event	the event the products are going to be put into
instance_name	name of the instance for all data products
doWireAssns	whether to enable associations to wires
doRawDigitAssns	whether to enable associations to raw digits

All the data products (hit collection and associations) will have the specified product instance name.

Definition at line 278 of file HitCreator.cxx.

    : HitAndAssociationsWriterBase
      (event, instance_name, doWireAssns, doRawDigitAssns)
  {
    hits.reset(new std::vector<recob::Hit>);
  } // HitCollectionCreator::HitCollectionCreator()

recob::HitCollectionCreator::HitCollectionCreator ( art::Event &  event, bool  doWireAssns, bool  doRawDigitAssns  )

inline

Constructor: no product instance name.

Parameters

event	the event the products are going to be put into
doWireAssns	whether to enable associations to wires
doRawDigitAssns	whether to enable associations to raw digits

Definition at line 536 of file HitCreator.h.

       :
      HitCollectionCreator(event, "", doWireAssns, doRawDigitAssns)
      {}

Member Function Documentation

void recob::HitCollectionCreator::CreateAssociationsToLastHit ( art::Ptr< recob::Wire > const &  wire, art::Ptr< raw::RawDigit > const &  digits  )

protected

Creates associations between the last hit and the specified pointers.

Definition at line 327 of file HitCreator.cxx.

    {
    // if no association is required, we are done
    if (!WireAssns && !RawDigitAssns) return;

    // art pointer to the hit we just created
    HitPtr_t hit_ptr(CreatePtrToLastHit());

    // association with wires
    if (WireAssns && wire.isNonnull())
      WireAssns->addSingle(wire, hit_ptr); // if it fails, it throws

    // association with wires
    if (RawDigitAssns && digits.isNonnull())
      RawDigitAssns->addSingle(digits, hit_ptr); // if it fails, it throws

  } // HitCollectionCreator::CreateAssociationsToLastHit()

HitPtr_t recob::HitCollectionCreator::CreatePtrToLastHit ( ) const

inlineprotected

Creates an art pointer to the hit with the last index.

Definition at line 672 of file HitCreator.h.

      { return hits->empty()? HitPtr_t(): CreatePtr(hits->size() - 1); }

void recob::HitCollectionCreator::emplace_back	(	recob::Hit &&	hit,
		art::Ptr< recob::Wire > const &	wire = art::Ptr<recob::Wire>(),
		art::Ptr< raw::RawDigit > const &	digits = art::Ptr<raw::RawDigit>()
	)

Adds the specified hit to the data collection.

Parameters

hit	the hit that will be moved into the collection
wire	art pointer to the wire to be associated to this hit
digits	art pointer to the raw digits to be associated to this hit

After this call, hit will be invalid. If a art pointer is not valid, that association will not be stored.

Definition at line 290 of file HitCreator.cxx.

    {

    // add the hit to the collection
    hits->emplace_back(std::move(hit));

    CreateAssociationsToLastHit(wire, digits);
  } // HitCollectionCreator::emplace_back(Hit&&)

void recob::HitCollectionCreator::emplace_back	(	recob::Hit const &	hit,
		art::Ptr< recob::Wire > const &	wire = art::Ptr<recob::Wire>(),
		art::Ptr< raw::RawDigit > const &	digits = art::Ptr<raw::RawDigit>()
	)

Adds the specified hit to the data collection.

Parameters

hit	the hit that will be copied into the collection
wire	art pointer to the wire to be associated to this hit
digits	art pointer to the raw digits to be associated to this hit

If a art pointer is not valid, that association will not be stored.

Definition at line 303 of file HitCreator.cxx.

    {

    // add the hit to the collection
    hits->push_back(hit);

    CreateAssociationsToLastHit(wire, digits);
  } // HitCollectionCreator::emplace_back(Hit)

void recob::HitCollectionCreator::emplace_back ( HitCreator &&  hit, art::Ptr< recob::Wire > const &  wire = art::Ptr<recob::Wire>(), art::Ptr< raw::RawDigit > const &  digits = art::Ptr<raw::RawDigit>()  )

inline

Adds the specified hit to the data collection.

Parameters

hit	the HitCreator object containing the hit
wire	art pointer to the wire to be associated to this hit
digits	art pointer to the raw digits to be associated to this hit

After this call, the hit creator will be empty. If a art pointer is not valid, that association will not be stored.

Definition at line 590 of file HitCreator.h.

      { emplace_back(hit.move(), wire, digits); }

void recob::HitCollectionCreator::emplace_back ( recob::Hit &&  hit, art::Ptr< raw::RawDigit > const &  digits  )

inline

Adds the specified hit to the data collection.

Parameters

hit	the hit that will be moved into the collection
digits	art pointer to the raw digits to be associated to this hit

After this call, hit will be invalid. If the digit pointer is not valid, its association will not be stored.

Definition at line 606 of file HitCreator.h.

      { emplace_back(std::move(hit), art::Ptr<recob::Wire>(), digits); }

void recob::HitCollectionCreator::emplace_back ( HitCreator &&  hit, art::Ptr< raw::RawDigit > const &  digits  )

inline

Adds the specified hit to the data collection.

Parameters

hit	the HitCreator object containing the hit
digits	art pointer to the raw digits to be associated to this hit

After this call, the hit creator will be empty. If the digit pointer is not valid, its association will not be stored.

Definition at line 618 of file HitCreator.h.

      { emplace_back(std::move(hit), art::Ptr<recob::Wire>(), digits); }

void recob::HitCollectionCreator::emplace_back ( HitCreator const &  hit, art::Ptr< raw::RawDigit > const &  digits  )

inline

Adds the specified hit to the data collection.

Parameters

hit	the HitCreator object containing the hit
digits	art pointer to the raw digits to be associated to this hit

If the digit pointer is not valid, its association will not be stored.

Definition at line 630 of file HitCreator.h.

      { emplace_back(std::move(hit.copy()), art::Ptr<recob::Wire>(), digits); }

std::vector<recob::Hit> const& recob::HitCollectionCreator::peek ( ) const

inline

Returns a read-only reference to the current list of hits.

Definition at line 665 of file HitCreator.h.

{ return *hits; }

void recob::HitCollectionCreator::put_into ( art::Event &  )

inline

Moves the data into an event.

The calling module must have already declared the production of these products with the proper instance name. After the move, the collections in this object are empty.

Deprecated:

Use the version with no arguments instead.

Definition at line 652 of file HitCreator.h.

{ put_into(); }

void recob::HitCollectionCreator::put_into

(

)

Moves the data into the event.

The calling module must have already declared the production of these products with the proper instance name. After the move, the collections in this object are empty.

Definition at line 316 of file HitCreator.cxx.

                                      {
    if (!hits) {
      throw art::Exception(art::errors::LogicError)
        << "HitCollectionCreator is trying to put into the event"
        " a hit collection that was never created!\n";
    }
    HitAndAssociationsWriterBase::put_into();
  } // HitCollectionCreator::put_into()

void recob::HitCollectionCreator::reserve ( size_t  new_size )

inline

Prepares the collection to host at least new_size hits.

Definition at line 640 of file HitCreator.h.

{ if (hits) hits->reserve(new_size); }

size_t recob::HitCollectionCreator::size ( ) const

inline

Returns the number of hits currently in the collection.

Definition at line 636 of file HitCreator.h.

{ return hits->size(); }

---

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

• HitCreator.h
• HitCreator.cxx