KM3NETDAQ::JRandomTimeslice Struct Reference

Timeslice with random data. More...

#include <JRandomTimeslice.hh>

Inheritance diagram for KM3NETDAQ::JRandomTimeslice:

Classes
struct	random_indices_t
	Auxiliary data structure for randomisation of indices. More...

Public Member Functions
	JRandomTimeslice ()
	Default constructor.
	JRandomTimeslice (const JDAQChronometer &chronometer, const JDetectorSimulator &simbad)
	Constructor.
void	recycle (const double T_ns)
	Recycle time slice by randomly shuffling time intervals of data.
	ClassDef (JDAQTimesliceL0, 1)
	ClassDef (JDAQTimeslice, 4)
	ClassDef (JDAQPreamble, 1)
	ClassDef (JDAQTimesliceHeader, 2)
	ClassDef (JDAQHeader, 2)
	ClassDef (JDAQChronometer, 3)
void	clear ()
	Clear data.
JDAQTimeslice &	add (const JDAQTimeslice &timeslice)
	Add another timeslice.
std::ostream &	print (std::ostream &out, const bool lpr=false) const
	Print DAQ Timeslice.
int	getLength () const
	Get length.
int	getDataType () const
	Get data type.
	ClassDefNV (JDAQAbstractPreamble, 1)
const JDAQTimesliceHeader &	getDAQTimesliceHeader () const
	Get DAQ time slice header.
const JDAQHeader &	getDAQHeader () const
	Get DAQ header.
void	setDAQHeader (const JDAQHeader &header)
	Set DAQ header.
const JDAQChronometer &	getDAQChronometer () const
	Get DAQ chronometer.
void	setDAQChronometer (const JDAQChronometer &chronometer)
	Set DAQ chronometer.
int	getDetectorID () const
	Get detector identifier.
int	getRunNumber () const
	Get run number.
int	getFrameIndex () const
	Get frame index.
JDAQUTCExtended	getTimesliceStart () const
	Get start of timeslice.
void	setRunNumber (const int run)
	Set run number.
void	setFrameIndex (const int frame_index)
	Set frame index.
void	setTimesliceStart (const JDAQUTCExtended &timeslice_start)
	Set timeslice start time.

Static Public Member Functions
template<class T >
static JDAQPreamble	getDAQPreamble (const T &object)
	Get DAQ preamble.

Protected Attributes
int	length
int	type
int	detector_id
int	run
int	frame_index
JDAQUTCExtended	timeslice_start

Detailed Description

Timeslice with random data.

Definition at line 31 of file JRandomTimeslice.hh.

Constructor & Destructor Documentation

JRandomTimeslice() [1/2]

KM3NETDAQ::JRandomTimeslice::JRandomTimeslice ( )

inline

Default constructor.

Definition at line 37 of file JRandomTimeslice.hh.

    {}

JRandomTimeslice() [2/2]

KM3NETDAQ::JRandomTimeslice::JRandomTimeslice ( const JDAQChronometer & chronometer, const JDetectorSimulator & simbad )

inline

Constructor.

Parameters

chronometer	chronometer
simbad	detector simulator

Definition at line 47 of file JRandomTimeslice.hh.

    {
      using namespace JPP;
 
      setDAQChronometer(chronometer);
 
      if (simbad.hasK40Simulator() &&
          simbad.hasPMTSimulator() &&
          simbad.hasCLBSimulator()) {
 
        const double     Tmin = getTimeSinceRTS(chronometer.getFrameIndex());   // [ns]
 
        const JTimeRange period(Tmin, Tmin + getFrameTime());                   // [ns]
        
        JModuleData buffer;
        
        for (JDetector::const_iterator module = simbad->begin(); module != simbad->end(); ++module) {
 
          if (!module->empty() && simbad.getCLBSimulator().hasCLB(module->getID())) {
 
            buffer.reset(module->size());
 
            simbad.generateHits(*module, period, buffer);
 
            this->push_back(JDAQSuperFrame(JDAQSuperFrameHeader(chronometer, module->getID())));
 
            simbad(*module, buffer, *(this->rbegin()));
          }
        }
      }
    }

Member Function Documentation

recycle()

void KM3NETDAQ::JRandomTimeslice::recycle ( const double T_ns )

inline

Recycle time slice by randomly shuffling time intervals of data.

Hits within one time interval are swapped with hits within another -randomly selected- time interval.
Time intervals in which a high-rate veto occurred are excluded.

