SiPixelGainCalibration Class Reference

#include <CondFormats/SiPixelObjects/src/SiPixelGainCalibration.cc>

Classes
struct	DecodingStructure
struct	DetRegistry
class	StrictWeakOrdering

Public Types
typedef std::vector< char >::const_iterator	ContainerIterator
typedef std::pair< ContainerIterator, ContainerIterator >	Range
typedef std::vector< DetRegistry >	Registry
typedef Registry::const_iterator	RegistryIterator

Public Member Functions
void	getDetIds (std::vector< uint32_t > &DetIds_) const
float	getGain (const int &col, const int &row, const Range &range, const int &nCols, bool &isDead, bool &isNoisy) const
double	getGainHigh () const
double	getGainLow () const
const int	getNCols (const uint32_t &detID) const
unsigned int	getNumberOfRowsToAverageOver () const
float	getPed (const int &col, const int &row, const Range &range, const int &nCols, bool &isDead, bool &isNoisy) const
double	getPedHigh () const
double	getPedLow () const
const Range	getRange (const uint32_t &detID) const
const std::pair< const Range, const int >	getRangeAndNCols (const uint32_t &detID) const
void	initialize ()
bool	put (const uint32_t &detID, Range input, const int &nCols)
void	setData (float ped, float gain, std::vector< char > &vped, bool thisPixelIsDead=false, bool thisPixelIsNoisy=false)
void	setDeadPixel (std::vector< char > &vped)
void	setNoisyPixel (std::vector< char > &vped)
	SiPixelGainCalibration ()
	SiPixelGainCalibration (float minPed, float maxPed, float minGain, float maxGain)
	~SiPixelGainCalibration ()

Private Member Functions
float	decodeGain (unsigned int gain) const
float	decodePed (unsigned int ped) const
float	encodeGain (const float &gain)
float	encodePed (const float &ped)
template<class Archive >
void	serialize (Archive &ar, const unsigned int version)

Private Attributes
unsigned int	deadFlag_
std::vector< DetRegistry >	indexes
float	maxGain_
float	maxPed_
float	minGain_
float	minPed_
unsigned int	nBinsToUseForEncoding_
unsigned int	noisyFlag_
unsigned int	numberOfRowsToAverageOver_
std::vector< char >	v_pedestals

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

Detailed Description

Description: Gain calibration object for the Silicon Pixel detector. Store gain/pedestal information at pixel granularity

Implementation: <Notes on="" implementation>="">

Definition at line 29 of file SiPixelGainCalibration.h.

Member Typedef Documentation

typedef std::vector<char>::const_iterator SiPixelGainCalibration::ContainerIterator

Definition at line 50 of file SiPixelGainCalibration.h.

typedef std::pair<ContainerIterator, ContainerIterator> SiPixelGainCalibration::Range

Definition at line 51 of file SiPixelGainCalibration.h.

typedef std::vector<DetRegistry> SiPixelGainCalibration::Registry

Definition at line 52 of file SiPixelGainCalibration.h.

typedef Registry::const_iterator SiPixelGainCalibration::RegistryIterator

Definition at line 53 of file SiPixelGainCalibration.h.

Constructor & Destructor Documentation

SiPixelGainCalibration::SiPixelGainCalibration

(

)

Definition at line 9 of file SiPixelGainCalibration.cc.

References deadFlag_, and Exception.

    : minPed_(0.),
      maxPed_(255.),
      minGain_(0.),
      maxGain_(255.),
      numberOfRowsToAverageOver_(1),
      nBinsToUseForEncoding_(253),
      deadFlag_(255),
      noisyFlag_(254) {
  if (deadFlag_ > 0xFF)
    throw cms::Exception("GainCalibration Payload configuration error")
        << "[SiPixelGainCalibration::SiPixelGainCalibration] Dead flag was set to " << deadFlag_
        << ", and it must be set less than or equal to 255";
}

