Phase2ITPixelCluster Class Reference

Pixel cluster – collection of neighboring pixels above threshold. More...

#include <Phase2ITPixelCluster.h>

Classes
class	Pixel
class	PixelPos
class	Shift

Public Types
typedef std::vector< PixelDigi >::const_iterator	PixelDigiIter
typedef std::pair< PixelDigiIter, PixelDigiIter >	PixelDigiRange

Public Member Functions
void	add (const PixelPos &pix, uint32_t adc)
float	charge () const
int	colSpan () const
void	computeMax ()
	moslty to be compatible for <610 More...
float	getSplitClusterErrorX () const
float	getSplitClusterErrorY () const
uint32_t	maxPixelCol () const
uint32_t	maxPixelRow () const
uint32_t	minPixelCol () const
uint32_t	minPixelRow () const
bool	overflow () const
bool	overflowCol () const
bool	overflowRow () const
void	packCol (uint32_t ymin, uint32_t yspan)
void	packRow (uint32_t xmin, uint32_t xspan)
	Phase2ITPixelCluster ()
	Phase2ITPixelCluster (unsigned int isize, uint32_t const *adcs, uint32_t const *xpos, uint32_t const *ypos, uint32_t const xmin, uint32_t const ymin)
	Phase2ITPixelCluster (const PixelPos &pix, uint32_t adc)
Pixel	pixel (int i) const
const std::vector< uint32_t > &	pixelADC () const
const std::vector< uint16_t > &	pixelOffset () const
const std::vector< Pixel >	pixels () const
int	rowSpan () const
void	setSplitClusterErrorX (float errx)
void	setSplitClusterErrorY (float erry)
int	size () const
int	sizeX () const
int	sizeY () const
void	verifyVersion () const
	mostly to be compatible for <610 More...
float	x () const
float	y () const

Static Public Attributes
static unsigned int	MAXPOS =2047
static unsigned int	MAXSPAN =255
static unsigned int	POSBITS =20
static unsigned int	SPANBITS =12

Static Private Member Functions
static int	overflow_ (uint32_t packed)
static uint32_t	pack_ (uint32_t zmin, unsigned int zspan)
static int	span_ (uint32_t packed)

Private Attributes
float	err_x
float	err_y
std::vector< uint32_t >	thePixelADC
uint32_t	thePixelCol
std::vector< uint16_t >	thePixelOffset
uint32_t	thePixelRow

Detailed Description

Pixel cluster – collection of neighboring pixels above threshold.

Pixel cluster – collection of pixels with ADC counts.

Class to contain and store all the topological information of pixel clusters: charge, global size, size and the barycenter in x and y local directions. It builds a vector of Pixel (which is an inner class) and a container of channels.

Class to contain and store all the topological information of pixel clusters: charge, global size, size and the barycenter in x and y local directions. It builds a vector of SiPixel (which is an inner class) and a container of channels.

March 2007: Edge pixel methods moved to RectangularPixelTopology (V.Chiochia) May 2008: Offset based packing (D.Fehling / A. Rizzi)

Author

Petar Maksimovic, JHU

Definition at line 23 of file Phase2ITPixelCluster.h.

Member Typedef Documentation

typedef std::vector<PixelDigi>::const_iterator Phase2ITPixelCluster::PixelDigiIter

Definition at line 63 of file Phase2ITPixelCluster.h.

typedef std::pair<PixelDigiIter,PixelDigiIter> Phase2ITPixelCluster::PixelDigiRange

Definition at line 64 of file Phase2ITPixelCluster.h.

Constructor & Destructor Documentation

Phase2ITPixelCluster::Phase2ITPixelCluster ( )

inline

Construct from a range of digis that form a cluster and from a DetID. The range is assumed to be non-empty.

Definition at line 75 of file Phase2ITPixelCluster.h.

Referenced by Phase2ITPixelCluster().

: thePixelRow(MAXPOS), thePixelCol(MAXPOS), err_x(-99999.9), err_y(-99999.9) {}  // needed by many....

Phase2ITPixelCluster::Phase2ITPixelCluster ( unsigned int  isize, uint32_t const *  adcs, uint32_t const *  xpos, uint32_t const *  ypos, uint32_t const  xmin, uint32_t const  ymin  )

inline

Definition at line 77 of file Phase2ITPixelCluster.h.

