PixelDataFormatter Class Reference

#include <PixelDataFormatter.h>

Public Types
typedef std::map< cms_uint32_t, DetBadChannels >	BadChannels
typedef edm::DetSetVector< PixelDigi >	Collection
typedef std::vector< PixelFEDChannel >	DetBadChannels
typedef std::vector< PixelDigi >	DetDigis
typedef std::vector< SiPixelRawDataError >	DetErrors
typedef std::map< cms_uint32_t, DetDigis >	Digis
typedef std::map< cms_uint32_t, DetErrors >	Errors
typedef std::pair< DetDigis::const_iterator, DetDigis::const_iterator >	Range
typedef std::map< int, FEDRawData >	RawData
typedef cms_uint32_t	Word32
typedef cms_uint64_t	Word64

Public Member Functions
void	formatRawData (unsigned int lvl1_ID, RawData &fedRawData, const Digis &digis, const BadChannels &badChannels)
void	interpretRawData (bool &errorsInEvent, int fedId, const FEDRawData &data, Collection &digis, Errors &errors)
cms_uint32_t	linkId (cms_uint32_t word32)
int	nDigis () const
int	nWords () const
void	passFrameReverter (const SiPixelFrameReverter *reverter)
	PixelDataFormatter (const SiPixelFedCabling *map, bool phase1=false)
void	setErrorStatus (bool ErrorStatus)
void	setModulesToUnpack (const std::set< unsigned int > *moduleIds)
void	setQualityStatus (bool QualityStatus, const SiPixelQuality *QualityInfo)

Private Member Functions
int	checkError (const Word32 &data) const
int	digi2word (cms_uint32_t detId, const PixelDigi &digi, std::map< int, std::vector< Word32 > > &words) const
int	digi2wordPhase1Layer1 (cms_uint32_t detId, const PixelDigi &digi, std::map< int, std::vector< Word32 > > &words) const
cms_uint32_t	errorDetId (const SiPixelFrameConverter *converter, int fedId, int errorType, const Word32 &word) const
std::string	print (const PixelDigi &digi) const
std::string	print (const Word64 &word) const
int	word2digi (const int fedId, const SiPixelFrameConverter *converter, const bool includeError, const bool useQuality, const Word32 &word, Digis &digis) const

Private Attributes
Word32	ADC_mask
int	ADC_shift
int	allDetDigis
const SiPixelQuality *	badPixelInfo
Word32	COL_mask
int	COL_shift
Word32	DCOL_mask
int	DCOL_shift
bool	debug
std::unique_ptr< ErrorCheckerBase >	errorcheck
int	hasDetDigis
bool	includeErrors
Word32	LINK_mask
int	LINK_shift
int	maxROCIndex
const std::set< unsigned int > *	modulesToUnpack
bool	phase1
Word32	PXID_mask
int	PXID_shift
Word32	ROC_mask
int	ROC_shift
Word32	ROW_mask
int	ROW_shift
SiPixelFedCabling const *	theCablingTree
int	theDigiCounter
const SiPixelFrameReverter *	theFrameReverter
int	theWordCounter
bool	useQualityInfo

Detailed Description

Transforms Pixel raw data of a given FED to orca digi and vice versa.

FED OUTPUT DATA FORMAT 6/02, d.k. (11/02 updated for 100*150 pixels)

The output is transmitted through a 64 bit S-link connection. The packet format is defined by the CMS RU group to be : 1st packet header, 64 bits, includes a 6 bit FED id. 2nd packet header, 64 bits. .......................... (detector data) packet trailer, 64 bits. of the 64 bit pixel data records consists of 2 32 bit words. Each 32 bit word includes data from 1 pixel, the bit fields are the following:

6 bit link ID (max 36) - this defines the input link within 1 FED. 5 bit ROC ID (max 24) - this defines the readout chip within one link. 5 bit DCOL ID (max 26) - this defines the double column index with 1 chip. 8 bit pixel ID (max 180) - this defines the pixel address within 1 DCOL. 8 bit ADC vales - this has the charge amplitude.

So, 1 pixel occupies 4 bytes. If the number of pixels is odd, one extra 32 bit word is added (value 0) to fill all 64 bits.

The PixelDataFormatter interpret/format ONLY detector data words (not FED headers or trailer, which are treated elsewhere).

Definition at line 57 of file PixelDataFormatter.h.

Member Typedef Documentation

BadChannels

typedef std::map<cms_uint32_t, DetBadChannels> PixelDataFormatter::BadChannels

Definition at line 68 of file PixelDataFormatter.h.

Collection

typedef edm::DetSetVector<PixelDigi> PixelDataFormatter::Collection

Definition at line 59 of file PixelDataFormatter.h.

DetBadChannels

typedef std::vector<PixelFEDChannel> PixelDataFormatter::DetBadChannels

Definition at line 67 of file PixelDataFormatter.h.

DetDigis

typedef std::vector<PixelDigi> PixelDataFormatter::DetDigis

