KM3NETDAQ::JDAQRate Class Reference

Data storage class for rate measurement of one PMT. More...

#include <JDAQSummaryFrame.hh>

Public Types
typedef unsigned char	JRate_t

Public Member Functions
	JDAQRate ()
	Default constructor. More...
JRate_t	getValue () const
	Get value. More...
void	setValue (const int numberOfHits, const double frameTime_ns)
	Set value. More...
void	setValue (const double rate_Hz)
	Set value. More...
double	getRate () const
	Get count rate. More...
double	getWeight () const
	Get weight. More...
JDAQRate &	mul (const double factor)
	Scale rate. More...
JDAQRate &	div (const double factor)
	Scale rate. More...

Static Public Member Functions
static double	getMinimalRate ()
	Get minimal rate (below this, value is set to zero) More...
static double	getMaximalRate ()
	Get maximal rate (above this, value is set to maximum) More...
static JRate_t	getValue (const int numberOfHits, const double frameTime_ns)
	Get value. More...
static JRate_t	getValue (const double rate_Hz)
	Get value. More...
static double	getRate (const JRate_t value)
	Get count rate. More...
static double	getWeight (const JRate_t value)
	Get weight. More...
static int	getN ()
	Get number of bins. More...
static const double *	getData (const double factor=1.0)
	Get abscissa values. More...

Protected Attributes
JRate_t	value

Static Private Member Functions
static const double	getFactor ()
	Get conversion factor. More...
static double	get_rate (const double value)
	Get count rate. More...

Friends
class	JDAQSummaryFrame

Detailed Description

Data storage class for rate measurement of one PMT.

Note that the rate value is compressed. The number of bins and corresponding abscissa values can be obtained with methods JDAQRare::getN and JDAQRate::getData, respectively.

Definition at line 36 of file JDAQSummaryFrame.hh.

Member Typedef Documentation

typedef unsigned char KM3NETDAQ::JDAQRate::JRate_t

Definition at line 42 of file JDAQSummaryFrame.hh.

Constructor & Destructor Documentation

KM3NETDAQ::JDAQRate::JDAQRate ( )

inline

Default constructor.

Definition at line 171 of file JDAQSummaryFrame.hh.

               :
      value(0)
    {}

Member Function Documentation

static double KM3NETDAQ::JDAQRate::getMinimalRate ( )

inlinestatic

Get minimal rate (below this, value is set to zero)

Returns

rate [Hz]

Definition at line 50 of file JDAQSummaryFrame.hh.

    {
      return 2.0e3;
    }

static double KM3NETDAQ::JDAQRate::getMaximalRate ( )

inlinestatic

Get maximal rate (above this, value is set to maximum)

Returns

rate [Hz]

Definition at line 61 of file JDAQSummaryFrame.hh.

    {
      return 2.0e6;
    }

static JRate_t KM3NETDAQ::JDAQRate::getValue ( const int  numberOfHits, const double  frameTime_ns  )

inlinestatic

Get value.

Parameters

numberOfHits	number of hits
frameTime_ns	frame time [ns]

Returns

value

Definition at line 74 of file JDAQSummaryFrame.hh.

    {
      return getValue(numberOfHits * 1.0e9 / frameTime_ns);
    }

static JRate_t KM3NETDAQ::JDAQRate::getValue ( const double  rate_Hz )

inlinestatic

Get value.

Parameters

rate_Hz

rate [Hz]

Returns

value

Definition at line 86 of file JDAQSummaryFrame.hh.

    {
      if      (rate_Hz <= getMinimalRate())
        return 0;
      else if (rate_Hz >= getMaximalRate())
        return std::numeric_limits<JRate_t>::max();
      else
        return (JRate_t) (log(rate_Hz/getMinimalRate()) / getFactor() + 0.5);
    }

static double KM3NETDAQ::JDAQRate::getRate ( const JRate_t  value )

inlinestatic

Get count rate.

Parameters

value

value

Returns

rate [Hz]

Definition at line 103 of file JDAQSummaryFrame.hh.

    {
      if (value == 0)
        return 0.0;
      else
        return get_rate(value);
    }

static double KM3NETDAQ::JDAQRate::getWeight ( const JRate_t  value )

inlinestatic

Get weight.

Parameters

value

value

Returns

weight [Hz^-1]