Note that the time interval should be:

• (much) larger than time differences of hits in L1 coincidence; and
• (much) smaller than time covered by data (as per KM3NETDAQ::getFrameTime()).

Parameters

T_ns	time interval

Definition at line 93 of file JRandomTimeslice.hh.

    {
      using namespace std;
      using namespace JPP;
 
      typedef vector<JDAQHit>  buffer_type;
      typedef JDAQHit::JTDC_t  JTDC_t;
 
      size_t N = (size_t) (getFrameTime() / T_ns + 0.5);         // number of time intervals
 
      if (N <   100) { N =   100; }                              // allow to keep indices at time of high-rate veto
      if (N > 50000) { N = 50000; }                              // maximum expected number of hits due to high-rate veto
 
      const JTDC_t Ts = (JTDC_t) (getFrameTime() / N);           // TDC interval
 
      random_indices_t    index (N);                             // indices of time intervals for swapping
      vector<buffer_type> buffer(N);                             // data per time interval
 
      for (iterator frame = this->begin(); frame != this->end(); ++frame) {
 
        if (!frame->empty()) {
 
          for (size_t i = 0; i != N; ++i) {
            buffer[i].clear();
          }
 
          // store data per time interval
          
          vector<JTDC_t> T_max(NUMBER_OF_PMTS,
                               numeric_limits<JTDC_t>::max());   // maximal time per PMT, e.g. due to high-rate veto
 
          for (JDAQSuperFrame::const_iterator hit = frame->begin(); hit != frame->end(); ++hit) {
 
            T_max[hit->getPMT()] = hit->getT();
 
            const int i = hit->getT() / Ts;
              
            buffer[i].push_back(*hit);
          }
 
          set<size_t> keep;                                      // indices corresponding to times of high-rate veto
          
          for (int pmt = 0; pmt != NUMBER_OF_PMTS; ++pmt) {
            if (frame->testHighRateVeto(pmt)) {
              keep.insert(T_max[pmt] / Ts);
            }
          }
 
          index.random_shuffle(keep);                            // randomly shuffle values between kept indices
 
          // Wall street shuflle
 
          JDAQSuperFrame::iterator hit = frame->begin();
 
          for (size_t in = 0; in != N; ++in) {
 
            const size_t  out   = index [in];
            buffer_type&  zbuf  = buffer[out];
 
            const JTDC_t  T_in  = in  * Ts;
            const JTDC_t  T_out = out * Ts;
 
            for (buffer_type::iterator i = zbuf.begin(); i != zbuf.end(); ++i, ++hit) {
              *hit = JDAQHit(i->getPMT(), (i->getT() - T_out) + T_in, i->getToT());
            }
          }
        }
      }
    }

ClassDef() [1/6]

KM3NETDAQ::JDAQTimesliceL0::ClassDef ( JDAQTimesliceL0 , 1  )

inherited

ClassDef() [2/6]

KM3NETDAQ::JDAQTimeslice::ClassDef ( JDAQTimeslice , 4  )

inherited

ClassDef() [3/6]

KM3NETDAQ::JDAQPreamble::ClassDef ( JDAQPreamble , 1  )

inherited

ClassDef() [4/6]

KM3NETDAQ::JDAQTimesliceHeader::ClassDef ( JDAQTimesliceHeader , 2  )

inherited

ClassDef() [5/6]

KM3NETDAQ::JDAQHeader::ClassDef ( JDAQHeader , 2  )

inherited

ClassDef() [6/6]

KM3NETDAQ::JDAQChronometer::ClassDef ( JDAQChronometer , 3  )

inherited

clear()

void KM3NETDAQ::JDAQTimeslice::clear ( )

inlineinherited

Clear data.

Definition at line 97 of file JDAQTimeslice.hh.

    {
      for (iterator i = this->begin(); i != this->end(); ++i) {
        i->clear();
      }
 
      std::vector<JDAQSuperFrame>::clear();
    }

add()

JDAQTimeslice & KM3NETDAQ::JDAQTimeslice::add ( const JDAQTimeslice & timeslice )

inlineinherited

Add another timeslice.

Parameters

timeslice

timeslice

Returns

this timeslice