Definition at line 62 of file PixelDataFormatter.h.

DetErrors

typedef std::vector<SiPixelRawDataError> PixelDataFormatter::DetErrors

Definition at line 65 of file PixelDataFormatter.h.

Digis

typedef std::map<cms_uint32_t, DetDigis> PixelDataFormatter::Digis

Definition at line 63 of file PixelDataFormatter.h.

Errors

typedef std::map<cms_uint32_t, DetErrors> PixelDataFormatter::Errors

Definition at line 66 of file PixelDataFormatter.h.

Range

typedef std::pair<DetDigis::const_iterator, DetDigis::const_iterator> PixelDataFormatter::Range

Definition at line 64 of file PixelDataFormatter.h.

RawData

typedef std::map<int, FEDRawData> PixelDataFormatter::RawData

Definition at line 61 of file PixelDataFormatter.h.

Word32

typedef cms_uint32_t PixelDataFormatter::Word32

Definition at line 70 of file PixelDataFormatter.h.

Word64

typedef cms_uint64_t PixelDataFormatter::Word64

Definition at line 71 of file PixelDataFormatter.h.

Constructor & Destructor Documentation

PixelDataFormatter()

PixelDataFormatter::PixelDataFormatter	(	const SiPixelFedCabling *	map,
		bool	phase1 = false
	)

Definition at line 57 of file PixelDataFormatter.cc.

    : theDigiCounter(0),
      theWordCounter(0),
      theCablingTree(map),
      badPixelInfo(nullptr),
      modulesToUnpack(nullptr),
      phase1(phase) {
  int s32 = sizeof(Word32);
  int s64 = sizeof(Word64);
  int s8 = sizeof(char);
  if (s8 != 1 || s32 != 4 * s8 || s64 != 2 * s32) {
    LogError("UnexpectedSizes") << " unexpected sizes: "
                                << "  size of char is: " << s8 << ", size of Word32 is: " << s32
                                << ", size of Word64 is: " << s64 << ", send exception";
  }
  includeErrors = false;
  useQualityInfo = false;
  allDetDigis = 0;
  hasDetDigis = 0;
 
  ADC_shift = 0;
  PXID_shift = ADC_shift + ADC_bits;
  DCOL_shift = PXID_shift + PXID_bits;
  ROC_shift = DCOL_shift + DCOL_bits;
 
  if (phase1) {  // for phase 1
    LINK_shift = ROC_shift + ROC_bits1;
    LINK_mask = ~(~PixelDataFormatter::Word32(0) << LINK_bits1);
    ROC_mask = ~(~PixelDataFormatter::Word32(0) << ROC_bits1);
    // special for layer 1 ROC
    ROW_shift = ADC_shift + ADC_bits;
    COL_shift = ROW_shift + ROW_bits1_l1;
    COL_mask = ~(~PixelDataFormatter::Word32(0) << COL_bits1_l1);
    ROW_mask = ~(~PixelDataFormatter::Word32(0) << ROW_bits1_l1);
    maxROCIndex = 8;
 
  } else {  // for phase 0
    LINK_shift = ROC_shift + ROC_bits;
    LINK_mask = ~(~PixelDataFormatter::Word32(0) << LINK_bits);
    ROC_mask = ~(~PixelDataFormatter::Word32(0) << ROC_bits);
    maxROCIndex = 25;
  }
 
  DCOL_mask = ~(~PixelDataFormatter::Word32(0) << DCOL_bits);
  PXID_mask = ~(~PixelDataFormatter::Word32(0) << PXID_bits);
  ADC_mask = ~(~PixelDataFormatter::Word32(0) << ADC_bits);
 
  if (phase1) {
    errorcheck = std::unique_ptr<ErrorCheckerBase>(new ErrorChecker());
  } else {
    errorcheck = std::unique_ptr<ErrorCheckerBase>(new ErrorCheckerPhase0());
  }
}

References ADC_mask, ADC_shift, allDetDigis, COL_mask, COL_shift, DCOL_mask, DCOL_shift, errorcheck, hasDetDigis, includeErrors, LINK_mask, LINK_shift, maxROCIndex, phase1, PXID_mask, PXID_shift, ROC_mask, ROC_shift, ROW_mask, ROW_shift, and useQualityInfo.

Member Function Documentation

checkError()

int PixelDataFormatter::checkError ( const Word32 &  data ) const

private

digi2word()

int PixelDataFormatter::digi2word ( cms_uint32_t  detId, const PixelDigi &  digi, std::map< int, std::vector< Word32 > > &  words  ) const

private

Definition at line 401 of file PixelDataFormatter.cc.

                                                                             {
  LogDebug("PixelDataFormatter")
      // <<" detId: " << detId
      << print(digi);
 
  DetectorIndex detector = {detId, digi.row(), digi.column()};
  ElectronicIndex cabling;
  int fedId = theFrameReverter->toCabling(cabling, detector);
  if (fedId < 0)
    return fedId;
 
  //if(DANEK) cout<<" digi2raw "<<detId<<" "<<digi.column()<<" "<<digi.row()<<" "<<digi.adc()<<" "
  //  <<cabling.link<<" "<<cabling.roc<<" "<<cabling.dcol<<" "<<cabling.pxid<<endl;
 
  Word32 word = (cabling.link << LINK_shift) | (cabling.roc << ROC_shift) | (cabling.dcol << DCOL_shift) |
                (cabling.pxid << PXID_shift) | (digi.adc() << ADC_shift);
  words[fedId].push_back(word);
  theWordCounter++;
 
  return fedId;
}

References PixelDigi::adc(), ADC_shift, PixelDigi::column(), sipixelobjects::ElectronicIndex::dcol, DCOL_shift, hgcalTestNeighbor_cfi::detector, l1tstage2_dqm_sourceclient-live_cfg::fedId, sipixelobjects::ElectronicIndex::link, LINK_shift, LogDebug, print(), sipixelobjects::ElectronicIndex::pxid, PXID_shift, sipixelobjects::ElectronicIndex::roc, ROC_shift, PixelDigi::row(), theFrameReverter, theWordCounter, and SiPixelFrameReverter::toCabling().

Referenced by formatRawData().

digi2wordPhase1Layer1()

int PixelDataFormatter::digi2wordPhase1Layer1 ( cms_uint32_t  detId, const PixelDigi &  digi, std::map< int, std::vector< Word32 > > &  words  ) const

private

Definition at line 424 of file PixelDataFormatter.cc.

                                                                                         {
  LogDebug("PixelDataFormatter")
      // <<" detId: " << detId
      << print(digi);
 
  DetectorIndex detector = {detId, digi.row(), digi.column()};
  ElectronicIndex cabling;
  int fedId = theFrameReverter->toCabling(cabling, detector);
  if (fedId < 0)
    return fedId;
 
  int col = ((cabling.dcol) * 2) + ((cabling.pxid) % 2);
  int row = LocalPixel::numRowsInRoc - ((cabling.pxid) / 2);
 
  //if(DANEK) cout<<" layer 1: digi2raw "<<detId<<" "<<digi.column()<<" "<<digi.row()<<" "<<digi.adc()<<" "
  //  <<cabling.link<<" "<<cabling.roc<<" "<<cabling.dcol<<" "<<cabling.pxid<<" "
  //  <<col<<" "<<row<<endl;
 
  Word32 word = (cabling.link << LINK_shift) | (cabling.roc << ROC_shift) | (col << COL_shift) | (row << ROW_shift) |
                (digi.adc() << ADC_shift);
  words[fedId].push_back(word);
  theWordCounter++;
 
  return fedId;
}

References PixelDigi::adc(), ADC_shift, cuy::col, COL_shift, PixelDigi::column(), sipixelobjects::ElectronicIndex::dcol, hgcalTestNeighbor_cfi::detector, l1tstage2_dqm_sourceclient-live_cfg::fedId, sipixelobjects::ElectronicIndex::link, LINK_shift, LogDebug, phase1PixelTopology::numRowsInRoc, print(), sipixelobjects::ElectronicIndex::pxid, sipixelobjects::ElectronicIndex::roc, ROC_shift, PixelDigi::row(), ROW_shift, theFrameReverter, theWordCounter, and SiPixelFrameReverter::toCabling().

Referenced by formatRawData().

errorDetId()

cms_uint32_t PixelDataFormatter::errorDetId ( const SiPixelFrameConverter *  converter, int  fedId, int  errorType, const Word32 &  word  ) const

private

formatRawData()

void PixelDataFormatter::formatRawData	(	unsigned int	lvl1_ID,
		RawData &	fedRawData,
		const Digis &	digis,
		const BadChannels &	badChannels
	)

Definition at line 297 of file PixelDataFormatter.cc.

                                                                       {
  std::map<int, vector<Word32> > words;
 
  // translate digis into 32-bit raw words and store in map indexed by Fed
  for (Digis::const_iterator im = digis.begin(); im != digis.end(); im++) {
    allDetDigis++;
    cms_uint32_t rawId = im->first;
    int layer = 0;
    bool barrel = PixelModuleName::isBarrel(rawId);
    if (barrel)
      layer = PixelROC::bpixLayerPhase1(rawId);
    //if(DANEK) cout<<" layer "<<layer<<" "<<phase1<<endl;
 
    BadChannels::const_iterator detBadChannels = badChannels.find(rawId);
 
    hasDetDigis++;
    const DetDigis& detDigis = im->second;
    for (DetDigis::const_iterator it = detDigis.begin(); it != detDigis.end(); it++) {
      theDigiCounter++;
      const PixelDigi& digi = (*it);
      int fedId = 0;
 
      if (layer == 1 && phase1)
        fedId = digi2wordPhase1Layer1(rawId, digi, words);
      else
        fedId = digi2word(rawId, digi, words);
 
      if (fedId < 0) {
        LogError("FormatDataException") << " digi2word returns error #" << fedId << " Ndigis: " << theDigiCounter
                                        << endl
                                        << " detector: " << rawId << endl
                                        << print(digi) << endl;
      } else if (detBadChannels != badChannels.end()) {
        auto badChannel =
            std::find_if(detBadChannels->second.begin(), detBadChannels->second.end(), [&](const PixelFEDChannel& ch) {
              return (int(ch.fed) == fedId && ch.link == linkId(words[fedId].back()));
            });
        if (badChannel != detBadChannels->second.end()) {
          LogError("FormatDataException") << " while marked bad, found digi for FED " << fedId << " Link "
                                          << linkId(words[fedId].back()) << " on module " << rawId << endl
                                          << print(digi) << endl;
        }
      }  // if (fedId)
    }    // for (DetDigis
  }      // for (Digis
  LogTrace(" allDetDigis/hasDetDigis : ") << allDetDigis << "/" << hasDetDigis;
 
  // fill FED error 25 words
  for (const auto& detBadChannels : badChannels) {
    for (const auto& badChannel : detBadChannels.second) {
      unsigned int FEDError25 = 25;
      Word32 word = (badChannel.link << LINK_shift) | (FEDError25 << ROC_shift);
      words[badChannel.fed].push_back(word);
      theWordCounter++;
    }
  }
 
  typedef std::map<int, vector<Word32> >::const_iterator RI;
  for (RI feddata = words.begin(); feddata != words.end(); feddata++) {
    int fedId = feddata->first;
    // since raw words are written in the form of 64-bit packets
    // add extra 32-bit word to make number of words even if necessary
    if (words.find(fedId)->second.size() % 2 != 0)
      words[fedId].push_back(Word32(0));
 
    // size in Bytes; create output structure
    int dataSize = words.find(fedId)->second.size() * sizeof(Word32);
    int nHeaders = 1;
    int nTrailers = 1;
    dataSize += (nHeaders + nTrailers) * sizeof(Word64);
    FEDRawData* rawData = new FEDRawData(dataSize);
 
    // get begining of data;
    Word64* word = reinterpret_cast<Word64*>(rawData->data());
 
    // write one header
    FEDHeader::set(reinterpret_cast<unsigned char*>(word), 0, lvl1_ID, 0, fedId);
    word++;
 
    // write data
    unsigned int nWord32InFed = words.find(fedId)->second.size();
    for (unsigned int i = 0; i < nWord32InFed; i += 2) {
      *word = (Word64(words.find(fedId)->second[i + 1]) << 32) | words.find(fedId)->second[i];
      LogDebug("PixelDataFormatter") << print(*word);
      word++;
    }
 
    // write one trailer
    FEDTrailer::set(reinterpret_cast<unsigned char*>(word), dataSize / sizeof(Word64), 0, 0, 0);
    word++;
 
    // check memory
    if (word != reinterpret_cast<Word64*>(rawData->data() + dataSize)) {
      string s = "** PROBLEM in PixelDataFormatter !!!";
      throw cms::Exception(s);
    }  // if (word !=
    fedRawData[fedId] = *rawData;
    delete rawData;
  }  // for (RI feddata
}

References allDetDigis, Reference_intrackfit_cff::barrel, digi2word(), digi2wordPhase1Layer1(), Exception, l1tstage2_dqm_sourceclient-live_cfg::fedId, l1t_dqm_sourceclient-live_cfg::fedRawData, hasDetDigis, mps_fire::i, PixelModuleName::isBarrel(), LINK_shift, linkId(), LogDebug, LogTrace, phase1, print(), l1tstage2_dqm_sourceclient-live_cfg::rawData, ROC_shift, alignCSCRings::s, FEDHeader::set(), FEDTrailer::set(), theDigiCounter, and theWordCounter.

interpretRawData()

void PixelDataFormatter::interpretRawData	(	bool &	errorsInEvent,
		int	fedId,
		const FEDRawData &	data,
		Collection &	digis,
		Errors &	errors
	)

Definition at line 125 of file PixelDataFormatter.cc.

                                                                                                  {
  using namespace sipixelobjects;
 
  int nWords = rawData.size() / sizeof(Word64);
  if (nWords == 0)
    return;
 
  SiPixelFrameConverter converter(theCablingTree, fedId);
 
  // check CRC bit
  const Word64* trailer = reinterpret_cast<const Word64*>(rawData.data()) + (nWords - 1);
  if (!errorcheck->checkCRC(errorsInEvent, fedId, trailer, errors))
    return;
 
  // check headers
  const Word64* header = reinterpret_cast<const Word64*>(rawData.data());
  header--;
  bool moreHeaders = true;
  while (moreHeaders) {
    header++;
    LogTrace("") << "HEADER:  " << print(*header);
    bool headerStatus = errorcheck->checkHeader(errorsInEvent, fedId, header, errors);
    moreHeaders = headerStatus;
  }
 
  // check trailers
  bool moreTrailers = true;
  trailer++;
  while (moreTrailers) {
    trailer--;
    LogTrace("") << "TRAILER: " << print(*trailer);
    bool trailerStatus = errorcheck->checkTrailer(errorsInEvent, fedId, nWords, trailer, errors);
    moreTrailers = trailerStatus;
  }
 
  // data words
  theWordCounter += 2 * (nWords - 2);
  LogTrace("") << "data words: " << (trailer - header - 1);
 
  int link = -1;
  int roc = -1;
  int layer = 0;
  PixelROC const* rocp = nullptr;
  bool skipROC = false;
  edm::DetSet<PixelDigi>* detDigis = nullptr;
 
  const Word32* bw = (const Word32*)(header + 1);
  const Word32* ew = (const Word32*)(trailer);
  if (*(ew - 1) == 0) {
    ew--;
    theWordCounter--;
  }
  for (auto word = bw; word < ew; ++word) {
    LogTrace("") << "DATA: " << print(*word);
 
    auto ww = *word;
    if UNLIKELY (ww == 0) {
      theWordCounter--;
      continue;
    }
    int nlink = (ww >> LINK_shift) & LINK_mask;
    int nroc = (ww >> ROC_shift) & ROC_mask;
 
    //if(DANEK) cout<<" fed, link, roc "<<fedId<<" "<<nlink<<" "<<nroc<<endl;
 
    if ((nlink != link) | (nroc != roc)) {  // new roc
      link = nlink;
      roc = nroc;
      skipROC = LIKELY(roc < maxROCIndex)
                    ? false
                    : !errorcheck->checkROC(errorsInEvent, fedId, &converter, theCablingTree, ww, errors);
      if (skipROC)
        continue;
      rocp = converter.toRoc(link, roc);
      if UNLIKELY (!rocp) {
        errorsInEvent = true;
        errorcheck->conversionError(fedId, &converter, 2, ww, errors);
        skipROC = true;
        continue;
      }
      auto rawId = rocp->rawId();
      bool barrel = PixelModuleName::isBarrel(rawId);
      if (barrel)
        layer = PixelROC::bpixLayerPhase1(rawId);
      else
        layer = 0;
 
      //if(DANEK) cout<<" rocp "<<rocp->print()<<" layer "<<rocp->bpixLayerPhase1(rawId)<<" "
      //  <<layer<<" phase1 "<<phase1<<" rawid "<<rawId<<endl;
 
      if (useQualityInfo & (nullptr != badPixelInfo)) {
        short rocInDet = (short)rocp->idInDetUnit();
        skipROC = badPixelInfo->IsRocBad(rawId, rocInDet);
        if (skipROC)
          continue;
      }
      skipROC = modulesToUnpack && (modulesToUnpack->find(rawId) == modulesToUnpack->end());
      if (skipROC)
        continue;
 
      detDigis = &digis.find_or_insert(rawId);
      if ((*detDigis).empty())
        (*detDigis).data.reserve(32);  // avoid the first relocations
    }
 
    // skip is roc to be skipped ot invalid
    if UNLIKELY (skipROC || !rocp)
      continue;
 
    int adc = (ww >> ADC_shift) & ADC_mask;
    std::unique_ptr<LocalPixel> local;
 
    if (phase1 && layer == 1) {  // special case for layer 1ROC
      // for l1 roc use the roc column and row index instead of dcol and pixel index.
      int col = (ww >> COL_shift) & COL_mask;
      int row = (ww >> ROW_shift) & ROW_mask;
      //if(DANEK) cout<<" layer 1: raw2digi "<<link<<" "<<roc<<" "
      //  <<col<<" "<<row<<" "<<adc<<endl;
 
      LocalPixel::RocRowCol localCR = {row, col};  // build pixel
      //if(DANEK)cout<<localCR.rocCol<<" "<<localCR.rocRow<<endl;
      if UNLIKELY (!localCR.valid()) {
        LogDebug("PixelDataFormatter::interpretRawData") << "status #3";
        errorsInEvent = true;
        errorcheck->conversionError(fedId, &converter, 3, ww, errors);
        continue;
      }
      local = std::make_unique<LocalPixel>(localCR);  // local pixel coordinate
      //if(DANEK) cout<<local->dcol()<<" "<<local->pxid()<<" "<<local->rocCol()<<" "<<local->rocRow()<<endl;
 
    } else {  // phase0 and phase1 except bpix layer 1
      int dcol = (ww >> DCOL_shift) & DCOL_mask;
      int pxid = (ww >> PXID_shift) & PXID_mask;
      //if(DANEK) cout<<" raw2digi "<<link<<" "<<roc<<" "
      //<<dcol<<" "<<pxid<<" "<<adc<<" "<<layer<<endl;
 
      LocalPixel::DcolPxid localDP = {dcol, pxid};
      //if(DANEK) cout<<localDP.dcol<<" "<<localDP.pxid<<endl;
 
      if UNLIKELY (!localDP.valid()) {
        LogDebug("PixelDataFormatter::interpretRawData") << "status #3";
        errorsInEvent = true;
        errorcheck->conversionError(fedId, &converter, 3, ww, errors);
        continue;
      }
      local = std::make_unique<LocalPixel>(localDP);  // local pixel coordinate
      //if(DANEK) cout<<local->dcol()<<" "<<local->pxid()<<" "<<local->rocCol()<<" "<<local->rocRow()<<endl;
    }
 
    GlobalPixel global = rocp->toGlobal(*local);  // global pixel coordinate (in module)
    (*detDigis).data.emplace_back(global.row, global.col, adc);
    //if(DANEK) cout<<global.row<<" "<<global.col<<" "<<adc<<endl;
    LogTrace("") << (*detDigis).data.back();
  }
}

References ecalLiteDTU::adc(), ADC_mask, ADC_shift, badPixelInfo, Reference_intrackfit_cff::barrel, sipixelobjects::GlobalPixel::col, cuy::col, COL_mask, COL_shift, edm::DetSet< T >::data, DCOL_mask, DCOL_shift, errorcheck, funct::false, l1tstage2_dqm_sourceclient-live_cfg::fedId, edm::DetSetVector< T >::find_or_insert(), RecoTauValidation_cfi::header, sipixelobjects::PixelROC::idInDetUnit(), PixelModuleName::isBarrel(), SiPixelQuality::IsRocBad(), LIKELY, MainPageGenerator::link, LINK_mask, LINK_shift, DTRecHitClients_cfi::local, LogDebug, LogTrace, maxROCIndex, modulesToUnpack, nWords(), phase1, print(), PXID_mask, PXID_shift, l1tstage2_dqm_sourceclient-live_cfg::rawData, sipixelobjects::PixelROC::rawId(), PixelMapPlotter::roc, ROC_mask, ROC_shift, sipixelobjects::GlobalPixel::row, ROW_mask, ROW_shift, theCablingTree, theWordCounter, sipixelobjects::PixelROC::toGlobal(), UNLIKELY, useQualityInfo, sipixelobjects::LocalPixel::RocRowCol::valid(), and sipixelobjects::LocalPixel::DcolPxid::valid().

linkId()

cms_uint32_t PixelDataFormatter::linkId ( cms_uint32_t  word32 )

inline

Definition at line 87 of file PixelDataFormatter.h.

{ return (word32 >> LINK_shift) & LINK_mask; }

References LINK_mask, and LINK_shift.

Referenced by formatRawData().

nDigis()

int PixelDataFormatter::nDigis ( ) const

inline

Definition at line 80 of file PixelDataFormatter.h.

{ return theDigiCounter; }

References theDigiCounter.

nWords()

int PixelDataFormatter::nWords ( ) const

inline

Definition at line 81 of file PixelDataFormatter.h.

{ return theWordCounter; }

References theWordCounter.

Referenced by interpretRawData().

passFrameReverter()

void PixelDataFormatter::passFrameReverter

(

const SiPixelFrameReverter *

reverter

)

Definition at line 123 of file PixelDataFormatter.cc.

{ theFrameReverter = reverter; }

References theFrameReverter.

Referenced by SiPixelDigiToRaw::produce().

print() [1/2]

std::string PixelDataFormatter::print ( const PixelDigi &  digi ) const

private

Definition at line 512 of file PixelDataFormatter.cc.

                                                               {
  ostringstream str;
  str << " DIGI: row: " << digi.row() << ", col: " << digi.column() << ", adc: " << digi.adc();
  return str.str();
}

References PixelDigi::adc(), PixelDigi::column(), PixelDigi::row(), and str.

Referenced by digi2word(), digi2wordPhase1Layer1(), formatRawData(), and interpretRawData().

print() [2/2]

std::string PixelDataFormatter::print ( const Word64 &  word ) const

private

Definition at line 518 of file PixelDataFormatter.cc.

                                                            {
  ostringstream str;
  str << "word64:  " << reinterpret_cast<const bitset<64>&>(word);
  return str.str();
}

References str.

setErrorStatus()

void PixelDataFormatter::setErrorStatus

(

bool

ErrorStatus

)

Definition at line 111 of file PixelDataFormatter.cc.

                                                        {
  includeErrors = ErrorStatus;
  errorcheck->setErrorStatus(includeErrors);
}

References errorcheck, and includeErrors.

Referenced by SiPixelRawToDigi::produce().

setModulesToUnpack()

void PixelDataFormatter::setModulesToUnpack

(

const std::set< unsigned int > *

moduleIds

)

Definition at line 121 of file PixelDataFormatter.cc.

{ modulesToUnpack = moduleIds; }

References modulesToUnpack.

setQualityStatus()

void PixelDataFormatter::setQualityStatus	(	bool	QualityStatus,
		const SiPixelQuality *	QualityInfo
	)

Definition at line 116 of file PixelDataFormatter.cc.

                                                                                               {
  useQualityInfo = QualityStatus;
  badPixelInfo = QualityInfo;
}

References badPixelInfo, and useQualityInfo.

word2digi()

int PixelDataFormatter::word2digi ( const int  fedId, const SiPixelFrameConverter *  converter, const bool  includeError, const bool  useQuality, const Word32 &  word, Digis &  digis  ) const

private

Definition at line 453 of file PixelDataFormatter.cc.

                                                      {
  // do not interpret false digis
  if (word == 0)
    return 0;
 
  ElectronicIndex cabling;
  cabling.dcol = (word >> DCOL_shift) & DCOL_mask;
  cabling.pxid = (word >> PXID_shift) & PXID_mask;
  cabling.link = (word >> LINK_shift) & LINK_mask;
  cabling.roc = (word >> ROC_shift) & ROC_mask;
  int adc = (word >> ADC_shift) & ADC_mask;
 
  if (debug) {
    LocalPixel::DcolPxid pixel = {cabling.dcol, cabling.pxid};
    LocalPixel local(pixel);
    LogTrace("") << " link: " << cabling.link << ", roc: " << cabling.roc << " rocRow: " << local.rocRow()
                 << ", rocCol:" << local.rocCol() << " (dcol: " << cabling.dcol << ", pxid:" << cabling.pxid
                 << "), adc:" << adc;
  }
 
  if (!converter)
    return 0;
 
  DetectorIndex detIdx;
  int status = converter->toDetector(cabling, detIdx);
  if (status)
    return status;
 
  // exclude ROC(raw) based on bad ROC list bad in SiPixelQuality
  // enable: process.siPixelDigis.UseQualityInfo = True
  // 20-10-2010 A.Y.
  if (useQuality && badPixelInfo) {
    CablingPathToDetUnit path = {static_cast<unsigned int>(fedId),
                                 static_cast<unsigned int>(cabling.link),
                                 static_cast<unsigned int>(cabling.roc)};
    const PixelROC* roc = theCablingTree->findItem(path);
    short rocInDet = (short)roc->idInDetUnit();
    bool badROC = badPixelInfo->IsRocBad(detIdx.rawId, rocInDet);
    if (badROC)
      return 0;
  }
 
  if (modulesToUnpack && modulesToUnpack->find(detIdx.rawId) == modulesToUnpack->end())
    return 0;
 
  digis[detIdx.rawId].emplace_back(detIdx.row, detIdx.col, adc);
 
  theDigiCounter++;
 
  if (debug)
    LogTrace("") << digis[detIdx.rawId].back();
  return 0;
}

References ecalLiteDTU::adc(), ADC_mask, ADC_shift, badPixelInfo, sipixelobjects::DetectorIndex::col, sipixelobjects::ElectronicIndex::dcol, DCOL_mask, DCOL_shift, debug, l1tstage2_dqm_sourceclient-live_cfg::fedId, SiPixelFedCabling::findItem(), SiPixelQuality::IsRocBad(), sipixelobjects::ElectronicIndex::link, LINK_mask, LINK_shift, DTRecHitClients_cfi::local, LogTrace, modulesToUnpack, castor_dqm_sourceclient_file_cfg::path, muonClassificationByHits_cfi::pixel, sipixelobjects::ElectronicIndex::pxid, PXID_mask, PXID_shift, sipixelobjects::DetectorIndex::rawId, sipixelobjects::ElectronicIndex::roc, PixelMapPlotter::roc, ROC_mask, ROC_shift, sipixelobjects::DetectorIndex::row, mps_update::status, theCablingTree, theDigiCounter, and bysipixelclustmulteventfilter_cfi::useQuality.

Member Data Documentation

ADC_mask

Word32 PixelDataFormatter::ADC_mask

private

Definition at line 108 of file PixelDataFormatter.h.

Referenced by interpretRawData(), PixelDataFormatter(), and word2digi().

ADC_shift

int PixelDataFormatter::ADC_shift

private

Definition at line 107 of file PixelDataFormatter.h.

Referenced by digi2word(), digi2wordPhase1Layer1(), interpretRawData(), PixelDataFormatter(), and word2digi().

allDetDigis

int PixelDataFormatter::allDetDigis

private

Definition at line 101 of file PixelDataFormatter.h.

Referenced by formatRawData(), and PixelDataFormatter().

badPixelInfo

const SiPixelQuality* PixelDataFormatter::badPixelInfo

private

Definition at line 95 of file PixelDataFormatter.h.

Referenced by interpretRawData(), setQualityStatus(), and word2digi().

COL_mask

Word32 PixelDataFormatter::COL_mask

private

Definition at line 108 of file PixelDataFormatter.h.

Referenced by interpretRawData(), and PixelDataFormatter().

COL_shift

int PixelDataFormatter::COL_shift

private

Definition at line 107 of file PixelDataFormatter.h.

Referenced by digi2wordPhase1Layer1(), interpretRawData(), and PixelDataFormatter().

DCOL_mask

Word32 PixelDataFormatter::DCOL_mask

private

Definition at line 108 of file PixelDataFormatter.h.

Referenced by interpretRawData(), PixelDataFormatter(), and word2digi().

DCOL_shift

int PixelDataFormatter::DCOL_shift

private

Definition at line 107 of file PixelDataFormatter.h.

Referenced by digi2word(), interpretRawData(), PixelDataFormatter(), and word2digi().

debug

bool PixelDataFormatter::debug

private

Definition at line 100 of file PixelDataFormatter.h.

Referenced by rrapi.RRApi::dprint(), pkg.AbstractPkg::generate(), rrapi.RRApi::get(), pkg.AbstractPkg::get_kwds(), runTauIdMVA.TauIDEmbedder::loadMVA_WPs_run2_2017(), runTauIdMVA.TauIDEmbedder::runTauID(), word2digi(), and pkg.AbstractPkg::write().

errorcheck

std::unique_ptr<ErrorCheckerBase> PixelDataFormatter::errorcheck

private

Definition at line 103 of file PixelDataFormatter.h.

Referenced by interpretRawData(), PixelDataFormatter(), and setErrorStatus().

hasDetDigis

int PixelDataFormatter::hasDetDigis

private

Definition at line 102 of file PixelDataFormatter.h.

Referenced by formatRawData(), and PixelDataFormatter().

includeErrors

bool PixelDataFormatter::includeErrors

private

Definition at line 98 of file PixelDataFormatter.h.

Referenced by PixelDataFormatter(), and setErrorStatus().

LINK_mask

Word32 PixelDataFormatter::LINK_mask

private

Definition at line 108 of file PixelDataFormatter.h.

Referenced by interpretRawData(), linkId(), PixelDataFormatter(), and word2digi().

LINK_shift

int PixelDataFormatter::LINK_shift

private

Definition at line 107 of file PixelDataFormatter.h.

Referenced by digi2word(), digi2wordPhase1Layer1(), formatRawData(), interpretRawData(), linkId(), PixelDataFormatter(), and word2digi().

maxROCIndex

int PixelDataFormatter::maxROCIndex

private

Definition at line 109 of file PixelDataFormatter.h.

Referenced by interpretRawData(), and PixelDataFormatter().

modulesToUnpack

const std::set<unsigned int>* PixelDataFormatter::modulesToUnpack

private

Definition at line 96 of file PixelDataFormatter.h.

Referenced by interpretRawData(), setModulesToUnpack(), and word2digi().

phase1

bool PixelDataFormatter::phase1

private

Definition at line 110 of file PixelDataFormatter.h.

Referenced by formatRawData(), interpretRawData(), and PixelDataFormatter().

PXID_mask

Word32 PixelDataFormatter::PXID_mask

private

Definition at line 108 of file PixelDataFormatter.h.

Referenced by interpretRawData(), PixelDataFormatter(), and word2digi().

PXID_shift

int PixelDataFormatter::PXID_shift

private

Definition at line 107 of file PixelDataFormatter.h.

Referenced by digi2word(), interpretRawData(), PixelDataFormatter(), and word2digi().

ROC_mask

Word32 PixelDataFormatter::ROC_mask

private

Definition at line 108 of file PixelDataFormatter.h.

Referenced by interpretRawData(), PixelDataFormatter(), and word2digi().

ROC_shift

int PixelDataFormatter::ROC_shift

private

Definition at line 107 of file PixelDataFormatter.h.

Referenced by digi2word(), digi2wordPhase1Layer1(), formatRawData(), interpretRawData(), PixelDataFormatter(), and word2digi().

ROW_mask

Word32 PixelDataFormatter::ROW_mask

private

Definition at line 108 of file PixelDataFormatter.h.

Referenced by interpretRawData(), and PixelDataFormatter().

ROW_shift

int PixelDataFormatter::ROW_shift

private

Definition at line 107 of file PixelDataFormatter.h.

Referenced by digi2wordPhase1Layer1(), interpretRawData(), and PixelDataFormatter().

theCablingTree

SiPixelFedCabling const* PixelDataFormatter::theCablingTree

private

Definition at line 93 of file PixelDataFormatter.h.

Referenced by interpretRawData(), and word2digi().

theDigiCounter

int PixelDataFormatter::theDigiCounter

mutableprivate

Definition at line 90 of file PixelDataFormatter.h.

Referenced by formatRawData(), nDigis(), and word2digi().

theFrameReverter

const SiPixelFrameReverter* PixelDataFormatter::theFrameReverter

private

Definition at line 94 of file PixelDataFormatter.h.

Referenced by digi2word(), digi2wordPhase1Layer1(), and passFrameReverter().

theWordCounter

int PixelDataFormatter::theWordCounter

mutableprivate

Definition at line 91 of file PixelDataFormatter.h.

Referenced by digi2word(), digi2wordPhase1Layer1(), formatRawData(), interpretRawData(), and nWords().

useQualityInfo

bool PixelDataFormatter::useQualityInfo

private

Definition at line 99 of file PixelDataFormatter.h.

Referenced by interpretRawData(), PixelDataFormatter(), and setQualityStatus().