dqm::ECONDDigiDQM Class Reference

Histograms of the output of packing::ECONDDecoder. More...

#include <ECONDDigiDQM.h>

Public Member Functions
	ECONDDigiDQM (const std::string &name, framework::Process &process)
	constructor
void	configure (framework::config::Parameters &parameters) override
	configure the input names
void	onProcessStart () override
	create the histograms
void	analyze (const framework::Event &event) override
	fill the histograms
Public Member Functions inherited from framework::Analyzer
	Analyzer (const std::string &name, Process &process)
	Class constructor.
virtual void	process (Event &event) final
	Processing an event for an Analyzer is calling analyze.
virtual void	beforeNewRun (ldmx::RunHeader &run_header) final
	Don't allow Analyzers to add parameters to the run header.
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	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	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	digi_name_
	name of the digi collection
std::string	info_name_
	name of the ECONDEventInfo
std::string	input_pass_
	pass of the decoder

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

Histograms of the output of packing::ECONDDecoder.

Fills the corruption flags and header data from the ECONDEventInfo and the channel measurements from the HgcrocDigiCollection. The measurements are taken from the sample word bits following the HGCROC convention (bit 31 = Tc, bit 30 = Tp).

Definition at line 18 of file ECONDDigiDQM.h.

Constructor & Destructor Documentation

ECONDDigiDQM()

dqm::ECONDDigiDQM::ECONDDigiDQM ( const std::string & name, framework::Process & process )

inline

constructor

Definition at line 21 of file ECONDDigiDQM.h.

      : framework::Analyzer(name, process) {}

Member Function Documentation

analyze()

void dqm::ECONDDigiDQM::analyze ( const framework::Event & event )

overridevirtual

fill the histograms

Implements framework::Analyzer.

Definition at line 39 of file ECONDDigiDQM.cxx.

                                                      {
  const auto& info{
      event.getObject<ldmx::ECONDEventInfo>(info_name_, input_pass_)};
  const auto& digis{
      event.getObject<ldmx::HgcrocDigiCollection>(digi_name_, input_pass_)};
 
  // bin 0 is good, bit i of the mask is bin i+1
  int frame_mask = info.getCorruption();
  if (frame_mask == 0) histograms_.fill("frame_flags", 0);
  for (int i{0}; i < 11; i++) {
    if ((frame_mask >> i) & 1) histograms_.fill("frame_flags", i + 1);
  }
  if (info.isCorrupt(ldmx::ECONDEventInfo::NO_FRAME)) return;
 
  histograms_.fill("n_samples", info.getSamples().size());
  histograms_.fill("i_soi", info.getSOIIndex());
  for (const auto& sample : info.getSamples()) {
    int mask = sample.getCorruption();
    if (mask == 0) {
      histograms_.fill("packet_flags", sample.getPayloadLength() == 0 ? 1 : 0);
      histograms_.fill("bx", sample.getBX());
    }
    for (int i{0}; i < 6; i++) {
      if ((mask >> i) & 1) histograms_.fill("packet_flags", i + 2);
    }
    const auto& links{sample.getLinks()};
    for (std::size_t i_link{0}; i_link < links.size(); i_link++) {
      const auto& link{links[i_link]};
      if (link.hasBadStat()) histograms_.fill("link_bad_stat", i_link);
      histograms_.fill("adc_cm", link.getADCCM0());
      histograms_.fill("adc_cm", link.getADCCM1());
      histograms_.fill("calib_adc", (link.getCalib() >> 10) & 0x3ff);
    }
  }
 
  histograms_.fill("n_digis", digis.getNumDigis());
  for (unsigned int i_digi{0}; i_digi < digis.getNumDigis(); i_digi++) {
    auto digi{digis.getDigi(i_digi)};
    for (unsigned int i_sample{0}; i_sample < digi.size(); i_sample++) {
      uint32_t w = digi.at(i_sample).raw();
      bool tc = (w >> 31) & 1;
      bool tp = (w >> 30) & 1;
      histograms_.fill("flags", 2 * tc + tp);
      histograms_.fill("toa", w & 0x3ff);
      if (tc) {
        histograms_.fill("tot", (w >> 10) & 0x3ff);
      } else {
        histograms_.fill("adc", (w >> 10) & 0x3ff);
        histograms_.fill("adc_tm1", (w >> 20) & 0x3ff);
      }
    }
    uint32_t soi = digi.soi().raw();
    if (((soi >> 31) & 1) == 0) {
      histograms_.fill("soi_adc_by_channel", i_digi, (soi >> 10) & 0x3ff);
    }
  }
}

