Performs digitization of simulated Trigger Scintillator data. More...

#include <TrigScintDigiProducer.h>

Public Types
typedef int	layer

typedef std::pair< double, double >	zboundaries

Public Member Functions
	TrigScintDigiProducer (const std::string &name, framework::Process &process)

void	configure (framework::config::Parameters &parameters) override
	Callback for the processor to configure itself from the given set of parameters.

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

ldmx::TrigScintID	generateRandomID (int module)

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

virtual void	beforeNewRun (ldmx::RunHeader &header)
	Handle allowing producers to modify run headers before the run begins.

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

virtual	~EventProcessor ()
	Class destructor.

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

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

virtual void	onFileClose (EventFile &eventFile)
	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::unique_ptr< TRandom3 >	random_ {nullptr}
	Random number generator.

std::unique_ptr< ldmx::NoiseGenerator >	noiseGenerator_ {nullptr}
	Generate noise hits given the number of channels and mean noise.

bool	verbose_ {false}
	Class to set the verbosity level.

std::string	inputCollection_
	Name of the input collection containing the sim hits.

std::string	inputPassName_
	Name of the pass that the input collection is on (empty string means take any pass)

std::string	outputCollection_
	Name of the output collection that will be used to stored the digitized trigger scintillator hits.

int	stripsPerArray_ {50}
	Number of strips per array.

int	numberOfArrays_ {3}
	Number of arrays.

double	meanNoise_ {0}
	Mean readout noise.

double	mevPerMip_ {1.40}
	Total MeV per MIP.

double	pePerMip_ {13.5}
	Total number of photoelectrons per MIP.

Additional Inherited Members
Static Public Member Functions inherited from framework::EventProcessor
static void	declare (const std::string &classname, int classtype, EventProcessorMaker *)
	Internal function which is part of the PluginFactory machinery.

Static Public Attributes inherited from framework::Producer
static const int	CLASSTYPE {1}
	Constant used to track EventProcessor types by the PluginFactory.

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

Protected Attributes inherited from framework::EventProcessor
HistogramHelper	histograms_
	Interface class for making and filling histograms.

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

logging::logger	theLog_
	The logger for this EventProcessor.

Detailed Description

Performs digitization of simulated Trigger Scintillator data.

Definition at line 41 of file TrigScintDigiProducer.h.

Member Typedef Documentation

◆ layer

typedef int trigscint::TrigScintDigiProducer::layer

Definition at line 43 of file TrigScintDigiProducer.h.

◆ zboundaries

typedef std::pair<double, double> trigscint::TrigScintDigiProducer::zboundaries

Definition at line 45 of file TrigScintDigiProducer.h.

Constructor & Destructor Documentation

◆ TrigScintDigiProducer()

trigscint::TrigScintDigiProducer::TrigScintDigiProducer	(	const std::string &	name,
		framework::Process &	process
	)

Definition at line 10 of file TrigScintDigiProducer.cxx.

12 : Producer(name, process) {}

framework::Producer::Producer

Producer(const std::string &name, Process &process)

Class constructor.

Definition EventProcessor.cxx:68

Member Function Documentation

◆ configure()

void trigscint::TrigScintDigiProducer::configure ( framework::config::Parameters & parameters )

overridevirtual

Callback for the processor to configure itself from the given set of parameters.

Parameters

parameters ParameterSet for configuration.

Reimplemented from framework::EventProcessor.

Definition at line 14 of file TrigScintDigiProducer.cxx.

                                           {
  // Configure this instance of the producer
  stripsPerArray_ = parameters.getParameter<int>("number_of_strips");
  numberOfArrays_ = parameters.getParameter<int>("number_of_arrays");
  meanNoise_ = parameters.getParameter<double>("mean_noise");
  mevPerMip_ = parameters.getParameter<double>("mev_per_mip");
  pePerMip_ = parameters.getParameter<double>("pe_per_mip");
  inputCollection_ = parameters.getParameter<std::string>("input_collection");
  inputPassName_ = parameters.getParameter<std::string>("input_pass_name");
  outputCollection_ = parameters.getParameter<std::string>("output_collection");
  verbose_ = parameters.getParameter<bool>("verbose");
 
  random_ =
      std::make_unique<TRandom3>(parameters.getParameter<int>("randomSeed"));
 
  noiseGenerator_ = std::make_unique<ldmx::NoiseGenerator>(meanNoise_, false);
  noiseGenerator_->setNoiseThreshold(1);
}

References framework::config::Parameters::getParameter().

◆ generateRandomID()

ldmx::TrigScintID trigscint::TrigScintDigiProducer::generateRandomID ( int module )

Definition at line 34 of file TrigScintDigiProducer.cxx.

                                                                  {
  ldmx::TrigScintID tempID(module, random_->Integer(stripsPerArray_));
  if (module >= TrigScintSection::NUM_SECTIONS) {
    // Throw an exception
    std::cout << "WARNING [TrigScintDigiProducer::generateRandomID]: "
                 "TrigScintSection is not known"
              << std::endl;
  }
 
  return tempID;
}

◆ produce()