SiPixelGainCalibration::SiPixelGainCalibration	(	float	minPed,
		float	maxPed,
		float	minGain,
		float	maxGain
	)

Definition at line 24 of file SiPixelGainCalibration.cc.

References deadFlag_, and Exception.

    : minPed_(minPed),
      maxPed_(maxPed),
      minGain_(minGain),
      maxGain_(maxGain),
      numberOfRowsToAverageOver_(1),
      nBinsToUseForEncoding_(253),
      deadFlag_(255),
      noisyFlag_(254) {
  if (deadFlag_ > 0xFF)
    throw cms::Exception("GainCalibration Payload configuration error")
        << "[SiPixelGainCalibration::SiPixelGainCalibration] Dead flag was set to " << deadFlag_
        << ", and it must be set less than or equal to 255";
}

SiPixelGainCalibration::~SiPixelGainCalibration ( )

inline

Definition at line 58 of file SiPixelGainCalibration.h.

{}

Member Function Documentation

float SiPixelGainCalibration::decodeGain ( unsigned int  gain ) const

private

Definition at line 184 of file SiPixelGainCalibration.cc.

References dqmMemoryStats::float, maxGain_, minGain_, nBinsToUseForEncoding_, and common_cff::precision.

Referenced by getGain(), and setNoisyPixel().

                                                                {
  double precision = (maxGain_ - minGain_) / static_cast<float>(nBinsToUseForEncoding_);
  float decodedGain = (float)(gain * precision + minGain_);
  return decodedGain;
}

float SiPixelGainCalibration::decodePed ( unsigned int  ped ) const

private

Definition at line 178 of file SiPixelGainCalibration.cc.

References dqmMemoryStats::float, maxPed_, minPed_, nBinsToUseForEncoding_, and common_cff::precision.

Referenced by getPed(), and setNoisyPixel().

                                                              {
  double precision = (maxPed_ - minPed_) / static_cast<float>(nBinsToUseForEncoding_);
  float decodedPed = (float)(ped * precision + minPed_);
  return decodedPed;
}

float SiPixelGainCalibration::encodeGain ( const float &  gain )

private

Definition at line 156 of file SiPixelGainCalibration.cc.

References Exception, dqmMemoryStats::float, maxGain_, minGain_, nBinsToUseForEncoding_, and common_cff::precision.

Referenced by setData(), and setNoisyPixel().

                                                          {
  if (gain < minGain_ || gain > maxGain_) {
    throw cms::Exception("InsertFailure") << "[SiPixelGainCalibration::encodeGain] Trying to encode gain (" << gain
                                          << ") out of range [" << minGain_ << "," << maxGain_ << "]\n";
  } else {
    double precision = (maxGain_ - minGain_) / static_cast<float>(nBinsToUseForEncoding_);
    float encodedGain = (float)((gain - minGain_) / precision);
    return encodedGain;
  }
}

float SiPixelGainCalibration::encodePed ( const float &  ped )

private

Definition at line 167 of file SiPixelGainCalibration.cc.

References Exception, dqmMemoryStats::float, maxPed_, minPed_, nBinsToUseForEncoding_, and common_cff::precision.

Referenced by setData(), and setNoisyPixel().

                                                        {
  if (ped < minPed_ || ped > maxPed_) {
    throw cms::Exception("InsertFailure") << "[SiPixelGainCalibration::encodePed] Trying to encode pedestal (" << ped
                                          << ") out of range [" << minPed_ << "," << maxPed_ << "]\n";
  } else {
    double precision = (maxPed_ - minPed_) / static_cast<float>(nBinsToUseForEncoding_);
    float encodedPed = (float)((ped - minPed_) / precision);
    return encodedPed;
  }
}

void SiPixelGainCalibration::getDetIds

(

std::vector< uint32_t > &

DetIds_

)

const

Definition at line 91 of file SiPixelGainCalibration.cc.