References digi_name_, framework::HistogramPool::fill(), framework::EventProcessor::histograms_, info_name_, and input_pass_.

configure()

void dqm::ECONDDigiDQM::configure ( framework::config::Parameters & parameters )

overridevirtual

configure the input names

Reimplemented from framework::EventProcessor.

Definition at line 8 of file ECONDDigiDQM.cxx.

                                                          {
  digi_name_ = ps.get<std::string>("digi_name");
  info_name_ = ps.get<std::string>("info_name");
  input_pass_ = ps.get<std::string>("input_pass");
}

References digi_name_, framework::config::Parameters::get(), info_name_, and input_pass_.

onProcessStart()

void dqm::ECONDDigiDQM::onProcessStart ( )

overridevirtual

create the histograms

Reimplemented from framework::EventProcessor.

Definition at line 14 of file ECONDDigiDQM.cxx.

                                  {
  getHistoDirectory();
  histograms_.create("frame_flags", "",
                     {"good", "resync", "lost sync", "no trailer",
                      "trailer count", "ECON ID", "sample index", "truncated",
                      "extra words", "no SOI", "frame size", "no frame"});
  histograms_.create("packet_flags", "",
                     {"good", "empty", "header marker", "length", "header CRC",
                      "CRC-32", "payload", "truncated"});
  histograms_.create("n_samples", "Samples per Event", 33, -0.5, 32.5);
  histograms_.create("i_soi", "Index of Sample of Interest", 33, -0.5, 32.5);
  histograms_.create("bx", "BX", 128, 0, 4096);
  histograms_.create("link_bad_stat", "Link Index", 12, -0.5, 11.5);
  histograms_.create("adc_cm", "Common Mode ADC", 256, 0, 1024);
  histograms_.create("calib_adc", "Calibration Channel ADC", 256, 0, 1024);
  histograms_.create("n_digis", "Digis per Event", 100, 0, 500);
  histograms_.create("flags", "Tc Tp Flags", {"00", "01", "10", "11"});
  histograms_.create("adc", "ADC", 256, 0, 1024);
  histograms_.create("adc_tm1", "ADC(t-1)", 256, 0, 1024);
  histograms_.create("toa", "TOA", 256, 0, 1024);
  histograms_.create("tot", "TOT (10-bit compressed)", 256, 0, 1024);
  histograms_.create("soi_adc_by_channel", "Digi Index", 432, -0.5, 431.5,
                     "ADC in Sample of Interest", 128, 0, 1024);
}

References framework::HistogramPool::create(), framework::EventProcessor::getHistoDirectory(), and framework::EventProcessor::histograms_.

Member Data Documentation

digi_name_

std::string dqm::ECONDDigiDQM::digi_name_

private

name of the digi collection

Definition at line 35 of file ECONDDigiDQM.h.

Referenced by analyze(), and configure().

info_name_

std::string dqm::ECONDDigiDQM::info_name_

private

name of the ECONDEventInfo

Definition at line 37 of file ECONDDigiDQM.h.

Referenced by analyze(), and configure().

input_pass_

std::string dqm::ECONDDigiDQM::input_pass_

private

pass of the decoder

Definition at line 39 of file ECONDDigiDQM.h.

Referenced by analyze(), and configure().

---

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

• DQM/include/DQM/ECONDDigiDQM.h
• DQM/src/DQM/ECONDDigiDQM.cxx