File router for fast addressing of summary data. More...

#include <JSummaryFileRouter.hh>

Inheritance diagram for JSUPPORT::JSummaryFileRouter:

Public Member Functions
	JSummaryFileRouter (const std::string &file_name)
	Constructor.

	JSummaryFileRouter (const std::string &file_name, const double rate_Hz)
	Constructor.

void	update (const JDAQHeader &header)
	Update router.

const JDAQSummaryFrame &	getSummaryFrame () const
	Get default summary frame.

const JDAQSummaryFrame &	getSummaryFrame (const JDAQModuleIdentifier &module) const
	Get summary frame.

double	getRate () const
	Get default rate.

double	getRate (const JDAQPMTIdentifier &id) const
	Get rate.

bool	hasDefault () const
	Has default.

void	setDefault (const double rate_Hz)
	Set default.

void	unsetDefault ()
	Unset default.

void	update (const JDAQSummaryslice *ps)
	Update router.

bool	is_valid () const
	Check validity of summary data.

const JDAQSummaryslice *	getSummaryslice () const
	Get summary slice.

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

bool	hasSummaryFrame (const JDAQModuleIdentifier &module) const
	Has summary frame.

Static Public Attributes
static const int	MODULE_IDENTIFIER = 1
	module identifier to allow default

Private Attributes
JTOOLS::JRouter< int >	router

const JDAQSummaryslice *	summary

JDAQSummaryFrame	frame

double	rate_Hz

Detailed Description

File router for fast addressing of summary data.

The member method update() should be used to update the internal router for a given event. The member method getRate(const JDAQPMTIdentifier&) const can subsequently be used to obtain the measured singles rate for a given PMT at the closest time of the event.

Definition at line 37 of file JSummaryFileRouter.hh.

Constructor & Destructor Documentation

◆ JSummaryFileRouter() [1/2]

JSUPPORT::JSummaryFileRouter::JSummaryFileRouter ( const std::string & file_name )

inline

Constructor.

Parameters

file_name file name

Definition at line 47 of file JSummaryFileRouter.hh.

                                                   :
      JSummaryRouter(),
      JTreeScanner<JDAQSummaryslice, JDAQEvaluator>(file_name)
    {}

◆ JSummaryFileRouter() [2/2]

JSUPPORT::JSummaryFileRouter::JSummaryFileRouter	(	const std::string &	file_name,
		const double	rate_Hz )

inline

Constructor.

Parameters

file_name	file name
rate_Hz	default singles rate [Hz]

Definition at line 59 of file JSummaryFileRouter.hh.

                                                   :
      JSummaryRouter(rate_Hz),
      JTreeScanner<JDAQSummaryslice, JDAQEvaluator>(file_name)
    {}

Member Function Documentation

◆ update() [1/2]

void JSUPPORT::JSummaryFileRouter::update ( const JDAQHeader & header )

inline

Update router.

Parameters

header header

Definition at line 71 of file JSummaryFileRouter.hh.

    {
      static Long64_t previous = -1;
 
      const  Long64_t index    = this->find(header);
 
      if (index != -1) {
 
        if (index != previous) {
 
          previous = index;
 
          JSummaryRouter::update(this->getEntry(index));
        }
      }
    }

◆ getSummaryFrame() [1/2]

const JDAQSummaryFrame & JSUPPORT::JSummaryRouter::getSummaryFrame ( ) const

inlineinherited

Get default summary frame.

Returns: summary frame

Definition at line 72 of file JSupport/JSummaryRouter.hh.

    {
      return frame;
    }

◆ getSummaryFrame() [2/2]

const JDAQSummaryFrame & JSUPPORT::JSummaryRouter::getSummaryFrame ( const JDAQModuleIdentifier & module ) const

inlineinherited

Get summary frame.

Parameters

module module

Returns: summary frame

Definition at line 216 of file JSupport/JSummaryRouter.hh.

    {
      if      (router.has(module.getModuleID()))
        return (*summary)[getAddress(module)];
      else if (this->hasDefault())
        return frame;
      else
        THROW(JValueOutOfRange, "Invalid module identifier " << module);
    }

◆ getRate() [1/2]

double JSUPPORT::JSummaryRouter::getRate ( ) const

inlineinherited

Get default rate.

Returns: rate [Hz]

Definition at line 83 of file JSupport/JSummaryRouter.hh.

    {
      return this->rate_Hz;
    }

◆ getRate() [2/2]

double JSUPPORT::JSummaryRouter::getRate ( const JDAQPMTIdentifier & id ) const

inlineinherited

Get rate.

Parameters

id	PMT identifier

Returns: rate [Hz]

Definition at line 233 of file JSupport/JSummaryRouter.hh.

    {
      double R = 0.0;
 
      if (this->hasSummaryFrame(id.getModuleIdentifier())) {
        R = this->getSummaryFrame(id.getModuleIdentifier()).getRate(id.getPMTAddress());
      }
 
      if (R < this->getRate()) {
        R = this->getRate();
      }
      
      return R;
    }

◆ hasDefault()

bool JSUPPORT::JSummaryRouter::hasDefault ( ) const

inlineinherited

Has default.

Returns: true if default has been set; else false

Definition at line 94 of file JSupport/JSummaryRouter.hh.

    {
      return (frame.getModuleID() == MODULE_IDENTIFIER);
    }

◆ setDefault()

void JSUPPORT::JSummaryRouter::setDefault ( const double rate_Hz )

inlineinherited

Set default.

Parameters

rate_Hz rate [Hz]

Definition at line 105 of file JSupport/JSummaryRouter.hh.

    {
      using namespace KM3NETDAQ;
 
      this->rate_Hz = rate_Hz;
 
      frame.setModuleIdentifier(MODULE_IDENTIFIER);                // allow default
      frame.setDAQFrameStatus(JDAQFrameStatus::getInstance());     // valid status
 
      for (int i = 0; i != NUMBER_OF_PMTS; ++i) {
        frame.setRate(i, rate_Hz);
      }
    }

◆ unsetDefault()

void JSUPPORT::JSummaryRouter::unsetDefault ( )

inlineinherited

Unset default.

Definition at line 123 of file JSupport/JSummaryRouter.hh.

    {
      using namespace KM3NETDAQ;
 
      frame.setModuleIdentifier(JDAQModuleIdentifier());           // disallow default
      frame.setDAQFrameStatus(JDAQFrameStatus());                  // invalid status
 
      for (int i = 0; i != NUMBER_OF_PMTS; ++i) {
        frame[i] = JDAQRate();
      }
    }

◆ update() [2/2]

void JSUPPORT::JSummaryRouter::update ( const JDAQSummaryslice * ps )

inlineinherited

Update router.

Parameters

ps	pointer to new summary slice

Definition at line 141 of file JSupport/JSummaryRouter.hh.

    {
      // reset internal router
 
      if (summary != NULL) {
        for (JDAQSummaryslice::const_iterator i = summary->begin(); i != summary->end(); ++i) {
          router.put(i->getModuleID(), router.getDefaultAddress());
        }
      }
      
      summary = ps;
 
      if (summary != NULL) {
 
        // set internal router
 
        for (JDAQSummaryslice::const_iterator i = summary->begin(); i != summary->end(); ++i) {
          router.put(i->getModuleID(), distance(summary->begin(), i));
        }
      }
    }

◆ is_valid()

bool JSUPPORT::JSummaryRouter::is_valid ( ) const

inlineinherited

Check validity of summary data.

Returns: true if summary data available; else false

Definition at line 169 of file JSupport/JSummaryRouter.hh.

    {
      return summary != NULL;
    }

◆ getSummaryslice()

const JDAQSummaryslice * JSUPPORT::JSummaryRouter::getSummaryslice ( ) const

inlineinherited

Get summary slice.

                    pointer to summary slice (may be NULL)

Definition at line 180 of file JSupport/JSummaryRouter.hh.

    {
      return summary;
    }

◆ getAddress()

const int JSUPPORT::JSummaryRouter::getAddress ( const JDAQModuleIdentifier & module ) const

inlineinherited

Get address of module.

Parameters

module module

Returns: address

Definition at line 192 of file JSupport/JSummaryRouter.hh.

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

◆ hasSummaryFrame()

bool JSUPPORT::JSummaryRouter::hasSummaryFrame ( const JDAQModuleIdentifier & module ) const

inlineinherited

Has summary frame.

Parameters

module module

Returns: true if module present; else false

Definition at line 204 of file JSupport/JSummaryRouter.hh.

    {
      return router.has(module.getModuleID()) || this->hasDefault();
    }

Member Data Documentation

◆ MODULE_IDENTIFIER

const int JSUPPORT::JSummaryRouter::MODULE_IDENTIFIER = 1

staticinherited

module identifier to allow default

Definition at line 248 of file JSupport/JSummaryRouter.hh.

◆ router

JTOOLS::JRouter<int> JSUPPORT::JSummaryRouter::router

privateinherited

Definition at line 251 of file JSupport/JSummaryRouter.hh.

◆ summary

const JDAQSummaryslice* JSUPPORT::JSummaryRouter::summary

privateinherited

Definition at line 252 of file JSupport/JSummaryRouter.hh.

◆ frame

JDAQSummaryFrame JSUPPORT::JSummaryRouter::frame

privateinherited

Definition at line 253 of file JSupport/JSummaryRouter.hh.

◆ rate_Hz

double JSUPPORT::JSummaryRouter::rate_Hz

privateinherited

Definition at line 254 of file JSupport/JSummaryRouter.hh.

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

JSummaryFileRouter.hh

Public Member Functions

Static Public Attributes

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ JSummaryFileRouter() [1/2]

◆ JSummaryFileRouter() [2/2]

Member Function Documentation

◆ update() [1/2]

◆ getSummaryFrame() [1/2]

◆ getSummaryFrame() [2/2]

◆ getRate() [1/2]

◆ getRate() [2/2]

◆ hasDefault()

◆ setDefault()

◆ unsetDefault()

◆ update() [2/2]

◆ is_valid()

◆ getSummaryslice()

◆ getAddress()

◆ hasSummaryFrame()

Member Data Documentation

◆ MODULE_IDENTIFIER

◆ router

◆ summary

◆ frame

◆ rate_Hz