Organizes digis into TrigScintHits, based on linearized full event readout from test beam/test stand. More...

#include <TestBeamHitProducer.h>

Public Member Functions
	TestBeamHitProducer (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.

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_col_
	Set the local verbosity level.

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

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

std::vector< double >	gain_
	SiPM gain, per channel (all initialized to 2e6 in default config)

std::vector< double >	peds_
	channel pedestals [fC]

std::vector< double >	mip_response_
	channel MIP response for intercalibration

int	start_sample_ {10}
	start sample for pulse integration (not including any fiber offsets)

int	pulse_width_ {5}
	Total number of samples used in pulse integration.

int	pulse_width_lyso_ {8}
	Total number of samples used in pulse integration for LYSO (long decay, might need wider window)

int	n_instrumented_channels_ {12}
	Number of instrumented channels in module.

bool	do_clean_hits_ {false}
	boolean indicating whether we want to apply quality criteria in hit reconstruction

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

Organizes digis into TrigScintHits, based on linearized full event readout from test beam/test stand.

Definition at line 31 of file TestBeamHitProducer.h.

Constructor & Destructor Documentation

◆ TestBeamHitProducer()

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

Definition at line 12 of file TestBeamHitProducer.cxx.

14 : Producer(name, process) {}

framework::Producer::Producer

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

Class constructor.

Definition EventProcessor.cxx:54

framework::Producer::process

virtual void process(Event &event) final

Processing an event for a Producer is calling produce.

Definition EventProcessor.h:278

Member Function Documentation

◆ configure()

void trigscint::TestBeamHitProducer::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 16 of file TestBeamHitProducer.cxx.

                                                                         {
  input_col_ = parameters.get<std::string>("inputCollection");
  output_collection_ = parameters.get<std::string>("outputCollection");
  input_pass_name_ = parameters.get<std::string>("inputPassName");
  mip_response_ = parameters.get<std::vector<double> >("MIPresponse");
  peds_ = parameters.get<std::vector<double> >("pedestals");
  gain_ = parameters.get<std::vector<double> >("gain");
 
  start_sample_ = parameters.get<int>("startSample");
  pulse_width_ = parameters.get<int>("pulseWidth");
  pulse_width_lyso_ = parameters.get<int>("pulseWidthLYSO");
  n_instrumented_channels_ = parameters.get<int>("nInstrumentedChannels");
  do_clean_hits_ = parameters.get<bool>("doCleanHits");
 
  std::cout << " [ TestBeamHitProducer ] In configure(), got parameters "
            << "\n\t inputCollection = " << input_col_
            << "\n\t inputPassName = " << input_pass_name_
            << "\n\t outputCollection = " << output_collection_
            << "\n\t startSample = " << start_sample_
            << "\n\t pulseWidth = " << pulse_width_
            << "\n\t pulseWidthLYSO = " << pulse_width_lyso_
            << "\n\t gain[0] = " << gain_[0]
            << "\n\t nInstrumentedChannels = " << n_instrumented_channels_
            << "\n\t doCleanHits = " << do_clean_hits_
            << "\n\t pedestals[0] = " << peds_[0]
            << "\n\t MIPresponse[0] = " << mip_response_[0] << "\t."
            << std::endl;
 
  return;
}

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

◆ produce()

void trigscint::TestBeamHitProducer::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 TestBeamHitProducer.cxx.

                                                       {
  /*
    hit producer.
    sum up all charge within a certain time window. could work two ways:
        - find a time sample above a threshold or where TDC is 0-50 (0-2)
                 * this could allow for finding several pulses per event, just
    keep sliding along in time
                     -- in that case, record nPulses, startsample, pulsewidth
    for each hit
            - use a fixed start sample, and keep summing from there until
    nSamples is reached or all time samples used
 
    specifics:
            - each channel has its own pedestal to subtract. also try using the
    first 5 samples to establish a threshold in the event. store both
            - store hit Q and hit PE conversion
            - for now use the same reconstruction paradigm for LYSO and plastic.
    two notes though
              1. LYSO pulse looks wider, and might need wider window. plastic is
    fine with 5. start by 8 for LYSO (even if for large pulses, sometimes 10
    seem to be needed). could probe this by correlating plastic and LYSO, and
    checking if at some amplitude (in plastic), we start cutting off charge in
    LYSO
                  2. there is a time offset between fibers. need to have a
    parameter fiber2offset to use for elecID >= 8
                  -- added this as a variable in EventReadout, along with fiber
    number. so this class doesn't need any detailed knowledge
 
    variables to write out:
        - start sample
            - pulse width
            - n samples above threshold
            - nPulses
            - early pedestal (from first 5)
            - assumed/average channel pedestal
            - total Q
            - ped subtracted total Q
            - PE value
            - max amplitude in pulse
            - store material assumption? isLYSO?
   */
 
  float mev_per_mip = 0.3;
  float pe_per_mip = 100;
 
  const auto channels{event.getCollection<trigscint::EventReadout>(
      input_col_, input_pass_name_)};
 
  int ev_nb = event.getEventNumber();
  std::vector<trigscint::TestBeamHit> hits;
  for (auto chan : channels) {
    trigscint::TestBeamHit hit;
    int bar = chan.getChanID();
    // don't run hit reconstruction on junk signal
    if (bar >= n_instrumented_channels_) continue;
    int width = pulse_width_;
    if (bar % 2 == 0) {           // LYSO channel: allow for wider pulses
      width = pulse_width_lyso_;  // avoid hardwiring
    }
    hit.setPulseWidth(width);
    hit.setStartSample(start_sample_);
    float ped = peds_.at(bar);  // chan.getPedestal() ;
    float early_ped = chan.getEarlyPedestal();
    hit.setPedestal(ped);
    hit.setEarlyPedestal(early_ped);
    int is_clean = 0;             // false;
    float threshold = fabs(ped);  // 2*fabs(peds_[ bar ]); // or sth
    if (do_clean_hits_) threshold = 7 * fabs(ped);  // stricter cut
 
    int start_t = start_sample_ + chan.getTimeOffset();
    float max_q = -999.;
    int n_samp_above_ped = 0;
    int n_samp_above_thr = 0;
    float tot_subtr_q = 0;
    std::vector<float> q = chan.getQ();
    // go to the start sample defined for this channel.
    for (int i_t = start_t; i_t < q.size(); i_t++) {
      ldmx_log(debug) << "in event " << ev_nb << "; channel " << bar
                      << ", got charge[" << i_t << "] = " << q.at(i_t);
      // for the defined number of samples, subtract pedestal. if > 0, increment
      // sample counter.
      float sub_q = q.at(i_t) -
                    ped;  // this might be addition, if ped is negative. should
                          // see this as channel dependence in nSampAbove
      // once beyond nSamples, want to see how long positive threshold
      // subtracted tail is --> increment sample counter in any case.
      if (sub_q > 0) n_samp_above_ped++;
      if (sub_q > threshold) n_samp_above_thr++;
      if (i_t - start_t < width) {  // we're in the pulse integration window
        if (sub_q > max_q)  // keep track of max Q. this is the pulse amplitude
          max_q = sub_q;    // q.at(iT);
        if (sub_q > 0)
          tot_subtr_q +=
              sub_q;  // add positive subtracted Q to total pulse charge.
      } else if (sub_q < 0 ||
                 q.at(i_t) < 0)  // if after the full pulse width, subQ <
                                 // pedestal, break. special case to break at
                                 // q=0 for cases where ped < 0
        break;
      // done
    }  // over time samples
 
    // first check that hit passes any quality cuts
    uint flag = chan.getQualityFlag();
    if (do_clean_hits_) {
      //        int isLongPulse=(nSampAboveThr < 2 || nSampAboveThr >
      // width + 2);
      int is_long_pulse =
          (n_samp_above_thr >
           width);  // the short ones we'll have to single out otherwise (like
                    // spike flag or low Q) or live with
      flag += 4 * is_long_pulse;
      if (max_q > 2e5 && n_samp_above_thr < 3 &&
          flag % 2 == 0)  // this was not flagged as a spike but is eerily
                          // narrow and with high Q; flag it as a spike.
        flag += 1;
      if (flag == 0) is_clean = 1;
    }
 
    float pe = tot_subtr_q * 6250. / gain_[bar];
    if (pe > 20)  // dont't want to intercalibrate the shot noise
      pe *= mip_response_[bar];
 
    // set pulse properties like PE and amplitude
    hit.setSampAbovePed(n_samp_above_ped);
    hit.setSampAboveThr(n_samp_above_thr);
    hit.setQ(tot_subtr_q);
    hit.setAmplitude(max_q);
    hit.setPE(pe);
    hit.setHitQuality(is_clean);
    hit.setQualityFlag(flag);
    // set bar id. set moduleNB = 0
    hit.setBarID(bar);
    hit.setModuleID(0);  // test beam
    // the rest are a little ill-defined for now (PE-energy conversion not
    // known/different between LYSO and plastic)
    hit.setTime(-999);  // maybe?
    hit.setBeamEfrac(-1.);
    hit.setEnergy(hit.getPE() * mev_per_mip / pe_per_mip);
 
    // add hit
    hits.push_back(hit);
  }  // over channels
 
  // at end of event, write the collection of trigger scintillator hits.
  event.add(output_collection_, hits);
 
  return;
}

Member Data Documentation

◆ do_clean_hits_

bool trigscint::TestBeamHitProducer::do_clean_hits_ {false}

private

boolean indicating whether we want to apply quality criteria in hit reconstruction

Definition at line 85 of file TestBeamHitProducer.h.

85{false};

◆ gain_

std::vector<double> trigscint::TestBeamHitProducer::gain_

private

SiPM gain, per channel (all initialized to 2e6 in default config)

Definition at line 62 of file TestBeamHitProducer.h.

◆ input_col_

std::string trigscint::TestBeamHitProducer::input_col_

private

Set the local verbosity level.

Name of the input collection containing the event readout samples

Definition at line 51 of file TestBeamHitProducer.h.

◆ input_pass_name_

std::string trigscint::TestBeamHitProducer::input_pass_name_

private

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

Definition at line 55 of file TestBeamHitProducer.h.

◆ mip_response_

std::vector<double> trigscint::TestBeamHitProducer::mip_response_

private

channel MIP response for intercalibration

Definition at line 68 of file TestBeamHitProducer.h.

◆ n_instrumented_channels_

int trigscint::TestBeamHitProducer::n_instrumented_channels_ {12}

private

Number of instrumented channels in module.

Definition at line 81 of file TestBeamHitProducer.h.

81{12};

◆ output_collection_

std::string trigscint::TestBeamHitProducer::output_collection_

private

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

Definition at line 59 of file TestBeamHitProducer.h.

◆ peds_

std::vector<double> trigscint::TestBeamHitProducer::peds_

private

channel pedestals [fC]

Definition at line 65 of file TestBeamHitProducer.h.

◆ pulse_width_

int trigscint::TestBeamHitProducer::pulse_width_ {5}

private

Total number of samples used in pulse integration.

Definition at line 74 of file TestBeamHitProducer.h.

74{5};

◆ pulse_width_lyso_

int trigscint::TestBeamHitProducer::pulse_width_lyso_ {8}

private

Total number of samples used in pulse integration for LYSO (long decay, might need wider window)

Definition at line 78 of file TestBeamHitProducer.h.

78{8};

◆ start_sample_

int trigscint::TestBeamHitProducer::start_sample_ {10}

private

start sample for pulse integration (not including any fiber offsets)

Definition at line 71 of file TestBeamHitProducer.h.

71{10};

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

TrigScint/include/TrigScint/TestBeamHitProducer.h
TrigScint/src/TrigScint/TestBeamHitProducer.cxx

Public Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ TestBeamHitProducer()

Member Function Documentation

◆ configure()

◆ produce()

Member Data Documentation

◆ do_clean_hits_

◆ gain_

◆ input_col_

◆ input_pass_name_

◆ mip_response_

◆ n_instrumented_channels_

◆ output_collection_

◆ peds_

◆ pulse_width_

◆ pulse_width_lyso_

◆ start_sample_