#include <TileCalibDrawerOfc.h>

Inheritance diagram for TileCalibDrawerOfc:

Collaboration diagram for TileCalibDrawerOfc:

Public Types
enum	FIELD { FieldA = 0, FieldB = 1, FieldG = 2, FieldC = 3, FieldDG = 4 }
	OFC field identifier. More...

Public Member Functions
virtual	~TileCalibDrawerOfc ()
	Dtor. More...

virtual uint16_t	getType () const
	Returns TileCalibType::OFC. More...

uint32_t	getNSamples () const
	Returns the number of sample stored. More...

int32_t	getNPhases () const
	Returns the number of phases (WARNING: Can be negative!) More...

float	getPhase (unsigned int channel, unsigned int adc, unsigned int phaseIdx) const
	Returns the stored phase. More...

uint32_t	getNFields (uint16_t objVersion=0) const
	Returns the number of fields. More...

float	getOfc (unsigned int field, unsigned int channel, unsigned int adc, float phase, unsigned int sample) const
	Returns OFC data. More...

void	fillOfc (unsigned int channel, unsigned int adc, float &phase, float w_a, float w_b, float w_c, float g, float *dg) const
	Fill all OFC for optimazation. More...

virtual void	dump () const
	Prints out the object content to std::cout. More...

virtual void	dump (std::ostream &stm) const
	Prints out the object content. More...

void	init (uint16_t objVersion, uint32_t nSamples, int32_t nPhases, uint16_t nChans, uint16_t nGains, const std::string &author="", const std::string &comment="", uint64_t timeStamp=0)
	Function for initializing a TileCalibDrawerOfc BLOB. More...

void	setOfc (unsigned int field, unsigned int channel, unsigned int adc, float phase, unsigned int sample, float value)
	Sets OFC data. More...

void	setPhases (unsigned int channel, unsigned int adc, const std::vector< float > &phases)
	Sets a phase value. More...

virtual void	clone (const TileCalibDrawerBase &other)
	Initialzes Blob with content of other Blob. More...

long	getBlobSize () const
	Returns the BLOB size in units of bytes. More...

long	getBlobSize32 () const
	Returns the BLOB size in units of uint32_t. More...

uint16_t	getObjType () const
	Returns the BLOB object type. More...

uint16_t	getObjVersion () const
	Returns the BLOB object version. More...

uint32_t	getObjSizeUint32 () const
	Returns the size of a data object in units of uint32_t. More...

uint32_t	getObjSizeByte () const
	Returns the size of a data object in units of bytes. More...

uint32_t	getNObjs () const
	Returns the number of data objects stored int the BLOB. More...

uint16_t	getNChans () const
	Returns the number of channels stored in the BLOB. More...

uint16_t	getNGains () const
	Returns the number of gains stored for each channel. More...

uint32_t	getCommentSizeUint32 () const
	Returns the space occupied by the comment fields in units of uint32_t. More...

uint32_t	getCommentSizeChar () const
	Returns the space occupied by the comment fields in units of chars. More...

std::string	getAuthor () const
	Returns the comment author. More...

std::string	getComment () const
	Returns the actual comment. More...

uint64_t	getTimeStamp () const
	Returns the unix timestamp of the comment (seconds since 1.1.1970) More...

std::string	getDate () const
	Returns the date of the comment as string (derived from timestamp) More...

std::string	getFullComment () const
	Returns a formated string build from all comment fields. More...

const void *	getAddress (unsigned int iEle) const
	Returns start address of iEle-th basic unit. More...

void *	getAddress (unsigned int iEle)

Static Public Member Functions
static TileCalibDrawerOfc *	getInstance (coral::Blob &blob, uint16_t objVersion, uint32_t nSamples, int32_t nPhases, uint16_t nChans, uint16_t nGains, const std::string &author="", const std::string &comment="", uint64_t timeStamp=0)
	Returns a pointer to a non-const TileCalibDrawerOfc. More...

static const TileCalibDrawerOfc *	getInstance (const coral::Blob &blob)
	Returns a pointer to a const TileCalibDrawerOfc. More...

Static Public Attributes
static const unsigned int	m_hdrSize32 = 5
	The header size in units of uint32_t. More...

