Nominal time-to-digit conversion parameters (simplified model) More...

#include <TOPNominalTDC.h>

Inheritance diagram for TOPNominalTDC:

Collaboration diagram for TOPNominalTDC:

[legend]

Public Types
enum	{ c_WindowSize = 64 , c_syncWindows = 2 }
	Various constants. More...

Public Member Functions
	TOPNominalTDC ()
	Default constructor.

	TOPNominalTDC (int numWindows, int subBits, double syncTimeBase, int numofBunches, double offset, double pileupTime, double doubleHitResolution, double timeJitter, double efficiency, const std::string &name="TOPNominalTDC")
	Useful constructor (new xml file version) More...

	TOPNominalTDC (unsigned numBits, double binWidth, double offset, double pileupTime, double doubleHitResolution, double timeJitter, double efficiency, const std::string &name="TOPNominalTDCold")
	Useful constructor (old xml file version) More...

void	setADCBits (unsigned adcBits)
	Sets the number of ADC bits. More...

void	setAveragePedestal (int averagePedestal)
	Sets average of pedestals. More...

unsigned	getADCBits () const
	Returns the number of ADC bits. More...

unsigned	getADCRange () const
	Returns ADC range. More...

int	getAveragePedestal () const
	Returns average of pedestals. More...

unsigned	getNumWindows () const
	Returns number of ASIC windows per waveform. More...

unsigned	getSubBits () const
	Returns number of bits per sample. More...

double	getSyncTimeBase () const
	Returns synchonization time base (time width of c_syncWindows) More...

unsigned	getNumofBunches () const
	Returns number of bunches in the synchonization time base. More...