References Phase2ITPixelCluster::Pixel::adc, add(), i, min(), packCol(), packRow(), Phase2ITPixelCluster(), thePixelOffset, TrackerOfflineValidation_Dqm_cff::xmin, and Phase2TrackerMonitorDigi_cff::ymin.

                                                      :   
    thePixelOffset(2*isize), thePixelADC(adcs,adcs+isize), err_x(-99999.9), err_y(-99999.9) {
    uint32_t maxCol = 0;
    uint32_t maxRow = 0;
    for (unsigned int i=0; i!=isize; ++i) {
      uint32_t xoffset = xpos[i]-xmin;
      uint32_t yoffset = ypos[i]-ymin;
      thePixelOffset[i*2] = std::min(uint32_t(MAXSPAN),xoffset);
      thePixelOffset[i*2+1] = std::min(uint32_t(MAXSPAN),yoffset);
      if (xoffset > maxRow) maxRow = xoffset; 
      if (yoffset > maxCol) maxCol = yoffset; 
    }
    packRow(xmin,maxRow);
    packCol(ymin,maxCol);
  }

Phase2ITPixelCluster::Phase2ITPixelCluster	(	const PixelPos &	pix,
		uint32_t	adc
	)

Definition at line 19 of file Phase2ITPixelCluster.cc.

References thePixelADC, and thePixelOffset.

                                                                                                 :
  thePixelRow(pix.row()),
  thePixelCol(pix.col()),
    // ggiurgiu@fnal.gov, 01/05/12
  // Initialize the split cluster errors to un-physical values.
  // The CPE will check these errors and if they are not un-physical, 
  // it will recognize the clusters as split and assign these (increased) 
  // errors to the corresponding rechit. 
  err_x(-99999.9),
  err_y(-99999.9)
{
  // First pixel in this cluster.
  thePixelADC.push_back( adc );
  thePixelOffset.push_back(0 );
  thePixelOffset.push_back(0 );
}

Member Function Documentation

void Phase2ITPixelCluster::add	(	const PixelPos &	pix,
		uint32_t	adc
	)

Definition at line 36 of file Phase2ITPixelCluster.cc.

References Phase2ITPixelCluster::PixelPos::col(), i, maxPixelCol(), maxPixelRow(), MAXSPAN, min(), minPixelCol(), minPixelRow(), overflowCol(), overflowRow(), packCol(), packRow(), Phase2ITPixelCluster::PixelPos::row(), thePixelADC, and thePixelOffset.

Referenced by Phase2ITPixelThresholdClusterizer::make_cluster(), Phase2ITPixelCluster(), and counter.Counter::register().

                                                                                     {
  
  uint32_t ominRow = minPixelRow();
  uint32_t ominCol = minPixelCol();
  bool recalculate = false;
  
  uint32_t minRow = ominRow;
  uint32_t minCol = ominCol;
  
  if (pix.row() < minRow) {
    minRow = pix.row();
    recalculate = true;
  }
  if (pix.col() < minCol) {
    minCol = pix.col();
    recalculate = true;
  }
  
  if (recalculate) {
    int maxCol = 0;
    int maxRow = 0;
    int isize = thePixelADC.size();
    for (int i=0; i<isize; ++i) {
      int xoffset = thePixelOffset[i*2]  + ominRow - minRow;
      int yoffset = thePixelOffset[i*2+1]  + ominCol -minCol;
      thePixelOffset[i*2] = std::min(int(MAXSPAN),xoffset);
      thePixelOffset[i*2+1] = std::min(int(MAXSPAN),yoffset);
      if (xoffset > maxRow) maxRow = xoffset; 
      if (yoffset > maxCol) maxCol = yoffset; 
    }
    packRow(minRow,maxRow);
    packCol(minCol,maxCol);
  }
  
  if ( (!overflowRow()) && pix.row() > maxPixelRow()) 
    packRow(minRow,pix.row()-minRow);
  
  if ( (!overflowCol()) && pix.col() > maxPixelCol())
    packCol(minCol,pix.col()-minCol);
  
  thePixelADC.push_back( adc );
  thePixelOffset.push_back( std::min(MAXSPAN,pix.row() - minRow) );
  thePixelOffset.push_back( std::min(MAXSPAN,pix.col() - minCol) );
}

float Phase2ITPixelCluster::charge ( ) const

inline

