SiStripCluster Class Reference

#include <SiStripCluster.h>

Public Types
typedef std::vector < SiStripDigi > ::const_iterator	SiStripDigiIter
typedef std::pair < SiStripDigiIter, SiStripDigiIter >	SiStripDigiRange

Public Member Functions
SiStripCluster const &	amplitudes () const
float	barycenter () const
auto const *	begin () const
int	charge () const
bool	empty () const
auto const *	end () const
uint16_t	endStrip () const
template<typename Iter >
void	extend (Iter begin, Iter end)
uint16_t	firstStrip () const
bool	full () const
float	getSplitClusterError () const
bool	isMerged () const
auto	operator[] (int i) const
void	setMerged (bool mergedState)
void	setSplitClusterError (float errx)
	SiStripCluster ()
	SiStripCluster (const SiStripDigiRange &range)
	SiStripCluster (uint16_t firstStrip, std::vector< uint8_t > &&data)
template<typename Iter >
	SiStripCluster (const uint16_t &firstStrip, Iter begin, Iter end)
template<typename Iter >
	SiStripCluster (const uint16_t &firstStrip, Iter begin, Iter end, bool merged)
auto	size () const

Static Public Attributes
static const uint16_t	mergedValueMask = 0x8000
static const uint16_t	stripIndexMask = 0x7FFF

Private Attributes
std::vector< uint8_t >	amplitudes_
float	error_x = -99999.9
uint16_t	firstStrip_ = 0

Detailed Description

Definition at line 8 of file SiStripCluster.h.

Member Typedef Documentation

typedef std::vector<SiStripDigi>::const_iterator SiStripCluster::SiStripDigiIter

Definition at line 10 of file SiStripCluster.h.

typedef std::pair<SiStripDigiIter, SiStripDigiIter> SiStripCluster::SiStripDigiRange

Definition at line 11 of file SiStripCluster.h.

Constructor & Destructor Documentation

SiStripCluster::SiStripCluster ( )

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 20 of file SiStripCluster.h.

{}

SiStripCluster::SiStripCluster ( const SiStripDigiRange &  range )

explicit

check if digis consecutive

Definition at line 4 of file SiStripCluster.cc.

References amplitudes_, mps_fire::i, dqmiolumiharvest::j, and findQualityFiles::v.

                                                            : firstStrip_(range.first->strip()), error_x(-99999.9) {
  std::vector<uint8_t> v;
  v.reserve(range.second - range.first);

  uint16_t lastStrip = 0;
  bool firstInloop = true;
  for (SiStripDigiIter i = range.first; i != range.second; i++) {
    if (!firstInloop && i->strip() != lastStrip + 1) {
      for (int j = 0; j < i->strip() - (lastStrip + 1); j++) {
        v.push_back(0);
      }
    }
    lastStrip = i->strip();
    firstInloop = false;

    v.push_back(i->adc());
  }
  amplitudes_ = v;
}

SiStripCluster::SiStripCluster ( uint16_t  firstStrip, std::vector< uint8_t > &&  data  )

inline

Definition at line 24 of file SiStripCluster.h.

      : amplitudes_(std::move(data)), firstStrip_(firstStrip) {}

template<typename Iter >

SiStripCluster::SiStripCluster ( const uint16_t &  firstStrip, Iter  begin, Iter  end  )

inline

Definition at line 28 of file SiStripCluster.h.

: amplitudes_(begin, end), firstStrip_(firstStrip) {}

template<typename Iter >

SiStripCluster::SiStripCluster ( const uint16_t &  firstStrip, Iter  begin, Iter  end, bool  merged  )

inline

Definition at line 31 of file SiStripCluster.h.

References firstStrip_, and mergedValueMask.

      : amplitudes_(begin, end), firstStrip_(firstStrip) {
    if (merged)
      firstStrip_ |= mergedValueMask;  // if this is a candidate merged cluster
  }

Member Function Documentation

SiStripCluster const& SiStripCluster::amplitudes ( ) const

inline

Definition at line 61 of file SiStripCluster.h.

