LArG4::CalibSDTool Class Reference

A base class for tools that manage LArG4CalibSDs. More...

#include <CalibSDTool.h>

Inheritance diagram for LArG4::CalibSDTool:

Collaboration diagram for LArG4::CalibSDTool:

Public Member Functions
	CalibSDTool (const std::string &type, const std::string &name, const IInterface *parent)
	Constructor.
StatusCode	initialize () override final
	Initialize the tool.
StatusCode	initializeSD () override final
	Create and register all SDs for the current thread.
StatusCode	SetupEvent (HitCollectionMap &) override final
	Create event-owned hit collections.
StatusCode	Gather (HitCollectionMap &) override final
	Finalize and record event-owned hit collections.

Protected Member Functions
virtual StatusCode	initializeCalculators ()
	Initialize Calculator Services.
LArG4CalibSD *	makeOneSD (const std::string &name, ILArCalibCalculatorSvc *calc, const std::vector< std::string > &volumes) const
	Helper method to create one SD.
virtual std::string	hitCollectionName () const
virtual std::string	deadHitCollectionName () const
virtual std::string	srHitCollectionName () const
StatusCode	assignSD (std::unique_ptr< G4VSensitiveDetector > sd, const std::vector< std::string > &volumes) const
	Assign SD to a list of volumes.
void	SetSensitiveDetector (G4LogicalVolume *, G4VSensitiveDetector *) const
	Method stolen from G4VUserDetectorConstruction in G4 10.2.

Protected Attributes
Gaudi::Property< std::vector< std::string > >	m_volumeNames {this, "LogicalVolumeNames", {}}
	All the volumes to which this SD is assigned.
Gaudi::Property< std::vector< std::string > >	m_outputCollectionNames {this, "OutputCollectionNames", {}}
	Names of all output collections written out by this SD.
Gaudi::Property< bool >	m_noVolumes {this, "NoVolumes", false}
	This SensitiveDetector has no volumes associated with it.
configuration properties
Gaudi::Property< G4bool >	m_doPID {this, "ParticleID", false}
	Are we set up to run with PID hits?
Calo identifier helpers
const LArEM_ID *	m_larEmID {nullptr}
const LArFCAL_ID *	m_larFcalID {nullptr}
const LArHEC_ID *	m_larHecID {nullptr}
const CaloDM_ID *	m_caloDmID {nullptr}
const AtlasDetectorID *	m_id_helper {nullptr}

Static Private Member Functions
static bool	matchStrings (const char *first, const char *second)
	Match two strings with wildcard support.

Detailed Description

A base class for tools that manage LArG4CalibSDs.

The tool owns only the Athena-event lifecycle of the output collections. Geant4 SD instances write through calibration builder containers, which carry per-event merge state and preserve per-SD hit partitions.

Author

Steve Farrell Steve.nosp@m.n.Fa.nosp@m.rrell.nosp@m.@cer.nosp@m.n.ch

Definition at line 47 of file CalibSDTool.h.

Constructor & Destructor Documentation

CalibSDTool()

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

Constructor.

Member Function Documentation

assignSD()

StatusCode SensitiveDetectorBase::assignSD ( std::unique_ptr< G4VSensitiveDetector > sd, const std::vector< std::string > & volumes ) const

protectedinherited

Assign SD to a list of volumes.

This method supports wild card matching

Definition at line 55 of file SensitiveDetectorBase.cxx.