Protected Member Functions
	TileCalibDrawerOfc (const coral::Blob &blob)
	Ctor (const). More...

	TileCalibDrawerOfc (coral::Blob &blob)
	Ctor (non0const). More...

uint32_t	createBlob (uint16_t objType, uint16_t objVersion, uint32_t objSizeUint32, uint32_t nObjs, uint16_t nChans, uint16_t nGains, const std::string &author="", const std::string &comment="", uint64_t timeStamp=0)
	(re-)creation of the referenced BLOB object. More...

void	dumpHeader (std::ostream &stm) const
	Prints the BLOB header summary information. More...

Private Member Functions
void	initCheck ()

const float *	getOfcStartAddress (unsigned int field, unsigned int channel, unsigned int adc, float &phase) const
	Returns pointer to first data OFC for a given field, ADC & phase. More...

float *	getOfcStartAddress (unsigned int field, unsigned int channel, unsigned int adc, float &phase)

unsigned int	getOfcStartOffset (unsigned int field, unsigned int channel, unsigned int adc, float &phase) const

const int32_t *	getPhaseStartAddress (unsigned int channel, unsigned int adc, unsigned int phaseIdx) const
	Returns pointer to the requested phase value. More...

int32_t *	getPhaseStartAddress (unsigned int channel, unsigned int adc, unsigned int phaseIdx)

unsigned int	getPhaseStartOffset (unsigned int channel, unsigned int adc, unsigned int phaseIdx) const

unsigned int	getPhaseNumber (unsigned int channel, unsigned int adc, float &phase) const
	Returns the index for a given phase. More...

Private Attributes
coral::Blob *	m_blob_nc
	Non-const reference to the BLOB. More...

const coral::Blob *	m_blob
	Const reference to the BLOB (always there) More...

const uint32_t *	m_blobStart32
	Cache blob starting address as uint_32t*. More...

const uint16_t *	m_blobStart16
	Cache blob starting address as uint_16t*. More...

uint64_t	m_blobSize32
	Cache blob size in units of uint32_t. More...

bool	m_isBlobOwner
	Is this TileCalibDrawer owner of the BLOB. More...

Detailed Description

Definition at line 40 of file TileCalibDrawerOfc.h.

Member Enumeration Documentation

◆ FIELD

enum TileCalibDrawerOfc::FIELD

OFC field identifier.

Enumerator
FieldA
FieldB
FieldG
FieldC
FieldDG

Definition at line 45 of file TileCalibDrawerOfc.h.

45 {FieldA = 0, FieldB = 1, FieldG = 2, FieldC = 3, FieldDG = 4};

Constructor & Destructor Documentation

◆ ~TileCalibDrawerOfc()

virtual TileCalibDrawerOfc::~TileCalibDrawerOfc ( )

inlinevirtual

Dtor.

Definition at line 48 of file TileCalibDrawerOfc.h.

48 {}

◆ TileCalibDrawerOfc() [1/2]

TileCalibDrawerOfc::TileCalibDrawerOfc ( const coral::Blob & blob )

protected

Ctor (const).

Definition at line 42 of file TileCalibDrawerOfc.cxx.

   : TileCalibDrawerBase(blob)
 {
   initCheck();
 }

◆ TileCalibDrawerOfc() [2/2]

TileCalibDrawerOfc::TileCalibDrawerOfc ( coral::Blob & blob )

protected

Ctor (non0const).

Definition at line 50 of file TileCalibDrawerOfc.cxx.

   : TileCalibDrawerBase(blob)
 {
   initCheck();
 }

Member Function Documentation

◆ clone()

void TileCalibDrawerBase::clone ( const TileCalibDrawerBase & other )

virtualinherited

Initialzes Blob with content of other Blob.

Parameters

other TileCalibDrawer used for initialization

Definition at line 74 of file TileCalibDrawerBase.cxx.

 {
   //=== copy content of other blob
   *m_blob_nc = *other.m_blob;
   //=== and reset cached attributes
   m_blobStart32 = static_cast<const uint32_t*>(m_blob->startingAddress());
   m_blobStart16 = static_cast<const uint16_t*>(m_blob->startingAddress());
   m_blobSize32  = m_blob->size()/sizeof(uint32_t);
 }