Referenced by TrackerHitAssociator::associateSimpleRecHitCluster(), SimpleCosmicBONSeeder::checkCharge(), ClusterVariables::clusterSize(), SiStripGainFromData::ComputeChargeOverPath(), DeDxTools::getCharge(), ClusterShapeHitFilter::getSizes(), SiStripRecHitConverterAlgorithm::isMasked(), StMeasurementConditionSet::isMasked(), CalibrationTrackSelector::isOkCharge(), StripCPEfromTrackAngle::localParameters(), PrintRecoObjects::print(), ClusterTPAssociationProducer::produce(), ShallowGainCalibration::produce(), DeDxTools::shapeSelection(), ClusterVariables::stripCharges(), SiStripClusterInfo::stripCharges(), StripSubClusterShapeFilterBase::testLastHit(), reco::InverseCrosstalkMatrix::unfold(), and SiStripClusterInfo::width().

{ return *this; }

float SiStripCluster::barycenter

(

)

const

The barycenter of the cluster, not corrected for Lorentz shift; should not be used as position estimate for tracking.

Definition at line 25 of file SiStripCluster.cc.

References amplitudes_, firstStrip_, mps_fire::i, size(), and stripIndexMask.

Referenced by SiStripClusterInfo::baryStrip(), SiStripFineDelayHit::closestCluster(), SiStripRecHitConverterAlgorithm::isMasked(), StMeasurementConditionSet::isMasked(), StripCPE::localParameters(), StripCPEfromTrackAngle::localParameters(), PrintRecoObjects::print(), and SiStripApproximateCluster::SiStripApproximateCluster().

                                       {
  int sumx = 0;
  int suma = 0;
  auto asize = size();
  for (auto i = 0U; i < asize; ++i) {
    sumx += i * amplitudes_[i];
    suma += amplitudes_[i];
  }

  // strip centers are offcet by half pitch w.r.t. strip numbers,
  // so one has to add 0.5 to get the correct barycenter position.
  // Need to mask off the high bit of firstStrip_, which contains the merged status.
  return float((firstStrip_ & stripIndexMask)) + float(sumx) / float(suma) + 0.5f;
}

auto const* SiStripCluster::begin ( void  ) const

inline

Definition at line 55 of file SiStripCluster.h.

References amplitudes_.

Referenced by charge(), SimpleCosmicBONSeeder::checkCharge(), end(), extend(), CalibrationTrackSelector::isOkCharge(), and operator[]().

{ return amplitudes_.data(); }

int SiStripCluster::charge ( ) const

inline

total charge

Definition at line 77 of file SiStripCluster.h.

References begin(), and end().

Referenced by SiStripApproximateCluster::SiStripApproximateCluster().

{ return std::accumulate(begin(), end(), int(0)); }

bool SiStripCluster::empty ( ) const

inline

Definition at line 58 of file SiStripCluster.h.

References amplitudes_.

{ return amplitudes_.empty(); }

auto const* SiStripCluster::end ( void  ) const

inline

Definition at line 56 of file SiStripCluster.h.

References begin(), and size().

Referenced by charge(), SimpleCosmicBONSeeder::checkCharge(), Types.LuminosityBlockRange::cppID(), Types.EventRange::cppID(), extend(), and CalibrationTrackSelector::isOkCharge().

{ return begin() + size(); }

uint16_t SiStripCluster::endStrip ( ) const

inline

Definition at line 67 of file SiStripCluster.h.

References firstStrip(), and size().

{ return firstStrip() + size(); }

template<typename Iter >

void SiStripCluster::extend ( Iter  begin, Iter  end  )

inline

Definition at line 39 of file SiStripCluster.h.

References amplitudes_, begin(), and end().

Referenced by MatrixUtil.WF::__init__(), Config.Process::extend(), Config.Process::load(), and Mixins._ValidatingParameterListBase::setValue().

                                    {
    amplitudes_.insert(amplitudes_.end(), begin, end);
  }

uint16_t SiStripCluster::firstStrip ( ) const

inline

The number of the first strip in the cluster. The high bit of firstStrip_ indicates whether the cluster is a candidate for being merged.

Definition at line 66 of file SiStripCluster.h.

References firstStrip_, and stripIndexMask.