References begin, end, indexes, and AlCaHLTBitMon_ParallelJobs::p.

Referenced by initialize().

                                                                         {
  // returns vector of DetIds in map
  SiPixelGainCalibration::RegistryIterator begin = indexes.begin();
  SiPixelGainCalibration::RegistryIterator end = indexes.end();
  for (SiPixelGainCalibration::RegistryIterator p = begin; p != end; ++p) {
    DetIds_.push_back(p->detid);
  }
}

float SiPixelGainCalibration::getGain	(	const int &	col,
		const int &	row,
		const Range &	range,
		const int &	nCols,
		bool &	isDead,
		bool &	isNoisy
	)		const

Definition at line 141 of file SiPixelGainCalibration.cc.

References deadFlag_, decodeGain(), Exception, PedestalClient_cfi::gain, noisyFlag_, and hgcaltilesconstants::nRows.

Referenced by setNoisyPixel().

                                                                                                             {
  int nRows = (range.second - range.first) / 2 / nCols;
  const unsigned int gain = *(range.first + (col * nRows + row) * 2) & 0xFF;
  if (col >= nCols || row >= nRows) {
    throw cms::Exception("CorruptedData")
        << "[SiPixelGainCalibration::getPed] Pixel out of range: col " << col << " row " << row;
  }
  if (gain == deadFlag_)
    isDead = true;
  if (gain == noisyFlag_)
    isNoisy = true;
  return decodeGain(gain);
}

double SiPixelGainCalibration::getGainHigh ( ) const

inline

Definition at line 70 of file SiPixelGainCalibration.h.

References maxGain_.

{ return maxGain_; }

double SiPixelGainCalibration::getGainLow ( ) const

inline

Definition at line 69 of file SiPixelGainCalibration.h.

References minGain_.

{ return minGain_; }

const int SiPixelGainCalibration::getNCols

(

const uint32_t &

detID

)

const

Definition at line 59 of file SiPixelGainCalibration.cc.

References indexes, and AlCaHLTBitMon_ParallelJobs::p.

Referenced by initialize().

                                                                      {
  // get number of columns of DetId
  RegistryIterator p =
      std::lower_bound(indexes.begin(), indexes.end(), DetId, SiPixelGainCalibration::StrictWeakOrdering());
  if (p == indexes.end() || p->detid != DetId)
    return 0;
  else
    return p->ncols;
}

unsigned int SiPixelGainCalibration::getNumberOfRowsToAverageOver ( ) const

inline

Definition at line 68 of file SiPixelGainCalibration.h.

References numberOfRowsToAverageOver_.

{ return numberOfRowsToAverageOver_; }

float SiPixelGainCalibration::getPed	(	const int &	col,
		const int &	row,
		const Range &	range,
		const int &	nCols,
		bool &	isDead,
		bool &	isNoisy
	)		const

Definition at line 126 of file SiPixelGainCalibration.cc.

References deadFlag_, decodePed(), Exception, noisyFlag_, and hgcaltilesconstants::nRows.

Referenced by setNoisyPixel().

                                                                                                             {
  int nRows = (range.second - range.first) / 2 / nCols;
  const unsigned int ped = *(range.first + 1 + (col * nRows + row) * 2) & 0xFF;
  if (col >= nCols || row >= nRows) {
    throw cms::Exception("CorruptedData")
        << "[SiPixelGainCalibration::getPed] Pixel out of range: col " << col << " row " << row;
  }
  if (ped == deadFlag_)
    isDead = true;
  if (ped == noisyFlag_)
    isNoisy = true;
  return decodePed(ped);
}

double SiPixelGainCalibration::getPedHigh ( ) const

inline

Definition at line 72 of file SiPixelGainCalibration.h.

References SiPixelGainCalibration::DecodingStructure::gain, maxPed_, SiPixelGainCalibration::DecodingStructure::ped, and setData().

{ return maxPed_; }

double SiPixelGainCalibration::getPedLow ( ) const

