Class for monitoring beam background hit rates of CDC. More...

#include <CDCHitRateCounter.h>

Inheritance diagram for CDCHitRateCounter:

Collaboration diagram for CDCHitRateCounter:

[legend]

Classes
struct	TreeStruct
	tree structure More...

Public Member Functions
	CDCHitRateCounter (const int timeWindowLowerEdge_smallCell, const int timeWindowUpperEdge_smallCell, const int timeWindowLowerEdge_normalCell, const int timeWindowUpperEdge_normalCell, const bool enableBadWireTreatment, const bool enableBackgroundHitFilter, const bool enableMarkBackgroundHit)
	Constructor. More...

virtual void	initialize (TTree *tree) override
	Class initializer: set branch addresses and other staf. More...

virtual void	clear () override
	Clear time-stamp buffer to prepare for 'accumulate'.

virtual void	accumulate (unsigned timeStamp) override
	Accumulate hits. More...

virtual void	normalize (unsigned timeStamp) override
	Normalize accumulated hits (e.g. More...

Private Member Functions
bool	isInTimeWindow (const int SL, const short tdc)
	return true if the hit is in the given time window More...

void	countActiveWires_countAll ()
	set m_nActiveWireInTotal, m_nActiveWireInLayer[] and m_nActiveWireInSuperLayer[]. More...

void	countActiveWires ()
	set m_nActiveWireInTotal, m_nActiveWireInLayer[] and m_nActiveWireInSuperLayer[]. More...

unsigned short	getIPhiBin (unsigned short iSL, unsigned short iWireInLayer)
	get the bin ID of the division.

Private Attributes
TreeStruct	m_rates
	tree variables

std::map< unsigned, TreeStruct >	m_buffer
	average rates in time stamps

StoreArray< CDCHit >	m_digits
	collection of digits

const int	m_timeWindowLowerEdge_smallCell
	lower edge of the time window for small cells [tdc count = 0.982536 ns]

const int	m_timeWindowUpperEdge_smallCell
	upper edge of the time window for small cells [tdc count = 0.982536 ns]

const int	m_timeWindowLowerEdge_normalCell
	lower edge of the time window for normal cells [tdc count = 0.982536 ns]

const int	m_timeWindowUpperEdge_normalCell
	upper edge of the time window for normal cells [tdc count = 0.982536 ns]

const bool	m_enableBadWireTreatment
	flag to enable the bad wire treatment. More...

const bool	m_enableBackgroundHitFilter
	flag to enable the CDC background hit (crosstakl, noise) filter. More...

const bool	m_enableMarkBackgroundHit
	flag to enable to mark background flag on CDCHit (set 0x100 bit for CDCHit::m_status). More...

int	m_nActiveWireInTotal
	the number of wires used in this hit-rate calculation in the whole CDC More...

int	m_nActiveWireInSuperLayer [f_nSuperLayer] = {0}
	the number of wires used in this hit-rate calculation in each suler layer

int	m_nActiveWireInLayer [f_nLayer] = {0}
	the number of wires used in this hit-rate calculation in each layer

int	m_nActiveWireInLayerPhi [f_nLayer][f_nPhiDivision] = {{0}}
	the number of wires used in this hit-rate calculation in each phi bin in each layer

Static Private Attributes
static const int	f_nSuperLayer = 9
	the number of super layers

static const int	f_nLayer = 56
	the number of layers

static const int	f_nPhiDivision = 8
	the number of division in phi

Detailed Description

Class for monitoring beam background hit rates of CDC.

Definition at line 28 of file CDCHitRateCounter.h.

Constructor & Destructor Documentation

◆ CDCHitRateCounter()

CDCHitRateCounter	(	const int	timeWindowLowerEdge_smallCell,
		const int	timeWindowUpperEdge_smallCell,
		const int	timeWindowLowerEdge_normalCell,
		const int	timeWindowUpperEdge_normalCell,
		const bool	enableBadWireTreatment,
		const bool	enableBackgroundHitFilter,
		const bool	enableMarkBackgroundHit
	)

inline

Constructor.

Parameters

timeWindowLowerEdge_smallCell	lower edge of the timing window for the layers with small cells (SL0)
timeWindowUpperEdge_smallCell	upper edge of the timing window for the layers with small cells (SL0)
timeWindowLowerEdge_normalCell	lower edge of the timing window for the layers with normal cells (SL1-8)
timeWindowUpperEdge_normalCell	upper edge of the timing window for the layers with normal cells (SL1-8)
enableBadWireTreatment	flag to enable the bad wire treatment. default: true
enableBackgroundHitFilter	flag to enable the CDC background hit (crosstakl, noise) filter. default: true
enableMarkBackgroundHit	flag to enable to mark background flag on CDCHit (set 0x100 bit for CDCHit::m_status). default: false

Definition at line 108 of file CDCHitRateCounter.h.

                                                            :
         m_timeWindowLowerEdge_smallCell(timeWindowLowerEdge_smallCell),
         m_timeWindowUpperEdge_smallCell(timeWindowUpperEdge_smallCell),
         m_timeWindowLowerEdge_normalCell(timeWindowLowerEdge_normalCell),
         m_timeWindowUpperEdge_normalCell(timeWindowUpperEdge_normalCell),
         m_enableBadWireTreatment(enableBadWireTreatment),
         m_enableBackgroundHitFilter(enableBackgroundHitFilter),
         m_enableMarkBackgroundHit(enableMarkBackgroundHit)
       {
         if (m_timeWindowUpperEdge_smallCell  - m_timeWindowLowerEdge_smallCell  <= 0 ||
             m_timeWindowUpperEdge_normalCell - m_timeWindowLowerEdge_normalCell <= 0) {
           B2FATAL("invalid seting of CDC time window");
         }
       }

Member Function Documentation

◆ accumulate()

void accumulate ( unsigned timeStamp )

overridevirtual

Accumulate hits.

Parameters

timeStamp time stamp

Implements HitRateBase.

Definition at line 71 of file CDCHitRateCounter.cc.

     {
       // check if data are available
       if (not m_digits.isValid()) return;
  
       // get buffer element
       auto& rates = m_buffer[timeStamp];
  
       // increment event counter
       rates.numEvents++;
  
       std::map<const CDCHit*, bool> CDCHitToBackgroundFlag;
       if (m_enableBackgroundHitFilter) {
         StoreWrappedObjPtr<std::vector<CDCWireHit>> storeVector("CDCWireHitVector");
         if (not storeVector) {
           B2FATAL("CDCWireHitVector is unaccessible in DataStore."
                   "Need TFCDC_WireHitParameter module before.");
         }
         const std::vector<CDCWireHit>& cdcWireHitVector = *storeVector;
         for (const auto& cdcWireHit : cdcWireHitVector) {
           const CDCHit* cdcHit = cdcWireHit.getHit();
           CDCHitToBackgroundFlag[cdcHit] = cdcWireHit->hasBackgroundFlag(); 
         }
       }
  
       CDC::CDCGeometryPar& geometryPar = CDC::CDCGeometryPar::Instance();
  
       for (CDCHit& hit : m_digits) {
         const WireID wireID(hit.getID());
         if (m_enableBadWireTreatment && geometryPar.isBadWire(wireID))
           continue;
  
         const unsigned short iSuperLayer  = hit.getISuperLayer();
         const unsigned short iLayer       = hit.getICLayer();
         const unsigned short iWireInLayer = hit.getIWire();
         const unsigned short iPhiBin      = getIPhiBin(iSuperLayer, iWireInLayer);
         const unsigned short adc = hit.getADCCount();
         const short tdc          = hit.getTDCCount();
  
         if (m_enableBackgroundHitFilter) {
           if (CDCHitToBackgroundFlag[&hit]) {
             if (m_enableMarkBackgroundHit) {
               unsigned short newStatus = (hit.getStatus() | 0x100);
               hit.setStatus(newStatus);
             }
             continue;
           }
         } else {
           if (iSuperLayer == 0 && adc < 15)
             continue;
           if (iSuperLayer != 0 && adc < 18)
             continue;
         }
  
         if (not isInTimeWindow(iSuperLayer, tdc))
           continue;
  
  
         rates.averageRate += 1;
         rates.superLayerHitRate[iSuperLayer] += 1;
         rates.layerHitRate[iLayer] += 1;
         rates.layerPhiHitRate[iLayer][iPhiBin] += 1;
       }
  
       // set flag to true to indicate the rates are valid
       rates.valid = true;
     }

◆ countActiveWires()

void countActiveWires ( )

private

set m_nActiveWireInTotal, m_nActiveWireInLayer[] and m_nActiveWireInSuperLayer[].

called in initialize function. count the number of wires excluding dead wires (bad channels).

end i loop

end iL loop

end iSL loop

Definition at line 230 of file CDCHitRateCounter.cc.

◆ countActiveWires_countAll()

void countActiveWires_countAll ( )

private

set m_nActiveWireInTotal, m_nActiveWireInLayer[] and m_nActiveWireInSuperLayer[].

called in initialize function. count the number of all the wires including dead wires (bad channels).

Definition at line 202 of file CDCHitRateCounter.cc.

◆ initialize()

void initialize ( TTree * tree )

overridevirtual

Class initializer: set branch addresses and other staf.

Parameters

tree	a valid TTree pointer

Implements HitRateBase.

Definition at line 36 of file CDCHitRateCounter.cc.

◆ isInTimeWindow()

bool isInTimeWindow	(	const int	SL,
		const short	tdc
	)

inlineprivate

return true if the hit is in the given time window

Parameters

SL	super layer ID which the wire of the hit belongs to
tdc	TDC value of the hit

Definition at line 175 of file CDCHitRateCounter.h.

◆ normalize()

void normalize ( unsigned timeStamp )

overridevirtual

Normalize accumulated hits (e.g.

transform to rates)

Parameters

timeStamp time stamp

copy nActiveWire

Implements HitRateBase.

Definition at line 147 of file CDCHitRateCounter.cc.

Member Data Documentation

◆ m_enableBackgroundHitFilter

const bool m_enableBackgroundHitFilter

private

flag to enable the CDC background hit (crosstakl, noise) filter.

default: true

Definition at line 188 of file CDCHitRateCounter.h.

◆ m_enableBadWireTreatment

const bool m_enableBadWireTreatment

private

flag to enable the bad wire treatment.

default: true

Definition at line 187 of file CDCHitRateCounter.h.

◆ m_enableMarkBackgroundHit

const bool m_enableMarkBackgroundHit

private

flag to enable to mark background flag on CDCHit (set 0x100 bit for CDCHit::m_status).

default: false

Definition at line 190 of file CDCHitRateCounter.h.

◆ m_nActiveWireInTotal

int m_nActiveWireInTotal

private

Initial value:

=

0

the number of wires used in this hit-rate calculation in the whole CDC

Definition at line 192 of file CDCHitRateCounter.h.

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

background/modules/BeamBkgHitRateMonitor/include/CDCHitRateCounter.h
background/modules/BeamBkgHitRateMonitor/src/CDCHitRateCounter.cc

Classes

Public Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ CDCHitRateCounter()

Member Function Documentation

◆ accumulate()

◆ countActiveWires()

◆ countActiveWires_countAll()

◆ initialize()

◆ isInTimeWindow()

◆ normalize()

Member Data Documentation

◆ m_enableBackgroundHitFilter

◆ m_enableBadWireTreatment

◆ m_enableMarkBackgroundHit

◆ m_nActiveWireInTotal