◆ createBlob()

uint32_t TileCalibDrawerBase::createBlob	(	uint16_t	objType,
		uint16_t	objVersion,
		uint32_t	objSizeUint32,
		uint32_t	nObjs,
		uint16_t	nChans,
		uint16_t	nGains,
		const std::string &	author = `""`,
		const std::string &	comment = `""`,
		uint64_t	timeStamp = `0`
	)

protectedinherited

(re-)creation of the referenced BLOB object.

Parameters

objType	Object type
objVersion	Object version
objSizeUint32	Size of a data object (in uint32_t)
nObjs	Total number of data objects
nChans	number of stored channels
nGains	number of stored gains
author	comment author
comment	actual comment
timeStamp	unix time stamp (if 0, current time is used)

Definition at line 87 of file TileCalibDrawerBase.cxx.

 {
   //=== blob data length including header in bytes
   uint32_t dataSizeByte = (m_hdrSize32+objSizeUint32*nObjs) * sizeof(uint32_t);
   
   //=== calculate comment length, including two ASCII NULLs to end text fields
   uint32_t commentSizeChar(0);
   if(author.size() || comment.size() || timeStamp){
     commentSizeChar += author.size()+comment.size()+sizeof(uint64_t) + 2;
     //=== force comment length to end on 4 byte boundary
     commentSizeChar += (commentSizeChar % sizeof(uint32_t)) ? 
       (sizeof(uint32_t)-(commentSizeChar % sizeof(uint32_t))) : 0;
   }
   
   //=== create blob
   uint32_t blobSizeInBytes = dataSizeByte+commentSizeChar;
   m_blob_nc->resize(blobSizeInBytes);
   uint32_t* blobStart32 = static_cast<uint32_t*>(m_blob_nc->startingAddress());
   uint16_t* blobStart16 = static_cast<uint16_t*>(m_blob_nc->startingAddress());
   m_blobSize32  = m_blob_nc->size()/sizeof(uint32_t);
  
   m_blobStart32 = blobStart32;
   m_blobStart16 = blobStart16;
  
   //=== fill header
   blobStart16[0] = objType;
   blobStart16[1] = objVersion;
   blobStart32[1] = objSizeUint32;
   blobStart32[2] = nObjs;
   blobStart16[6] = nChans;
   blobStart16[7] = nGains;
   blobStart32[4] = commentSizeChar/sizeof(uint32_t);
   
   //==== fill comment fields
   if(commentSizeChar){
     if(!timeStamp) timeStamp = ::time(0);
     uint64_t* pTimeStamp = reinterpret_cast<uint64_t*>(blobStart32+dataSizeByte/sizeof(uint32_t));
     pTimeStamp[0] = timeStamp;
     char* pChar = reinterpret_cast<char*>(++pTimeStamp); 
     std::string::const_iterator iStr = author.begin();
     for(; iStr!=author.end(); ++iStr){ *pChar = *iStr; ++pChar; }
     *pChar = 0; 
     for(iStr=comment.begin(); iStr!=comment.end(); ++iStr){ *(++pChar) = *iStr; }
     *(++pChar) = 0;
   }
  
   return (blobSizeInBytes/sizeof(uint32_t));
 }

◆ dump() [1/2]

virtual void TileCalibDrawerOfc::dump ( ) const

inlinevirtual

Prints out the object content to std::cout.

Reimplemented from TileCalibDrawerBase.

Definition at line 122 of file TileCalibDrawerOfc.h.

122 { dump(std::cout); }

◆ dump() [2/2]

void TileCalibDrawerOfc::dump ( std::ostream & stm ) const

virtual

Prints out the object content.

Parameters

stm	The stream to print to

Reimplemented from TileCalibDrawerBase.

Definition at line 165 of file TileCalibDrawerOfc.cxx.

                                                    {
   TileCalibDrawerBase::dumpHeader(stm);
   unsigned int channel = 0;
   for(int iPhase = 0; iPhase < std::abs(getNPhases()); ++iPhase){
     for(unsigned int sample = 0; sample < getNSamples(); ++sample){
       for(unsigned int adc = 0; adc < getNGains(); ++adc){
     float phase = getPhase(channel, adc, iPhase);
     stm << channel << "/" << phase << "/" << sample << "/" << adc << "\t";
     for(unsigned int field = 0; field < getNFields(getObjVersion()); ++field){
       stm << getOfc(field,channel, adc, phase, sample) << "\t";
     }
     stm << std::endl;
       }
     }
   }
 }