double	getBunchSeparationTime () const
	Returns bunch separation time (e.g. More...

double	getOffset () const
	Returns time offset. More...

double	getPileupTime () const
	Returns pile-up time. More...

double	getDoubleHitResolution () const
	Returns double hit resolution time. More...

double	getTimeJitter () const
	Returns r.m.s. More...

double	getEfficiency () const
	Returns electronic efficiency. More...

unsigned	getNumBits () const
	Returns number of bits. More...

double	getBinWidth () const
	Returns time width of a TDC bin. More...

double	getSampleWidth () const
	Returns time difference between two samples. More...

int	getOverflowValue () const
	Returns TDC overflow value. More...

double	getTime (int TDC) const
	Convert TDC count to time. More...

double	getTimeMin () const
	Returns time range lower limit. More...

double	getTimeMax () const
	Returns time range upper limit. More...

int	getTDCcount (double time) const
	Converts time to TDC count. More...

int	getSample (double time) const
	Converts time to sample number. More...

double	getSampleTime (int sample) const
	Converts sample number to time. More...

bool	isSampleValid (int sample) const
	Check for the validity of sample number. More...

bool	isConsistent () const override
	Check for consistency of data members. More...

void	print (const std::string &title="Nominal time-to-digit conversion parameters") const override
	Print the content of the class. More...

void	setName (const std::string &name)
	Sets object name. More...

const std::string &	getName () const
	Returns object name. More...

virtual void	printSurface (const GeoOpticalSurface &surface) const
	Print the content of optical surface. More...

double	getReflectivity (const GeoOpticalSurface &surface, double energy) const
	Returns reflectivity of optical surface at given photon energy. More...

Protected Member Functions
void	printUnderlined (const std::string &title) const
	Print the content of the class. More...

	ClassDef (TOPGeoBase, 1)
	ClassDef.

Protected Attributes
std::string	m_name
	geometry object name

Static Protected Attributes
static double	s_unit = Unit::cm
	conversion unit for length

static std::string	s_unitName
	conversion unit name

Private Member Functions
	ClassDefOverride (TOPNominalTDC, 3)
	ClassDef.

Private Attributes
unsigned	m_numWindows = 0
	number of ASIC windows per waveform

unsigned	m_subBits = 0
	number of bits per sample

float	m_syncTimeBase = 0
	time width of c_syncWindows

unsigned	m_numofBunches = 0
	number of bunches per syncTimeBase

float	m_offset = 0
	time offset

float	m_pileupTime = 0
	pile-up time

float	m_doubleHitResolution = 0
	double hit resolution time

float	m_timeJitter = 0
	r.m.s. More...

float	m_efficiency = 0
	electronic efficiency (fract. More...

unsigned	m_numBits = 0
	number of bits

float	m_binWidth = 0
	time width of a TDC bin

float	m_sampleWidth = 0
	time between two samples

unsigned	m_adcBits = 12
	number of ADC bits

int	m_averagePedestal = 0
	average of pedestals [ADC bins]

Detailed Description

Nominal time-to-digit conversion parameters (simplified model)

Definition at line 22 of file TOPNominalTDC.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Various constants.

Enumerator
c_WindowSize	number of samples per ASIC window
c_syncWindows	number of windows corresponding to syncTimeBase

Definition at line 28 of file TOPNominalTDC.h.

          {c_WindowSize = 64, 
           c_syncWindows = 2  
          };

Constructor & Destructor Documentation

◆ TOPNominalTDC()

TOPNominalTDC	(	unsigned	numBits,
		double	binWidth,
		double	offset,
		double	pileupTime,
		double	doubleHitResolution,
		double	timeJitter,
		double	efficiency,
		const std::string &	name = `"TOPNominalTDCold"`
	)

inline

Useful constructor (old xml file version)

Parameters

numBits	number of bits
binWidth	time width of a TDC bin
offset	time offset
pileupTime	pile-up time
doubleHitResolution	double hit resolution time
timeJitter	r.m.s. of time jitter
efficiency	electronic efficiency (fraction of hits above threshold)
name	object name

Definition at line 73 of file TOPNominalTDC.h.

Member Function Documentation

◆ getADCBits()

unsigned getADCBits ( ) const

inline

Returns the number of ADC bits.

Returns: number of ADC bits

Definition at line 108 of file TOPNominalTDC.h.

◆ getADCRange()

unsigned getADCRange ( ) const

inline

Returns ADC range.

Returns: overflow value

Definition at line 114 of file TOPNominalTDC.h.

◆ getAveragePedestal()

int getAveragePedestal ( ) const

inline

Returns average of pedestals.

Returns: average of pedestals

Definition at line 120 of file TOPNominalTDC.h.

◆ getBinWidth()

double getBinWidth ( ) const

inline

Returns time width of a TDC bin.

Returns: time width of a TDC bin

Definition at line 191 of file TOPNominalTDC.h.

◆ getBunchSeparationTime()

double getBunchSeparationTime ( ) const

inline

Returns bunch separation time (e.g.

RF cycle - empty bunches are included!)

Returns: bunch separation time

Definition at line 149 of file TOPNominalTDC.h.

◆ getDoubleHitResolution()

double getDoubleHitResolution ( ) const

inline

Returns double hit resolution time.

Returns: double hit resolution time

Definition at line 167 of file TOPNominalTDC.h.

◆ getEfficiency()

double getEfficiency ( ) const

inline

Returns electronic efficiency.

Returns: electronic efficiency

Definition at line 179 of file TOPNominalTDC.h.

◆ getName()

const std::string& getName ( void ) const

inlineinherited

Returns object name.

Returns: object name

Definition at line 51 of file TOPGeoBase.h.

◆ getNumBits()

unsigned getNumBits ( ) const

inline

Returns number of bits.

Returns: number of bits

Definition at line 185 of file TOPNominalTDC.h.

◆ getNumofBunches()

unsigned getNumofBunches ( ) const

inline

Returns number of bunches in the synchonization time base.

Returns: number of bunches

Definition at line 143 of file TOPNominalTDC.h.

◆ getNumWindows()

unsigned getNumWindows ( ) const

inline

Returns number of ASIC windows per waveform.

Returns: number of ASIC windows per waveform

Definition at line 126 of file TOPNominalTDC.h.

◆ getOffset()

double getOffset ( ) const

inline

Returns time offset.

Returns: time offset

Definition at line 155 of file TOPNominalTDC.h.

◆ getOverflowValue()

int getOverflowValue ( ) const

inline

Returns TDC overflow value.

Returns: overflow value

Definition at line 203 of file TOPNominalTDC.h.

◆ getPileupTime()

double getPileupTime ( ) const

inline

Returns pile-up time.

Returns: pile-up time

Definition at line 161 of file TOPNominalTDC.h.

◆ getSampleTime()

double getSampleTime ( int sample ) const

inline

Converts sample number to time.

Parameters

sample sample number

Returns: time [ns]

Definition at line 245 of file TOPNominalTDC.h.

◆ getSampleWidth()

double getSampleWidth ( ) const

inline

Returns time difference between two samples.

Returns: time between two samples

Definition at line 197 of file TOPNominalTDC.h.

◆ getSubBits()

unsigned getSubBits ( ) const

inline

Returns number of bits per sample.

Returns: number of bits per sample

Definition at line 131 of file TOPNominalTDC.h.

◆ getSyncTimeBase()

double getSyncTimeBase ( ) const

inline

Returns synchonization time base (time width of c_syncWindows)

Returns: synchonization time base

Definition at line 137 of file TOPNominalTDC.h.

◆ getTime()

double getTime ( int TDC ) const

inline

Convert TDC count to time.

Parameters

TDC TDC count

Returns: time [ns]

Definition at line 210 of file TOPNominalTDC.h.

◆ getTimeJitter()

double getTimeJitter ( ) const

inline

Returns r.m.s.

of time jitter

Returns: r.m.s. of time jitter

Definition at line 173 of file TOPNominalTDC.h.

◆ getTimeMax()

double getTimeMax ( ) const

inline

Returns time range upper limit.

Returns: upper limit

Definition at line 222 of file TOPNominalTDC.h.

◆ getTimeMin()

double getTimeMin ( ) const

inline

Returns time range lower limit.

Returns: lower limit

Definition at line 216 of file TOPNominalTDC.h.

◆ setADCBits()

void setADCBits ( unsigned adcBits )

inline

Sets the number of ADC bits.

Parameters

adcBits number of adcBits

Definition at line 96 of file TOPNominalTDC.h.

◆ setAveragePedestal()

void setAveragePedestal ( int averagePedestal )

inline

Sets average of pedestals.

Parameters

averagePedestal average pedestal value

Definition at line 102 of file TOPNominalTDC.h.

◆ setName()

void setName ( const std::string & name )

inlineinherited

Sets object name.

Parameters

name	object name

Definition at line 45 of file TOPGeoBase.h.

Member Data Documentation

◆ m_efficiency

float m_efficiency = 0

private

electronic efficiency (fract.

of hits above threshold)

Definition at line 277 of file TOPNominalTDC.h.

◆ m_timeJitter

float m_timeJitter = 0

private

r.m.s.

of time jitter

Definition at line 276 of file TOPNominalTDC.h.

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

top/dbobjects/include/TOPNominalTDC.h
top/dbobjects/src/TOPNominalTDC.cc

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Member Enumeration Documentation

◆ anonymous enum

Constructor & Destructor Documentation

◆ TOPNominalTDC()

Member Function Documentation

◆ getADCBits()

◆ getADCRange()

◆ getAveragePedestal()

◆ getBinWidth()

◆ getBunchSeparationTime()

◆ getDoubleHitResolution()

◆ getEfficiency()

◆ getName()

◆ getNumBits()

◆ getNumofBunches()

◆ getNumWindows()

◆ getOffset()

◆ getOverflowValue()

◆ getPileupTime()

◆ getSampleTime()

◆ getSampleWidth()

◆ getSubBits()

◆ getSyncTimeBase()

◆ getTime()

◆ getTimeJitter()

◆ getTimeMax()

◆ getTimeMin()

◆ setADCBits()

◆ setAveragePedestal()

◆ setName()

Member Data Documentation

◆ m_efficiency

◆ m_timeJitter