Definition at line 127 of file Phase2ITPixelCluster.h.

References i, and thePixelADC.

Referenced by Phase2ITPixelThresholdClusterizer::clusterizeDetUnit(), Phase2ITPixelThresholdClusterizer::make_cluster(), x(), and y().

                              {
    float qm = 0.0;
    int isize = thePixelADC.size();
    for (int i=0; i<isize; ++i) 
      qm += float(thePixelADC[i]);
    return qm;
  } // Return total cluster charge.

int Phase2ITPixelCluster::colSpan ( ) const

inline

Definition at line 173 of file Phase2ITPixelCluster.h.

References span_(), and thePixelCol.

Referenced by maxPixelCol(), and sizeY().

{return span_(thePixelCol); }

void Phase2ITPixelCluster::computeMax ( )

inline

moslty to be compatible for <610

Definition at line 200 of file Phase2ITPixelCluster.h.

References i, minPixelCol(), minPixelRow(), packCol(), packRow(), thePixelADC, thePixelOffset, xsize, and ysize.

Referenced by verifyVersion().

                     {
    int maxRow = 0;
    int maxCol = 0;
    int isize  = thePixelADC.size();
    for (int i=0; i!=isize; ++i) {
      int xsize  = thePixelOffset[i*2];
      if (xsize > maxRow) maxRow = xsize;
      int ysize = thePixelOffset[i*2+1] ;
      if (ysize > maxCol) maxCol = ysize;
    }
    // assume minimum is correct
    uint32_t minCol= minPixelCol();
    packCol(minCol,maxCol);
    uint32_t minRow= minPixelRow();
    packRow(minRow,maxRow);
  }

float Phase2ITPixelCluster::getSplitClusterErrorX ( ) const

inline

Definition at line 220 of file Phase2ITPixelCluster.h.

References err_x.

{ return err_x; }

float Phase2ITPixelCluster::getSplitClusterErrorY ( ) const

inline

Definition at line 221 of file Phase2ITPixelCluster.h.

References err_y.

{ return err_y; }

uint32_t Phase2ITPixelCluster::maxPixelCol ( ) const

inline

Definition at line 138 of file Phase2ITPixelCluster.h.

References colSpan(), minPixelCol(), and verifyVersion().

Referenced by add().

{ verifyVersion(); return minPixelCol() + colSpan();} // The max y index.

uint32_t Phase2ITPixelCluster::maxPixelRow ( ) const

inline

Definition at line 136 of file Phase2ITPixelCluster.h.

References minPixelRow(), rowSpan(), and verifyVersion().

Referenced by add().

{ verifyVersion(); return minPixelRow() + rowSpan();} // The max x index.

uint32_t Phase2ITPixelCluster::minPixelCol ( ) const

inline

Definition at line 137 of file Phase2ITPixelCluster.h.

References MAXPOS, and thePixelCol.

Referenced by add(), computeMax(), maxPixelCol(), operator<(), pixel(), and y().

{ return thePixelCol&MAXPOS;} // The min y index.

uint32_t Phase2ITPixelCluster::minPixelRow ( ) const

inline

Definition at line 135 of file Phase2ITPixelCluster.h.

References MAXPOS, and thePixelRow.

Referenced by add(), computeMax(), maxPixelRow(), operator<(), pixel(), and x().

{ return thePixelRow&MAXPOS;} // The min x index.

bool Phase2ITPixelCluster::overflow ( ) const

inline

Definition at line 182 of file Phase2ITPixelCluster.h.

References overflowCol(), and overflowRow().

{ return  overflowCol() || overflowRow(); }

static int Phase2ITPixelCluster::overflow_ ( uint32_t  packed )

inlinestaticprivate

Definition at line 166 of file Phase2ITPixelCluster.h.

References span_().

Referenced by overflowCol(), and overflowRow().

{ return span_(packed)==uint32_t(MAXSPAN);}

bool Phase2ITPixelCluster::overflowCol ( ) const

inline

Definition at line 178 of file Phase2ITPixelCluster.h.

References overflow_(), and thePixelCol.

Referenced by add(), and overflow().

{ return overflow_(thePixelCol); }

bool Phase2ITPixelCluster::overflowRow ( ) const

inline

Definition at line 180 of file Phase2ITPixelCluster.h.

References overflow_(), and thePixelRow.

Referenced by add(), and overflow().