{
  // Propagate verbosity setting to the SD
  if(msgLvl(MSG::VERBOSE)) sd->SetVerboseLevel(10);
  else if(msgLvl(MSG::DEBUG)) sd->SetVerboseLevel(5);
 
  // Add the sensitive detector to the SD manager in G4 for SDs,
  // even if it has no volumes associated to it.
  auto sdMgr = G4SDManager::GetSDMpointer();
  auto sdPtr = sd.get();
  // SDManager is now the SD owner
  //for later use
  auto sdName = sd->GetName();
  sdMgr->AddNewDetector(sd.release());
 
  if(!volumes.empty()) {
    bool gotOne = false;
    auto logicalVolumeStore = G4LogicalVolumeStore::GetInstance();
    for(const auto& volumeName : volumes) {
      // Keep track of how many volumes we find with this name string.
      // We allow for multiple matches.
      int numFound = 0;
 
      // Find volumes with this name
      for(auto* logVol : *logicalVolumeStore) {
 
        ATH_MSG_VERBOSE("Check whether "<<logVol->GetName()<<" belongs to the set of sensitive detectors "<<volumeName);
        if( matchStrings( volumeName.data(), logVol->GetName() ) ){
          ++numFound;
          SetSensitiveDetector(logVol, sdPtr);
        }
        
      }
      // Warn if no volumes were found
      if(numFound == 0) {
        ATH_MSG_WARNING("Volume " << volumeName <<
                        " not found in G4LogicalVolumeStore.");
      }
      else {
        ATH_MSG_VERBOSE("Found " << numFound << " copies of LV " << volumeName <<
                        "; SD " << sdName << " assigned.");
        gotOne = true;
      }
 
    }
 
    // Abort if we have failed to assign any volume
    if(!gotOne) {
      ATH_MSG_ERROR( "Failed to assign *any* volume to SD " << name() <<
                     " and expected at least one. Size of the volume store "<<G4LogicalVolumeStore::GetInstance()->size() );
      return StatusCode::FAILURE;
    }
  }
 
  return StatusCode::SUCCESS;
}

deadHitCollectionName()

virtual std::string LArG4::CalibSDTool::deadHitCollectionName ( ) const

protectedvirtual

Reimplemented in LArG4::ActiveSDTool, and LArG4::InactiveSDTool.

Gather()

StatusCode LArG4::CalibSDTool::Gather ( HitCollectionMap & )

finaloverridevirtual

Finalize and record event-owned hit collections.

Reimplemented from SensitiveDetectorBase.

hitCollectionName()

virtual std::string LArG4::CalibSDTool::hitCollectionName ( ) const

protectedvirtual

Reimplemented in LArG4::ActiveSDTool, LArG4::DeadSDTool, and LArG4::InactiveSDTool.

initialize()

StatusCode LArG4::CalibSDTool::initialize ( )

finaloverride

Initialize the tool.

initializeCalculators()

virtual StatusCode LArG4::CalibSDTool::initializeCalculators ( )

inlineprotectedvirtual

Initialize Calculator Services.

Reimplemented in LArG4::ActiveSDTool, LArG4::DeadSDTool, and LArG4::InactiveSDTool.

Definition at line 71 of file CalibSDTool.h.

{ return StatusCode::SUCCESS; }

initializeSD()

StatusCode LArG4::CalibSDTool::initializeSD ( )

finaloverride

Create and register all SDs for the current thread.

makeOneSD()

LArG4CalibSD * LArG4::CalibSDTool::makeOneSD ( const std::string & name, ILArCalibCalculatorSvc * calc, const std::vector< std::string > & volumes ) const

protected

Helper method to create one SD.

matchStrings()

bool SensitiveDetectorBase::matchStrings ( const char * first, const char * second )

staticprivateinherited

Match two strings with wildcard support.

Compares two strings character by character with optional * wildcard in the first argument

Definition at line 115 of file SensitiveDetectorBase.cxx.

{
  // If we reach at the end of both strings, we are done
  if (*first == '\0' && *second == '\0')
    return true;
 
  // If there are consecutive '*' present in the first string
  // advance to the next character
  if(*first == '*' && *(first + 1) == '*')
    return matchStrings(first + 1, second);
 
  // Make sure that the characters after '*' are present in second string.
  if (*first == '*' && *(first + 1) != '\0' && *second == '\0')
    return false;
 
  // If the current characters of both strings match
  if (*first == *second)
    return matchStrings(first + 1, second + 1);
 
  // If there is *, then there are two possibilities
  // a) We consider current character of second string
  // b) We ignore current character of second string.
  if (*first == '*')
    return matchStrings(first + 1, second) || matchStrings(first, second + 1);
  return false;
}

SetSensitiveDetector()