◆ dumpHeader()

void TileCalibDrawerBase::dumpHeader ( std::ostream & stm ) const

protectedinherited

Prints the BLOB header summary information.

Parameters

stm	output stream to use

Definition at line 200 of file TileCalibDrawerBase.cxx.

 {
   stm << "This is a " << TileCalibType::getClassName(getObjType()) << std::endl;
   stm << "ObjType        : " << getObjType()     << std::endl;
   stm << "ObjVersion     : " << getObjVersion()  << std::endl;
   stm << "ObjSize [bytes]: " << getObjSizeByte() << std::endl;
   stm << "NObjs          : " << getNObjs()       << std::endl;
   stm << "NChannels      : " << getNChans()      << std::endl;
   stm << "NGains         : " << getNGains()      << std::endl;
   if(!getCommentSizeUint32()){
     stm << "=== No comment available ===" << std::endl;
   }
   else{
     stm << "Author         : " << getAuthor()      << std::endl;
     stm << "Date           : " << getDate() << " ("<< getTimeStamp() << ")" << std::endl;
     stm << "Comment:       : " << getComment()     << std::endl;
   }  
 }

◆ fillOfc()

void TileCalibDrawerOfc::fillOfc	(	unsigned int	channel,
		unsigned int	adc,
		float &	phase,
		float *	w_a,
		float *	w_b,
		float *	w_c,
		float *	g,
		float *	dg
	)		const

Fill all OFC for optimazation.

Parameters

channel	The channel number; If channel number >= getNChans() it is reset to channel % (maximum number of channels in drawer) if channel number > (maximum number of channels in drawer) otherwise it is reset to 0 without warning (default policy)
adc	The gain index; if >= getNGains() it is reset to 0 without warning (default policy)
phase	The phase of interest

◆ getAddress() [1/2]

void* TileCalibDrawerBase::getAddress ( unsigned int iEle )

inherited

◆ getAddress() [2/2]

const void* TileCalibDrawerBase::getAddress ( unsigned int iEle ) const

inherited

Returns start address of iEle-th basic unit.

Parameters

iEle	sequential basic unit number

◆ getAuthor()

std::string TileCalibDrawerBase::getAuthor ( ) const

inherited

Returns the comment author.

Definition at line 147 of file TileCalibDrawerBase.cxx.

 {
   if(!getCommentSizeUint32()) return std::string("");
   const char* iBeg =
     reinterpret_cast<const char*>(m_blobStart32 + m_hdrSize32     +
                                   getNObjs()*getObjSizeUint32()   +
                                   sizeof(uint64_t)/sizeof(uint32_t));
   return std::string(iBeg);
 }

◆ getBlobSize()

long TileCalibDrawerBase::getBlobSize ( ) const

inlineinherited

Returns the BLOB size in units of bytes.

Definition at line 92 of file TileCalibDrawerBase.h.

92 { return m_blobSize32 * sizeof(uint32_t); }

◆ getBlobSize32()

long TileCalibDrawerBase::getBlobSize32 ( ) const

inlineinherited

Returns the BLOB size in units of uint32_t.

Definition at line 94 of file TileCalibDrawerBase.h.

94 { return m_blobSize32; }

◆ getComment()

std::string TileCalibDrawerBase::getComment ( ) const

inherited

Returns the actual comment.

Definition at line 161 of file TileCalibDrawerBase.cxx.

 {
   if(!getCommentSizeUint32()) return std::string("");
   const char* iBeg =
     reinterpret_cast<const char*>(m_blobStart32 + m_hdrSize32     +
                                   getNObjs()*getObjSizeUint32()   +
                                   sizeof(uint64_t)/sizeof(uint32_t));
   const char* iEnd = iBeg + getCommentSizeChar();
   iBeg = std::find(iBeg,iEnd,0);
   return std::string(++iBeg);
 }

◆ getCommentSizeChar()

uint32_t TileCalibDrawerBase::getCommentSizeChar ( ) const

