Auxiliary classes and methods for triggering. More...

Classes
struct	clusterize
	Anonymous structure for clustering of hits. More...

struct	reverse_clusterize
	Anonymous structure for reverse clustering of hits. More...

struct	clusterizeWeight
	Anonymous struct for weighed clustering of hits. More...

class	JBinder2nd
	Auxiliary class to convert binary JMatch operator and given hit to unary match operator. More...

struct	JBuild
	Auxiliary base class for hit building. More...

struct	JBuildHelper
	Auxiliary class to extend hit building functionality to all DAQ data types. More...

class	JBuildL0
	Template L0 hit builder. More...

class	JBuildL0< JHitL0 >
	Template specialisation of L0 builder for JHitL0 data type. More...

class	JBuildL0< JHitR0 >
	Template specialisation of L0 builder for JHitR0 data type. More...

class	JBuildL0< JHitR1 >
	Template specialisation of L0 builder for JHitR1 data type. More...

struct	JBuildL1Parameters
	Auxiliary data structure for L1 build parameters. More...

class	JBuildL1
	Template L1 hit builder. More...

class	JBuildL1< JHitL1 >
	Template specialisation of L1 builder for JHitL1 data type. More...

class	JBuildL1< JHitR1 >
	Template specialisation of L1 builder for JHitR1 data type. More...

class	JBuildL2
	Template L2 builder. More...

class	JBuildL2< JHitL2 >
	Template specialisation of L2 builder for JHitL2 data type. More...

class	JBuildL2< JHitR2 >
	Template specialisation of L2 builder for JHitR2 data type. More...

struct	JChecksum
	Auxiliary class to perform check-sum on raw data. More...

class	JCLBRunByRunSimulator
	CLB simulation based on run-by-run information. More...

class	JClone
	Clone of a container. More...

struct	JDAQHitSelector
	Auxiliary class to select DAQ hits. More...

struct	JDAQHitDefaultSelector
	Default class to select DAQ hits. More...

struct	JDAQHitToTSelector
	Auxiliary class to select DAQ hits based on time-over-treshold value. More...

class	JDOMToPMTMaskMap

class	JEvent
	Triggered event. More...

class	JEventOverlap
	Match of two events considering overlap in time. More...

class	JFrame
	Data frame for calibrated hits of one PMT. More...

class	JFrame_t
	Data frame with end marker. More...

class	JFrameClone
	Clone of JFrame. More...

struct	JGetRiseTime
	Auxiliary class for rise time evaluation. More...

class	JHit
	Hit data structure. More...

class	JHitL0
	Data structure for L0 hit. More...

class	JHitL1
	Data structure for L1 hit. More...

class	JHitR0
	Reduced data structure for L0 hit. More...

class	JHitR1
	Reduced data structure for L1 hit. More...

struct	JHitToolkit
	Template definition of hit toolkit. More...

struct	JHitToolkit< JHit, false >
	Template specialisation of hit toolkit for JHit class. More...

struct	JHitToolkit< JDAQHit, false >
	Template specialisation of hit toolkit for JDAQHit class. More...

struct	JHitToolkit< JHitR0, false >
	Template specialisation of hit toolkit for JHitR0 class. More...

struct	JHitToolkit< JHit_t, true >
	Template specialisation of hit toolkit for any primitive data type. More...

class	JK40RunByRunSimulator
	K40 simulation based on run-by-run information. More...

class	JMatch
	Function object interface for hit matching. More...

class	JMatchHelper
	Auxiliary class to handle pointer to match function. More...

class	JMatch1D
	1D match criterion. More...

class	JMatch3B
	3D match criterion with road width. More...

class	JMatch3D
	3D match criterion. More...

class	JMatch3G
	3G match criterion. More...

class	JMatchL0
	L0 match criterion. More...

struct	JModuleCounter
	Auxiliary class for counting unique modules. More...

struct	JModuleHeader
	Header for Module. More...

struct	JParametersHelper
	Wrapper class to share parameters. More...

struct	JPMTHeader
	Header for PMT. More...

class	JPMTIdentifier_t

class	JPMTMask
	Auxiliary class for PMT mask. More...

class	JPMTRunByRunSimulator
	PMT simulation based on run-by-run information. More...

