RD53SimTool Class Reference

#include <RD53SimTool.h>

Inheritance diagram for RD53SimTool:

Collaboration diagram for RD53SimTool:

Public Member Functions
	RD53SimTool (const std::string &type, const std::string &name, const IInterface *parent)
virtual StatusCode	initialize () override
virtual void	process (const EventContext &ctx, SiChargedDiodeCollection &chargedDiodes, PixelRDO_Collection &rdoCollection, CLHEP::HepRandomEngine *rndmEngine) const override
	AthAlgTool (const std::string &type, const std::string &name, const IInterface *parent)
	Constructor with parameters:
ServiceHandle< StoreGateSvc > &	evtStore ()
	The standard StoreGateSvc (event store) Returns (kind of) a pointer to the StoreGateSvc.
const ServiceHandle< StoreGateSvc > &	detStore () const
	The standard StoreGateSvc/DetectorStore Returns (kind of) a pointer to the StoreGateSvc.
virtual StatusCode	sysInitialize () override
	Perform system initialization for an algorithm.
virtual StatusCode	sysStart () override
	Handle START transition.
virtual std::vector< Gaudi::DataHandle * >	inputHandles () const override
	Return this algorithm's input handles.
virtual std::vector< Gaudi::DataHandle * >	outputHandles () const override
	Return this algorithm's output handles.
Gaudi::Details::PropertyBase &	declareProperty (Gaudi::Property< T, V, H > &t)
void	updateVHKA (Gaudi::Details::PropertyBase &)
MsgStream &	msg () const
bool	msgLvl (const MSG::Level lvl) const

Protected Member Functions
void	renounceArray (SG::VarHandleKeyArray &handlesArray)
	remove all handles from I/O resolution
std::enable_if_t< std::is_void_v< std::result_of_t< decltype(&T::renounce)(T)> > &&!std::is_base_of_v< SG::VarHandleKeyArray, T > &&std::is_base_of_v< Gaudi::DataHandle, T >, void >	renounce (T &h)
void	extraDeps_update_handler (Gaudi::Details::PropertyBase &ExtraDeps)
	Add StoreName to extra input/output deps as needed.

Protected Attributes
int	m_numberOfBcid {1}
double	m_timeOffset {5.0}
double	m_timeJitter {0.0}
double	m_thermalNoise {160.0}
ToolHandle< IInDetConditionsTool >	m_pixelConditionsTool
ServiceHandle< InDetDD::IPixelReadoutManager >	m_pixelReadout
SG::ReadCondHandleKey< PixelChargeCalibCondData >	m_chargeDataKey
Gaudi::Property< int >	m_BarrelEC
Gaudi::Property< bool >	m_doNoise
Gaudi::Property< bool >	m_cosmics

Static Protected Attributes
static constexpr double	m_bunchSpace {25.0}

Private Types
typedef ServiceHandle< StoreGateSvc >	StoreGateSvc_t

Private Member Functions
	RD53SimTool ()
Gaudi::Details::PropertyBase &	declareGaudiProperty (Gaudi::Property< T, V, H > &hndl, const SG::VarHandleKeyType &)
	specialization for handling Gaudi::Property<SG::VarHandleKey>

Private Attributes
ITkPixSimulationParameters	m_chipSim {}
Gaudi::Property< bool >	m_doTimeWalk
Gaudi::Property< int >	m_overDrive
StoreGateSvc_t	m_evtStore
	Pointer to StoreGate (event store by default).
StoreGateSvc_t	m_detStore
	Pointer to StoreGate (detector store by default).
std::vector< SG::VarHandleKeyArray * >	m_vhka
bool	m_varHandleArraysDeclared

Detailed Description

Definition at line 26 of file RD53SimTool.h.

Member Typedef Documentation

StoreGateSvc_t

typedef ServiceHandle<StoreGateSvc> AthCommonDataStore< AthCommonMsg< AlgTool > >::StoreGateSvc_t

privateinherited

Definition at line 388 of file AthCommonDataStore.h.

Constructor & Destructor Documentation

RD53SimTool() [1/2]

RD53SimTool::RD53SimTool	(	const std::string &	type,
		const std::string &	name,
		const IInterface *	parent )

Definition at line 22 of file RD53SimTool.cxx.

                                                                                               :
  FrontEndSimTool(type, name, parent) {
}

RD53SimTool() [2/2]

RD53SimTool::RD53SimTool ( )

private

Member Function Documentation

AthAlgTool()

AthAlgTool::AthAlgTool ( const std::string & type, const std::string & name, const IInterface * parent )

inherited

Constructor with parameters:

Definition at line 31 of file AthAlgTool.cxx.

                                       : 
  AthCommonDataStore<AthCommonMsg<AlgTool>> ( type, name, parent )
{
}

declareGaudiProperty()

Gaudi::Details::PropertyBase & AthCommonDataStore< AthCommonMsg< AlgTool > >::declareGaudiProperty ( Gaudi::Property< T, V, H > & hndl, const SG::VarHandleKeyType &  )

inlineprivateinherited

specialization for handling Gaudi::Property<SG::VarHandleKey>

Definition at line 156 of file AthCommonDataStore.h.

  {
    return *AthCommonDataStore<PBASE>::declareProperty(hndl.name(),
                                                       hndl.value(), 
                                                       hndl.documentation());
 
  }

declareProperty()

Gaudi::Details::PropertyBase & AthCommonDataStore< AthCommonMsg< AlgTool > >::declareProperty ( Gaudi::Property< T, V, H > & t )

inlineinherited

Definition at line 145 of file AthCommonDataStore.h.

                                                                     {
    typedef typename SG::HandleClassifier<T>::type htype;
    return AthCommonDataStore<PBASE>::declareGaudiProperty(t, htype());
  }

detStore()

const ServiceHandle< StoreGateSvc > & AthCommonDataStore< AthCommonMsg< AlgTool > >::detStore ( ) const

inlineinherited

The standard StoreGateSvc/DetectorStore Returns (kind of) a pointer to the StoreGateSvc.

Definition at line 95 of file AthCommonDataStore.h.

{ return m_detStore; }

evtStore()

ServiceHandle< StoreGateSvc > & AthCommonDataStore< AthCommonMsg< AlgTool > >::evtStore ( )

inlineinherited

The standard StoreGateSvc (event store) Returns (kind of) a pointer to the StoreGateSvc.

Definition at line 85 of file AthCommonDataStore.h.

{ return m_evtStore; }

extraDeps_update_handler()

void AthCommonDataStore< AthCommonMsg< AlgTool > >::extraDeps_update_handler ( Gaudi::Details::PropertyBase & ExtraDeps )

protectedinherited

Add StoreName to extra input/output deps as needed.

use the logic of the VarHandleKey to parse the DataObjID keys supplied via the ExtraInputs and ExtraOuputs Properties to add the StoreName if it's not explicitly given

initialize()

StatusCode RD53SimTool::initialize ( )

overridevirtual

Reimplemented from FrontEndSimTool.

Definition at line 26 of file RD53SimTool.cxx.

                                   {
  ATH_CHECK(FrontEndSimTool::initialize());
  ATH_MSG_DEBUG("RD53SimTool::initialize()");
  return StatusCode::SUCCESS;
}

inputHandles()

virtual std::vector< Gaudi::DataHandle * > AthCommonDataStore< AthCommonMsg< AlgTool > >::inputHandles ( ) const

overridevirtualinherited

Return this algorithm's input handles.

We override this to include handle instances from key arrays if they have not yet been declared. See comments on updateVHKA.

msg()

MsgStream & AthCommonMsg< AlgTool >::msg ( ) const

inlineinherited

Definition at line 24 of file AthCommonMsg.h.

                                {
    return this->msgStream();
  }

msgLvl()

bool AthCommonMsg< AlgTool >::msgLvl ( const MSG::Level lvl ) const

inlineinherited

Definition at line 30 of file AthCommonMsg.h.

                                               {
    return this->msgLevel(lvl);
  }

outputHandles()

virtual std::vector< Gaudi::DataHandle * > AthCommonDataStore< AthCommonMsg< AlgTool > >::outputHandles ( ) const

overridevirtualinherited

Return this algorithm's output handles.

We override this to include handle instances from key arrays if they have not yet been declared. See comments on updateVHKA.

process()

void RD53SimTool::process ( const EventContext & ctx, SiChargedDiodeCollection & chargedDiodes, PixelRDO_Collection & rdoCollection, CLHEP::HepRandomEngine * rndmEngine ) const

overridevirtual

Implements FrontEndSimTool.

Definition at line 32 of file RD53SimTool.cxx.

                                                                  {
  const PixelID* pixelId = static_cast<const PixelID*>(chargedDiodes.element()->getIdHelper());
  const IdentifierHash moduleHash = pixelId->wafer_hash(chargedDiodes.identify()); // wafer hash
  Identifier moduleID = pixelId->wafer_id(chargedDiodes.element()->identify());
 
  int barrel_ec = pixelId->barrel_ec(chargedDiodes.element()->identify());
  if (std::abs(barrel_ec) != m_BarrelEC) {
    return;
  }
 
  SG::ReadCondHandle<PixelChargeCalibCondData> calibDataHandle(m_chargeDataKey, ctx);
  const PixelChargeCalibCondData *calibData = *calibDataHandle;
 
  int overflowToT = 14; //for RD53 (aka ITkPixV2) chip, not FEI4
 
  // Add cross-talk
  auto xtalk = m_chipSim.crossTalk();
  crossTalk(xtalk, chargedDiodes);
 
  if (m_doNoise) {
    // Add thermal noise
    thermalNoise(m_thermalNoise, chargedDiodes, rndmEngine);
    // Add random noise
    randomNoise(chargedDiodes, m_chipSim, m_numberOfBcid, calibData, rndmEngine, m_pixelReadout.get());
  }
 
  // Add random diabled pixels
  randomDisable(chargedDiodes, m_chipSim, rndmEngine); // FIXME How should we handle disabling pixels in Overlay jobs?
 
  for (auto &[mapId,mapDiode]:chargedDiodes) {//cannot be const ref, mapDiode will be altered
    Identifier diodeID = chargedDiodes.getId(mapId);
    double charge = mapDiode.charge();
    unsigned int FE = m_pixelReadout->getFE(diodeID, moduleID);
    InDetDD::PixelDiodeType type = m_pixelReadout->getDiodeType(diodeID);
    if ((FE == InDetDD::invalidFrontEnd) or (type == InDetDD::PixelDiodeType::NONE)){
      SiHelper::disabled(mapDiode, true, true);
      continue;//invalid frontend
    } 
    // Apply analogue threshold, timing simulation
    const auto &thresholds = calibData->getThresholds(type, moduleHash, FE);
    double threshold =  PixelDigitization::randomThreshold(thresholds, rndmEngine); 
 
    if (charge > threshold) {
      int bunchSim = 0;
      if (mapDiode.totalCharge().fromTrack()) {
        bunchSim = static_cast<int>(std::floor((getG4Time(mapDiode.totalCharge()) + m_timeOffset) / m_bunchSpace));
        //Timewalk implementation 
        if(m_doTimeWalk){
          if(charge < (threshold + m_overDrive)){
            const int timeWalk = 25; // Here it is assumed that the maximum value of timewalk is one bunch crossing (25ns)
            bunchSim = static_cast<int>(std::floor((getG4Time(mapDiode.totalCharge()) + m_timeOffset + timeWalk) / m_bunchSpace));
          } 
        }
      } else {
        bunchSim = CLHEP::RandFlat::shootInt(rndmEngine, m_numberOfBcid);
      }
 
      if (bunchSim < 0 || bunchSim > m_numberOfBcid) {
        SiHelper::belowThreshold(mapDiode, true, true);
      } else {
        SiHelper::SetBunch(mapDiode, bunchSim);
      }
    } else {
      SiHelper::belowThreshold(mapDiode, true, true);
    }
 
    // charge to ToT conversion
    double tot = calibData->getToT(type, moduleHash, FE, charge);
    double totsig = calibData->getTotRes(moduleHash, FE, tot);
    int nToT = generateToT(rndmEngine, tot,totsig, std::make_pair(0,overflowToT));
    auto thresh = m_chipSim.totThreshold();
 
    if (nToT <= thresh) {
      SiHelper::belowThreshold(mapDiode, true, true);
    }
 
    // Filter events
    if (SiHelper::isMaskOut(mapDiode)) {
      continue;
    }
    if (SiHelper::isDisabled(mapDiode)) {
      continue;
    }
 
    if (!m_pixelConditionsTool->isActive(moduleHash, diodeID, ctx)) {
      SiHelper::disabled(mapDiode, true, true);
      continue;
    }
 
    int flag = mapDiode.flag();
    int bunch = (flag >> 8) & 0xff;
 
    InDetDD::SiReadoutCellId cellId = mapDiode.getReadoutCell();
    const Identifier id_readout = chargedDiodes.element()->identifierFromCellId(cellId);
 
    // Front-End simulation
    if (bunch >= 0 && bunch < m_numberOfBcid) {
      Pixel1RawData* p_rdo = new Pixel1RawData(id_readout, nToT, bunch, 0, bunch);
      rdoCollection.push_back(p_rdo);
      p_rdo = nullptr;
    }
  }
}

renounce()

std::enable_if_t< std::is_void_v< std::result_of_t< decltype(&T::renounce)(T)> > &&!std::is_base_of_v< SG::VarHandleKeyArray, T > &&std::is_base_of_v< Gaudi::DataHandle, T >, void > AthCommonDataStore< AthCommonMsg< AlgTool > >::renounce ( T & h )

inlineprotectedinherited

Definition at line 380 of file AthCommonDataStore.h.

  {
    h.renounce();
    PBASE::renounce (h);
  }

renounceArray()

void AthCommonDataStore< AthCommonMsg< AlgTool > >::renounceArray ( SG::VarHandleKeyArray & handlesArray )

inlineprotectedinherited

remove all handles from I/O resolution

Definition at line 364 of file AthCommonDataStore.h.

                                                          {
    handlesArray.renounce();
  }

sysInitialize()

virtual StatusCode AthCommonDataStore< AthCommonMsg< AlgTool > >::sysInitialize ( )

overridevirtualinherited

Perform system initialization for an algorithm.

We override this to declare all the elements of handle key arrays at the end of initialization. See comments on updateVHKA.

Reimplemented in asg::AsgMetadataTool, AthCheckedComponent< AthAlgTool >, and AthCheckedComponent<::AthAlgTool >.

sysStart()

virtual StatusCode AthCommonDataStore< AthCommonMsg< AlgTool > >::sysStart ( )

overridevirtualinherited

Handle START transition.

We override this in order to make sure that conditions handle keys can cache a pointer to the conditions container.

updateVHKA()

void AthCommonDataStore< AthCommonMsg< AlgTool > >::updateVHKA ( Gaudi::Details::PropertyBase & )

inlineinherited

Definition at line 308 of file AthCommonDataStore.h.

                                               {
    // debug() << "updateVHKA for property " << p.name() << " " << p.toString() 
    //         << "  size: " << m_vhka.size() << endmsg;
    for (auto &a : m_vhka) {
      std::vector<SG::VarHandleKey*> keys = a->keys();
      for (auto k : keys) {
        k->setOwner(this);
      }
    }
  }

Member Data Documentation

m_BarrelEC

Gaudi::Property<int> FrontEndSimTool::m_BarrelEC

protectedinherited

Initial value:

{
    this, "BarrelEC", 0, "Index of barrel or endcap"
  }

Definition at line 57 of file FrontEndSimTool.h.

                               {
    this, "BarrelEC", 0, "Index of barrel or endcap"
  };

m_bunchSpace

double FrontEndSimTool::m_bunchSpace {25.0}

staticconstexprprotectedinherited

Definition at line 39 of file FrontEndSimTool.h.

{25.0};

m_chargeDataKey

SG::ReadCondHandleKey<PixelChargeCalibCondData> FrontEndSimTool::m_chargeDataKey

protectedinherited

Initial value:

{
    this, "PixelChargeCalibCondData", "PixelChargeCalibCondData", "Pixel charge calibration data"
  }

Definition at line 53 of file FrontEndSimTool.h.

                                                               {
    this, "PixelChargeCalibCondData", "PixelChargeCalibCondData", "Pixel charge calibration data"
  };

m_chipSim

ITkPixSimulationParameters RD53SimTool::m_chipSim {}

private

