A helper to centralise creation of a hit collection data product. More...

#include <HitCreator.h>

Public Types
using	Writer_t = Writer
	Type of managed hit collection writer. More...

Public Member Functions
	HitAndAssociationsWriterManager ()=default
	Constructor: does not declare anything. More...

	HitAndAssociationsWriterManager (art::ProducesCollector &collector, std::string instanceName="", bool doWireAssns=true, bool doRawDigitAssns=true)
	Declares the hit products we are going to fill. More...

void	declareProducts (art::ProducesCollector &collector, std::string instanceName="", bool doWireAssns=true, bool doRawDigitAssns=true)
	Declares the hit products we are going to fill. More...

Writer_t	collectionWriter (art::Event &event) const
	Returns a new writer already configured. More...

std::string	instanceName () const
	Returns the configured product instance name. More...

bool	ready () const noexcept
	Returns whether the class is fully configured. More...

Protected Attributes
art::ProducesCollector *	collector_p = nullptr
	Collector this manager is bound to. More...

std::string	prodInstance
	Tame of the instance for data products. More...

bool	hasRawDigitAssns = true
	Whether we produce hit-digit associations. More...

bool	hasWireAssns = true
	Whether we produce hit-wire associations. More...

Detailed Description

template<typename Writer>
class recob::HitAndAssociationsWriterManager< Writer >

A helper to centralise creation of a hit collection data product.

Template Parameters

Writer	writer class to manage
ModuleType	owning module: `art::EDProducer` or `art::EDFilter`

This class adds an indirection layer to the model relying on HitAndAssociationsWriter. In that one, two different steps are required, one in the constructor of the module, where data products are declared, and one in the place where hits are actually assembled. These two steps need consistent setup, but they are separate and formally independent. The "manager" approach consists of an object performing the first step directly, and delivering an already configured object for the second step.

An example of usage in a module:

class MyHitProducer: public art::EDProducer {
  recob::HitAndAssociationsWriterManager<recob::HitCollectionCreator>
    hitCollCreator;
    public:
  MyHitProducer(fhicl::ParameterSet const& pset)
    : EDProducer{pset}
    , hitCollCreator(*this, pset.get<std::string>("instanceName", ""))
    {}
  void produce(art::Event& event)
    {
      auto hitCollWriter = hitCollCreator.collectionWriter(event);
      for (recob::Wire const& wire: Wires) {
        // create hits...
          hitCollWriter.emplace_back(hit, wire, digit);
      }
      hitCollWriter.put_into();
    }
}; // class MyHitProducer

Definition at line 977 of file HitCreator.h.

Member Typedef Documentation

template<typename Writer>

using recob::HitAndAssociationsWriterManager< Writer >::Writer_t = Writer

Type of managed hit collection writer.

Definition at line 980 of file HitCreator.h.

Constructor & Destructor Documentation

template<typename Writer>

recob::HitAndAssociationsWriterManager< Writer >::HitAndAssociationsWriterManager ( )

default

Constructor: does not declare anything.

This constructor does not declare products. Calling declare_products() explicitly is then required in the module constructor.

template<typename Writer >

recob::HitAndAssociationsWriterManager< Writer >::HitAndAssociationsWriterManager	(	art::ProducesCollector &	collector,
		std::string	instanceName = `""`,
		bool	doWireAssns = `true`,
		bool	doRawDigitAssns = `true`
	)

Declares the hit products we are going to fill.

Parameters

collector	the module this manager is bound to
instanceName	name of the instance for all data products
doWireAssns	whether to enable associations to wires
doRawDigitAssns	whether to enable associations to raw digits

This constructor calls declareProducts().

Definition at line 1069 of file HitCreator.h.

 {
   declareProducts
     (collector, instanceName, doWireAssns, doRawDigitAssns);
 } // recob::HitAndAssociationsWriterManager::HitAndAssociationsWriterManager()

Member Function Documentation

template<typename Writer >

recob::HitAndAssociationsWriterManager< Writer >::Writer_t recob::HitAndAssociationsWriterManager< Writer >::collectionWriter ( art::Event & event ) const

Returns a new writer already configured.

Definition at line 1106 of file HitCreator.h.

 {
   if (!collector_p) {
     // this means you forgot to code a call to declaredProducts()
     // or used the wrong constructor:
     throw art::Exception(art::errors::LogicError)
       << "HitAndAssociationsWriter<>::collectionWriter() called"
       " before products are declared.";
   }
   return
     { event, prodInstance, hasWireAssns, hasRawDigitAssns };
 } // recob::HitAndAssociationsWriterManager::collectionWriter()

template<typename Writer >

void recob::HitAndAssociationsWriterManager< Writer >::declareProducts	(	art::ProducesCollector &	collector,
		std::string	instanceName = `""`,
		bool	doWireAssns = `true`,
		bool	doRawDigitAssns = `true`
	)

Declares the hit products we are going to fill.

Parameters

collector	the module this manager is bound to
instanceName	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 made 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 1082 of file HitCreator.h.

 {
   if (collector_p) {
     // this means you already called to declaredProducts()
     // or used the wrong constructor (which did that for you):
     throw art::Exception(art::errors::LogicError)
       << "HitAndAssociationsWriter<> has already declared its products.";
   }
   collector_p = &collector;
   prodInstance = instanceName;
   hasWireAssns = doWireAssns;
   hasRawDigitAssns = doRawDigitAssns;
   HitAndAssociationsWriterBase::declare_products
     (collector, prodInstance, hasWireAssns, hasRawDigitAssns);
 } // recob::HitAndAssociationsWriterManager::declareProducts()