Definition at line 133 of file JDAQTimeslice.hh.

    {
      using namespace std;
 
      map<JDAQModuleIdentifier, int> buffer;
 
      for (const_iterator i = this->begin(); i != this->end(); ++i) {
        buffer[i->getModuleIdentifier()] = distance(static_cast<const JDAQTimeslice&>(*this).begin(),i);
      }
 
      for (JDAQTimeslice::const_iterator i = timeslice.begin(); i != timeslice.end(); ++i) {
 
        map<JDAQModuleIdentifier, int>::const_iterator p = buffer.find(i->getModuleIdentifier());
        
        if (p != buffer.end()) {
 
          JDAQSuperFrame& frame = this->at(p->second);
 
          frame.add(*i);
 
          sort(frame.begin(), frame.end());
 
        } else {
 
          this->push_back(*i);
        }
      }
      
      return *this;
    }

print()

std::ostream & KM3NETDAQ::JDAQTimeslice::print ( std::ostream & out, const bool lpr = false ) const

inlineinherited

Print DAQ Timeslice.

Parameters

out	output stream
lpr	long print

Returns

output stream

Definition at line 172 of file JDAQTimeslice.hh.

    {
      using namespace std;
      
      out << this->ClassName() << endl;
      out << dynamic_cast<const JDAQPreamble&>   (*this) << endl;
      out << dynamic_cast<const JDAQChronometer&>(*this) << endl;
      
      for (JDAQTimeslice::const_iterator frame = this->begin(); frame != this->end(); ++frame) {
        
        out << ' ' << setw(10) << frame->getModuleID();
        out << ' ' << setw(6)  << frame->getLength();
        out << ' ' << setw(6)  << frame->getDataType();
        out << ' ' << setw(6)  << frame->getTimesliceStart();
        out << ' ' << setw(8)  << setfill('0') << hex << frame->getStatus()     << dec << setfill(' ');
        out << '|' << setw(8)  << setfill('0') << hex << frame->getFIFOStatus() << dec << setfill(' ');
        out << ' ' << setw(2)  << frame->getUDPNumberOfReceivedPackets();
        out << '/' << setw(2)  << frame->getUDPMaximalSequenceNumber();
        out << ' ' << setw(6)  << frame->size();
        
        if (!lpr) {
          
          if (!frame->empty()) {
            
            out << ' ' << setw(10) << frame-> begin()->getT();
            out << " ... ";
            out << ' ' << setw(10) << frame->rbegin()->getT();
          }
          
          out << endl;
          
        } else {
          
          out << endl;
          
          int n = 1;
          
          for (JDAQFrame::const_iterator hit = frame->begin(); hit != frame->end(); ++hit, ++n) {
            out << setw(2) << (int) hit->getPMT() << ' ' 
                << setw(8) << (int) hit->getT()   << ' ' 
                << setw(3) << (int) hit->getToT() << (n%10 == 0 ? '\n' : ' ');
          }
 
          out << endl;
        }
      }
 
      return out;
    }

getDAQPreamble()

template<class T >

static JDAQPreamble KM3NETDAQ::JDAQPreamble::getDAQPreamble ( const T & object )

inlinestaticinherited

Get DAQ preamble.

This method should be used for binary I/O to get the actual data for the given object.
To this end, the following method should be overloaded for the corresponding data type.

   size_t  getSizeof(const T&);

Parameters

object

object

Returns

preamble

Definition at line 76 of file JDAQPreamble.hh.

    {
      static JDAQPreamble preamble;
 
      preamble.length = getSizeof(object);
      preamble.type   = KM3NETDAQ::getDataType<T>();
 
      return preamble;
    }

getLength()

int KM3NETDAQ::JDAQAbstractPreamble::getLength ( ) const

inlineinherited

Get length.

Returns

number of bytes

Definition at line 49 of file JDAQAbstractPreamble.hh.

    { 
      return length;
    }

getDataType()

int KM3NETDAQ::JDAQAbstractPreamble::getDataType ( ) const

inlineinherited

Get data type.

Returns

data type

Definition at line 60 of file JDAQAbstractPreamble.hh.

    { 
      return type; 
    }

ClassDefNV()

KM3NETDAQ::JDAQAbstractPreamble::ClassDefNV ( JDAQAbstractPreamble , 1  )

inherited

getDAQTimesliceHeader()

const JDAQTimesliceHeader & KM3NETDAQ::JDAQTimesliceHeader::getDAQTimesliceHeader ( ) const

inlineinherited

Get DAQ time slice header.

Returns

DAQ time slice header

Definition at line 43 of file JDAQTimesliceHeader.hh.

    {
      return static_cast<const JDAQTimesliceHeader&>(*this);
    }

getDAQHeader()

const JDAQHeader & KM3NETDAQ::JDAQHeader::getDAQHeader ( ) const

inlineinherited

Get DAQ header.

Returns

DAQ header

Definition at line 49 of file JDAQHeader.hh.

    { 
      return static_cast<const JDAQHeader&>(*this); 
    }

setDAQHeader()

void KM3NETDAQ::JDAQHeader::setDAQHeader ( const JDAQHeader & header )

inlineinherited

Set DAQ header.

Parameters

header

DAQ header

Definition at line 60 of file JDAQHeader.hh.

    { 
      static_cast<JDAQHeader&>(*this) = header;
    }

getDAQChronometer()

const JDAQChronometer & KM3NETDAQ::JDAQChronometer::getDAQChronometer ( ) const

inlineinherited

Get DAQ chronometer.

Returns

DAQ chronometer

Definition at line 88 of file JDAQChronometer.hh.

    { 
      return static_cast<const JDAQChronometer&>(*this); 
    }

setDAQChronometer()

void KM3NETDAQ::JDAQChronometer::setDAQChronometer ( const JDAQChronometer & chronometer )

inlineinherited

Set DAQ chronometer.

Parameters

chronometer

DAQ chronometer

Definition at line 99 of file JDAQChronometer.hh.

    { 
      static_cast<JDAQChronometer&>(*this) = chronometer;
    }

getDetectorID()

int KM3NETDAQ::JDAQChronometer::getDetectorID ( ) const

inlineinherited

Get detector identifier.

Returns

detector identifier

Definition at line 110 of file JDAQChronometer.hh.

    { 
      return detector_id; 
    }

getRunNumber()

int KM3NETDAQ::JDAQChronometer::getRunNumber ( ) const

inlineinherited

Get run number.

Returns

run number

Definition at line 121 of file JDAQChronometer.hh.

    { 
      return run; 
    }

getFrameIndex()

int KM3NETDAQ::JDAQChronometer::getFrameIndex ( ) const

inlineinherited

Get frame index.

Returns

frame index

Definition at line 132 of file JDAQChronometer.hh.

    { 
      return frame_index; 
    }

getTimesliceStart()

JDAQUTCExtended KM3NETDAQ::JDAQChronometer::getTimesliceStart ( ) const

inlineinherited

Get start of timeslice.

Returns

timeslice start

Definition at line 144 of file JDAQChronometer.hh.

    {
      return timeslice_start;
    }

setRunNumber()

void KM3NETDAQ::JDAQChronometer::setRunNumber ( const int run )

inlineinherited

Set run number.

Parameters

run	run number

Definition at line 155 of file JDAQChronometer.hh.

    { 
      this->run = run;
    }

setFrameIndex()

void KM3NETDAQ::JDAQChronometer::setFrameIndex ( const int frame_index )

inlineinherited

Set frame index.

Parameters

frame_index

frame index

Definition at line 166 of file JDAQChronometer.hh.

    { 
      this->frame_index = frame_index;
    }

setTimesliceStart()

void KM3NETDAQ::JDAQChronometer::setTimesliceStart ( const JDAQUTCExtended & timeslice_start )

inlineinherited

Set timeslice start time.

Parameters

timeslice_start

timeslice start time

Definition at line 177 of file JDAQChronometer.hh.

    {
      this->timeslice_start = timeslice_start;
    }

Member Data Documentation

length

int KM3NETDAQ::JDAQAbstractPreamble::length

protectedinherited

Definition at line 69 of file JDAQAbstractPreamble.hh.

type

int KM3NETDAQ::JDAQAbstractPreamble::type

protectedinherited

Definition at line 70 of file JDAQAbstractPreamble.hh.

detector_id

int KM3NETDAQ::JDAQChronometer::detector_id

protectedinherited

Definition at line 187 of file JDAQChronometer.hh.

run

int KM3NETDAQ::JDAQChronometer::run

protectedinherited

Definition at line 188 of file JDAQChronometer.hh.

frame_index

int KM3NETDAQ::JDAQChronometer::frame_index

protectedinherited

Definition at line 189 of file JDAQChronometer.hh.

timeslice_start

JDAQUTCExtended KM3NETDAQ::JDAQChronometer::timeslice_start

protectedinherited

Definition at line 190 of file JDAQChronometer.hh.

---

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

• JRandomTimeslice.hh