LArRodBlockPhysicsV5.h

Go to the documentation of this file.

//Dear emacs, this is -*- c++ -*-
 
/*
  Copyright (C) 2002-2026 CERN for the benefit of the ATLAS collaboration
*/
 
#ifndef LARBYTESTREAM_LARRODBLOCKPHYSICSV5_H
#define LARBYTESTREAM_LARRODBLOCKPHYSICSV5_H

 
#include "LArByteStream/LArRodBlockStructure.h"
#include "CaloIdentifier/CaloGain.h"
#include "GaudiKernel/ISvcLocator.h"
#include "LArIdentifier/LArOnlineID.h"
#include <cstdint>
class IMessageSvc;
 
 
class LArRodBlockPhysicsV5 : public LArRodBlockStructure
{
public:
  // ----------------- Header words indexes -----------------
  enum {
    NWTot,            // First words: DSP event header
    NWTot_h,
    FEBID,
    FEBID_h,
    FEB_SN,           // FEB serial number
    FEB_SN_h,         // FEB serial number
    ResultsOff1,      // Size of results (Physics averages in DSP)
    ResultsDim1,      // Offset to results
    ResultsOff2,      // Size of times (in physics)
    ResultsDim2,      // Offset to times (in physics)
    RawDataBlkOff,
    RawDataBlkDim, // Raw FEB event offset
    EventStatus,      // Bits describing the event
    EventStatus_h,      
    NGains,
    NSamples,   
    FirstSampleIndex,  
    FebConfig,
    InFPGAFormat, // added 08.09.2005 - wrong 28.09.2005?
    InFPGAFormat_h,
    endtag          //This tag needs to be an odd number, see *) for constructor
  };
  // constructor
  LArRodBlockPhysicsV5(IMessageSvc* msgSvc);
 
  // ------ Identify RodBlockStructure -------
  static std::string BlockType() { return std::string("RodBlockPhysicsV5");}
 public:
  // ----------------- Decoding methods -----------------
  // Never to be used while encoding!
  // set full ROD fragment before trying to get anything!
  // in case there is more than 1 FEB in 1 fragment, jump to next FEB
  virtual inline int getNextEnergy(int& channelNumber, int32_t& energy, int32_t& time,int32_t& quality,uint32_t& gain);
  virtual int      getNextRawData(int& channelNumber, std::vector<short>& samples, uint32_t& gain);
  int              getNextDigits(int& channelNumber, std::vector<short>& samples, uint32_t& gain);
  virtual uint16_t getResults1Size() const;
  virtual uint16_t getResults2Size() const;
  virtual uint16_t getRawDataSize() const;
  virtual uint16_t getNbSweetCells1() const;
  virtual uint16_t getNbSweetCells2() const;
  virtual uint32_t getNumberOfSamples() const;
  virtual uint32_t getNumberOfGains() const;
  virtual uint32_t getRadd(uint32_t adc, uint32_t sample) const;
  virtual uint16_t getCtrl1(uint32_t adc) const;
  virtual uint16_t getCtrl2(uint32_t adc) const;
  virtual uint16_t getCtrl3(uint32_t adc) const;
  virtual uint32_t getStatus() const;
 
  virtual inline  uint32_t  hasCalibBlock()   const {return 0;} ; 
  virtual inline  uint32_t  hasPhysicsBlock() const {return getHeader16(ResultsOff1);} ;
  virtual inline  uint32_t  hasRawDataBlock() const {return getHeader16(RawDataBlkOff)+getHeader16(ResultsOff2);} ;
  virtual inline  uint32_t  hasControlWords() const {return getHeader16(RawDataBlkOff);} ;
  virtual inline int FebToRodChannel(int ch) const;
 
  // Decode counter block
  virtual inline int32_t getEx() const;
  virtual inline int32_t getEy() const;
  virtual inline int32_t getEz() const;
  virtual inline uint32_t getVROBFebId();
  virtual inline int32_t getVROBEx() const;
  virtual inline int32_t getVROBEy() const;
  virtual inline int32_t getVROBEz() const;
 
  virtual inline int setGain(const int /*GainValue*/) { return 1; };
 
  // Enconding methods
  void initializeFragment(std::vector<uint32_t>& fragment);
  void initializeFEB(const uint32_t id);
  void setNextEnergy(const int channel, const int32_t energy, const int32_t time, const int32_t quality, const uint32_t gain);
  void setRawData(const int , const std::vector<short>& , const uint32_t);
  void finalizeFEB();
  // build full ROD fragment
  void concatinateFEBs();
  virtual inline void setEx(double);
  virtual inline void setEy(double);
  virtual inline void setEz(double);
  
  void setRequiredNSamples(unsigned short ns) { m_requiredNSamples = ns; }
 
  //Ordering relation for channels & digits
  template<class RAWDATA>
  bool operator () (const RAWDATA* ch1, const RAWDATA* ch2) const;
  using LArRodBlockStructure::sortDataVector;  // avoid warnings.
  void sortDataVector( std::vector<const LArDigit*>& vDigit) 
    {std::sort(vDigit.begin(),vDigit.end(),*this); }
 
  
private:
  inline void setE(unsigned index, double E);
  virtual void resetPointers();
  virtual bool setPointers();
  void setNextEnergy(const uint16_t energy,const int16_t time, const int16_t quality, const uint32_t gain);
  uint16_t getNbSweetCells1FromMask() const;
  uint16_t getNbSweetCells2FromMask() const;
 
  std::vector<uint32_t>  m_SumBlkBlockE1;
  std::vector<uint32_t>  m_SumBlkBlockE2;
  std::vector<uint32_t>  m_GainBlock;
  std::vector<uint32_t>  m_FebInfoBlock;
  std::vector<uint16_t>  m_TimeQualityBlock;
  std::vector<uint32_t>  m_RawDataBlock;
  std::vector<uint16_t>  m_EnergyBlockEncode;
  std::vector<uint16_t>  m_DigitsEncode;
 
  int m_EnergyIndex = 0;
  int m_TimeQualityIndex = 0;
  int m_DigitsIndex = 0;
  int m_DigitsChannel = 0;
  int m_RawDataIndex = 0;
  const uint32_t* m_GainPointer = nullptr;
  const uint32_t* m_MaskTimeQualityPointer = nullptr;
  const uint32_t* m_MaskDigitsPointer = nullptr;
  const uint16_t* m_RaddPointer = nullptr;
  const uint16_t* m_EnergyPointer = nullptr;
  const int32_t*  m_SumPointer = nullptr;
  const uint16_t* m_TimeQualityPointer = nullptr;
  const uint16_t* m_DigitsPointer = nullptr;
  const uint16_t* m_RawDataPointer = nullptr;
 
  //For fixed gain mode
  int m_fixedGain;
  uint16_t m_numberHotCell = 0U;
  uint16_t m_numberHotCellOffTime; 
  // Needs one threshold to send time/quality another for samples
  uint16_t m_EnergyThreshold1;
  uint16_t m_EnergyThreshold2;
  int16_t  m_OffTimeCut;
 
  unsigned short m_requiredNSamples;
  const LArOnlineID* m_onlineHelper;
  
public:
  inline uint16_t getFebConfig() const;
  inline uint16_t getFirstSampleIndex() const;
 
  virtual bool canSetCalibration() {return false;}
  bool canSetEnergy() { return true;}
  bool canSetRawData() { return false;}
  bool canIncludeRawData() { return true;}
};
 
inline uint16_t LArRodBlockPhysicsV5::getFebConfig() const
{
  return getHeader16(FebConfig);
}
 
inline uint16_t LArRodBlockPhysicsV5::getFirstSampleIndex() const
{
  return getHeader16(FirstSampleIndex);
}
 
inline int LArRodBlockPhysicsV5::getNextEnergy(int& channelNumber,int32_t& energy,int32_t& time,int32_t& quality, uint32_t& gain)
{
  m_logstr << MSG::DEBUG << "in LArRodBlockPhysicsV5::getNextEnergy." << endmsg;
  m_logstr << MSG::DEBUG << "m_channelsPerFEB=" << m_channelsPerFEB << endmsg;
  if (m_EnergyIndex>=m_channelsPerFEB)                       // Already beyond maximal number of channels
    return 0;
  if (!m_EnergyPointer)                                               // No data block present
    return 0;
 
  unsigned rodChannelNumber=m_EnergyIndex;      // Index of Channel in ROD-Block
  channelNumber=((rodChannelNumber&0xe)<<2) + ((rodChannelNumber&0x1)<<6) + (rodChannelNumber>>4);    //channel number of the FEB
 
  // get information available for all cells
  // Energy on a 16 bit word and decode ranges
  uint16_t encodedEnergy;  // 16 bits Encoded Energy word
  int32_t  aux;  
  uint16_t range;          // 2 bits range
  uint16_t  sign;
 
  m_logstr << MSG::DEBUG <<  "-------->>>> in LArRodBlockPhysicsV5::getNextEnergy : decode energy....." << "\n";
  // decode energy
  if(m_EnergyIndex & 0x1) encodedEnergy = m_EnergyPointer[m_EnergyIndex-1]; // Big/Little Endien stuff
  else                    encodedEnergy = m_EnergyPointer[m_EnergyIndex+1]; // Big/Little Endien stuff
 
  aux = (int32_t) (encodedEnergy&0x1fff); 
  range    = (encodedEnergy & 0xc000) >> 14;
  if(aux==0 && range>0) aux=0x2000;
  sign     =  encodedEnergy & 0x2000;
  aux    <<= 3*range;
  if(sign) aux = -aux;
  energy = aux; 
  
  // gain in 2 bits of a 32 bits word 
  if(m_GainPointer) {
    gain = (uint32_t) ((m_GainPointer[m_EnergyIndex>>4] >> ((m_EnergyIndex&0xf)<<1)) & 0x3);
    gain=RawToOfflineGain(gain);
  } else gain=0xffffffff;
  
  // Get Time and Quality if the information is present according to summary block
  uint32_t hasTQ;
  if(m_MaskTimeQualityPointer)
    hasTQ = (uint32_t) ((m_MaskTimeQualityPointer[m_EnergyIndex>>5] >> (m_EnergyIndex&0x1f)) &0x1);
  else 
    hasTQ = 0;
  m_EnergyIndex++;
  if (m_TimeQualityPointer && hasTQ) // Data has Time and Quality information 
    {
      //Time is in 10 ps in ByteStream, hence the factor 10 to convert to ps
      time    = 10*(reinterpret_cast<const int16_t *>(m_TimeQualityPointer))[m_TimeQualityIndex++]; 
      quality = m_TimeQualityPointer[m_TimeQualityIndex++]; 
 
#ifdef LARBSDBGOUTPUT
      m_logstr << MSG::DEBUG <<"This cell has time and Quality information "<<endmsg;
#endif
    }
  else  // Data has no Time and Quality information
    {
      time=0;
      quality=-1;
    }
 
 
#ifdef LARBSDBGOUTPUT
  m_logstr << MSG::DEBUG <<"Range = "<<range<<endmsg;
  m_logstr << MSG::DEBUG <<"Sign = "<<sign<<endmsg;
  m_logstr << MSG::DEBUG <<" Encoded Energy ="<< MSG::hex << encodedEnergy << MSG::dec << " E=" << energy
     << " t=" << time 
     << " Q=" << quality 
     << " G=" << gain 
     << " channel Number=" << channelNumber
     << endmsg;
#endif
 
  return 1;
}
 
inline int32_t  LArRodBlockPhysicsV5::getEx() const
{
  if(m_SumPointer) return (m_SumPointer[0]>>9);
  return 0;
}
 
inline int32_t  LArRodBlockPhysicsV5::getEy() const
{
  if(m_SumPointer) return (m_SumPointer[1]>>9);
  return 0;
}
 
inline int32_t LArRodBlockPhysicsV5::getEz() const
{
  if(m_SumPointer) return (m_SumPointer[2]>>9);
  return 0;
}
 
inline uint32_t  LArRodBlockPhysicsV5::getVROBFebId()
{
  m_ROB_to_decode--;
  if ( m_ROB_to_decode>=0 ) {
    m_virtualROBPointerLocal = m_virtualROBPointer;
    m_virtualROBPointer+=m_virtualROBJump;
  } else m_virtualROBPointerLocal=0;
  if(m_virtualROBPointerLocal) return (m_virtualROBPointerLocal[0]);
  return 0;
}
 
inline int32_t  LArRodBlockPhysicsV5::getVROBEx() const
{
  const int32_t* p = reinterpret_cast<const int32_t*>(m_virtualROBPointerLocal);
  if(p) return (p[1]>>9);
  return 0;
}
 
inline int32_t  LArRodBlockPhysicsV5::getVROBEy() const
{
  const int32_t* p = reinterpret_cast<const int32_t*>(m_virtualROBPointerLocal);
  if(p) return (p[2]>>9);
  return 0;
}
 
inline int32_t  LArRodBlockPhysicsV5::getVROBEz() const
{
  const int32_t* p = reinterpret_cast<const int32_t*>(m_virtualROBPointerLocal);
  if(p) return (p[3]>>9);
  return 0;
}
 
inline int LArRodBlockPhysicsV5::FebToRodChannel(int ch) const
{
  return ( (ch&0x7) << 4) | ( (ch&0x38) >>2 ) | ((ch&0x40)>>6);
}
 
inline void
LArRodBlockPhysicsV5::setE(unsigned index, double E){
  if (m_TimeQualityBlock.size() < index + 2) {
    return;
  }
  const auto scaled = static_cast<std::int32_t>(E) * (1 << 9);
  const auto bits = static_cast<std::uint32_t>(scaled);
  m_TimeQualityBlock[index] = static_cast<std::uint16_t>(bits & 0xffffu);
  m_TimeQualityBlock[index + 1] = static_cast<std::uint16_t>((bits >> 16) & 0xffffu);
}
 
inline void LArRodBlockPhysicsV5::setEx(double Ex){ 
  setE (0, Ex);
}
 
 
inline void LArRodBlockPhysicsV5::setEy(double Ey){
  setE (2, Ey);
}
 
 
inline void LArRodBlockPhysicsV5::setEz(double Ez){
  setE (4, Ez);
}
 
 
#endif