inline

Definition at line 71 of file SiPixelGainCalibration.h.

References minPed_.

{ return minPed_; }

const SiPixelGainCalibration::Range SiPixelGainCalibration::getRange

(

const uint32_t &

detID

)

const

Definition at line 69 of file SiPixelGainCalibration.cc.

References indexes, AlCaHLTBitMon_ParallelJobs::p, and v_pedestals.

Referenced by initialize().

                                                                                              {
  // get SiPixelGainCalibration Range of DetId

  RegistryIterator p =
      std::lower_bound(indexes.begin(), indexes.end(), DetId, SiPixelGainCalibration::StrictWeakOrdering());
  if (p == indexes.end() || p->detid != DetId)
    return SiPixelGainCalibration::Range(v_pedestals.end(), v_pedestals.end());
  else
    return SiPixelGainCalibration::Range(v_pedestals.begin() + p->ibegin, v_pedestals.begin() + p->iend);
}

const std::pair< const SiPixelGainCalibration::Range, const int > SiPixelGainCalibration::getRangeAndNCols

(

const uint32_t &

detID

)

const

Definition at line 80 of file SiPixelGainCalibration.cc.

References indexes, AlCaHLTBitMon_ParallelJobs::p, and v_pedestals.

Referenced by initialize().

                                 {
  RegistryIterator p =
      std::lower_bound(indexes.begin(), indexes.end(), DetId, SiPixelGainCalibration::StrictWeakOrdering());
  if (p == indexes.end() || p->detid != DetId)
    return std::make_pair(SiPixelGainCalibration::Range(v_pedestals.end(), v_pedestals.end()), 0);
  else
    return std::make_pair(SiPixelGainCalibration::Range(v_pedestals.begin() + p->ibegin, v_pedestals.begin() + p->iend),
                          p->ncols);
}

void SiPixelGainCalibration::initialize ( )

inline

Definition at line 60 of file SiPixelGainCalibration.h.

References getDetIds(), getNCols(), getRange(), getRangeAndNCols(), input, and put().

{}

bool SiPixelGainCalibration::put	(	const uint32_t &	detID,
		Range	input,
		const int &	nCols
	)

Definition at line 39 of file SiPixelGainCalibration.cc.

References SiPixelGainCalibration::DetRegistry::detid, SiPixelGainCalibration::DetRegistry::ibegin, SiPixelGainCalibration::DetRegistry::iend, indexes, SiPixelGainCalibration::DetRegistry::ncols, AlCaHLTBitMon_ParallelJobs::p, sd, and v_pedestals.

Referenced by initialize(), and SiPixelFakeGainESSource::produce().

                                                                                     {
  // put in SiPixelGainCalibration of DetId

  Registry::iterator p =
      std::lower_bound(indexes.begin(), indexes.end(), DetId, SiPixelGainCalibration::StrictWeakOrdering());
  if (p != indexes.end() && p->detid == DetId)
    return false;

  size_t sd = input.second - input.first;
  DetRegistry detregistry;
  detregistry.detid = DetId;
  detregistry.ncols = nCols;
  detregistry.ibegin = v_pedestals.size();
  detregistry.iend = v_pedestals.size() + sd;
  indexes.insert(p, detregistry);

  v_pedestals.insert(v_pedestals.end(), input.first, input.second);
  return true;
}

template<class Archive >

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

private

void SiPixelGainCalibration::setData	(	float	ped,
		float	gain,
		std::vector< char > &	vped,
		bool	thisPixelIsDead = false,
		bool	thisPixelIsNoisy = false
	)

Definition at line 100 of file SiPixelGainCalibration.cc.

References data, deadFlag_, encodeGain(), encodePed(), sistrip::extrainfo::gain_, and noisyFlag_.

