Electron counting processor. More...

#include <ElectronCounter.h>

Public Member Functions
	ElectronCounter (const std::string &name, framework::Process &process)
	Constructor.

	~ElectronCounter ()
	Destructor.

void	configure (framework::config::Parameters &parameters) override
	Configure the processor using the given user specified parameters.

void	produce (framework::Event &event) override
	Process the event and put new data products into it.

Public Member Functions inherited from framework::Producer
	Producer (const std::string &name, Process &process)
	Class constructor.

virtual void	process (Event &event) final
	Processing an event for a Producer is calling produce.

Public Member Functions inherited from framework::EventProcessor
	DECLARE_FACTORY (EventProcessor, EventProcessor *, const std::string &, Process &)
	declare that we have a factory for this class

	EventProcessor (const std::string &name, Process &process)
	Class constructor.

virtual	~EventProcessor ()=default
	Class destructor.

virtual void	beforeNewRun (ldmx::RunHeader &run_header)
	Callback for Producers to add parameters to the run header before conditions are initialized.

virtual void	onNewRun (const ldmx::RunHeader &run_header)
	Callback for the EventProcessor to take any necessary action when the run being processed changes.

virtual void	onFileOpen (EventFile &event_file)
	Callback for the EventProcessor to take any necessary action when a new event input ROOT file is opened.

virtual void	onFileClose (EventFile &event_file)
	Callback for the EventProcessor to take any necessary action when a event input ROOT file is closed.

virtual void	onProcessStart ()
	Callback for the EventProcessor to take any necessary action when the processing of events starts, such as creating histograms.

virtual void	onProcessEnd ()
	Callback for the EventProcessor to take any necessary action when the processing of events finishes, such as calculating job-summary quantities.

template<class T >
const T &	getCondition (const std::string &condition_name)
	Access a conditions object for the current event.

TDirectory *	getHistoDirectory ()
	Access/create a directory in the histogram file for this event processor to create histograms and analysis tuples.

void	setStorageHint (framework::StorageControl::Hint hint)
	Mark the current event as having the given storage control hint from this module_.

void	setStorageHint (framework::StorageControl::Hint hint, const std::string &purposeString)
	Mark the current event as having the given storage control hint from this module and the given purpose string.

int	getLogFrequency () const
	Get the current logging frequency from the process.

int	getRunNumber () const
	Get the run number from the process.

std::string	getName () const
	Get the processor name.

void	createHistograms (const std::vector< framework::config::Parameters > &histos)
	Internal function which is used to create histograms passed from the python configuration @parma histos vector of Parameters that configure histograms to create.

Private Attributes
std::string	input_coll_
	The name of the input collection used for counting electrons.

std::string	input_pass_name_
	The pass name of the input collection used for counting electrons.

std::string	output_coll_
	The name of the output collection used to save some electron counting variables.

int	n_electrons_sim_ {-1}
	The number of electrons actually simulated in the event.

int	use_sim_electron_count_ {false}
	Use the number of electrons actually simulated in the event as the electron count.

Additional Inherited Members
Protected Member Functions inherited from framework::EventProcessor
void	abortEvent ()
	Abort the event immediately.

Protected Attributes inherited from framework::EventProcessor
HistogramPool	histograms_
	helper object for making and filling histograms

NtupleManager &	ntuple_ {NtupleManager::getInstance()}
	Manager for any ntuples.

logging::logger	the_log_
	The logger for this EventProcessor.

Detailed Description

Electron counting processor.

This processor will use objects reconstructed in the trigger scintillators, or truth info on the number of electrons, and set the electron count in the event.

Definition at line 22 of file ElectronCounter.h.

Constructor & Destructor Documentation

◆ ElectronCounter()

recon::ElectronCounter::ElectronCounter	(	const std::string &	name,
		framework::Process &	process )

Constructor.

Parameters

name	Name for this instance of the class.
process	The Process class associated with EventProcessor, provided by the framework.

Definition at line 5 of file ElectronCounter.cxx.

7 : framework::Producer(name, process) {}

framework::Producer

Base class for a module which produces a data product.

Definition EventProcessor.h:257

framework::Producer::process

virtual void process(Event &event) final

Processing an event for a Producer is calling produce.

Definition EventProcessor.h:278

◆ ~ElectronCounter()

recon::ElectronCounter::~ElectronCounter ( )

Destructor.

Definition at line 9 of file ElectronCounter.cxx.

9{}

Member Function Documentation

◆ configure()

void recon::ElectronCounter::configure ( framework::config::Parameters & parameters )

overridevirtual

Configure the processor using the given user specified parameters.

The user specified parameters that are availabed are defined in the python configuration class. Look at the my_processor.py module of the EventProc python for the python structure.

Parameters