struct	JPMTSelector
	Auxiliary data structure for set of PMT identifiers. More...

struct	JPreprocessor
	Auxiliary class for specifying the way of pre-processing of hits. More...

class	JPrescaler
	Auxiliary class for prescaling. More...

class	JSummaryRouter
	Router for fast addressing of summary data in JDAQSummaryslice data structure as a function of the optical module identifier. More...

class	JSuperFrame1D
	1-dimensional frame with time calibrated data from one optical module. More...

class	JSuperFrame2D
	2-dimensional frame with time calibrated data from one optical module. More...

class	JSuperFrameClone1D
	Clone of JSuperFrame1D. More...

class	JSuperFrameClone2D
	Clone of JSuperFrame2D. More...

class	JTimeslice
	Time slice with calibrated data. More...

class	JTimesliceClone
	Clone of JTimeslice. More...

class	JTimesliceL1
	Auxiliary class to build JDAQTimeslice for L1 timeslice. More...

struct	JTimesliceRouter_t
	Auxiliary base class for JTimesliceRouter. More...

struct	JTimesliceRouter
	Router for fast addressing of hits in KM3NETDAQ::JDAQTimeslice data structure as a function of the optical module identifier and time. More...

class	JTrigger3D
	General purpose majority trigger. More...

class	JTrigger3DMuon
	Muon trigger. More...

struct	JTrigger3DMuon_t
	Muon trigger parameters. More...

class	JTrigger3DShower
	Shower trigger. More...

struct	JTrigger3DShower_t
	Shower trigger parameters. More...

class	JTrigger3N
	General purpose muon trigger. More...

class	JTriggeredEvent
	Auxiliary class to build JDAQEvent for a triggered event. More...

class	JTriggeredHit
	Data structure for triggered hit. More...

class	JTriggerException
	General exception. More...

class	JTriggerInput
	Data structure for input to trigger algorithm. More...

class	JTriggerInterface
	Trigger interface. More...

struct	JTriggerBit
	This class is used to map trigger class to trigger bit. More...

struct	JAssertBit
	This class will generate a compiler error if trigger bit is out of range. More...

struct	JAssertBit< N, true >
	Implementation of a valid trigger bit. More...

struct	JAttributes
	Module attributes. More...

class	JTriggerMXShower
	Shower trigger. More...

struct	JTriggerMXShower_t
	Shower trigger parameters. More...

class	JTriggerNB
	Nano-beacon trigger. More...

struct	JTriggerNB_t
	Nano-beacon trigger parameters. More...

class	JTriggerOutput
	Set of triggered events. More...

struct	JL2Parameters
	Data structure for L2 parameters. More...

class	JTriggerParameters
	Data structure for all trigger parameters. More...

Typedefs
typedef JHitL1	JHitL2
	Type definition of L2 hit. More...

typedef JHitR1	JHitR2
	Type definition of R2 hit. More...

typedef unsigned int	JPMTMask_t
	Type definition of PMT mask. More...

typedef unsigned int	JTriggerbit_t
	Type definition of trigger bit. More...

Functions
template<class JHit_t >
bool	weightSorter (const JHit_t &first, const JHit_t &second)
	Compare two hits by weight. More...

template<class JHit_t >
bool	timeSorter (const JHit_t &first, const JHit_t &second)
	Compare two hits by weight. More...

template<class JHit_t >
JBinder2nd< JHit_t >	JBind2nd (const JMatch< JHit_t > &match, const JHit_t &second)
	Auxiliary method to create JBinder2nd object. More...

bool	operator< (const JEvent &first, const JEvent &second)
	Less than operator for events. More...

JTimeRange	getTimeRange (const JEvent &event)
	Get time range (i.e. earlist and latest hit time) of triggered event. More...

bool	operator< (const JHit &first, const JHit &second)
	Less than operator for hits. More...

bool	operator< (const JHit &hit, const double t1)
	Less than operator for hits. More...

bool	operator== (const JHit &first, const JHit &second)
	Equal operator for hits. More...

template<class T >
int	getCount (const T &hit)
	Get hit count. More...

template<class T >
int	getCount (T __begin, T __end)
	Get hit count. More...