void trigscint::TrigScintDigiProducer::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 46 of file TrigScintDigiProducer.cxx.

                                                         {
  // Need to handle seeding on the first event
  if (!noiseGenerator_->hasSeed()) {
    const auto &rseed = getCondition<framework::RandomNumberSeedService>(
        framework::RandomNumberSeedService::CONDITIONS_OBJECT_NAME);
    noiseGenerator_->seedGenerator(
        rseed.getSeed("TrigScintDigiProducer::NoiseGenerator"));
  }
 
  std::map<ldmx::TrigScintID, int> cellPEs;
  std::map<ldmx::TrigScintID, int> cellMinPEs;
  std::map<ldmx::TrigScintID, float> Xpos, Ypos, Zpos, Edep, Time, beamFrac;
  std::set<ldmx::TrigScintID> noiseHitIDs;
 
  auto numRecHits{0};
 
  // looper over sim hits and aggregate energy depositions for each detID
  const auto simHits{event.getCollection<ldmx::SimCalorimeterHit>(
      inputCollection_, inputPassName_)};
  auto particleMap{event.getMap<int, ldmx::SimParticle>("SimParticles")};
 
  int module{-1};
  for (const auto &simHit : simHits) {
    ldmx::TrigScintID id(simHit.getID());
 
    // Just set the module ID to use for noise hits here.  Given that
    // we are currently processing a single module at a time, setting
    // it within the loop shouldn't matter.
    module = id.module();
    std::vector<float> position = simHit.getPosition();
 
    if (verbose_) {
      std::cout << id << std::endl;
    }
 
    // check if hits is from beam electron and, if so, add to beamFrac
    for (int i = 0; i < simHit.getNumberOfContribs(); i++) {
      auto contrib = simHit.getContrib(i);
      if (verbose_) {
        std::cout << "contrib " << i << " trackID: " << contrib.trackID
                  << " pdgID: " << contrib.pdgCode << " edep: " << contrib.edep
                  << std::endl;
        std::cout << "\t particle id: "
                  << particleMap[contrib.trackID].getPdgID()
                  << " particle status: "
                  << particleMap[contrib.trackID].getGenStatus() << std::endl;
      }
      if (particleMap[contrib.trackID].getPdgID() == 11 &&
          particleMap[contrib.trackID].getGenStatus() == 1) {
        if (beamFrac.find(id) == beamFrac.end())
          beamFrac[id] = contrib.edep;
        else
          beamFrac[id] += contrib.edep;
      }
    }
 
    // for now, we take am energy weighted average of the hit in each stip to
    // simulate the hit position. AJW: these should be dropped, they are likely
    // to lead to a problem since we can't measure them anyway except roughly y
    // and z, which is encoded in the ids.
    if (Edep.find(id) == Edep.end()) {
      // first hit, initialize
      Edep[id] = simHit.getEdep();
      Time[id] = simHit.getTime() * simHit.getEdep();
      Xpos[id] = position[0] * simHit.getEdep();
      Ypos[id] = position[1] * simHit.getEdep();
      Zpos[id] = position[2] * simHit.getEdep();
      numRecHits++;
 
    } else {
      // not first hit, aggregate, and store the largest radius hit
      Xpos[id] += position[0] * simHit.getEdep();
      Ypos[id] += position[1] * simHit.getEdep();
      Zpos[id] += position[2] * simHit.getEdep();
      Edep[id] += simHit.getEdep();
      // AJW: need to figure out a better way to model this...
      Time[id] += simHit.getTime() * simHit.getEdep();
    }
  }
 
  // Create the container to hold the digitized trigger scintillator hits.
  std::vector<ldmx::TrigScintHit> trigScintHits;
 
  // loop over detIDs and simulate number of PEs
  for (std::map<ldmx::TrigScintID, float>::iterator it = Edep.begin();
       it != Edep.end(); ++it) {
    ldmx::TrigScintID id(it->first);
 
    double depEnergy = Edep[id];
    Time[id] = Time[id] / Edep[id];
    Xpos[id] = Xpos[id] / Edep[id];
    Ypos[id] = Ypos[id] / Edep[id];
    Zpos[id] = Zpos[id] / Edep[id];
    double meanPE = depEnergy / mevPerMip_ * pePerMip_;
    cellPEs[id] = random_->Poisson(meanPE + meanNoise_);
 
    // If a cell has a PE count above threshold, persit the hit.
    if (cellPEs[id] >= 1) {
      ldmx::TrigScintHit hit;
      hit.setID(id.raw());
      hit.setPE(cellPEs[id]);
      hit.setMinPE(cellMinPEs[id]);
      hit.setAmplitude(cellPEs[id]);
      hit.setEnergy(depEnergy);
      hit.setTime(Time[id]);
      hit.setXPos(Xpos[id]);
      hit.setYPos(Ypos[id]);
      hit.setZPos(Zpos[id]);
      hit.setModuleID(module);
      hit.setBarID(id.bar());  // getFieldValue("bar"));
      hit.setNoise(false);
      hit.setBeamEfrac(beamFrac[id] / depEnergy);
 
      trigScintHits.push_back(hit);
    }
 
    if (verbose_) {
      std::cout << id << std::endl;
      std::cout << "Edep: " << Edep[id] << std::endl;
      std::cout << "numPEs: " << cellPEs[id] << std::endl;
      std::cout << "time: " << Time[id] << std::endl;
      std::cout << "z: " << Zpos[id] << std::endl;
      std::cout << "\t X: " << Xpos[id] << "\t Y: " << Ypos[id]
                << "\t Z: " << Zpos[id] << std::endl;
    }  // end verbose
  }
 
  // ------------------------------- Noise simulation -----------------------//
  // ------------------------------------------------------------------------//
  // only simulating for single array until
  // all arrays are merged into one collection
  int numEmptyCells = stripsPerArray_ - numRecHits;
  std::vector<double> noiseHits_PE =
      noiseGenerator_->generateNoiseHits(numEmptyCells);
 
  ldmx::TrigScintID tempID;
 
  for (auto &noiseHitPE : noiseHits_PE) {
    ldmx::TrigScintHit hit;
    // generate random ID from remaining cells
    do {
      tempID = generateRandomID(module);
    } while (Edep.find(tempID) != Edep.end() ||
             noiseHitIDs.find(tempID) != noiseHitIDs.end());
 
    ldmx::TrigScintID noiseID = tempID;
 
    noiseHitIDs.insert(noiseID);
    hit.setID(noiseID.raw());
    hit.setPE(noiseHitPE);
    hit.setMinPE(noiseHitPE);
    hit.setAmplitude(noiseHitPE);
    hit.setEnergy(0.);
    hit.setTime(0.);
    hit.setXPos(0.);
    hit.setYPos(0.);
    hit.setZPos(0.);
    hit.setModuleID(module);
    hit.setBarID(noiseID.bar());
    hit.setNoise(true);
    hit.setBeamEfrac(0.);
 
    trigScintHits.push_back(hit);
  }
  // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  // - -
 
  event.add(outputCollection_, trigScintHits);
}