inlineinherited

Returns the space occupied by the comment fields in units of chars.

Definition at line 112 of file TileCalibDrawerBase.h.

112 {return getCommentSizeUint32()*sizeof(uint32_t);}

◆ getCommentSizeUint32()

uint32_t TileCalibDrawerBase::getCommentSizeUint32 ( ) const

inherited

Returns the space occupied by the comment fields in units of uint32_t.

◆ getDate()

std::string TileCalibDrawerBase::getDate ( ) const

inherited

Returns the date of the comment as string (derived from timestamp)

Definition at line 176 of file TileCalibDrawerBase.cxx.

 {
   if(!getCommentSizeUint32()) return std::string("");
   ::time_t timeStamp = getTimeStamp();
   char buf[32];
   char* iBeg = ::ctime_r(&timeStamp, buf);
   char* iEnd = iBeg;
   while(*iEnd!='\n'){++iEnd;}
   return std::string(iBeg,iEnd-iBeg);
 }

◆ getFullComment()

std::string TileCalibDrawerBase::getFullComment ( ) const

inherited

Returns a formated string build from all comment fields.

Definition at line 190 of file TileCalibDrawerBase.cxx.

 {
   if(!getCommentSizeUint32()) return std::string("");
   return getAuthor()+" ("+getDate()+"): "+getComment();
 }

◆ getInstance() [1/2]

const TileCalibDrawerOfc * TileCalibDrawerOfc::getInstance ( const coral::Blob & blob )

static

Returns a pointer to a const TileCalibDrawerOfc.

Definition at line 31 of file TileCalibDrawerOfc.cxx.

                                                                                {
  
   //=== const Blob needs to be correctly formated
   if(blob.size() < static_cast<long>(m_hdrSize32)) {
     throw TileCalib::InvalidBlob("TileCalibDrawerOfc::getInstance");
   }
   return (new TileCalibDrawerOfc(blob));
 }

◆ getInstance() [2/2]

TileCalibDrawerOfc * TileCalibDrawerOfc::getInstance	(	coral::Blob &	blob,
		uint16_t	objVersion,
		uint32_t	nSamples,
		int32_t	nPhases,
		uint16_t	nChans,
		uint16_t	nGains,
		const std::string &	author = `""`,
		const std::string &	comment = `""`,
		uint64_t	timeStamp = `0`
	)

static

Returns a pointer to a non-const TileCalibDrawerOfc.

A negative nPhases value implies that the same phase table is used for all stored ADCs.

Parameters

blob	Reference to coral::Blob
objVersion	The objects version
nSamples	The number of samples to store.
nPhases	The number of phases to be stored for each ADC (negative: same phases for all ADCs)
nChans	The number of channels
nGains	The number of gains
author	String containing the author user id
comment	String containing the actual comment
timeStamp	Unix time stamp (if 0, current time is used)

Definition at line 14 of file TileCalibDrawerOfc.cxx.

 {
   TileCalibDrawerOfc* calibDrawer = new TileCalibDrawerOfc(blob);
   calibDrawer->init(objVersion, nSamples, nPhases, nChans, nGains, author, comment, timeStamp);
   return calibDrawer;
 }

◆ getNChans()

uint16_t TileCalibDrawerBase::getNChans ( ) const

inherited

Returns the number of channels stored in the BLOB.

◆ getNFields()

uint32_t TileCalibDrawerOfc::getNFields ( uint16_t objVersion = 0 ) const

Returns the number of fields.

Returns 3 for OF1, 4 for OF2, 5 for OF2+pulse_derivative.

Parameters

objVersion The object version If default objVersion is passed, the object version is determined from the Blob.

◆ getNGains()

uint16_t TileCalibDrawerBase::getNGains ( ) const

inherited

Returns the number of gains stored for each channel.

◆ getNObjs()

uint32_t TileCalibDrawerBase::getNObjs ( ) const

inherited

Returns the number of data objects stored int the BLOB.

◆ getNPhases()

int32_t TileCalibDrawerOfc::getNPhases ( ) const

Returns the number of phases (WARNING: Can be negative!)

◆ getNSamples()

uint32_t TileCalibDrawerOfc::getNSamples ( ) const