void SensitiveDetectorBase::SetSensitiveDetector ( G4LogicalVolume * logVol, G4VSensitiveDetector * aSD ) const

protectedinherited

Method stolen from G4VUserDetectorConstruction in G4 10.2.

Definition at line 142 of file SensitiveDetectorBase.cxx.

{
  // New Logic: allow for "multiple" SDs being attached to a single LV.
  // To do that we use a special proxy SD called G4MultiSensitiveDetector
 
  // Get existing SD if already set and check if it is of the special type
  G4VSensitiveDetector* originalSD = logVol->GetSensitiveDetector();
  if ( originalSD == nullptr )
    {
      logVol->SetSensitiveDetector(aSD);
    }
  else
    {
      G4MultiSensitiveDetector* msd = dynamic_cast<G4MultiSensitiveDetector*>(originalSD);
      if ( msd != nullptr )
        {
          msd->AddSD(aSD);
        }
      else
        {
          // Construct a unique name using the volume address
          std::stringstream ss;
          ss << static_cast<const void*>(logVol);
          const G4String msdname = "/MultiSD_" + logVol->GetName() + ss.str();
          msd = new G4MultiSensitiveDetector(std::move(msdname));
          // We need to register the proxy to have correct handling of IDs
          G4SDManager::GetSDMpointer()->AddNewDetector(msd);
          msd->AddSD(originalSD);
          msd->AddSD(aSD);
          logVol->SetSensitiveDetector(msd);
        }
    }
}

SetupEvent()

StatusCode LArG4::CalibSDTool::SetupEvent ( HitCollectionMap & )

finaloverridevirtual

Create event-owned hit collections.

Reimplemented from SensitiveDetectorBase.

srHitCollectionName()

virtual std::string LArG4::CalibSDTool::srHitCollectionName ( ) const

protectedvirtual

Reimplemented in LArG4::ActiveSDTool.

Member Data Documentation

m_caloDmID

const CaloDM_ID* LArG4::CalibSDTool::m_caloDmID {nullptr}

protected

Definition at line 97 of file CalibSDTool.h.

{nullptr};

m_doPID

Gaudi::Property<G4bool> LArG4::CalibSDTool::m_doPID {this, "ParticleID", false}

protected

Are we set up to run with PID hits?

Definition at line 88 of file CalibSDTool.h.

{this, "ParticleID", false};

m_id_helper

const AtlasDetectorID* LArG4::CalibSDTool::m_id_helper {nullptr}

protected

Definition at line 98 of file CalibSDTool.h.

{nullptr};

m_larEmID

const LArEM_ID* LArG4::CalibSDTool::m_larEmID {nullptr}

protected

Definition at line 94 of file CalibSDTool.h.

{nullptr};

m_larFcalID

const LArFCAL_ID* LArG4::CalibSDTool::m_larFcalID {nullptr}

protected

Definition at line 95 of file CalibSDTool.h.

{nullptr};

m_larHecID

const LArHEC_ID* LArG4::CalibSDTool::m_larHecID {nullptr}

protected

Definition at line 96 of file CalibSDTool.h.

{nullptr};

m_noVolumes

Gaudi::Property<bool> SensitiveDetectorBase::m_noVolumes {this, "NoVolumes", false}

protectedinherited

This SensitiveDetector has no volumes associated with it.

Definition at line 83 of file SensitiveDetectorBase.h.

{this, "NoVolumes", false};

m_outputCollectionNames

Gaudi::Property<std::vector<std::string> > SensitiveDetectorBase::m_outputCollectionNames {this, "OutputCollectionNames", {}}

protectedinherited

Names of all output collections written out by this SD.

Definition at line 80 of file SensitiveDetectorBase.h.

{this, "OutputCollectionNames", {}};

m_volumeNames

Gaudi::Property<std::vector<std::string> > SensitiveDetectorBase::m_volumeNames {this, "LogicalVolumeNames", {}}

protectedinherited

All the volumes to which this SD is assigned.

Definition at line 78 of file SensitiveDetectorBase.h.

{this, "LogicalVolumeNames", {}};

---

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

• CalibSDTool.h