Template L2 builder. More...

#include <JBuildL2.hh>

Inheritance diagram for JTRIGGER::JBuildL2< JHit_t >:

Public Types
typedef JHit_t	value_type

typedef JMatch< value_type >	match_type

Public Member Functions
	JBuildL2 (const JL2Parameters &parameters)
	Constructor. More...

template<class JOutput_t >
void	operator() (const JSuperFrame2D< JHit_t > &inputL0, const std::vector< JHit_t > &inputL1, JOutput_t out) const
	Build hits from calibrated data. More...

template<class JOutput_t >
void	operator() (const JSuperFrame2D< JHit_t > &inputL0, JOutput_t out) const
	Build hits from calibrated data. More...

template<class JOutput_t >
void	operator() (const JDAQSuperFrame &input, const JModule &module, JOutput_t out) const
	Build hits from DAQ data. More...

void	reset ()
	Reset L2 parameters. More...

bool	equals (const JL2Parameters &parameters) const
	Equality. More...

bool	is_valid () const
	Check validity. More...

	ClassDef (JL2Parameters, 1)

template<class JOutput_t >
void	operator() (typename JSuperFrame2D< JHit_t >::const_iterator __begin, typename JSuperFrame2D< JHit_t >::const_iterator __end, JOutput_t out) const
	Build hits from set of frames with calibrated data. More...

template<class JOutput_t >
void	operator() (const JSuperFrame1D< JHit_t > &input, JOutput_t out) const
	Build hits from calibrated data. More...

void	operator() (const JDAQTimeslice &timeslice, const JModuleRouter &router, JOutput_t out) const
	Build hits from uncalibrated DAQ data. More...

void	operator() (const JDAQEvent &event, const JModuleRouter &router, bool snapshot, JOutput_t out) const
	Build hits from uncalibrated DAQ data. More...

void	operator() (const JDAQEvent &event, const JModuleRouter &router, JOutput_t out) const
	Build hits from uncalibrated DAQ data. More...

void	setPreprocessor (const JPreprocessor::JOption_t option, const match_type &match)
	Set pre-processor. More...

JSuperFrame2D< JHit_t > &	demultiplex (const JDAQSuperFrame &input, const JModule &module) const
	Demultiplex and pre-process DAQ super frame. More...

void	operator() (const JDAQTimeslice &timeslice, const JModuleRouter &router, JOutput_t out) const
	Build hits from uncalibrated DAQ data. More...

void	operator() (const JDAQEvent &event, const JModuleRouter &router, bool snapshot, JOutput_t out) const
	Build hits from uncalibrated DAQ data. More...

void	operator() (const JDAQEvent &event, const JModuleRouter &router, JOutput_t out) const
	Build hits from uncalibrated DAQ data. More...

Public Attributes
int	numberOfHits
	minimal number of hits More...

double	TMaxLocal_ns
	maximal time difference [ns] More...

double	ctMin
	minimal cosine space angle between PMT axes More...

double	TMax_ns

bool	combine

JPreprocessor::JOption_t	option
	pre-processor option More...

JLANG::JSharedPointer< match_type >	match
	match criterion More...

Protected Member Functions
bool	isL2 (const JSuperFrameClone2D< JHit_t > &clone, const JHit_t &hit) const
	Test if requirements for given hit are satisfied. More...

Protected Attributes
std::vector< JHit_t >	bufferL1

Detailed Description

template<class JHit_t>
class JTRIGGER::JBuildL2< JHit_t >

Template L2 builder.

An L2 hit is a local coincidence between two or more hits from different PMTs within the same optical module satisfying:

minimal number of hits requirement;
maximal time difference between hits; and
maximal space angle requirement between the PMT axes.

Definition at line 45 of file JBuildL2.hh.

Member Typedef Documentation

◆ value_type

template<class JHit_t>

typedef JHit_t JTRIGGER::JBuildL2< JHit_t >::value_type

Definition at line 54 of file JBuildL2.hh.

◆ match_type

template<class JHit_t>

typedef JMatch<value_type> JTRIGGER::JBuild< JHit_t >::match_type

inherited

Definition at line 34 of file JBuild.hh.

Constructor & Destructor Documentation

◆ JBuildL2()

template<class JHit_t>

JTRIGGER::JBuildL2< JHit_t >::JBuildL2 ( const JL2Parameters & parameters )

inline

Constructor.

Parameters

parameters L2 parameters

Definition at line 62 of file JBuildL2.hh.

                                               :
       JL2Parameters   (parameters),
       JBuildL1<JHit_t>(parameters)
     {}

Member Function Documentation

◆ operator()() [1/11]

template<class JHit_t>

template<class JOutput_t >

void JTRIGGER::JBuildL2< JHit_t >::operator()	(	const JSuperFrame2D< JHit_t > &	inputL0,
		const std::vector< JHit_t > &	inputL1,
		JOutput_t	out
	)		const

inline

Build hits from calibrated data.

Only the input hits that satisfy the predefined requirements are copied from input to output.
The requirements are checked using the calibrated data of each PMT inside the same module. The input data should be time sorted. The output data are time sorted.

Parameters

inputL0	input L0 data
inputL1	input L1 data
out	output L2 data

Definition at line 81 of file JBuildL2.hh.

     {
       const JSuperFrameClone2D<JHit_t> clone(inputL0);
  
       for (typename std::vector<JHit_t>::const_iterator p = inputL1.begin(); p != inputL1.end(); ++p) {
  
         clone.fast_forward(*p);
  
         if (isL2(clone,*p)) {
           *out = *p;
           ++out;
         }
       }
     }

◆ operator()() [2/11]

template<class JHit_t>

template<class JOutput_t >

void JTRIGGER::JBuildL2< JHit_t >::operator()	(	const JSuperFrame2D< JHit_t > &	inputL0,
		JOutput_t	out
	)		const

inline

Build hits from calibrated data.

The calibrated data of each PMT inside the optical module are used to build L2 coincidences. The predefined requirements are then checked using the same calibrated data of each PMT. The output data are time sorted.

Parameters

inputL0	input L0 data
out	output L2 data

Definition at line 110 of file JBuildL2.hh.

     {
       bufferL1.clear();
  
       static_cast<const JBuildL1<JHit_t>&>(*this)(inputL0, std::back_inserter(bufferL1));
  
       (*this)(inputL0, bufferL1, out);
     }

◆ operator()() [3/11]

template<class JHit_t>

template<class JOutput_t >

void JTRIGGER::JBuildL2< JHit_t >::operator()	(	const JDAQSuperFrame &	input,
		const JModule &	module,
		JOutput_t	out
	)		const

inline

Build hits from DAQ data.

The time calibration is applied and the requirements are applied to the calibrated data. The output data are time sorted.

Parameters

input	DAQ super frame
module	module
out	output L2 data

Definition at line 131 of file JBuildL2.hh.

     {
       if (!input.empty()) {
         (*this)(this->demultiplex(input, module), out);
       }
     }

◆ isL2()

template<class JHit_t>

bool JTRIGGER::JBuildL2< JHit_t >::isL2	(	const JSuperFrameClone2D< JHit_t > &	clone,
		const JHit_t &	hit
	)		const

inlineprotected

Test if requirements for given hit are satisfied.

The internal iterators of the cloned L0 data should be set before this test operation.

Parameters

clone	L0 data
hit	L1 hit

Returns: true is L2 condition is satisfied; else false

Definition at line 149 of file JBuildL2.hh.

     {
       using namespace JPP;
  
       for (typename JSuperFrameClone2D<JHit_t>::const_iterator i = clone.begin(); i != clone.end(); ++i) {
         
         if (this->getTimeDifference(hit,*(i->get())) <= TMaxLocal_ns) {
           
           int n = 1;
  
           for (typename JSuperFrameClone2D<JHit_t>::const_iterator j = i; ++j != clone.end(); ) {
             
             if (this->getTimeDifference(hit,*(j->get())) <= TMaxLocal_ns) {
               
               if (getDot(i->getDirection(), j->getDirection()) >= ctMin) {
                 
                 if (++n >= numberOfHits) {
                   return true;
                 }
               }
             }
           }
         }
       }
  
       return false;
     }

◆ reset()

void JTRIGGER::JL2Parameters::reset ( )

inlineinherited

Reset L2 parameters.

Definition at line 72 of file JTriggerParameters.hh.

     {
       numberOfHits = 0;
       TMaxLocal_ns = 0.0;
       ctMin        = 1.0;
     }

◆ equals()

bool JTRIGGER::JL2Parameters::equals ( const JL2Parameters & parameters ) const

inlineinherited

Equality.

Parameters

parameters L2 parameters

Returns: true if equals; else false

Definition at line 86 of file JTriggerParameters.hh.

     {
       return (this->numberOfHits == parameters.numberOfHits &&
               this->TMaxLocal_ns == parameters.TMaxLocal_ns &&
               this->ctMin        == parameters.ctMin);
     }

◆ is_valid()

bool JTRIGGER::JL2Parameters::is_valid ( ) const

inlineinherited

Check validity.

Returns: true if not-equal to default value; else false

Definition at line 99 of file JTriggerParameters.hh.

     {
       return !this->equals(JL2Parameters());
     }

◆ ClassDef()

JTRIGGER::JL2Parameters::ClassDef	(	JL2Parameters	,
		1
	)

inherited

◆ operator()() [4/11]

template<class JHit_t>

template<class JOutput_t >

void JTRIGGER::JBuildL1< JHit_t >::operator()	(	typename JSuperFrame2D< JHit_t >::const_iterator	__begin,
		typename JSuperFrame2D< JHit_t >::const_iterator	__end,
		JOutput_t	out
	)		const

inlineinherited

Build hits from set of frames with calibrated data.

The output data are time sorted.

Parameters

__begin	begin of input L0 data
__end	end of input L0 data
out	output L1 data

Definition at line 133 of file JBuildL1.hh.

     {
       (*this)(JSuperFrame1D<JHit_t>::multiplex(__begin, __end), out);
     }

◆ operator()() [5/11]

template<class JHit_t>

template<class JOutput_t >

void JTRIGGER::JBuildL1< JHit_t >::operator()	(	const JSuperFrame1D< JHit_t > &	input,
		JOutput_t	out
	)		const

inlineinherited

Build hits from calibrated data.

The output data are time sorted.

Parameters

input	input L0 data
out	output L1 data

Definition at line 150 of file JBuildL1.hh.

     {
       int n = input.size() - 1;  // remove end marker
  
       for (typename JSuperFrame1D<JHit_t>::const_iterator q = input.begin(), p = q++; n != 0; ++q, --n) {
           
         if (this->getTimeDifference(*p,*q) <= TMax_ns) {
           
           *out = *p;
           ++out;
           
           if (combine) {
             for (++q, --n; this->getTimeDifference(*p,*q) <= TMax_ns; ++q, --n) {}
           }
         }
         
         p = q;
       }
     }

◆ operator()() [6/11]

void JTRIGGER::JBuildHelper< JBuildL1< JHit_t > >::operator()	(	const JDAQTimeslice &	timeslice,
		const JModuleRouter &	router,
		JOutput_t	out
	)		const

inlineinherited

Build hits from uncalibrated DAQ data.

The time calibration is applied. Note that the output data are not time sorted.

Parameters

timeslice	DAQ time slice
router	module router
out	output data

Definition at line 57 of file JBuildHelper.hh.

     {
       for (JDAQTimeslice::const_iterator i = timeslice.begin(); i != timeslice.end(); ++i) {
         if (router.hasModule(i->getModuleID())) {
           static_cast<const JBuild_t&>(*this)(*i, router.getModule(i->getModuleID()), out);
         }
       }
     }

◆ operator()() [7/11]

void JTRIGGER::JBuildHelper< JBuildL1< JHit_t > >::operator()	(	const JDAQEvent &	event,
		const JModuleRouter &	router,
		bool	snapshot,
		JOutput_t	out
	)		const

inlineinherited

Build hits from uncalibrated DAQ data.

The time calibration is applied. Note that the output data are not time sorted.

Parameters

event	DAQ event
router	module router
snapshot	use shapshot hits (else use triggered hits)
out	output data

Definition at line 81 of file JBuildHelper.hh.

     {
       static_cast<const JBuild_t&>(*this)(JDAQTimeslice(event, snapshot), router, out);
     }

◆ operator()() [8/11]

void JTRIGGER::JBuildHelper< JBuildL1< JHit_t > >::operator()	(	const JDAQEvent &	event,
		const JModuleRouter &	router,
		JOutput_t	out
	)		const

inlineinherited

Build hits from uncalibrated DAQ data.

The snapshot data of the DAQ event are used. The time calibration is applied. Note that the output data are not time sorted.

Parameters

event	DAQ event
router	module router
out	output data

Definition at line 102 of file JBuildHelper.hh.

     {
       static_cast<const JBuild_t&>(*this)(JDAQTimeslice(event, true), router, out);
     }

◆ setPreprocessor()

template<class JHit_t>

void JTRIGGER::JBuild< JHit_t >::setPreprocessor	(	const JPreprocessor::JOption_t	option,
		const match_type &	match
	)

inlineinherited

Set pre-processor.

Parameters

option	option
match	match criterion

Definition at line 52 of file JBuild.hh.

     {
       this->option = option;
       this->match.reset(match.clone());
     }

◆ demultiplex()

template<class JHit_t>

JSuperFrame2D<JHit_t>& JTRIGGER::JBuild< JHit_t >::demultiplex	(	const JDAQSuperFrame &	input,
		const JModule &	module
	)		const

inlineinherited

Demultiplex and pre-process DAQ super frame.

Parameters

input	DAQ super frame
module	module data

Returns: 2D super frame

Definition at line 66 of file JBuild.hh.

     {
       JSuperFrame2D<JHit_t>& buffer = JSuperFrame2D<JHit_t>::demultiplex(input, module);
  
       if (match.is_valid()) {
         buffer.preprocess(option, *match);
       }
  
       return buffer;
     }

◆ operator()() [9/11]

void JTRIGGER::JBuildHelper< JBuildL2< JHit_t > >::operator()	(	const JDAQTimeslice &	timeslice,
		const JModuleRouter &	router,
		JOutput_t	out
	)		const

inlineinherited

Build hits from uncalibrated DAQ data.

The time calibration is applied. Note that the output data are not time sorted.

Parameters

timeslice	DAQ time slice
router	module router
out	output data

Definition at line 57 of file JBuildHelper.hh.

     {
       for (JDAQTimeslice::const_iterator i = timeslice.begin(); i != timeslice.end(); ++i) {
         if (router.hasModule(i->getModuleID())) {
           static_cast<const JBuild_t&>(*this)(*i, router.getModule(i->getModuleID()), out);
         }
       }
     }

◆ operator()() [10/11]

void JTRIGGER::JBuildHelper< JBuildL2< JHit_t > >::operator()	(	const JDAQEvent &	event,
		const JModuleRouter &	router,
		bool	snapshot,
		JOutput_t	out
	)		const

inlineinherited

Build hits from uncalibrated DAQ data.

The time calibration is applied. Note that the output data are not time sorted.

Parameters

event	DAQ event
router	module router
snapshot	use shapshot hits (else use triggered hits)
out	output data

Definition at line 81 of file JBuildHelper.hh.

     {
       static_cast<const JBuild_t&>(*this)(JDAQTimeslice(event, snapshot), router, out);
     }

◆ operator()() [11/11]

void JTRIGGER::JBuildHelper< JBuildL2< JHit_t > >::operator()	(	const JDAQEvent &	event,
		const JModuleRouter &	router,
		JOutput_t	out
	)		const

inlineinherited

Build hits from uncalibrated DAQ data.

The snapshot data of the DAQ event are used. The time calibration is applied. Note that the output data are not time sorted.

Parameters

event	DAQ event
router	module router
out	output data

Definition at line 102 of file JBuildHelper.hh.

     {
       static_cast<const JBuild_t&>(*this)(JDAQTimeslice(event, true), router, out);
     }

Member Data Documentation

◆ bufferL1

template<class JHit_t>

std::vector<JHit_t> JTRIGGER::JBuildL2< JHit_t >::bufferL1

mutableprotected

Definition at line 178 of file JBuildL2.hh.

◆ numberOfHits

int JTRIGGER::JL2Parameters::numberOfHits

inherited

minimal number of hits

Definition at line 107 of file JTriggerParameters.hh.

◆ TMaxLocal_ns

double JTRIGGER::JL2Parameters::TMaxLocal_ns

inherited

maximal time difference [ns]

Definition at line 108 of file JTriggerParameters.hh.

◆ ctMin

double JTRIGGER::JL2Parameters::ctMin

inherited

minimal cosine space angle between PMT axes

Definition at line 109 of file JTriggerParameters.hh.

◆ TMax_ns

double JTRIGGER::JBuildL1Parameters::TMax_ns

inherited

Definition at line 74 of file JBuildL1.hh.

◆ combine

bool JTRIGGER::JBuildL1Parameters::combine

inherited

Definition at line 75 of file JBuildL1.hh.

◆ option

template<class JHit_t>

JPreprocessor::JOption_t JTRIGGER::JBuild< JHit_t >::option

inherited

pre-processor option

Definition at line 78 of file JBuild.hh.

◆ match

template<class JHit_t>

JLANG::JSharedPointer<match_type> JTRIGGER::JBuild< JHit_t >::match

inherited

match criterion

Definition at line 79 of file JBuild.hh.

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

JBuildL2.hh

Public Types

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

template<class JHit_t> class JTRIGGER::JBuildL2< JHit_t >

Member Typedef Documentation

◆ value_type

◆ match_type

Constructor & Destructor Documentation

◆ JBuildL2()

Member Function Documentation

◆ operator()() [1/11]

◆ operator()() [2/11]

◆ operator()() [3/11]

◆ isL2()

◆ reset()

◆ equals()

◆ is_valid()

◆ ClassDef()

◆ operator()() [4/11]

◆ operator()() [5/11]

◆ operator()() [6/11]

◆ operator()() [7/11]

◆ operator()() [8/11]

◆ setPreprocessor()

◆ demultiplex()

◆ operator()() [9/11]

◆ operator()() [10/11]

◆ operator()() [11/11]

Member Data Documentation

◆ bufferL1

◆ numberOfHits

◆ TMaxLocal_ns

◆ ctMin

◆ TMax_ns

◆ combine

◆ option

◆ match

template<class JHit_t>
class JTRIGGER::JBuildL2< JHit_t >