{ return overflow_(thePixelRow); }

static uint32_t Phase2ITPixelCluster::pack_ ( uint32_t  zmin, unsigned int  zspan  )

inlinestaticprivate

Definition at line 167 of file Phase2ITPixelCluster.h.

References min().

Referenced by packCol(), and packRow().

                                                            {
    zspan = std::min(zspan, uint32_t(MAXSPAN));
    return (zspan<<POSBITS) | zmin;
  }

void Phase2ITPixelCluster::packCol ( uint32_t  ymin, uint32_t  yspan  )

inline

Definition at line 184 of file Phase2ITPixelCluster.h.

References pack_(), and thePixelCol.

Referenced by add(), computeMax(), and Phase2ITPixelCluster().

                                              {
    thePixelCol = pack_(ymin,yspan);
  }

void Phase2ITPixelCluster::packRow ( uint32_t  xmin, uint32_t  xspan  )

inline

Definition at line 187 of file Phase2ITPixelCluster.h.

References pack_(), and thePixelRow.

Referenced by add(), computeMax(), and Phase2ITPixelCluster().

                                              {
    thePixelRow = pack_(xmin,xspan);
  }

Pixel Phase2ITPixelCluster::pixel ( int  i ) const

inline

Definition at line 156 of file Phase2ITPixelCluster.h.

References minPixelCol(), minPixelRow(), Phase2ITPixelCluster::Pixel::Pixel(), thePixelADC, and thePixelOffset.

Referenced by pixels().

                           {
    return Pixel(minPixelRow() + thePixelOffset[i*2],
         minPixelCol() + thePixelOffset[i*2+1],
         thePixelADC[i]
         );
  }

const std::vector<uint32_t>& Phase2ITPixelCluster::pixelADC ( ) const

inline

Definition at line 142 of file Phase2ITPixelCluster.h.

References thePixelADC.

{ return thePixelADC;}

const std::vector<uint16_t>& Phase2ITPixelCluster::pixelOffset ( ) const

inline

Definition at line 141 of file Phase2ITPixelCluster.h.

References thePixelOffset.

{ return thePixelOffset;}

const std::vector<Pixel> Phase2ITPixelCluster::pixels ( ) const

inline

Definition at line 145 of file Phase2ITPixelCluster.h.

References i, pixel(), and thePixelADC.

Referenced by Phase2ITPixelThresholdClusterizer::make_cluster().

                                        {
    std::vector<Pixel> oldPixVector;
    int isize = thePixelADC.size();
    oldPixVector.reserve(isize); 
    for(int i=0; i<isize; ++i) {
      oldPixVector.push_back(pixel(i));
    }
    return oldPixVector;
  }

int Phase2ITPixelCluster::rowSpan ( ) const

inline

Definition at line 175 of file Phase2ITPixelCluster.h.

References span_(), and thePixelRow.

Referenced by maxPixelRow(), and sizeX().

{ return span_(thePixelRow); }

void Phase2ITPixelCluster::setSplitClusterErrorX ( float  errx )

inline

Definition at line 218 of file Phase2ITPixelCluster.h.

References err_x.

{ err_x = errx; }

void Phase2ITPixelCluster::setSplitClusterErrorY ( float  erry )

inline

Definition at line 219 of file Phase2ITPixelCluster.h.

References err_y.

{ err_y = erry; }

int Phase2ITPixelCluster::size ( void  ) const

inline

Definition at line 118 of file Phase2ITPixelCluster.h.

References thePixelADC.

Referenced by ntuple._Collection::__iter__(), and ntuple._Collection::__len__().

{ return thePixelADC.size();}

int Phase2ITPixelCluster::sizeX ( ) const

inline

Definition at line 121 of file Phase2ITPixelCluster.h.

References rowSpan(), and verifyVersion().

{verifyVersion(); return rowSpan() +1;}

int Phase2ITPixelCluster::sizeY ( ) const

inline

Definition at line 124 of file Phase2ITPixelCluster.h.

References colSpan(), and verifyVersion().

{verifyVersion(); return colSpan() +1;}

static int Phase2ITPixelCluster::span_ ( uint32_t  packed )

inlinestaticprivate

Definition at line 165 of file Phase2ITPixelCluster.h.

References POSBITS.

Referenced by colSpan(), overflow_(), and rowSpan().

{ return packed >> POSBITS;}