Referenced by getPedHigh(), SiPixelFakeGainESSource::produce(), setDeadPixel(), and setNoisyPixel().

                                                                                       {
  float theEncodedGain = 0;
  float theEncodedPed = 0;
  if (!isDeadPixel && !isNoisyPixel) {
    theEncodedGain = encodeGain(gain);
    theEncodedPed = encodePed(ped);
  }

  unsigned int ped_ = (static_cast<unsigned int>(theEncodedPed)) & 0xFF;
  unsigned int gain_ = (static_cast<unsigned int>(theEncodedGain)) & 0xFF;

  if (isDeadPixel) {
    ped_ = deadFlag_ & 0xFF;
    gain_ = deadFlag_ & 0xFF;
  }
  if (isNoisyPixel) {
    ped_ = noisyFlag_ & 0xFF;
    gain_ = noisyFlag_ & 0xFF;
  }
  unsigned int data = (ped_ << 8) | gain_;
  vped.resize(vped.size() + 2);
  // insert in vector of char
  ::memcpy((void*)(&vped[vped.size() - 2]), (void*)(&data), 2);
}

void SiPixelGainCalibration::setDeadPixel ( std::vector< char > &  vped )

inline

Definition at line 78 of file SiPixelGainCalibration.h.

References setData().

{ setData(0, 0, /*dummy values, not used*/ vped, true, false); }

void SiPixelGainCalibration::setNoisyPixel ( std::vector< char > &  vped )

inline

Definition at line 79 of file SiPixelGainCalibration.h.

References cuy::col, decodeGain(), decodePed(), encodeGain(), encodePed(), getGain(), getPed(), FastTimerService_cff::range, and setData().

{ setData(0, 0, /*dummy values, not used*/ vped, false, true); }

Friends And Related Function Documentation

friend class boost::serialization::access

friend

Definition at line 101 of file SiPixelGainCalibration.h.

template<typename CondSerializationT , typename Enabled >

friend struct cond::serialization::access

friend

Definition at line 101 of file SiPixelGainCalibration.h.

Member Data Documentation

unsigned int SiPixelGainCalibration::deadFlag_

private

Definition at line 98 of file SiPixelGainCalibration.h.

Referenced by getGain(), getPed(), setData(), and SiPixelGainCalibration().

std::vector<DetRegistry> SiPixelGainCalibration::indexes

private

Definition at line 91 of file SiPixelGainCalibration.h.

Referenced by getDetIds(), getNCols(), getRange(), getRangeAndNCols(), and put().

float SiPixelGainCalibration::maxGain_

private

Definition at line 92 of file SiPixelGainCalibration.h.

Referenced by decodeGain(), encodeGain(), and getGainHigh().

float SiPixelGainCalibration::maxPed_

private

Definition at line 92 of file SiPixelGainCalibration.h.

Referenced by decodePed(), encodePed(), and getPedHigh().

float SiPixelGainCalibration::minGain_

private

Definition at line 92 of file SiPixelGainCalibration.h.

Referenced by decodeGain(), encodeGain(), and getGainLow().

float SiPixelGainCalibration::minPed_

private

Definition at line 92 of file SiPixelGainCalibration.h.

Referenced by decodePed(), encodePed(), and getPedLow().

unsigned int SiPixelGainCalibration::nBinsToUseForEncoding_

private

Definition at line 97 of file SiPixelGainCalibration.h.

Referenced by decodeGain(), decodePed(), encodeGain(), and encodePed().

unsigned int SiPixelGainCalibration::noisyFlag_

private

Definition at line 99 of file SiPixelGainCalibration.h.

Referenced by getGain(), getPed(), and setData().

unsigned int SiPixelGainCalibration::numberOfRowsToAverageOver_

private

Definition at line 95 of file SiPixelGainCalibration.h.

Referenced by getNumberOfRowsToAverageOver().

std::vector<char> SiPixelGainCalibration::v_pedestals

private

Definition at line 90 of file SiPixelGainCalibration.h.

Referenced by getRange(), getRangeAndNCols(), and put().