Definition at line 118 of file JDAQSummaryFrame.hh.

    {
      double W = 1.0;
      
      if      (value == 0)
        W = get_rate(0.5)   - getMinimalRate();
      else if (value == std::numeric_limits<JRate_t>::max())
        W = getMaximalRate() - get_rate(std::numeric_limits<JRate_t>::max() - 0.5);
      else
        W = get_rate((double) value + 0.5) - get_rate((double) value - 0.5);

      return 1.0 / W;
    }

static int KM3NETDAQ::JDAQRate::getN ( )

inlinestatic

Get number of bins.

Returns

number of bins

Definition at line 138 of file JDAQSummaryFrame.hh.

    {
      return (int) std::numeric_limits<JRate_t>::max() + 1;
    }

static const double* KM3NETDAQ::JDAQRate::getData ( const double  factor = 1.0 )

inlinestatic

Get abscissa values.

Parameters

factor

scaling factor

Returns

abscissa values

Definition at line 150 of file JDAQSummaryFrame.hh.

    {
      static std::vector<double> buffer;

      buffer.clear();

      buffer.push_back(getMinimalRate() * factor);

      for (int i = 1; i != JDAQRate::getN(); ++i) {
        buffer.push_back(get_rate(i - 0.5) * factor);
      }
      
      buffer.push_back(getMaximalRate() * factor);

      return buffer.data();
    }

JRate_t KM3NETDAQ::JDAQRate::getValue ( ) const

inline

Get value.

Returns

value

Definition at line 181 of file JDAQSummaryFrame.hh.

    {
      return value;
    }

void KM3NETDAQ::JDAQRate::setValue ( const int  numberOfHits, const double  frameTime_ns  )

inline

Set value.

Parameters

numberOfHits	number of hits
frameTime_ns	frame time [ns]

Definition at line 193 of file JDAQSummaryFrame.hh.

    {
      value = getValue(numberOfHits, frameTime_ns);
    }

void KM3NETDAQ::JDAQRate::setValue ( const double  rate_Hz )

inline

Set value.

Parameters

rate_Hz

rate [Hz]

Definition at line 204 of file JDAQSummaryFrame.hh.

    {
      value = getValue(rate_Hz);
    }

double KM3NETDAQ::JDAQRate::getRate ( ) const

inline

Get count rate.

Returns

rate [Hz]

Definition at line 215 of file JDAQSummaryFrame.hh.

    {
      return getRate(value);
    }

double KM3NETDAQ::JDAQRate::getWeight ( ) const

inline

Get weight.

Returns

weight [Hz^-1]

Definition at line 226 of file JDAQSummaryFrame.hh.

    {
      return getWeight(value);
    }

JDAQRate& KM3NETDAQ::JDAQRate::mul ( const double  factor )

inline

Scale rate.

Parameters

factor

multiplication factor

Returns

this rate

Definition at line 238 of file JDAQSummaryFrame.hh.

    {
      setValue(getRate() * factor);
      
      return *this;
    }

JDAQRate& KM3NETDAQ::JDAQRate::div ( const double  factor )

inline

Scale rate.

Parameters

factor

multiplication factor

Returns

this rate

Definition at line 252 of file JDAQSummaryFrame.hh.

    {
      setValue(getRate() / factor);
      
      return *this;
    }

static const double KM3NETDAQ::JDAQRate::getFactor ( )

inlinestaticprivate

Get conversion factor.

Returns

factor

Definition at line 270 of file JDAQSummaryFrame.hh.

    {
      return std::log(getMaximalRate() / getMinimalRate()) / std::numeric_limits<JRate_t>::max();
    }

static double KM3NETDAQ::JDAQRate::get_rate ( const double  value )

inlinestaticprivate

Get count rate.

Parameters

value

value

Returns

rate [Hz]

Definition at line 282 of file JDAQSummaryFrame.hh.

    {
      return getMinimalRate() * std::exp(value * getFactor());
    }

Friends And Related Function Documentation

friend class JDAQSummaryFrame

friend

Definition at line 39 of file JDAQSummaryFrame.hh.

Member Data Documentation

JRate_t KM3NETDAQ::JDAQRate::value

protected

Definition at line 261 of file JDAQSummaryFrame.hh.

---

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

• JDAQSummaryFrame.hh