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

#include "HitCreator.h"

Inheritance diagram for recob::HitCollectionAssociator:

Public Member Functions
void	use_hits (std::unique_ptr< std::vector< recob::Hit >> &&srchits)
	Uses the specified collection as data product. More...

void	put_into (art::Event &)
	Moves the data into the event. More...

void	put_into ()
	Moves the data into the event. More...

size_t	size () const
	Returns the number of hits currently in the collection. More...

std::vector< recob::Hit > const &	peek () const
	Returns a read-only reference to the current list of hits. More...

Constructors
template<typename ModuleType >
	HitCollectionAssociator (ModuleType &producer, art::Event &event, std::string instance_name, art::InputTag const &WireModuleLabel, art::InputTag const &RawDigitModuleLabel)
	Constructor: sets instance name and whether to build associations. More...

template<typename ModuleType >
	HitCollectionAssociator (ModuleType &producer, art::Event &event, art::InputTag const &WireModuleLabel, art::InputTag const &RawDigitModuleLabel)
	Constructor: sets instance name and whether to build associations. More...

template<typename ModuleType >
	HitCollectionAssociator (ModuleType &producer, art::Event &event, std::string instance_name, art::InputTag const &WireModuleLabel, bool doRawDigitAssns)
	Constructor: sets instance name and whether to build associations. More...

template<typename ModuleType >
	HitCollectionAssociator (ModuleType &producer, art::Event &event, art::InputTag const &WireModuleLabel, bool doRawDigitAssns)
	Constructor: sets instance name and whether to build associations. More...

Static Public Member Functions
template<typename ModuleType >
static void	declare_products (ModuleType &producer, std::string instance_name="", bool doWireAssns=true, bool doRawDigitAssns=true)
	Declares the hit products we are going to fill. More...

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

Protected Member Functions
void	prepare_associations (std::vector< recob::Hit > const &srchits)
	Finds out the associations for the specified hits. More...

void	prepare_associations ()
	Finds out the associations for the current hits. More...

HitPtr_t	CreatePtr (size_t index) const
	Creates an art pointer to the hit with the specified index. More...

Protected Attributes
art::InputTag	wires_label
	Label of the collection of wires to associate. More...

art::InputTag	digits_label
	Label of raw digits collection to associate. More...

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.

Use this object if you already have a collection of recob::Hit and you simply want the hits associated to the wire and digit with the same channel.

Definition at line 703 of file HitCreator.h.

Member Typedef Documentation

using recob::HitAndAssociationsWriterBase::HitPtr_t = art::Ptr<recob::Hit>

protectedinherited

Type of art pointer to Hit.

Definition at line 462 of file HitCreator.h.

Constructor & Destructor Documentation

template<typename ModuleType >

recob::HitCollectionAssociator::HitCollectionAssociator	(	ModuleType &	producer,
		art::Event &	event,
		std::string	instance_name,
		art::InputTag const &	WireModuleLabel,
		art::InputTag const &	RawDigitModuleLabel
	)

Constructor: sets instance name and whether to build associations.

Template Parameters

ModuleType type of producing module (EDProducer or EDFilter)

Parameters

producer	the module producing the data products
event	the event the products are going to be put into
instance_name	name of the instance for all data products
WireModuleLabel	label of the module used to create wires
RawDigitModuleLabel	label of the module used to create raw digits

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

If a label is empty, the corresponding association will not be produced.

Definition at line 1175 of file HitCreator.h.

References recob::HitAndAssociationsWriterBase::hits.

   : HitAndAssociationsWriterBase(
       producer, event, instance_name,
       WireModuleLabel != "", RawDigitModuleLabel != ""
       )
   , wires_label(WireModuleLabel)
   , digits_label(RawDigitModuleLabel)
 {
   hits.reset(new std::vector<recob::Hit>);
 } // recob::HitCollectionAssociator::HitCollectionAssociator()

template<typename ModuleType >

recob::HitCollectionAssociator::HitCollectionAssociator	(	ModuleType &	producer,
		art::Event &	event,
		art::InputTag const &	WireModuleLabel,
		art::InputTag const &	RawDigitModuleLabel
	)

inline

Constructor: sets instance name and whether to build associations.

Template Parameters

ModuleType type of producing module (EDProducer or EDFilter)

Parameters

producer	the module producing the data products
event	the event the products are going to be put into
WireModuleLabel	label of the module used to create wires
RawDigitModuleLabel	label of the module used to create raw digits

All the data products (hit collection and associations) will have a default, empty product instance name.

If a label is empty, the corresponding association will not be produced.

Definition at line 743 of file HitCreator.h.

        :
       HitCollectionAssociator
         (producer, event, "", WireModuleLabel, RawDigitModuleLabel)
       {}

template<typename ModuleType >

recob::HitCollectionAssociator::HitCollectionAssociator	(	ModuleType &	producer,
		art::Event &	event,
		std::string	instance_name,
		art::InputTag const &	WireModuleLabel,
		bool	doRawDigitAssns
	)

Constructor: sets instance name and whether to build associations.

Template Parameters

ModuleType type of producing module (EDProducer or EDFilter)

Parameters

producer	the module producing the data products
event	the event the products are going to be put into
instance_name	name of the instance for all data products
WireModuleLabel	label of the module used to create wires
doRawDigitAssns	whether to write associations with raw digits

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

The raw digit association is built out of their existing associations with wires, rather than by directly using the raw digits data product.

Definition at line 1194 of file HitCreator.h.

References recob::HitAndAssociationsWriterManager< Writer, ModuleType >::HitAndAssociationsWriterManager(), recob::HitAndAssociationsWriterBase::hits, art::errors::LogicError, recob::HitAndAssociationsWriterBase::RawDigitAssns, and recob::HitAndAssociationsWriterBase::WireAssns.

   : HitAndAssociationsWriterBase(
       producer, event, instance_name,
       WireModuleLabel != "", doRawDigitAssns
       )
   , wires_label(WireModuleLabel)
   , digits_label()
 {
   if (RawDigitAssns && !WireAssns) {
     throw art::Exception(art::errors::LogicError)
       << "HitCollectionAssociator can't create hit <--> raw digit"
       " associations through wires, without wires!\n";
   }
   hits.reset(new std::vector<recob::Hit>);
 } // recob::HitCollectionAssociator::HitCollectionAssociator()

template<typename ModuleType >

recob::HitCollectionAssociator::HitCollectionAssociator	(	ModuleType &	producer,
		art::Event &	event,
		art::InputTag const &	WireModuleLabel,
		bool	doRawDigitAssns
	)

inline

Constructor: sets instance name and whether to build associations.

Template Parameters

ModuleType type of producing module (EDProducer or EDFilter)

Parameters

producer	the module producing the data products
event	the event the products are going to be put into
WireModuleLabel	label of the module used to create wires
doRawDigitAssns	whether to write associations with raw digits

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

The raw digit association is built out of their existing associations with wires, rather than by directly using the raw digits data product.

Definition at line 790 of file HitCreator.h.

        :
       HitCollectionAssociator
         (producer, event, "", WireModuleLabel, doRawDigitAssns)
       {}

Member Function Documentation

HitPtr_t recob::HitAndAssociationsWriterBase::CreatePtr ( size_t index ) const

inlineprotectedinherited

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

Definition at line 499 of file HitCreator.h.

499 { return hitPtrMaker(index); }

recob::HitAndAssociationsWriterBase::hitPtrMaker

art::PtrMaker< recob::Hit > hitPtrMaker

Tool to create hit pointers,.

Definition: HitCreator.h:475

template<typename ModuleType >

void recob::HitAndAssociationsWriterBase::declare_products	(	ModuleType &	producer,
		std::string	instance_name = `""`,
		bool	doWireAssns = `true`,
		bool	doRawDigitAssns = `true`
	)

staticinherited

Declares the hit products we are going to fill.

Template Parameters

ModuleType type of producing module (EDProducer or EDFilter)

Parameters

producer	the module producing the data products
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

This declaration must be given in the constructor of producer. It is equivalent to manually declare the relevant among these products:

produces<std::vector<recob::Hit>>(prod_instance);
produces<art::Assns<recob::Wire, recob::Hit>>(prod_instance);
produces<art::Assns<raw::RawDigit, recob::Hit>>(prod_instance);

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

Definition at line 1117 of file HitCreator.h.

Referenced by apa::APAHitFinder::APAHitFinder(), cluster::ClusterCrawler::ClusterCrawler(), CRHitRemoval::CRHitRemoval(), recob::HitAndAssociationsWriterManager< Writer, ModuleType >::declareProducts(), hit::DisambigCheater::DisambigCheater(), hit::DPRawHitFinder::DPRawHitFinder(), hit::FFTHitFinder::FFTHitFinder(), hit::GausHitFinder::GausHitFinder(), hit::HitCheater::HitCheater(), hit::HitFinder::HitFinder(), cluster::LineCluster::LineCluster(), hit::RawHitFinder::RawHitFinder(), hit::RFFHitFinder::RFFHitFinder(), cluster::SimpleLineCluster::SimpleLineCluster(), cluster::TrajCluster::TrajCluster(), and hit::TTHitFinder::TTHitFinder().

   {
   producer.template produces<std::vector<recob::Hit>>(instance_name);
   
   // declare the other products we are creating (if any)
   if (doWireAssns) {
     producer.template produces<art::Assns<recob::Wire, recob::Hit>>
       (instance_name);
   }
   if (doRawDigitAssns) {
     producer.template produces<art::Assns<raw::RawDigit, recob::Hit>>
       (instance_name);
   }
   
 } // recob::HitAndAssociationsWriterBase::declare_products()

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

inlineinherited

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

Definition at line 433 of file HitCreator.h.

References hits().

433 { return *hits; }

recob::HitAndAssociationsWriterBase::hits

std::unique_ptr< std::vector< recob::Hit > > hits

Collection of hits.

Definition: HitCreator.h:467

void recob::HitCollectionAssociator::prepare_associations ( std::vector< recob::Hit > const & srchits )

protected

Finds out the associations for the specified hits.

Definition at line 321 of file HitCreator.cxx.

References raw::RawDigit::Channel(), recob::Wire::Channel(), art::Ptr< T >::isNull(), art::errors::LogicError, util::MakeIndex(), max, and recob::HitRefinerAssociator::use_hits().

   {
     if (!RawDigitAssns && !WireAssns) return; // no associations needed
     assert(event);
     
     // we make the associations anew
     if (RawDigitAssns) ClearAssociations(*RawDigitAssns);
     if (WireAssns)     ClearAssociations(*WireAssns);
     
     // the following is true is we want associations with digits
     // but we don't know where digits are; in that case, we try to use wires
     const bool bUseWiresForDigits = RawDigitAssns && (digits_label == "");
     
     if (WireAssns || bUseWiresForDigits) {
       // do we use wires for digit associations too?
       
       // get the wire collection
       art::ValidHandle<std::vector<recob::Wire>> hWires
         = event->getValidHandle<std::vector<recob::Wire>>(wires_label);
       
       // fill a map of wire index vs. channel number
       std::vector<size_t> WireMap
         = util::MakeIndex(*hWires, std::mem_fn(&recob::Wire::Channel));
       
       // use raw rigit - wire association, assuming they have been produced
       // by the same producer as the wire and with the same instance name;
       // we don't check whether the data product is found, but the following
       // code will have FindOneP throw if that was not the case
       // (that's what we would do here anyway, maybe with a better message...)
       std::unique_ptr<art::FindOneP<raw::RawDigit>> WireToDigit;
       if (bUseWiresForDigits) {
         WireToDigit.reset
           (new art::FindOneP<raw::RawDigit>(hWires, *event, wires_label));
       }
       
       // add associations, hit by hit:
       for (size_t iHit = 0; iHit < srchits.size(); ++iHit) {
         
         // find the channel
         size_t iChannel = size_t(srchits[iHit].Channel()); // forcibly converted
         
         // find the wire associated to that channel
         size_t iWire = std::numeric_limits<size_t>::max();
         if (iChannel < WireMap.size()) iWire = WireMap[iChannel];
         if (iWire == std::numeric_limits<size_t>::max()) {
           throw art::Exception(art::errors::LogicError)
             << "No wire associated to channel #" << iChannel << " whence hit #"
             << iHit << " comes!\n";
         } // if no channel
         
         // make the association with wires
         if (WireAssns) {
           art::Ptr<recob::Wire> wire(hWires, iWire);
           WireAssns->addSingle(wire, CreatePtr(iHit));
         }
         
         if (bUseWiresForDigits) {
           // find the digit associated to that channel
           art::Ptr<raw::RawDigit> const& digit = WireToDigit->at(iWire);
           if (digit.isNull()) {
             throw art::Exception(art::errors::LogicError)
               << "No raw digit associated to channel #" << iChannel
               << " whence hit #" << iHit << " comes!\n";
           } // if no channel
           
           // make the association
           RawDigitAssns->addSingle(digit, CreatePtr(iHit));
         } // if create digit associations through wires
       } // for hit
       
     } // if wire associations
     
     if (RawDigitAssns && !bUseWiresForDigits) {
       // get the digit collection
       art::ValidHandle<std::vector<raw::RawDigit>> hDigits
         = event->getValidHandle<std::vector<raw::RawDigit>>(digits_label);
       
       // fill a map of wire index vs. channel number
       std::vector<size_t> DigitMap
         = util::MakeIndex(*hDigits, std::mem_fn(&raw::RawDigit::Channel));
       
       // add associations, hit by hit:
       for (size_t iHit = 0; iHit < srchits.size(); ++iHit) {
         
         // find the channel
         size_t iChannel = size_t(srchits[iHit].Channel()); // forcibly converted
         
         // find the digit associated to that channel
         size_t iDigit = std::numeric_limits<size_t>::max();
         if (iChannel < DigitMap.size()) iDigit = DigitMap[iChannel];
         if (iDigit == std::numeric_limits<size_t>::max()) {
           throw art::Exception(art::errors::LogicError)
             << "No raw digit associated to channel #" << iChannel
             << " whence hit #" << iHit << " comes!\n";
         } // if no channel
         
         // make the association
         art::Ptr<raw::RawDigit> digit(hDigits, iDigit);
         RawDigitAssns->addSingle(digit, CreatePtr(iHit));
         
       } // for hit
     } // if we have rawdigit label
     
   } // HitCollectionAssociator::put_into()

void recob::HitCollectionAssociator::prepare_associations ( )

inlineprotected

Finds out the associations for the current hits.

Definition at line 846 of file HitCreator.h.

References hits(), and prepare_associations().

Referenced by prepare_associations(), and put_into().

846 { prepare_associations(*hits); }

recob::HitCollectionAssociator::prepare_associations

void prepare_associations()

Finds out the associations for the current hits.

Definition: HitCreator.h:846

recob::HitAndAssociationsWriterBase::hits

std::unique_ptr< std::vector< recob::Hit > > hits

Collection of hits.

Definition: HitCreator.h:467

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

inline

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.

Deprecated:: Use the version with no arguments instead.

Definition at line 824 of file HitCreator.h.

References put_into().

Referenced by hit::HitFinder::produce(), hit::RFFHitFinder::produce(), cluster::ClusterCrawler::produce(), and put_into().

824 { put_into(); }

recob::HitCollectionAssociator::put_into

void put_into()

Moves the data into the event.

Definition: HitCreator.cxx:313

void recob::HitCollectionAssociator::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 313 of file HitCreator.cxx.

References prepare_associations(), and recob::HitAndAssociationsWriterBase::put_into().

                                          {
     prepare_associations();
     HitAndAssociationsWriterBase::put_into();
   } // HitCollectionAssociator::put_into()

size_t recob::HitAndAssociationsWriterBase::size ( ) const

inlineinherited

Returns the number of hits currently in the collection.

Definition at line 408 of file HitCreator.h.

References hits().

408 { return hits? hits->size(): 0; }

recob::HitAndAssociationsWriterBase::hits

std::unique_ptr< std::vector< recob::Hit > > hits

Collection of hits.

Definition: HitCreator.h:467

void recob::HitCollectionAssociator::use_hits ( std::unique_ptr< std::vector< recob::Hit >> && srchits )

Uses the specified collection as data product.

Parameters

srchits the collection to be used as data product

The very same collection is put into the event. This object will temporary own the collection until the hits are put into the event. If there were previous hits in the object, they are lost.

Definition at line 306 of file HitCreator.cxx.

References hits().

Referenced by recob::HitCollectionCreator::CreateAssociationsToLastHit(), hit::HitFinder::produce(), hit::RFFHitFinder::produce(), and cluster::ClusterCrawler::produce().

   {
     hits = std::move(srchits);
   } // HitCollectionAssociator::use_hits()

Member Data Documentation

art::InputTag recob::HitCollectionAssociator::digits_label

protected

Label of raw digits collection to associate.

Definition at line 840 of file HitCreator.h.

art::Event* recob::HitAndAssociationsWriterBase::event = nullptr

protectedinherited

Pointer to the event we are using.

Definition at line 473 of file HitCreator.h.

Referenced by recob::HitAndAssociationsWriterManager< Writer, ModuleType >::collectionWriter().

art::PtrMaker<recob::Hit> recob::HitAndAssociationsWriterBase::hitPtrMaker

protectedinherited

Tool to create hit pointers,.

Definition at line 475 of file HitCreator.h.

std::unique_ptr<std::vector<recob::Hit> > recob::HitAndAssociationsWriterBase::hits

protectedinherited

Collection of hits.

Definition at line 467 of file HitCreator.h.

Referenced by HitCollectionAssociator(), recob::HitCollectionCreator::HitCollectionCreator(), and recob::HitRefinerAssociator::HitRefinerAssociator().

std::string recob::HitAndAssociationsWriterBase::prod_instance

protectedinherited

Tame of the instance for data products.

Definition at line 464 of file HitCreator.h.

std::unique_ptr<art::Assns<raw::RawDigit, recob::Hit> > recob::HitAndAssociationsWriterBase::RawDigitAssns

protectedinherited

Associations with raw digits.

Definition at line 471 of file HitCreator.h.

Referenced by HitCollectionAssociator().

std::unique_ptr<art::Assns<recob::Wire, recob::Hit> > recob::HitAndAssociationsWriterBase::WireAssns

protectedinherited

Associations with wires.

Definition at line 469 of file HitCreator.h.

Referenced by HitCollectionAssociator().

art::InputTag recob::HitCollectionAssociator::wires_label

protected

Label of the collection of wires to associate.

Definition at line 838 of file HitCreator.h.

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

/cvmfs/larsoft.opensciencegrid.org/products/lardata/v07_01_01/source/lardata/ArtDataHelper/HitCreator.h
/cvmfs/larsoft.opensciencegrid.org/products/lardata/v07_01_01/source/lardata/ArtDataHelper/HitCreator.cxx

Public Member Functions

Static Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation