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

#include <JTimesliceRouter.hh>

Inheritance diagram for JTRIGGER::JTimesliceRouter:

Classes
struct	pair_type
	Auxiliary structure for indexing hits in a data frame. More...

Public Types
typedef JTOOLS::JElement2D < double, pair_type >	element_type

typedef JTOOLS::JGridCollection < element_type >	grid_type

typedef JDAQTimeslice::const_iterator	const_iterator

typedef JTOOLS::JHashMap< int, int >	router_type

Public Member Functions
	JTimesliceRouter (const int numberOfBins)
	Constructor. More...

	JTimesliceRouter (const JDAQTimeslice &timeslice, const int numberOfBins)
	Constructor. More...

void	configure (const JDAQTimeslice &timeslice)
	Configure. More...

const int	getAddress (const JDAQModuleIdentifier &module) const
	Get address of module. More...

bool	hasSuperFrame (const JDAQModuleIdentifier &module) const
	Check presence of module. More...

const JDAQSuperFrame &	getSuperFrame (const JDAQModuleIdentifier &module) const
	Get super frame. More...

JDAQFrameSubset	getFrameSubset (const JDAQModuleIdentifier &module, const JTimeRange &timeRange) const
	Get subset of frame given module identifier and range of hit times. More...

virtual JClass_t *	get () const override
	Get pointer. More...

virtual void	set (JClass_t *p) override
	Set pointer. More...

template<class T >
void	set (const JPointer< T > &pointer)
	Set pointer. More...

virtual void	reset () override
	Reset pointer. More...

template<class T >
void	reset (const JPointer< T > &pointer)
	Reset pointer. More...

void	reset (JClass_t *p)
	Reset pointer. More...

JClass_t *const &	getReference () const
	Get rereference to internal pointer. More...

JClass_t *&	getReference ()
	Get rereference to internal pointer. More...

virtual bool	equals (const JAbstractPointer &object) const
	Equals. More...

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

JClass_t *	operator-> () const
	Smart pointer operator. More...

	operator JClass_t * () const
	Type conversion operator. More...

Public Attributes
const JDAQHit::JTDC_t	TMIN_NS
	minimal TDC value More...

const JDAQHit::JTDC_t	TMAX_NS
	maximal TDC value More...

const JDAQHit	DAQHIT_MIN
	begin hit marker More...

const JDAQHit	DAQHIT_MAX
	end hit marker More...

Protected Attributes
int	numberOfBins

JClass_t *	__p
	pointer to object More...

Private Attributes
router_type	router

std::vector< grid_type >	table

Detailed Description

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

Note that the data in a frame from the same PMT are time ordered but the data from different PMTs are not necessarily time orderd.
The fast routing is based on the assumption that the time difference between consecutive hits in the same frame is limited.
The access speed is then determined by this time difference.

The time slice router class comprises two internal look-up tables:

The first table consists of a one dimensional look-up table which is is used to map the module identifier to the index of the corresponding data frame in the time slice.
The second table consists of a two dimensional array. In this, the first index of matches with the index of the corresponding data frame in the time slice. Each first index is mapped to a one dimensional look-up table. This one dimensional look-up table maps an uncalibrated time t1 to a pair of indices (lpos,rpos), where:
1. lpos is the index of the first hit in the data frame with time >= t1;
2. rpos is the index of the last hit in the data frame with time < t1;

Definition at line 91 of file JTimesliceRouter.hh.

Member Typedef Documentation

typedef JTOOLS::JElement2D<double, pair_type> JTRIGGER::JTimesliceRouter::element_type

Definition at line 103 of file JTimesliceRouter.hh.

typedef JTOOLS::JGridCollection<element_type> JTRIGGER::JTimesliceRouter::grid_type

Definition at line 104 of file JTimesliceRouter.hh.

typedef JDAQTimeslice::const_iterator JTRIGGER::JTimesliceRouter::const_iterator

Definition at line 105 of file JTimesliceRouter.hh.

typedef JTOOLS::JHashMap<int, int> JTRIGGER::JTimesliceRouter::router_type

Definition at line 106 of file JTimesliceRouter.hh.

Constructor & Destructor Documentation

JTRIGGER::JTimesliceRouter::JTimesliceRouter ( const int numberOfBins )

inline

Constructor.

Parameters

numberOfBins number of bins of the hit look-up table

Definition at line 114 of file JTimesliceRouter.hh.

                                              :
       JTimesliceRouter_t(numberOfBins)
     {}

JTRIGGER::JTimesliceRouter::JTimesliceRouter	(	const JDAQTimeslice &	timeslice,
		const int	numberOfBins
	)

inline

Constructor.

Parameters

timeslice	timeslice
numberOfBins	number of bins of the hit look-up table

Definition at line 125 of file JTimesliceRouter.hh.

                                                         :
       JTimesliceRouter_t(numberOfBins)
     {
       configure(timeslice);
     }

Member Function Documentation

void JTRIGGER::JTimesliceRouter::configure ( const JDAQTimeslice & timeslice )

inline

Configure.

Note that method reset should be called used after use.

Parameters

timeslice timeslice

Definition at line 140 of file JTimesliceRouter.hh.

     {
       using namespace std;
       using namespace JPP;
       using namespace KM3NETDAQ;
 
       typedef std::vector<JDAQHit::JTDC_t>               buffer_type;
       typedef std::vector<JDAQHit>                       frame_type;
 
 
       router.clear();
 
       this->set(&timeslice);
 
       for (const_iterator i = this->get()->begin(); i != this->get()->end(); ++i) {
 
         if (router.has(i->getModuleID())) {
           THROW(JTriggerException, "Multiple data from module " << i->getModuleID());
         }
 
         router.put(i->getModuleID(), distance(this->get()->begin(), i));
       }
 
 
       // setup grid
 
       int number_of_elements = 2;
 
       for (const_iterator i = this->get()->begin(); i != this->get()->end(); ++i) {
         if (i->size() > number_of_elements) {
           number_of_elements = i->size();
         }
       }
 
       if (numberOfBins > 1 && numberOfBins + 1 < number_of_elements) {
         number_of_elements = numberOfBins + 1;
       }
 
       double Tmin_ns = getTimeSinceRTS(this->get()->getFrameIndex()) - 0.05 * getFrameTime();    // [ns]
       double Tmax_ns = getTimeSinceRTS(this->get()->getFrameIndex()) + 1.05 * getFrameTime();    // [ns]
 
       if (Tmin_ns < TMIN_NS) { Tmin_ns = TMIN_NS; }
       if (Tmax_ns > TMAX_NS) { Tmax_ns = TMAX_NS; }
 
       const JGrid<double> bounds(number_of_elements, Tmin_ns, Tmax_ns);       // grid of abscissa values for lookup of hit indices based on time
 
 
       buffer_type limits(bounds.getSize() + 1);                               // abscissa values of grid with proper data type
 
       for (int i = 0; i != bounds.getSize(); ++i) {
         limits[i] = (JDAQHit::JTDC_t) bounds.getX(i);
       }
 
       limits[bounds.getSize()] = TMAX_NS;                                     // this will make rpos refer to the next abscissa value in grid
 
 
       table.resize(this->get()->size());                                      // lookup table with same indexing as current time slice
 
       frame_type buffer;                                                      // copy of raw data with additional begin and end marker
 
       vector<grid_type>::iterator grid = table.begin();
 
       for (const_iterator frame = this->get()->begin(); frame != this->get()->end(); ++frame, ++grid) {
 
         grid->configure(bounds);
 
         if (!frame->empty()) {
 
           buffer.resize(frame->size() + 2);                                   // reserve space for begin and end marker
 
           copy(frame->begin(), frame->end(), buffer.begin() + 1);
 
           *buffer. begin() = DAQHIT_MIN;                                      // begin marker
           *buffer.rbegin() = DAQHIT_MAX;                                      // end   markr
 
           {
             frame_type ::const_iterator hit = buffer.begin(); ++hit;          // skip begin marker
             buffer_type::const_iterator t1  = limits.begin();                 // corresponds to index in grid
 
             for (grid_type::iterator i = grid->begin(); i != grid->end(); ++i, ++t1) {
             
               while (hit->getT() < *t1) { ++hit; }
               
               i->getY().lpos = distance(buffer.cbegin(), hit)        - 1;     // correct distance for begin marker
             }
           }
 
           {
             frame_type ::const_reverse_iterator hit = buffer.rbegin(); ++hit; // skip end marker
             buffer_type::const_reverse_iterator t1  = limits.rbegin();        // corresponds to index in grid plus one
 
             for (grid_type::reverse_iterator i = grid->rbegin(); i != grid->rend(); ++i, ++t1) {
                 
               while (hit->getT() >= *t1) { ++hit; }
               
               i->getY().rpos = distance(buffer.cbegin(), hit.base()) - 1;     // correct distance for begin marker
             }
           }
         }
       }
     }

const int JTRIGGER::JTimesliceRouter::getAddress ( const JDAQModuleIdentifier & module ) const

inline

Get address of module.

Parameters

module module

Returns: address

Definition at line 249 of file JTimesliceRouter.hh.

     {
       return router.get(module.getModuleID());
     }

bool JTRIGGER::JTimesliceRouter::hasSuperFrame ( const JDAQModuleIdentifier & module ) const

inline

Check presence of module.

Parameters

module module

Returns: true if module present; else false

Definition at line 261 of file JTimesliceRouter.hh.

     {
       return router.has(module.getModuleID());
     }

const JDAQSuperFrame& JTRIGGER::JTimesliceRouter::getSuperFrame ( const JDAQModuleIdentifier & module ) const

inline

Get super frame.

Parameters

module module

Returns: super frame

Definition at line 273 of file JTimesliceRouter.hh.

     {
       return (*(this->get()))[this->getAddress(module)];
     }

JDAQFrameSubset JTRIGGER::JTimesliceRouter::getFrameSubset	(	const JDAQModuleIdentifier &	module,
		const JTimeRange &	timeRange
	)		const

inline

Get subset of frame given module identifier and range of hit times.

Note that the hit times should have been corrected for the maximal and minimal time offsets of the PMTs in the corresponding optical module.

Parameters

module	module
timeRange	time range [ns]

Returns: subset with begin and end iterators

Definition at line 289 of file JTimesliceRouter.hh.

     {
       const int address = this->getAddress(module);
 
       const grid_type&      grid  = table           [address];
       const JDAQSuperFrame& frame = (*(this->get()))[address];
 
       const int first  = grid.getIndex(timeRange.getLowerLimit());
       const int second = grid.getIndex(timeRange.getUpperLimit());
 
       if (first < 0 || second >= grid.getSize()) {
         THROW(JTriggerException, "Time range [ns] " << timeRange << " bounds " << grid.getXmin() << ' ' << grid.getXmax() << " indices " << first << ' ' << second);
       }
 
       return frame.subset(grid.getY(first).lpos, grid.getY(second).rpos);
     }

template<class JClass_t>

virtual JClass_t* JLANG::JPointer< JClass_t >::get ( ) const

inlineoverridevirtualinherited

Get pointer.

Returns: pointer to object

Implements JLANG::JAbstractPointer< JClass_t >.

Reimplemented in JLANG::JMultiPointer< JTypeList< JHead_t, JTail_t > >, JLANG::JMultiPointer< JClass_t >, JLANG::JMultiPointer< JTail_t >, JLANG::JMultiPointer< JHead_t >, JLANG::JMultiPointer< T >, and JLANG::JMultiPointer< JTypeList< JDAQEvent, JTypelist_t > >.

Definition at line 64 of file JPointer.hh.

     {
       return this->__p;
     }

template<class JClass_t>

virtual void JLANG::JPointer< JClass_t >::set ( JClass_t * p )

inlineoverridevirtualinherited

Set pointer.

Parameters

p	pointer to object

Implements JLANG::JAbstractPointer< JClass_t >.

Definition at line 75 of file JPointer.hh.

     {
       this->__p = p;
     }

template<class JClass_t>

template<class T >

void JLANG::JPointer< JClass_t >::set ( const JPointer< T > & pointer )

inlineinherited

Set pointer.

Parameters

pointer pointer to object

Definition at line 96 of file JPointer.hh.

     {
       this->set(pointer.get());
     }

template<class JClass_t>

virtual void JLANG::JPointer< JClass_t >::reset ( )

inlineoverridevirtualinherited

Reset pointer.

Implements JLANG::JAbstractPointer< JClass_t >.

Definition at line 84 of file JPointer.hh.

     { 
       this->__p = NULL;
     }

template<class JClass_t>

template<class T >

void JLANG::JPointer< JClass_t >::reset ( const JPointer< T > & pointer )

inlineinherited

Reset pointer.

Parameters

pointer pointer to object

Definition at line 108 of file JPointer.hh.

     {
       this->reset(pointer.get());
     }

template<class JClass_t>

void JLANG::JAbstractPointer< JClass_t >::reset ( JClass_t * p )

inlineinherited

Reset pointer.

Parameters

p	pointer to object

Definition at line 94 of file JAbstractPointer.hh.

     {
       if (this->get() != p) {
 
         this->reset();
 
         if (p != NULL) {
           this->set(p);
         }
       }
     }

template<class JClass_t>

JClass_t* const& JLANG::JPointer< JClass_t >::getReference ( ) const

inlineinherited

Get rereference to internal pointer.

Returns: reference to internal pointer

Definition at line 119 of file JPointer.hh.

     {
       return __p;
     }

template<class JClass_t>

JClass_t* & JLANG::JPointer< JClass_t >::getReference ( )

inlineinherited

Get rereference to internal pointer.

Returns: reference to internal pointer

Definition at line 130 of file JPointer.hh.

     {
       return __p;
     }

template<class JClass_t>

virtual bool JLANG::JAbstractPointer< JClass_t >::equals ( const JAbstractPointer< JClass_t > & object ) const

inlinevirtualinherited

Equals.

The equality is evaluated by comparison of the internal pointers.

Parameters

object abstract pointer

Returns: true if equals; else false

Definition at line 50 of file JAbstractPointer.hh.

     {
       return this->get() == object.get();
     }

template<class JClass_t>

bool JLANG::JAbstractPointer< JClass_t >::is_valid ( ) const

inlineinherited

Check validity of pointer.

Returns: true if pointer not null; else false

Definition at line 83 of file JAbstractPointer.hh.

     { 
       return this->get() != NULL; 
     }

template<class JClass_t>

JClass_t* JLANG::JAbstractPointer< JClass_t >::operator-> ( ) const

inlineinherited

Smart pointer operator.

Returns: pointer to object

Definition at line 112 of file JAbstractPointer.hh.

     { 
       if (!is_valid())
         throw JNullPointerException("JAbstractPointer::operator->()");
       else
         return this->get();
     }

template<class JClass_t>

JLANG::JAbstractPointer< JClass_t >::operator JClass_t * ( ) const

inlineinherited

Type conversion operator.

Returns: pointer to object

Definition at line 126 of file JAbstractPointer.hh.

     {
       return this->get();
     }

Member Data Documentation

router_type JTRIGGER::JTimesliceRouter::router

private

Definition at line 307 of file JTimesliceRouter.hh.

std::vector<grid_type> JTRIGGER::JTimesliceRouter::table

private

Definition at line 308 of file JTimesliceRouter.hh.

const JDAQHit::JTDC_t JTRIGGER::JTimesliceRouter_t::TMIN_NS

inherited

minimal TDC value

Definition at line 56 of file JTimesliceRouter.hh.

const JDAQHit::JTDC_t JTRIGGER::JTimesliceRouter_t::TMAX_NS

inherited

maximal TDC value

Definition at line 57 of file JTimesliceRouter.hh.

const JDAQHit JTRIGGER::JTimesliceRouter_t::DAQHIT_MIN

inherited

begin hit marker

Definition at line 59 of file JTimesliceRouter.hh.

const JDAQHit JTRIGGER::JTimesliceRouter_t::DAQHIT_MAX

inherited

end hit marker

Definition at line 60 of file JTimesliceRouter.hh.

int JTRIGGER::JTimesliceRouter_t::numberOfBins

protectedinherited

Definition at line 63 of file JTimesliceRouter.hh.

template<class JClass_t>

JClass_t* JLANG::JPointer< JClass_t >::__p

protectedinherited

pointer to object

Definition at line 136 of file JPointer.hh.

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

JTimesliceRouter.hh

Classes

Public Types

Public Member Functions

Public Attributes

Protected Attributes

Private Attributes

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation