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.

virtual void	onNewRun (const ldmx::RunHeader &runHeader) override
	Random number generation.

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	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::mt19937	rng_
	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 37 of file TrigScintDigiProducer.h.

Member Typedef Documentation

◆ layer

int trigscint::TrigScintDigiProducer::layer

Definition at line 39 of file TrigScintDigiProducer.h.

◆ zboundaries

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

Definition at line 41 of file TrigScintDigiProducer.h.

Constructor & Destructor Documentation

◆ TrigScintDigiProducer()

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

Definition at line 5 of file TrigScintDigiProducer.cxx.

7 : 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 9 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");
}

◆ generateRandomID()

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

Definition at line 36 of file TrigScintDigiProducer.cxx.

                                                                  {
  // Uniform distributions for integer generation
  std::uniform_int_distribution<int> strips_dist(0, stripsPerArray_ - 1);
  ldmx::TrigScintID tempID(module, strips_dist(rng_));
  if (module >= TrigScintSection::NUM_SECTIONS) {
    ldmx_log(fatal) << "TrigScintSection is not known";
  }
 
  return tempID;
}

◆ onNewRun()

void trigscint::TrigScintDigiProducer::onNewRun ( const ldmx::RunHeader & runHeader )

overridevirtual

Random number generation.

Reimplemented from framework::EventProcessor.

Definition at line 23 of file TrigScintDigiProducer.cxx.

                                                          {
  noiseGenerator_ = std::make_unique<ldmx::NoiseGenerator>(meanNoise_, false);
  noiseGenerator_->setNoiseThreshold(1);
  // Set up seeds
  const auto &rseed = getCondition<framework::RandomNumberSeedService>(
      framework::RandomNumberSeedService::CONDITIONS_OBJECT_NAME);
 
  noiseGenerator_->seedGenerator(
      rseed.getSeed("TrigScintDigiProducer::NoiseGenerator"));
  // Random number generator for module id
  rng_.seed(rseed.getSeed("TrigScintDigiProducer"));
}

References framework::RandomNumberSeedService::CONDITIONS_OBJECT_NAME.

◆ 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 47 of file TrigScintDigiProducer.cxx.

                                                         {
  std::map<ldmx::TrigScintID, int> cellPEs, 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 an energy weighted average of the hit in each strip 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_;
    std::poisson_distribution<int> poisson_dist(meanPE + meanNoise_);
    cellPEs[id] = poisson_dist(rng_);
 
    // If a cell has a PE count above threshold, persit the hit.
    // Thresholds are introduced (and configurable) in clustering.
    // the cell PE >=1 suppresses artifical noise that is below one light
    // quantum in the SiPM and unphysical.
    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);
}

References ldmx::TrigScintID::bar(), ldmx::DetectorID::raw(), ldmx::CalorimeterHit::setAmplitude(), ldmx::TrigScintHit::setBarID(), ldmx::TrigScintHit::setBeamEfrac(), ldmx::CalorimeterHit::setEnergy(), ldmx::CalorimeterHit::setID(), ldmx::HcalHit::setMinPE(), ldmx::TrigScintHit::setModuleID(), ldmx::CalorimeterHit::setNoise(), ldmx::TrigScintHit::setPE(), ldmx::CalorimeterHit::setTime(), ldmx::CalorimeterHit::setXPos(), ldmx::CalorimeterHit::setYPos(), and ldmx::CalorimeterHit::setZPos().

Member Data Documentation

◆ inputCollection_

std::string trigscint::TrigScintDigiProducer::inputCollection_

private

Name of the input collection containing the sim hits.

Definition at line 76 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 80 of file TrigScintDigiProducer.h.

◆ meanNoise_

double trigscint::TrigScintDigiProducer::meanNoise_ {0}

private

Mean readout noise.

Definition at line 93 of file TrigScintDigiProducer.h.

93{0};

◆ mevPerMip_

double trigscint::TrigScintDigiProducer::mevPerMip_ {1.40}

private

Total MeV per MIP.

Definition at line 96 of file TrigScintDigiProducer.h.

96{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 69 of file TrigScintDigiProducer.h.

69{nullptr};

◆ numberOfArrays_

int trigscint::TrigScintDigiProducer::numberOfArrays_ {3}

private

Number of arrays.

Definition at line 90 of file TrigScintDigiProducer.h.

90{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 84 of file TrigScintDigiProducer.h.

◆ pePerMip_

double trigscint::TrigScintDigiProducer::pePerMip_ {13.5}

private

Total number of photoelectrons per MIP.

Definition at line 99 of file TrigScintDigiProducer.h.

99{13.5};

◆ rng_

std::mt19937 trigscint::TrigScintDigiProducer::rng_

private

Random number generator.

Definition at line 66 of file TrigScintDigiProducer.h.

◆ stripsPerArray_

int trigscint::TrigScintDigiProducer::stripsPerArray_ {50}

private

Number of strips per array.

Definition at line 87 of file TrigScintDigiProducer.h.

87{50};

◆ verbose_

bool trigscint::TrigScintDigiProducer::verbose_ {false}

private

Class to set the verbosity level.

Definition at line 73 of file TrigScintDigiProducer.h.

73{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()

◆ onNewRun()

◆ produce()

Member Data Documentation

◆ inputCollection_

◆ inputPassName_

◆ meanNoise_

◆ mevPerMip_

◆ noiseGenerator_

◆ numberOfArrays_

◆ outputCollection_

◆ pePerMip_

◆ rng_

◆ stripsPerArray_

◆ verbose_