void Phase2ITPixelCluster::verifyVersion ( ) const

inline

mostly to be compatible for <610

Definition at line 194 of file Phase2ITPixelCluster.h.

References computeMax(), thePixelCol, thePixelRow, and unlikely.

Referenced by maxPixelCol(), maxPixelRow(), sizeX(), and sizeY().

                             {
    if unlikely( thePixelRow<MAXPOS && thePixelCol<MAXPOS)
         const_cast<Phase2ITPixelCluster*>(this)->computeMax();
  }

float Phase2ITPixelCluster::x ( ) const

inline

Definition at line 101 of file Phase2ITPixelCluster.h.

References charge(), i, minPixelRow(), thePixelADC, and thePixelOffset.

Referenced by svgfig.Curve.Sample::__repr__(), svgfig.Ellipse::__repr__(), Vispa.Gui.WidgetContainer.WidgetContainer::autosize(), Vispa.Gui.VispaWidget.VispaWidget::boundingRect(), geometryXMLparser.Alignable::pos(), and Vispa.Gui.ConnectableWidget.ConnectableWidget::positionizeMenuWidget().

                  {
    float qm = 0.0;
    int isize = thePixelADC.size();
    for (int i=0; i<isize; ++i)
      qm += float(thePixelADC[i]) * (thePixelOffset[i*2] + minPixelRow() + 0.5f);
    return qm/charge();
  }

float Phase2ITPixelCluster::y ( ) const

inline

Definition at line 109 of file Phase2ITPixelCluster.h.

References charge(), i, minPixelCol(), thePixelADC, and thePixelOffset.

Referenced by svgfig.Ellipse::__repr__(), Vispa.Gui.WidgetContainer.WidgetContainer::autosize(), Vispa.Gui.VispaWidget.VispaWidget::boundingRect(), geometryXMLparser.Alignable::pos(), and Vispa.Gui.ConnectableWidget.ConnectableWidget::positionizeMenuWidget().

                  {
    float qm = 0.0;
    int isize = thePixelADC.size();
    for (int i=0; i<isize; ++i)
      qm += float(thePixelADC[i]) * (thePixelOffset[i*2+1]  + minPixelCol() + 0.5f);
    return qm/charge();
  }

Member Data Documentation

float Phase2ITPixelCluster::err_x

private

Definition at line 238 of file Phase2ITPixelCluster.h.

Referenced by getSplitClusterErrorX(), and setSplitClusterErrorX().

float Phase2ITPixelCluster::err_y

private

Definition at line 239 of file Phase2ITPixelCluster.h.

Referenced by getSplitClusterErrorY(), and setSplitClusterErrorY().

unsigned int Phase2ITPixelCluster::MAXPOS =2047

static

Definition at line 69 of file Phase2ITPixelCluster.h.

Referenced by minPixelCol(), and minPixelRow().

unsigned int Phase2ITPixelCluster::MAXSPAN =255

static

Definition at line 68 of file Phase2ITPixelCluster.h.

Referenced by add().

unsigned int Phase2ITPixelCluster::POSBITS =20

static

Definition at line 66 of file Phase2ITPixelCluster.h.

Referenced by span_().

unsigned int Phase2ITPixelCluster::SPANBITS =12

static

Definition at line 67 of file Phase2ITPixelCluster.h.

std::vector<uint32_t> Phase2ITPixelCluster::thePixelADC

private

Definition at line 227 of file Phase2ITPixelCluster.h.

Referenced by add(), charge(), computeMax(), Phase2ITPixelCluster(), pixel(), pixelADC(), pixels(), size(), x(), and y().

uint32_t Phase2ITPixelCluster::thePixelCol

private

Definition at line 231 of file Phase2ITPixelCluster.h.

Referenced by colSpan(), minPixelCol(), overflowCol(), packCol(), and verifyVersion().

std::vector<uint16_t> Phase2ITPixelCluster::thePixelOffset

private

Definition at line 226 of file Phase2ITPixelCluster.h.

Referenced by add(), computeMax(), Phase2ITPixelCluster(), pixel(), pixelOffset(), x(), and y().

uint32_t Phase2ITPixelCluster::thePixelRow

private

Definition at line 230 of file Phase2ITPixelCluster.h.

Referenced by minPixelRow(), overflowRow(), packRow(), rowSpan(), and verifyVersion().