parameters Set of parameters used to configure this processor.

Reimplemented from framework::EventProcessor.

Definition at line 11 of file ElectronCounter.cxx.

                                                                     {
  input_coll_ = parameters.get<std::string>("input_collection");
  input_pass_name_ = parameters.get<std::string>("input_pass_name");
  output_coll_ = parameters.get<std::string>("output_collection");
  n_electrons_sim_ = parameters.get<int>("simulated_electron_number");
  use_sim_electron_count_ =
      parameters.get<bool>("use_simulated_electron_number");
 
  /*  // can rehash this for cluster vs track counting
  if (mode_ == 0) {
    algo_name_ = "LayerSumTrig";
  } else if (mode_ == 1) {
    algo_name_ = "CenterTower";
  }
  */
  ldmx_log(debug) << "ElectronCounter is using parameters: "
                  << " \n\tinput_collection = " << input_coll_
                  << " \n\tinput_pass_name = " << input_pass_name_
                  << " \n\toutput_collection = " << output_coll_
                  << " \n\tsimulated_electron_number = " << n_electrons_sim_
                  << " \n\tuse_simulated_electron_number = "
                  << use_sim_electron_count_;
}

References framework::config::Parameters::get(), input_coll_, input_pass_name_, n_electrons_sim_, output_coll_, and use_sim_electron_count_.

◆ produce()

void recon::ElectronCounter::produce ( framework::Event & event )

overridevirtual

Process the event and put new data products into it.

Parameters

event The event to process.

Implements framework::Producer.

Definition at line 35 of file ElectronCounter.cxx.

                                                   {
  int n_electrons = -1;
 
  if (use_sim_electron_count_) {
    if (n_electrons_sim_ < 0) {
      ldmx_log(fatal)
          << "Can't use unset number of simulated electrons as electron count! "
             "Set with 'simulated_electron_number' ";
      return;
    }
    // then we just set it equal to simulated number and we're done
    n_electrons = n_electrons_sim_;
  }
  // Check if the collection of trig scint tracks exist.  If not,
  // don't bother processing the event.
  else {
    if (!event.exists(input_coll_, input_pass_name_)) {
      ldmx_log(fatal) << "Attemping to use non-existing input collection "
                      << input_coll_ << "_" << input_pass_name_
                      << " to count electrons! Exiting.";
      return;
    }
    // TODO, if cluster counting is needed: have two functions, one with tracks,
    // one with clusters, and just call one or the other.
 
    // Get the collection of TS tracks
    const std::vector<ldmx::TrigScintTrack> tracks =
        event.getCollection<ldmx::TrigScintTrack>(input_coll_,
                                                  input_pass_name_);
 
    n_electrons = tracks.size();
    ldmx_log(info) << "Found " << tracks.size()
                   << " electrons (tracks) using input collection "
                   << input_coll_ << "_" << input_pass_name_;
  }
  // add number of electrons to event header. allow for it to be unset (-1)
  event.getEventHeader().setIntParameter("nElectrons", n_electrons);
  event.setElectronCount(n_electrons);
}

References framework::Event::exists(), input_coll_, input_pass_name_, n_electrons_sim_, and use_sim_electron_count_.

Member Data Documentation

◆ input_coll_

std::string recon::ElectronCounter::input_coll_

private

The name of the input collection used for counting electrons.

Definition at line 58 of file ElectronCounter.h.

Referenced by configure(), and produce().

◆ input_pass_name_

std::string recon::ElectronCounter::input_pass_name_

private

The pass name of the input collection used for counting electrons.

Definition at line 63 of file ElectronCounter.h.

Referenced by configure(), and produce().

◆ n_electrons_sim_

int recon::ElectronCounter::n_electrons_sim_ {-1}

private

The number of electrons actually simulated in the event.

Definition at line 74 of file ElectronCounter.h.

74{-1};

Referenced by configure(), and produce().

◆ output_coll_

std::string recon::ElectronCounter::output_coll_

private

The name of the output collection used to save some electron counting variables.

Definition at line 69 of file ElectronCounter.h.

Referenced by configure().

◆ use_sim_electron_count_

int recon::ElectronCounter::use_sim_electron_count_ {false}

private

Use the number of electrons actually simulated in the event as the electron count.

Definition at line 80 of file ElectronCounter.h.

80{false};

Referenced by configure(), and produce().

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

Recon/include/Recon/ElectronCounter.h
Recon/src/Recon/ElectronCounter.cxx

Public Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ElectronCounter()

◆ ~ElectronCounter()

Member Function Documentation

◆ configure()

◆ produce()

Member Data Documentation

◆ input_coll_

◆ input_pass_name_

◆ n_electrons_sim_

◆ output_coll_

◆ use_sim_electron_count_