Returns the number of sample stored.

◆ getObjSizeByte()

uint32_t TileCalibDrawerBase::getObjSizeByte ( ) const

inlineinherited

Returns the size of a data object in units of bytes.

Definition at line 102 of file TileCalibDrawerBase.h.

102 {return getObjSizeUint32()*sizeof(uint32_t);}

◆ getObjSizeUint32()

uint32_t TileCalibDrawerBase::getObjSizeUint32 ( ) const

inherited

Returns the size of a data object in units of uint32_t.

◆ getObjType()

uint16_t TileCalibDrawerBase::getObjType ( ) const

inherited

Returns the BLOB object type.

◆ getObjVersion()

uint16_t TileCalibDrawerBase::getObjVersion ( ) const

inherited

Returns the BLOB object version.

◆ getOfc()

float TileCalibDrawerOfc::getOfc	(	unsigned int	field,
		unsigned int	channel,
		unsigned int	adc,
		float	phase,
		unsigned int	sample
	)		const

Returns OFC data.

Parameters

field	The field identifier
channel	The channel number; If channel number >= getNChans() it is reset to channel % (maximum number of channels in drawer) if channel number > (maximum number of channels in drawer) otherwise it is reset to 0 without warning (default policy)
adc	The gain index; if >= getNGains() it is reset to 0 without warning (default policy)
phase	The phase of interest
sample	The sample of interest

◆ getOfcStartAddress() [1/2]

float* TileCalibDrawerOfc::getOfcStartAddress	(	unsigned int	field,
		unsigned int	channel,
		unsigned int	adc,
		float &	phase
	)

private

◆ getOfcStartAddress() [2/2]

const float* TileCalibDrawerOfc::getOfcStartAddress	(	unsigned int	field,
		unsigned int	channel,
		unsigned int	adc,
		float &	phase
	)		const

private

Returns pointer to first data OFC for a given field, ADC & phase.

Parameters

field	The field identifier
channel	The channel number
adc	The gain index
phase	The phase

◆ getOfcStartOffset()

unsigned int TileCalibDrawerOfc::getOfcStartOffset	(	unsigned int	field,
		unsigned int	channel,
		unsigned int	adc,
		float &	phase
	)		const

private

◆ getPhase()

float TileCalibDrawerOfc::getPhase	(	unsigned int	channel,
		unsigned int	adc,
		unsigned int	phaseIdx
	)		const

Returns the stored phase.

Parameters

channel	The channel number
adc	The gain index
phaseIdx	The phase index

◆ getPhaseNumber()

unsigned int TileCalibDrawerOfc::getPhaseNumber	(	unsigned int	channel,
		unsigned int	adc,
		float &	phase
	)		const

private

Returns the index for a given phase.

Parameters

channel	The channel number
adc	The gain index
phase	The phase of interest

◆ getPhaseStartAddress() [1/2]

int32_t* TileCalibDrawerOfc::getPhaseStartAddress	(	unsigned int	channel,
		unsigned int	adc,
		unsigned int	phaseIdx
	)

private

◆ getPhaseStartAddress() [2/2]

const int32_t* TileCalibDrawerOfc::getPhaseStartAddress	(	unsigned int	channel,
		unsigned int	adc,
		unsigned int	phaseIdx
	)		const

private

Returns pointer to the requested phase value.

Parameters

channel	The channel number
adc	The gain index
phaseIdx	The phase index

◆ getPhaseStartOffset()

unsigned int TileCalibDrawerOfc::getPhaseStartOffset	(	unsigned int	channel,
		unsigned int	adc,
		unsigned int	phaseIdx
	)		const

private

◆ getTimeStamp()

uint64_t TileCalibDrawerBase::getTimeStamp ( ) const

inherited

Returns the unix timestamp of the comment (seconds since 1.1.1970)

◆ getType()

virtual uint16_t TileCalibDrawerOfc::getType ( ) const

inlinevirtual

Returns TileCalibType::OFC.

Reimplemented from TileCalibDrawerBase.

Definition at line 51 of file TileCalibDrawerOfc.h.

51 {return TileCalibType::OFC;}

◆ init()