double	getTime (const JDAQHit &hit, const JCalibration &cal)
	Get calibrated time of DAQ hit. More...

double	getToT (const JDAQHit &hit, const JCalibration &cal)
	Get calibrated time-over-threshold of DAQ hit. More...

template<class JHit_t >
JMatchHelper< JHit_t >	make_match (bool(*match)(const JHit_t &, const JHit_t &))
	Auxiliary method to make JMatch object based on pointer to match function. More...

bool	operator== (const JPMTIdentifier_t &first, const JPMTIdentifier_t &second)
	Equal operator for PMT identifiers. More...

bool	operator< (const JPMTIdentifier_t &first, const JPMTIdentifier_t &second)
	Less than operator for PMT identifiers. More...

JPMTMask_t	getPMTMask (const unsigned int bit)
	Convert PMT bit to PMT mask. More...

	setTriggerBit (JTrigger3DShower, JTRIGGER3DSHOWER)

	setTriggerBit (JTriggerMXShower, JTRIGGERMXSHOWER)

	setTriggerBit (JTrigger3DMuon, JTRIGGER3DMUON)

	setTriggerBit (JTriggerNB, JTRIGGERNB)

bool	operator< (const JTriggeredHit &first, const JTriggeredHit &second)
	Less than operator for triggered hits. More...

bool	operator== (const JTriggeredHit &first, const JTriggeredHit &second)
	Equal operator for triggered hits. More...

template<class JTrigger_t >
JTriggerbit_t	getTriggerBit ()
	Get the trigger bit. More...

template<class JTrigger_t >
JTriggerbit_t	getTriggerBit (const JTrigger_t &event)
	Get the trigger bit. More...

const char *	getTriggerName (JTriggerbit_t bit)
	Get trigger name. More...

void	setAttributes (const JModule &first, const JModule &second, JAttributes &attributes)
	Set module attributes. More...

void	randomize (JTrigger3DMuon_t::JParameters *p)
	Randomize trigger parameters. More...

void	randomize (JTrigger3DShower_t::JParameters *p)
	Randomize trigger parameters. More...

void	randomize (JTriggerMXShower_t::JParameters *p)
	Randomize trigger parameters. More...

void	randomize (JTriggerNB_t::JParameters *p)
	Randomize trigger parameters. More...

void	randomize (JTriggerParameters *p)
	Randomize trigger parameters. More...

JTimeRange	getTimeRange (const JTriggerParameters &parameters)
	Get time range of snapshot. More...

JTimeRange	getTimeRange (const JTriggerNB_t::JParameters &parameters)
	Get time range of snapshot. More...

bool	getDAQStatus (const JDAQFrameStatus &frame, const JStatus &status)
	Test status of DAQ. More...

bool	getDAQStatus (const JDAQFrameStatus &frame, const JModule &module, const int pmt)
	Test status of DAQ. More...

bool	getPMTStatus (const JStatus &status)
	Test status of PMT. More...

bool	getPMTStatus (const JDAQFrameStatus &frame, const JStatus &status, const int pmt)
	Test status of PMT. More...

bool	getPMTStatus (const JDAQFrameStatus &frame, const JModule &module, const int pmt)
	Test status of PMT. More...

double	getRate (const JDAQSummaryFrame &frame, const int pmt, const double factor=1.0)
	Get corrected rate of PMT. More...

Variables
static struct JTRIGGER::clusterize	clusterize

static struct JTRIGGER::reverse_clusterize	reverse_clusterize

static struct JTRIGGER::clusterizeWeight	clusterizeWeight

static int	MAXIMAL_FRAME_SIZE = std::numeric_limits<int>::max()
	Maximal frame size. More...

static const JChecksum	checksum
	Function object to perform check-sum of raw data. More...

static const JGetRiseTime	getRiseTime
	Function object for rise time evaluation. More...

static const JModuleCounter	getNumberOfModules
	Function object to count unique modules. More...

static const unsigned int	NUMBER_OF_PMT_BITS = 31
	Number of PMT bits. More...

Detailed Description

Auxiliary classes and methods for triggering.

Trigger algorithms, support classes and auxiliary methods.

Author: mdejong; rbruijn; rgruiz

Typedef Documentation

typedef JHitL1 JTRIGGER::JHitL2

Type definition of L2 hit.

Definition at line 20 of file JHitL2.hh.

typedef JHitR1 JTRIGGER::JHitR2

Type definition of R2 hit.

Definition at line 20 of file JHitR2.hh.

typedef unsigned int JTRIGGER::JPMTMask_t

Type definition of PMT mask.

Definition at line 29 of file JPMTMask.hh.

typedef unsigned int JTRIGGER::JTriggerbit_t

Type definition of trigger bit.

Definition at line 29 of file JTriggerInterface.hh.

Function Documentation

template<class JHit_t >

bool JTRIGGER::weightSorter	(	const JHit_t &	first,
		const JHit_t &	second
	)

inline

Compare two hits by weight.

The template argument JHit_t refers to a data structure which should have the following member method:

double getW(); // [a.u.]

Parameters

first	first hit
second	second hit

Returns: true if first hit has larger weight than second; else false

Definition at line 433 of file JAlgorithm.hh.

   {
     return first.getW() > second.getW();
   }

template<class JHit_t >

bool JTRIGGER::timeSorter	(	const JHit_t &	first,
		const JHit_t &	second
	)

inline

Compare two hits by weight.

The template argument JHit_t refers to a data structure which should have the following member methods:

double getT(); // [a.u.]

Parameters

first	first hit
second	second hit

Returns: true if first hit earlier than second; else false

Definition at line 450 of file JAlgorithm.hh.

   {
     return first.getT() < second.getT();
   }

template<class JHit_t >

JBinder2nd<JHit_t> JTRIGGER::JBind2nd	(	const JMatch< JHit_t > &	match,
		const JHit_t &	second
	)

inline

Auxiliary method to create JBinder2nd object.

Parameters

match	match operator
second	second hit

Returns: JBinder2nd

Definition at line 66 of file JBind2nd.hh.

   {
     return JBinder2nd<JHit_t>(match, second);
   }

bool JTRIGGER::operator<	(	const JEvent &	first,
		const JEvent &	second
	)

inline

Less than operator for events.

The less than operator is applied to the first hit in the events.

Parameters

first	first event
second	second event

Returns: true if first event earliear than second; else false

Definition at line 215 of file JTrigger/JEvent.hh.

   {
     if (first.empty() || second.empty()) {
       throw JTriggerException("Comparison with empty event(s).");
     }
 
     return first.begin()->getT() < second.begin()->getT();
   }

JTimeRange JTRIGGER::getTimeRange ( const JEvent & event )

inline

Get time range (i.e. earlist and latest hit time) of triggered event.

Parameters

event event

Returns: time range

Definition at line 26 of file JEventToolkit.hh.

   {
     if (!event.empty())
       return JTimeRange(event.begin()->getT(), event.rbegin()->getT());
     else
       return JTimeRange::DEFAULT_RANGE();
   }

bool JTRIGGER::operator<	(	const JHit &	first,
		const JHit &	second
	)

inline

Less than operator for hits.

The less than operator is applied to the time of the hits.

Parameters

first	first hit
second	second hit

Returns: true if first hit earlier; else false

Definition at line 231 of file JTrigger/JHit.hh.

   {
     return first.getT() < second.getT();
   }

bool JTRIGGER::operator<	(	const JHit &	hit,
		const double	t1
	)

inline

Less than operator for hits.

The less than operator is applied to the time of the hits.

Parameters

hit	hit
t1	time [ns]

Returns: true if hit earlier than t; else false

Definition at line 246 of file JTrigger/JHit.hh.

   {
     return hit.getT() < t1;
   }

bool JTRIGGER::operator==	(	const JHit &	first,
		const JHit &	second
	)

inline

Equal operator for hits.

The equal operator is applied to the time of the hits.

Parameters

first	hit
second	hit

Returns: true if first hit time equal to second hit time; else false

Definition at line 261 of file JTrigger/JHit.hh.

   {
     return first.getT() == second.getT();
   }

template<class T >

int JTRIGGER::getCount ( const T & hit )

inline

Get hit count.

The hit refers to a data structure which should have the following member method:

int getN();

Parameters

hit hit

Returns: count

Definition at line 277 of file JTrigger/JHit.hh.

   {
     return hit.getN();
   }

template<class T >

int JTRIGGER::getCount	(	T	__begin,
		T	__end
	)

inline

Get hit count.

The hit iterator refers to a data structure which should have the following member method:

int getN();

Parameters

__begin	begin of data
__end	end of data

Returns: count

Definition at line 294 of file JTrigger/JHit.hh.

   {
     int count = 0;
 
     for (T hit = __begin; hit !=__end; ++hit) {
       count += getCount(*hit);
     }
 
     return count;
   }

double JTRIGGER::getTime	(	const JDAQHit &	hit,
		const JCalibration &	cal
	)

inline

Get calibrated time of DAQ hit.

Parameters

hit	DAQ hit
cal	calibration

Returns: time [ns]

Definition at line 34 of file JHitToolkit.hh.

   {
     return getTime(hit.getT(), cal);
   }

double JTRIGGER::getToT	(	const JDAQHit &	hit,
		const JCalibration &	cal
	)

inline

Get calibrated time-over-threshold of DAQ hit.

Parameters

hit	DAQ hit
cal	calibration

Returns: time-over-threshold [ns]

Definition at line 47 of file JHitToolkit.hh.

   {
     return getToT(hit.getToT(), cal);
   }

template<class JHit_t >

JMatchHelper<JHit_t> JTRIGGER::make_match ( bool(*)(const JHit_t &, const JHit_t &) match )

Auxiliary method to make JMatch object based on pointer to match function.

Parameters

match pointer to match function

Returns: match object

Definition at line 115 of file JMatch.hh.

   {
     return JMatchHelper<JHit_t>(match);
   }  

bool JTRIGGER::operator==	(	const JPMTIdentifier_t &	first,
		const JPMTIdentifier_t &	second
	)

inline

Equal operator for PMT identifiers.

Parameters

first	PMT identifier
second	PMT identifier

Returns: true if first PMT equal second PMT; else false

Definition at line 169 of file JPMTIdentifier_t.hh.

   {
     return (first.getModuleID()   == second.getModuleID()  &&
             first.getPMTAddress() == second.getPMTAddress());
   }

bool JTRIGGER::operator<	(	const JPMTIdentifier_t &	first,
		const JPMTIdentifier_t &	second
	)

inline

Less than operator for PMT identifiers.

The less than operator is applied first to the module identifer and then to the PMT address.

Parameters

first	PMT identifier
second	PMT identifier

Returns: true if first PMT lower than second PMT; else false

Definition at line 185 of file JPMTIdentifier_t.hh.

   {
     if (first.getModuleID() == second.getModuleID())
       return first.getPMTAddress() < second.getPMTAddress();
     else
       return first.getModuleID()   < second.getModuleID();
   }

JPMTMask_t JTRIGGER::getPMTMask ( const unsigned int bit )

inline

Convert PMT bit to PMT mask.

Parameters

bit PMT bit

Returns: PMT mask

Definition at line 44 of file JPMTMask.hh.

   {
     if (bit < NUMBER_OF_PMT_BITS)
       return JPMTMask_t(1) << bit;
     else
       return 0;
   }

JTRIGGER::setTriggerBit	(	JTrigger3DShower	,
		JTRIGGER3DSHOWER
	)

JTRIGGER::setTriggerBit	(	JTriggerMXShower	,
		JTRIGGERMXSHOWER
	)

JTRIGGER::setTriggerBit	(	JTrigger3DMuon	,
		JTRIGGER3DMUON
	)

JTRIGGER::setTriggerBit	(	JTriggerNB	,
		JTRIGGERNB
	)

bool JTRIGGER::operator<	(	const JTriggeredHit &	first,
		const JTriggeredHit &	second
	)

inline

Less than operator for triggered hits.

The less than operator is applied first to JTRIGGER::JHit and then to the KM3NETDAQ::JDAQPMTIdentifier. Hence, the ordering by JTRIGGER::JHit is maintained. This allows for the use of STL sort() and set_union() algorithms.

Parameters

first	first hit
second	second hit

Returns: true if first hit earlier or lower PMT identifier if equal; else false

Definition at line 86 of file JTriggeredHit.hh.

   {
     if (std::equal_to<JHit>()(first,second))
       return std::less<JDAQPMTIdentifier>()(first,second);
     else
       return std::less<JHit>             ()(first,second);
   }

bool JTRIGGER::operator==	(	const JTriggeredHit &	first,
		const JTriggeredHit &	second
	)

inline

Equal operator for triggered hits.

The equal operator is applied to JTRIGGER::JHit and to the KM3NETDAQ::JDAQPMTIdentifier.

Parameters

first	first hit
second	second hit

Returns: true if first hit equal second hit; else false

Definition at line 104 of file JTriggeredHit.hh.

   {
     return (std::equal_to<JDAQPMTIdentifier>()(first,second) &&
             std::equal_to<JHit>             ()(first,second));
   }

template<class JTrigger_t >

JTriggerbit_t JTRIGGER::getTriggerBit ( )

inline

Get the trigger bit.

Returns: trigger bit

Definition at line 206 of file JTriggerInterface.hh.

   {
     return JTriggerBit<JTrigger_t>::value;
   }

template<class JTrigger_t >

JTriggerbit_t JTRIGGER::getTriggerBit ( const JTrigger_t & event )

inline

Get the trigger bit.

Parameters

event triggered event

Returns: trigger bit

Definition at line 219 of file JTriggerInterface.hh.

   {
     return JTriggerBit<JTrigger_t>::value;
   }

const char* JTRIGGER::getTriggerName ( JTriggerbit_t bit )

inline

Get trigger name.

param bit trigger bit

Returns: trigger name

Definition at line 231 of file JTriggerInterface.hh.

   {
     return JTriggerInterface::getTriggerName(bit);
   }

void JTRIGGER::setAttributes	(	const JModule &	first,
		const JModule &	second,
		JAttributes &	attributes
	)

inline

Set module attributes.

Parameters

first	first module
second	second module
attributes	module attributes

Definition at line 46 of file JTriggerMXShower.hh.

   {
     using namespace JMATH;
     using namespace JTOOLS;
 
     typedef JTriggerMXShower_t::JParameters  JParameters_t;
 
     // get trigger parameters
 
     const JParameters_t& parameters = JParametersHelper<JParameters_t>::getParameters();
 
     const double d = getDistance(first.getPosition(), second.getPosition());
 
     double t1 = 0.0;
 
     if      (d <= 0.5 * parameters.DMax_m)
       t1 =  d                      * getIndexOfRefraction() * getInverseSpeedOfLight()  +  parameters.TMaxExtra_ns;
     else if (d <= parameters.DMax_m)
       t1 = (parameters.DMax_m - d) * getIndexOfRefraction() * getInverseSpeedOfLight()  +  parameters.TMaxExtra_ns;
 
     attributes.Tmin_ns = -t1;
     attributes.Tmax_ns = +t1;
   }

void JTRIGGER::randomize ( JTrigger3DMuon_t::JParameters * p )

inline

Randomize trigger parameters.

Parameters

p	pointer to valid object

Definition at line 26 of file JTriggerTestkit.hh.

   {
     p->enabled         =  getRandom<bool>();
     p->numberOfHits    =  getRandom<int>(1, 10);
     p->numberOfModules =  getRandom<int>(1, 10);
     p->DMax_m          =  getRandom<double>( 0.0, 999.0, 1.0);
     p->roadWidth_m     =  getRandom<double>(50.0, 250.0, 1.0);
     p->gridAngle_deg   =  getRandom<double>( 1.0,  10.0, 1.0);
     p->TMaxExtra_ns    =  getRandom<double>(10.0,  50.0, 1.0);
     p->factoryLimit    =  getRandom<double>(100,  200);
   }

void JTRIGGER::randomize ( JTrigger3DShower_t::JParameters * p )

inline

Randomize trigger parameters.

Parameters

p	pointer to valid object

Definition at line 44 of file JTriggerTestkit.hh.

   {
     p->enabled         =  getRandom<bool>();
     p->numberOfHits    =  getRandom<int>(1, 10);
     p->numberOfModules =  getRandom<int>(1, 10);
     p->DMax_m          =  getRandom<double>( 0.0, 999.0, 1.0);
     p->TMaxExtra_ns    =  getRandom<double>(10.0,  50.0, 1.0);
     p->factoryLimit    =  getRandom<double>(100,  200);
   }

void JTRIGGER::randomize ( JTriggerMXShower_t::JParameters * p )

inline

Randomize trigger parameters.

Parameters

p	pointer to valid object

Definition at line 60 of file JTriggerTestkit.hh.

   {
     p->enabled         =  getRandom<bool>();
     p->numberOfHits    =  getRandom<int>(1, 10);
     p->numberOfModules =  getRandom<int>(1, 10);
     p->DMax_m          =  getRandom<double>( 0.0, 999.0, 1.0);
     p->TMaxExtra_ns    =  getRandom<double>(10.0,  50.0, 1.0);
     p->factoryLimit    =  getRandom<double>(100,  200);
   }

void JTRIGGER::randomize ( JTriggerNB_t::JParameters * p )

inline

Randomize trigger parameters.

Parameters

p	pointer to valid object

Definition at line 76 of file JTriggerTestkit.hh.

   {
     p->enabled         =  getRandom<bool>();
 
     p->pmts.clear();
 
     for (int i = getRandom<int>(1, 10); i != 0; --i) {
       p->pmts.push_back(JPMTIdentifier_t(getRandom<int>(-1, 100),
                                          getRandom<int>(-1,  30)));
     }
   }

void JTRIGGER::randomize ( JTriggerParameters * p )

inline

Randomize trigger parameters.

Parameters

p	pointer to valid object

Definition at line 94 of file JTriggerTestkit.hh.

   {
     p->highRateVeto_Hz = getRandom<double>(1.0e3, 1.0e4, 1.0);
     p->L2Min           = getRandom<int>(2, 3);
     p->ctMin           = getRandom<double>( -1.0,  +1.0, 0.1);
     p->TMaxLocal_ns    = getRandom<double>( 10.0,  20.0, 1.0);
     p->TMaxEvent_ns    = getRandom<double>(100.0, 999.0, 1.0);
     p->numberOfBins    = getRandom<int>(100, 1000);
     p->combineL1       = getRandom<bool>();
 
     p->trigger3DMuon   = getRandom<JTrigger3DMuon_t  ::JParameters>();
     p->trigger3DShower = getRandom<JTrigger3DShower_t::JParameters>();
     p->triggerMXShower = getRandom<JTriggerMXShower_t::JParameters>();
     p->triggerNB       = getRandom<JTriggerNB_t      ::JParameters>();
 
     p->writeSummary    = getRandom<long long int>(0, 100);
     p->writeL0         = getRandom<long long int>(0, 100);
     p->writeL1         = getRandom<long long int>(0, 100);
     p->writeL2         = getRandom<long long int>(0, 100);
     p->writeSN         = getRandom<long long int>(0, 100);
   }

JTimeRange JTRIGGER::getTimeRange ( const JTriggerParameters & parameters )

inline

Get time range of snapshot.

Parameters

parameters trigger parameters

Returns: time range [ns]

Definition at line 40 of file JTriggerToolkit.hh.

   {
     return JTimeRange(-parameters.TMaxEvent_ns, 
                       +parameters.TMaxEvent_ns);
   }

JTimeRange JTRIGGER::getTimeRange ( const JTriggerNB_t::JParameters & parameters )

inline

Get time range of snapshot.

Parameters

parameters trigger parameters

Returns: time range [ns]

Definition at line 52 of file JTriggerToolkit.hh.

   {
     using namespace JPP;
 
     return JTimeRange(0.0, parameters.DMax_m * getIndexOfRefraction() * getInverseSpeedOfLight());
   }

bool JTRIGGER::getDAQStatus	(	const JDAQFrameStatus &	frame,
		const JStatus &	status
	)

inline

Test status of DAQ.

The DAQ test passes if the assembly of UDP packets is complete.
The test can be bypassed using the PMT control status.

Parameters

frame	data frame status
status	PMT control status

Returns: true if test passes; else false

Definition at line 70 of file JTriggerToolkit.hh.

   {
     return ((status.has(UDP_COUNTER_DISABLE) || (frame.getUDPNumberOfReceivedPackets() == frame.getUDPMaximalSequenceNumber() + 1))  &&
             (status.has(UDP_TRAILER_DISABLE) || (frame.hasUDPTrailer())));
   }

bool JTRIGGER::getDAQStatus	(	const JDAQFrameStatus &	frame,
		const JModule &	module,
		const int	pmt
	)

inline

Test status of DAQ.

The DAQ test passes if the assembly of UDP packets is complete.
The test can be bypassed using the PMT control status.

Parameters

frame	data frame status
module	module
pmt	PMT number

Returns: true if test passes; else false

Definition at line 88 of file JTriggerToolkit.hh.

   {
     return getDAQStatus(frame, module.getPMT(pmt));
   }

bool JTRIGGER::getPMTStatus ( const JStatus & status )

inline

Test status of PMT.

The PMT test passes if it is not disabled.

Parameters

status PMT control status

Returns: true if test passes; else false

Definition at line 102 of file JTriggerToolkit.hh.

   {
     return !status.has(PMT_DISABLE);
   }

bool JTRIGGER::getPMTStatus	(	const JDAQFrameStatus &	frame,
		const JStatus &	status,
		const int	pmt
	)

inline

Test status of PMT.

The PMT test passes if it is not disabled and no high-rate veto or FIFO (almost) full.
The test can be bypassed using the PMT control status.

Parameters

frame	data frame
status	PMT control status
pmt	PMT number

Returns: true if test passes; else false

Definition at line 119 of file JTriggerToolkit.hh.

   {
     return ((status.has(HIGH_RATE_VETO_DISABLE) || !frame.testHighRateVeto(pmt))   &&
             (status.has(FIFO_FULL_DISABLE)      || !frame.testFIFOStatus  (pmt))   &&
             (getPMTStatus(status)));
   }

bool JTRIGGER::getPMTStatus	(	const JDAQFrameStatus &	frame,
		const JModule &	module,
		const int	pmt
	)

inline

Test status of PMT.

The PMT test passes if it is not disabled and no high-rate veto or FIFO (almost) full.
The test can be bypassed using the PMT control status.

Parameters

frame	data frame
module	module
pmt	PMT number

Returns: true if test passes; else false

Definition at line 138 of file JTriggerToolkit.hh.

   {
     return getPMTStatus(frame, module.getPMT(pmt), pmt);
   }

double JTRIGGER::getRate	(	const JDAQSummaryFrame &	frame,
		const int	pmt,
		const double	factor = `1.0`
	)

inline

Get corrected rate of PMT.

The measured rate is corrected for the possible loss of UDP packets.

Parameters

frame	data frame
pmt	PMT number
factor	scaling factor

Returns: rate x scaling factor [Hz]

Definition at line 154 of file JTriggerToolkit.hh.

   {
     double rate_Hz = frame.getRate(pmt, factor);
 
     // correct measured rate for UDP packet loss
 
     const int n1  =  frame.getUDPNumberOfReceivedPackets();
     const int n2  =  frame.getUDPMaximalSequenceNumber  ();
 
     if (n1 < n2 + 1) {
       rate_Hz *= (double) (n2 + 1) / (double) n1;
     }
 
     return rate_Hz;
   }

Variable Documentation

struct JTRIGGER::clusterize JTRIGGER::clusterize

static

struct JTRIGGER::reverse_clusterize JTRIGGER::reverse_clusterize

static

struct JTRIGGER::clusterizeWeight JTRIGGER::clusterizeWeight

static

int JTRIGGER::MAXIMAL_FRAME_SIZE = std::numeric_limits<int>::max()

static

Maximal frame size.

Definition at line 32 of file JChecksum.hh.

const JChecksum JTRIGGER::checksum

static

Function object to perform check-sum of raw data.

Definition at line 176 of file JChecksum.hh.

const JGetRiseTime JTRIGGER::getRiseTime

static

Function object for rise time evaluation.

Definition at line 313 of file JGetRiseTime.hh.

const JModuleCounter JTRIGGER::getNumberOfModules

static

Function object to count unique modules.

Definition at line 67 of file JModuleCounter.hh.

const unsigned int JTRIGGER::NUMBER_OF_PMT_BITS = 31

static

Number of PMT bits.

Definition at line 35 of file JPMTMask.hh.

Classes

Typedefs

Functions

Variables

Detailed Description

Typedef Documentation

Function Documentation

Variable Documentation