SiPixelDbItem Class Reference

#include <SiPixelDbItem.h>

Classes
class	Packing
	Pack the pixel information to use less memory. More...

Public Member Functions
float	gain ()
short	noise ()
PackedPixDbType	packedValue ()
short	pedestal ()
void	set (short noise, short pedestal, float gain, char status)
	A fast version which sets all in one go. More...
void	setGain (float g)
void	setNoise (short n)
void	setPackedVal (PackedPixDbType p)
void	setPedestal (short p)
void	setStatus (char s)
	SiPixelDbItem ()
char	status ()
	~SiPixelDbItem ()

Private Types
typedef uint32_t	PackedPixDbType

Private Member Functions
template<class Archive >
void	serialize (Archive &ar, const unsigned int version)

Private Attributes
PackedPixDbType	packedVal_

Static Private Attributes
static Packing	packing_

Friends
class	boost::serialization::access
template<typename CondSerializationT , typename Enabled >
struct	cond::serialization::access

Detailed Description

Definition at line 21 of file SiPixelDbItem.h.

Member Typedef Documentation

PackedPixDbType

typedef uint32_t SiPixelDbItem::PackedPixDbType

private

Definition at line 22 of file SiPixelDbItem.h.

Constructor & Destructor Documentation

SiPixelDbItem()

SiPixelDbItem::SiPixelDbItem ( )

inline

Definition at line 25 of file SiPixelDbItem.h.

: packedVal_(0) { set(2, 0, 1.0, 0); }  // TO DO: is noise==2 in shifted rep or not???

~SiPixelDbItem()

SiPixelDbItem::~SiPixelDbItem ( )

inline

Definition at line 26 of file SiPixelDbItem.h.

{}

Member Function Documentation

gain()

float SiPixelDbItem::gain ( )

inline

Definition at line 29 of file SiPixelDbItem.h.

References SiPixelDbItem::Packing::gain_mask, SiPixelDbItem::Packing::gain_shift, packedVal_, and packing_.

Referenced by set().

{ return (packedVal_ >> packing_.gain_shift) & packing_.gain_mask; }

noise()

short SiPixelDbItem::noise ( )

inline

Definition at line 27 of file SiPixelDbItem.h.

References SiPixelDbItem::Packing::noise_mask, SiPixelDbItem::Packing::noise_shift, packedVal_, and packing_.

Referenced by set().

{ return (packedVal_ >> packing_.noise_shift) & packing_.noise_mask; }

packedValue()

PackedPixDbType SiPixelDbItem::packedValue ( )

inline

Definition at line 31 of file SiPixelDbItem.h.

References packedVal_.

{ return packedVal_; }

pedestal()

short SiPixelDbItem::pedestal ( )

inline

Definition at line 28 of file SiPixelDbItem.h.

References packedVal_, packing_, SiPixelDbItem::Packing::pedestal_mask, and SiPixelDbItem::Packing::pedestal_shift.

Referenced by set().

{ return (packedVal_ >> packing_.pedestal_shift) & packing_.pedestal_mask; }

serialize()

template<class Archive >

void SiPixelDbItem::serialize ( Archive &  ar, const unsigned int  version  )

private

set()

void SiPixelDbItem::set	(	short	noise,
		short	pedestal,
		float	gain,
		char	status
	)

A fast version which sets all in one go.

Definition at line 55 of file SiPixelDbItem.cc.

References gain(), SiPixelDbItem::Packing::gain_shift, createfilelist::int, noise(), SiPixelDbItem::Packing::noise_shift, packedVal_, packing_, pedestal(), SiPixelDbItem::Packing::pedestal_shift, status(), and SiPixelDbItem::Packing::status_shift.

                                                                            {
  // Convert gain into a shifted-integer
  int mult_factor = 1 << packing_.gain_shift;  // TO DO: check usage here
  unsigned short gInIntRep = int(gain * mult_factor);

  packedVal_ = (noise << packing_.noise_shift) | (pedestal << packing_.pedestal_shift) |
               (gInIntRep << packing_.gain_shift) | (status << packing_.status_shift);
}

setGain()

void SiPixelDbItem::setGain

(

float

g

)

Definition at line 38 of file SiPixelDbItem.cc.