Definition at line 36 of file RD53SimTool.h.

{};

m_cosmics

Gaudi::Property<bool> FrontEndSimTool::m_cosmics

protectedinherited

Initial value:

{
    this, "Cosmics", false, "Is this for Cosmics simulation?"
  }

Definition at line 65 of file FrontEndSimTool.h.

                               {
    this, "Cosmics", false, "Is this for Cosmics simulation?"
  };

m_detStore

StoreGateSvc_t AthCommonDataStore< AthCommonMsg< AlgTool > >::m_detStore

privateinherited

Pointer to StoreGate (detector store by default).

Definition at line 393 of file AthCommonDataStore.h.

m_doNoise

Gaudi::Property<bool> FrontEndSimTool::m_doNoise

protectedinherited

Initial value:

{
    this, "DoNoise", true, "Flag of noise simulation"
  }

Definition at line 61 of file FrontEndSimTool.h.

                               {
    this, "DoNoise", true, "Flag of noise simulation"
  };

m_doTimeWalk

Gaudi::Property<bool> RD53SimTool::m_doTimeWalk

private

Initial value:

{
    this, "DoTimeWalk",false,"include time-walk effects"
      }

Definition at line 39 of file RD53SimTool.h.

                                   {
    this, "DoTimeWalk",false,"include time-walk effects"
      };

m_evtStore

StoreGateSvc_t AthCommonDataStore< AthCommonMsg< AlgTool > >::m_evtStore

privateinherited

Pointer to StoreGate (event store by default).

Definition at line 390 of file AthCommonDataStore.h.

m_numberOfBcid

int FrontEndSimTool::m_numberOfBcid {1}

protectedinherited

Definition at line 40 of file FrontEndSimTool.h.

{1}; //assumed same for all positions

m_overDrive

Gaudi::Property<int> RD53SimTool::m_overDrive

private

Initial value:

{
    this, "OverDrive",150,"value of overdrive (in-time threshold - absolute threshold) in electrons"
      }

Definition at line 42 of file RD53SimTool.h.

                                 {
    this, "OverDrive",150,"value of overdrive (in-time threshold - absolute threshold) in electrons"
      };

m_pixelConditionsTool

ToolHandle<IInDetConditionsTool> FrontEndSimTool::m_pixelConditionsTool

protectedinherited

Initial value:

{
    this, "PixelConditionsSummaryTool", "PixelConditionsSummaryTool", "Tool to retrieve Pixel Conditions summary"
  }

Definition at line 44 of file FrontEndSimTool.h.

                                                        {
    this, "PixelConditionsSummaryTool", "PixelConditionsSummaryTool", "Tool to retrieve Pixel Conditions summary"
  };

m_pixelReadout

ServiceHandle<InDetDD::IPixelReadoutManager> FrontEndSimTool::m_pixelReadout

protectedinherited

Initial value:

{
    this, "PixelReadoutManager", "PixelReadoutManager", "Pixel readout manager"
  }

Definition at line 48 of file FrontEndSimTool.h.

                                                           {
    this, "PixelReadoutManager", "PixelReadoutManager", "Pixel readout manager"
  };

m_thermalNoise

double FrontEndSimTool::m_thermalNoise {160.0}

protectedinherited

Definition at line 43 of file FrontEndSimTool.h.

{160.0}; //default noise level

m_timeJitter

double FrontEndSimTool::m_timeJitter {0.0}

protectedinherited

Definition at line 42 of file FrontEndSimTool.h.

{0.0};

m_timeOffset

double FrontEndSimTool::m_timeOffset {5.0}

protectedinherited

Definition at line 41 of file FrontEndSimTool.h.

{5.0};

m_varHandleArraysDeclared

bool AthCommonDataStore< AthCommonMsg< AlgTool > >::m_varHandleArraysDeclared

privateinherited

Definition at line 399 of file AthCommonDataStore.h.

m_vhka

std::vector<SG::VarHandleKeyArray*> AthCommonDataStore< AthCommonMsg< AlgTool > >::m_vhka

privateinherited

Definition at line 398 of file AthCommonDataStore.h.

---

The documentation for this class was generated from the following files:

• RD53SimTool.h
• RD53SimTool.cxx