Referenced by fireworks::addSiStripClusters(), TrackerHitAssociator::associateSimpleRecHitCluster(), FWTrajectorySeedProxyBuilder::build(), SimpleCosmicBONSeeder::checkCharge(), SiStripGainFromData::ComputeChargeOverPath(), FakeCPE::Map::encode(), endStrip(), SiStripClusterInfo::firstStrip(), DeDxTools::getCharge(), ClusterShapeHitFilter::getSizes(), SiStripRecHitConverterAlgorithm::isMasked(), StMeasurementConditionSet::isMasked(), StripCPEgeometric::localParameters(), operator<(), PrintRecoObjects::print(), ShallowTrackClustersProducer::produce(), ClusterTPAssociationProducer::produce(), ShallowGainCalibration::produce(), and StripSubClusterShapeFilterBase::testLastHit().

{ return firstStrip_ & stripIndexMask; }

bool SiStripCluster::full ( ) const

inline

Definition at line 59 of file SiStripCluster.h.

{ return false; }

float SiStripCluster::getSplitClusterError ( ) const

inline

Definition at line 85 of file SiStripCluster.h.

References error_x.

{ return error_x; }

bool SiStripCluster::isMerged ( ) const

inline

Test (set) the merged status of the cluster

Definition at line 82 of file SiStripCluster.h.

References firstStrip_, and mergedValueMask.

Referenced by StripCPEfromTrackAngle::localParameters().

{ return (firstStrip_ & mergedValueMask) != 0; }

auto SiStripCluster::operator[] ( int  i ) const

inline

Definition at line 57 of file SiStripCluster.h.

References begin(), and mps_fire::i.

{ return *(begin() + i); }

void SiStripCluster::setMerged ( bool  mergedState )

inline

Definition at line 83 of file SiStripCluster.h.

References firstStrip_, mergedValueMask, and stripIndexMask.

{ mergedState ? firstStrip_ |= mergedValueMask : firstStrip_ &= stripIndexMask; }

void SiStripCluster::setSplitClusterError ( float  errx )

inline

Definition at line 86 of file SiStripCluster.h.

References error_x.

{ error_x = errx; }

auto SiStripCluster::size ( void  ) const

inline

The amplitudes of the strips forming the cluster. The amplitudes are on consecutive strips; if a strip is missing the amplitude is set to zero. A strip may be missing in the middle of a cluster because of a clusterizer that accepts holes. A strip may also be missing anywhere in the cluster, including the edge, to record a dead/noisy channel.

You can find the special meanings of values { 0, 254, 255} in section 3.4.1 of http://www.te.rl.ac.uk/esdg/cms-fed/firmware/Documents/FE_FPGA_Technical_Description.pdf

Definition at line 54 of file SiStripCluster.h.

References amplitudes_.

Referenced by ntupleDataFormat._Collection::__iter__(), ntupleDataFormat._Collection::__len__(), SiStripMonitorCluster::analyze(), TrackerHitAssociator::associateSimpleRecHitCluster(), barycenter(), ClusterVariables::clusterSize(), end(), endStrip(), ClusterShapeHitFilter::getSizes(), SiStripRecHitConverterAlgorithm::isMasked(), StMeasurementConditionSet::isMasked(), StripCPEfromTrackAngle::localParameters(), PrintRecoObjects::print(), ClusterTPAssociationProducer::produce(), SiStripApproximateCluster::SiStripApproximateCluster(), and SiStripClusterInfo::width().

{ return amplitudes_.size(); }

Member Data Documentation

std::vector<uint8_t> SiStripCluster::amplitudes_

private

Definition at line 89 of file SiStripCluster.h.

Referenced by barycenter(), begin(), empty(), extend(), SiStripCluster(), and size().

float SiStripCluster::error_x = -99999.9

private

Definition at line 101 of file SiStripCluster.h.

Referenced by getSplitClusterError(), and setSplitClusterError().

uint16_t SiStripCluster::firstStrip_ = 0

private

Definition at line 91 of file SiStripCluster.h.

Referenced by barycenter(), firstStrip(), isMerged(), setMerged(), and SiStripCluster().

const uint16_t SiStripCluster::mergedValueMask = 0x8000

static

Definition at line 14 of file SiStripCluster.h.

Referenced by isMerged(), setMerged(), and SiStripCluster().

const uint16_t SiStripCluster::stripIndexMask = 0x7FFF

static

Definition at line 13 of file SiStripCluster.h.

Referenced by barycenter(), firstStrip(), and setMerged().