void TileCalibDrawerOfc::init	(	uint16_t	objVersion,
		uint32_t	nSamples,
		int32_t	nPhases,
		uint16_t	nChans,
		uint16_t	nGains,
		const std::string &	author = `""`,
		const std::string &	comment = `""`,
		uint64_t	timeStamp = `0`
	)

Function for initializing a TileCalibDrawerOfc BLOB.

Parameters

objVersion	The objects version
nSamples	The number of samples to store.
nPhases	The number of phases to be stored for each ADC (negative: same phases for all ADCs)
nChans	The number of channels
nGains	The number of gains
author	String containing the author user id
comment	String containing the actual comment
timeStamp	Unix time stamp (if 0, current time is used)

A negative nPhases value implies that the same phase table is used for all stored ADCs.

Definition at line 91 of file TileCalibDrawerOfc.cxx.

 {
   const uint16_t extraHeaderSize(2);
   uint16_t objType  = getType();
   uint32_t objSize  = 1; // everything is either uint32_t or float
   uint32_t objCount = extraHeaderSize; 
  
   //=== if nPhases<0, use one phase table for ADCs
   //=== otherwise use one table per ADC
   unsigned int nPhasesAbs = std::abs(nPhases);
   int          nPhasesSgn = nPhases < 0 ? -1 : 1;
   unsigned int phasesSize = nPhasesAbs;
   if(nPhasesSgn > 0){ phasesSize *= nChans*nGains; }
   objCount += phasesSize;
   
   uint32_t nFields = getNFields(objVersion);
   objCount += ( nSamples * nFields * nGains * nPhasesAbs * nChans );
   
   //=== create blob of correct type and size
   uint32_t blobLengthUint32 = 
     createBlob(objType, objVersion, objSize, objCount, nChans, nGains, author, comment, timeStamp);
   
   //=== fill header
   uint32_t* pu = static_cast<uint32_t*>(getAddress(0));
   *pu = nSamples; 
   int32_t* pi = reinterpret_cast<int32_t*>(++pu);
   *pi = nPhases;
   //=== initialize phase field to zero
   for(unsigned int iPhase = 0; iPhase < phasesSize; ++iPhase){
     *(++pi) = int32_t(0);
   }
   
   //=== initialize rest of blob to zero
   union {
     unsigned int ii;
     float ff;
   } zero;
   zero.ff = 0;
   for(unsigned int i = 0; i < blobLengthUint32 - (m_hdrSize32 + extraHeaderSize+phasesSize); ++i){
     *(++pi) = zero.ii;
   }
 }

◆ initCheck()

void TileCalibDrawerOfc::initCheck ( )

private

Definition at line 58 of file TileCalibDrawerOfc.cxx.

 {
   if(getBlobSize()){
  
     //=== check for correct blob type
     if(getObjType() != getType()){
       throw TileCalib::TypeConflict("TileCalibDrawerOfc::Ctor", getObjType(), getType());
     }
     
     //=== check for correct object size
     unsigned int blobObjSize = getObjSizeByte();
     unsigned int thisObjSize = 0;
     if(     getObjVersion() == 1){ 
       //=== set object size to base unit (4 bytes) 
       thisObjSize = sizeof(uint32_t);
     }
     else if(getObjVersion() == 2){ 
       //=== set object size to base unit (4 bytes) 
       thisObjSize = sizeof(uint32_t);
     }
     else if(getObjVersion() == 3){ 
       //=== set object size to base unit (4 bytes) 
       thisObjSize = sizeof(uint32_t);
     }
     if(blobObjSize != thisObjSize){
       throw TileCalib::SizeConflict("TileCalibDrawerOfc::Ctor", thisObjSize, blobObjSize);
     }
     
   }
 }

◆ setOfc()

void TileCalibDrawerOfc::setOfc	(	unsigned int	field,
		unsigned int	channel,
		unsigned int	adc,
		float	phase,
		unsigned int	sample,
		float	value
	)

Sets OFC data.

Parameters

field	The field identifier
channel	The channel number
adc	The gain index
phase	The phase
sample	The sample number
value	The value to set

◆ setPhases()

void TileCalibDrawerOfc::setPhases	(	unsigned int	channel,
		unsigned int	adc,
		const std::vector< float > &	phases
	)

Sets a phase value.

Parameters

channel	The channel number
adc	The gain index
phases	Vector containing the phases to set

Definition at line 144 of file TileCalibDrawerOfc.cxx.

                                                                                                          {
  
   std::set<int32_t> phaseSet;
   for (const float phase : phases) {
     phaseSet.insert((int32_t) std::round(phase * (1 / PHASE_PRECISION))); // Phases are stored as int(10*phase) in DB  
   }
  
   if(int(phaseSet.size()) != std::abs(getNPhases())){
     throw TileCalib::IndexOutOfRange("TileCalibDrawerOfc::setPhases", phaseSet.size(), std::abs(getNPhases()));
   } 
  
   unsigned int idx(0);
   for (const int32_t phase : phaseSet) {
     *(getPhaseStartAddress(channel, adc, idx)) = phase;
     ++idx;
   }
  
 }

Member Data Documentation

◆ m_blob

const coral::Blob* TileCalibDrawerBase::m_blob

privateinherited

Const reference to the BLOB (always there)

Definition at line 176 of file TileCalibDrawerBase.h.

◆ m_blob_nc

coral::Blob* TileCalibDrawerBase::m_blob_nc

privateinherited

Non-const reference to the BLOB.

(Only present if we were created with a non-const blob.)

Definition at line 174 of file TileCalibDrawerBase.h.

◆ m_blobSize32

uint64_t TileCalibDrawerBase::m_blobSize32

privateinherited

Cache blob size in units of uint32_t.

Definition at line 182 of file TileCalibDrawerBase.h.

◆ m_blobStart16

const uint16_t* TileCalibDrawerBase::m_blobStart16

privateinherited

Cache blob starting address as uint_16t*.

Definition at line 180 of file TileCalibDrawerBase.h.

◆ m_blobStart32

const uint32_t* TileCalibDrawerBase::m_blobStart32

privateinherited

Cache blob starting address as uint_32t*.

Definition at line 178 of file TileCalibDrawerBase.h.

◆ m_hdrSize32

const unsigned int TileCalibDrawerBase::m_hdrSize32 = 5

staticinherited

The header size in units of uint32_t.

Definition at line 138 of file TileCalibDrawerBase.h.

◆ m_isBlobOwner

bool TileCalibDrawerBase::m_isBlobOwner

privateinherited

Is this TileCalibDrawer owner of the BLOB.

Definition at line 184 of file TileCalibDrawerBase.h.

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

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Private Member Functions

Private Attributes

Detailed Description

Member Enumeration Documentation

◆ FIELD

Constructor & Destructor Documentation

◆ ~TileCalibDrawerOfc()

◆ TileCalibDrawerOfc() [1/2]

◆ TileCalibDrawerOfc() [2/2]

Member Function Documentation

◆ clone()

◆ createBlob()

◆ dump() [1/2]

◆ dump() [2/2]

◆ dumpHeader()

◆ fillOfc()

◆ getAddress() [1/2]

◆ getAddress() [2/2]

◆ getAuthor()

◆ getBlobSize()

◆ getBlobSize32()

◆ getComment()

◆ getCommentSizeChar()

◆ getCommentSizeUint32()

◆ getDate()

◆ getFullComment()

◆ getInstance() [1/2]

◆ getInstance() [2/2]

◆ getNChans()

◆ getNFields()

◆ getNGains()

◆ getNObjs()

◆ getNPhases()

◆ getNSamples()

◆ getObjSizeByte()

◆ getObjSizeUint32()

◆ getObjType()

◆ getObjVersion()

◆ getOfc()

◆ getOfcStartAddress() [1/2]

◆ getOfcStartAddress() [2/2]

◆ getOfcStartOffset()

◆ getPhase()

◆ getPhaseNumber()

◆ getPhaseStartAddress() [1/2]

◆ getPhaseStartAddress() [2/2]

◆ getPhaseStartOffset()

◆ getTimeStamp()

◆ getType()

◆ init()

◆ initCheck()

◆ setOfc()

◆ setPhases()

Member Data Documentation

◆ m_blob

◆ m_blob_nc

◆ m_blobSize32

◆ m_blobStart16

◆ m_blobStart32

◆ m_hdrSize32

◆ m_isBlobOwner