Member Data Documentation

◆ inputCollection_

std::string trigscint::TrigScintDigiProducer::inputCollection_

private

Name of the input collection containing the sim hits.

Definition at line 75 of file TrigScintDigiProducer.h.

◆ inputPassName_

std::string trigscint::TrigScintDigiProducer::inputPassName_

private

Name of the pass that the input collection is on (empty string means take any pass)

Definition at line 79 of file TrigScintDigiProducer.h.

◆ meanNoise_

double trigscint::TrigScintDigiProducer::meanNoise_ {0}

private

Mean readout noise.

Definition at line 92 of file TrigScintDigiProducer.h.

92{0};

◆ mevPerMip_

double trigscint::TrigScintDigiProducer::mevPerMip_ {1.40}

private

Total MeV per MIP.

Definition at line 95 of file TrigScintDigiProducer.h.

95{1.40};

◆ noiseGenerator_

std::unique_ptr<ldmx::NoiseGenerator> trigscint::TrigScintDigiProducer::noiseGenerator_ {nullptr}

private

Generate noise hits given the number of channels and mean noise.

Definition at line 68 of file TrigScintDigiProducer.h.

68{nullptr};

◆ numberOfArrays_

int trigscint::TrigScintDigiProducer::numberOfArrays_ {3}

private

Number of arrays.

Definition at line 89 of file TrigScintDigiProducer.h.

89{3};

◆ outputCollection_

std::string trigscint::TrigScintDigiProducer::outputCollection_

private

Name of the output collection that will be used to stored the digitized trigger scintillator hits.

Definition at line 83 of file TrigScintDigiProducer.h.

◆ pePerMip_

double trigscint::TrigScintDigiProducer::pePerMip_ {13.5}

private

Total number of photoelectrons per MIP.

Definition at line 98 of file TrigScintDigiProducer.h.

98{13.5};

◆ random_

std::unique_ptr<TRandom3> trigscint::TrigScintDigiProducer::random_ {nullptr}

private

Random number generator.

Definition at line 65 of file TrigScintDigiProducer.h.

65{nullptr};

◆ stripsPerArray_

int trigscint::TrigScintDigiProducer::stripsPerArray_ {50}

private

Number of strips per array.

Definition at line 86 of file TrigScintDigiProducer.h.

86{50};

◆ verbose_

bool trigscint::TrigScintDigiProducer::verbose_ {false}

private

Class to set the verbosity level.

Definition at line 72 of file TrigScintDigiProducer.h.

72{false};

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

TrigScint/include/TrigScint/TrigScintDigiProducer.h
TrigScint/src/TrigScint/TrigScintDigiProducer.cxx

Public Types

Public Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ layer

◆ zboundaries

Constructor & Destructor Documentation

◆ TrigScintDigiProducer()

Member Function Documentation

◆ configure()

◆ generateRandomID()

◆ produce()

Member Data Documentation

◆ inputCollection_

◆ inputPassName_

◆ meanNoise_

◆ mevPerMip_

◆ noiseGenerator_

◆ numberOfArrays_

◆ outputCollection_

◆ pePerMip_

◆ random_

◆ stripsPerArray_

◆ verbose_