References g, SiPixelDbItem::Packing::gain_mask, SiPixelDbItem::Packing::gain_shift, createfilelist::int, packedVal_, and packing_.

                                   {
  // Convert gain into a shifted-integer
  int mult_factor = 1 << packing_.gain_shift;  // TO DO: check
  unsigned short gInIntRep = int(g * mult_factor);

  PackedPixDbType newGain = (gInIntRep & packing_.gain_mask) << packing_.gain_shift;
  PackedPixDbType oldValue = packedVal_ & (~(packing_.gain_mask << packing_.gain_shift));
  packedVal_ = oldValue | newGain;
}

setNoise()

void SiPixelDbItem::setNoise

(

short

n

)

The logic of individual setters: First, we put the new value into newXXX, which is a 32-bit word which has the new value at the bits where it should go, and 0's everywhere else. To make it, we:

• assign the value
• AND with a mask – so all others are zeroes
• shift up by noise_shift bits

Next, we prepare the oldValue with a whole where newXXX needs to go. ~(mask << shift) has 1's everywhere except where the new value will go, so AND-ing packedVal_ with it creates a ‘whole’ for the new value.

Finally, the new value is an OR of the two (since the wholes have 0's)

Example: 00 03 c3 02 – old, new one must blow c3 away, so we AND with ff ff 00 ff, and get 00 03 00 02. The new number is now positioned to be ff ff a2 ff, and then we AND these two and get 00 03 a2 02. We have replaced c3 with a2.

Definition at line 26 of file SiPixelDbItem.cc.

References dqmiodumpmetadata::n, SiPixelDbItem::Packing::noise_mask, SiPixelDbItem::Packing::noise_shift, packedVal_, and packing_.

                                    {
  PackedPixDbType newNoise = (n & packing_.noise_mask) << packing_.noise_shift;
  PackedPixDbType oldValue = packedVal_ & (~(packing_.noise_mask << packing_.noise_shift));
  packedVal_ = oldValue | newNoise;
}

setPackedVal()

void SiPixelDbItem::setPackedVal ( PackedPixDbType  p )

inline

Definition at line 33 of file SiPixelDbItem.h.

References AlCaHLTBitMon_ParallelJobs::p, and packedVal_.

{ packedVal_ = p; }

setPedestal()

void SiPixelDbItem::setPedestal

(

short

p

)

Definition at line 32 of file SiPixelDbItem.cc.

References AlCaHLTBitMon_ParallelJobs::p, packedVal_, packing_, SiPixelDbItem::Packing::pedestal_mask, and SiPixelDbItem::Packing::pedestal_shift.

                                       {
  PackedPixDbType newPedestal = (p & packing_.pedestal_mask) << packing_.pedestal_shift;
  PackedPixDbType oldValue = packedVal_ & (~(packing_.pedestal_mask << packing_.pedestal_shift));
  packedVal_ = oldValue | newPedestal;
}

setStatus()

void SiPixelDbItem::setStatus

(

char

s

)

Definition at line 48 of file SiPixelDbItem.cc.

References packedVal_, packing_, alignCSCRings::s, SiPixelDbItem::Packing::status_mask, and SiPixelDbItem::Packing::status_shift.

                                    {
  PackedPixDbType newStatus = (s & packing_.status_mask) << packing_.status_shift;
  PackedPixDbType oldValue = packedVal_ & (~(packing_.status_mask << packing_.status_shift));
  packedVal_ = oldValue | newStatus;
}

status()

char SiPixelDbItem::status ( )

inline

Definition at line 30 of file SiPixelDbItem.h.

References packedVal_, packing_, SiPixelDbItem::Packing::status_mask, and SiPixelDbItem::Packing::status_shift.

Referenced by set().

{ return (packedVal_ >> packing_.status_shift) & packing_.status_mask; }

Friends And Related Function Documentation

boost::serialization::access

friend class boost::serialization::access

friend

Definition at line 67 of file SiPixelDbItem.h.

cond::serialization::access

template<typename CondSerializationT , typename Enabled >

friend struct cond::serialization::access

friend

Definition at line 67 of file SiPixelDbItem.h.

Member Data Documentation

packedVal_

PackedPixDbType SiPixelDbItem::packedVal_

private

Definition at line 43 of file SiPixelDbItem.h.

Referenced by gain(), noise(), packedValue(), pedestal(), set(), setGain(), setNoise(), setPackedVal(), setPedestal(), setStatus(), and status().

packing_

SiPixelDbItem::Packing SiPixelDbItem::packing_

staticprivate

Definition at line 65 of file SiPixelDbItem.h.

Referenced by gain(), noise(), pedestal(), set(), setGain(), setNoise(), setPedestal(), setStatus(), and status().