KLMTime Class Reference

KLM time conversion. More...

#include <KLMTime.h>

Public Member Functions
void	updateConstants ()
	Update constants from database objects.
double	getTDCPeriod () const
	Get TDC period.
double	getCTimePeriod () const
	Get CTIME period.
double	getScintillatorTime (int ctime, int tdc, int triggerCTime) const
	Get time for scintillator.
std::pair< int, double >	getRPCTimes (int ctime, int tdc, int triggerTime) const
	Get coarse and fine times for RPC.
double	getTimeSimulation (int tdc, bool scintillator) const
	Get time for simulation.
uint16_t	getTDCByTime (double time) const
	Get TDC by time.

Static Public Member Functions
static KLMTime &	Instance ()
	Instantiation.

Private Member Functions
	KLMTime ()
	Constructor.
	~KLMTime ()
	Destructor.

Private Attributes
DBObjPtr< KLMTimeConversion >	m_KLMTimeConversion
	KLM time conversion.
DBObjPtr< HardwareClockSettings >	m_HardwareClockSettings
	Hardware clock settings.
double	m_TDCPeriod = 0.
	TDC period (stored here because getting it from m_HardwareClockSettings requires to search in a map).
double	m_CTimePeriod = 0.
	CTIME period.

Detailed Description

KLM time conversion.

Definition at line 27 of file KLMTime.h.

Constructor & Destructor Documentation

KLMTime()

KLMTime ( )

inlineprivate

Constructor.

Definition at line 91 of file KLMTime.h.

    {
    }

~KLMTime()

~KLMTime ( )

inlineprivate

Destructor.

Definition at line 98 of file KLMTime.h.

    {
    }

Member Function Documentation

getCTimePeriod()

double getCTimePeriod ( ) const

inline

Get CTIME period.

Definition at line 53 of file KLMTime.h.

    {
      return m_CTimePeriod;
    }

getRPCTimes()

std::pair< int, double > getRPCTimes	(	int	ctime,
		int	tdc,
		int	triggerTime
	)		const

Get coarse and fine times for RPC.

Parameters

[in]	ctime	REVO9 time.
[in]	tdc	TDC.
[in]	triggerTime	REVO9 Trigger time.

Definition at line 46 of file KLMTime.cc.

{
  /* Relative time in TDC periods for RPC hits. */
  int relativeTime = tdc & 0x7FF;
  /*
   * TDC frequency is 8 times greater than revo9 frequency.
   * The 2 last bits are zero, thus, the precision is 4 * (TDC period).
   * The TDC has 11 bits of dynamic range. Shift the triggerTime by
   * 10 ticks to align the new prompt-time peak with the old
   * TriggerCTime-relative peak (for backward compatibility of calibration).
   */
  int trigger = ((triggerTime - 10) & 0x0FF) << 3;
  if (relativeTime <= trigger)
    relativeTime -= trigger;
  else
    relativeTime -= trigger + 0x800;
  return std::pair<int, double>(ctime - triggerTime,
                                relativeTime * m_TDCPeriod);
}

getScintillatorTime()

double getScintillatorTime	(	int	ctime,
		int	tdc,
		int	triggerCTime
	)		const

Get time for scintillator.

Parameters

[in]	ctime	CTIME.
[in]	tdc	TDC.
[in]	triggerCTime	Trigger CTIME.

Definition at line 27 of file KLMTime.cc.

{
  int cTimeShift = m_KLMTimeConversion->getCTimeShift();
  /* Relative time in TDC periods for scintillators. */
  int relativeTime;
  /*
   * All time values were shifted by 2 bits for the phase2 data.
   */
  int correctedCTime = (((ctime << cTimeShift) & 0xFFFF) << 3) + (tdc & 0x7);
  int correctedTriggerCTime = ((triggerCTime << cTimeShift) & 0xFFFF) << 3;
  /* Scintillator: 16-bit CTIME. */
  if (correctedCTime <= correctedTriggerCTime)
    relativeTime = correctedCTime - correctedTriggerCTime;
  else
    relativeTime = correctedCTime - correctedTriggerCTime - (0x10000 << 3);
  /* Get time in TDC periods. */
  return relativeTime * m_TDCPeriod;
}

getTDCByTime()

uint16_t getTDCByTime

(

double

time

)

const

Get TDC by time.

Definition at line 73 of file KLMTime.cc.

{
  double timeOffset = m_KLMTimeConversion->getTimeOffset();
  return (time - timeOffset) / m_TDCPeriod;
}

getTDCPeriod()

double getTDCPeriod ( ) const

inline

Get TDC period.

Definition at line 45 of file KLMTime.h.

    {
      return m_TDCPeriod;
    }

getTimeSimulation()

double getTimeSimulation	(	int	tdc,
		bool	scintillator
	)		const

Get time for simulation.

Parameters

[in]	tdc	TDC.
[in]	scintillator	Scintillator (true) or RPC (false).

Definition at line 66 of file KLMTime.cc.

{
  double timeOffset = m_KLMTimeConversion->getTimeOffset();
  (void)scintillator;
  return tdc * m_TDCPeriod + timeOffset;
}

Instance()

KLMTime & Instance ( )

static

Instantiation.

Definition at line 14 of file KLMTime.cc.

{
  static KLMTime klmElementNumbers;
  return klmElementNumbers;
}

updateConstants()

void updateConstants

(

)

Update constants from database objects.

This function needs to be called when database objects change, for example, at the beginning of the run.

Definition at line 20 of file KLMTime.cc.

{
  m_TDCPeriod =
    1.0 / m_HardwareClockSettings->getClockFrequency(Const::KLM, "TDC");
  m_CTimePeriod = 1.0 / m_HardwareClockSettings->getGlobalClockFrequency();
}

Member Data Documentation

m_CTimePeriod

double m_CTimePeriod = 0.

private

CTIME period.

Definition at line 115 of file KLMTime.h.

m_HardwareClockSettings

DBObjPtr<HardwareClockSettings> m_HardwareClockSettings

private

Hardware clock settings.

Definition at line 106 of file KLMTime.h.

m_KLMTimeConversion

DBObjPtr<KLMTimeConversion> m_KLMTimeConversion

private

KLM time conversion.

Definition at line 103 of file KLMTime.h.

m_TDCPeriod

double m_TDCPeriod = 0.

private

TDC period (stored here because getting it from m_HardwareClockSettings requires to search in a map).

Definition at line 112 of file KLMTime.h.

---

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

• klm/time/include/KLMTime.h
• klm/time/src/KLMTime.cc