simcore::TrigScintSD Class Reference

Class defining a sensitive detector of type trigger scintillator. More...

#include <TrigScintSD.h>

Public Member Functions
	TrigScintSD (const std::string &name, simcore::ConditionsInterface &ci, const framework::config::Parameters &p)
	Class constructor.
virtual	~TrigScintSD ()=default
	Destructor.
virtual bool	isSensDet (G4LogicalVolume *vol) const override
	Should the input logical volume be included in this sensitive detector?
G4bool	ProcessHits (G4Step *step, G4TouchableHistory *history) override
	Process steps to create hits.
virtual void	saveHits (framework::Event &event) override
	Save our hits collection into the event bus and reset it.
virtual void	OnFinishedEvent () override
	Cleanup SD and prepare a new-event state.
Public Member Functions inherited from simcore::SensitiveDetector
	SensitiveDetector (const std::string &name, simcore::ConditionsInterface &ci, const framework::config::Parameters &parameters)
	Constructor.
virtual	~SensitiveDetector ()=default
	Destructor.
virtual void	EndOfEvent (G4HCofThisEvent *) override
	This is Geant4's handle to tell us the event is ending.

Private Attributes
std::vector< ldmx::SimCalorimeterHit >	hits_
	our collection of hits in this SD
std::string	collection_name_
	name of the hit collection for this SD
std::string	vol_name_
	name of trigger pad volume this SD is capturing
int	module_id_
	the ID number for the module we are gathering hits from

Additional Inherited Members
Public Types inherited from simcore::SensitiveDetector
using	Factory = ::simcore::Factory< SensitiveDetector, SensitiveDetector *, const std::string &, simcore::ConditionsInterface &, const framework::config::Parameters & >
	The SD Factory.
Protected Member Functions inherited from simcore::SensitiveDetector
template<class T >
const T &	getCondition (const std::string &condition_name)
	Record the configuration of this detector into the run header.
bool	isGeantino (const G4Step *step) const
	Check if the passed step is a step of a geantino.
const TrackMap &	getTrackMap () const
	Get a handle to the current track map.

Detailed Description

Class defining a sensitive detector of type trigger scintillator.

Definition at line 12 of file TrigScintSD.h.

Constructor & Destructor Documentation

TrigScintSD()

simcore::TrigScintSD::TrigScintSD	(	const std::string &	name,
		simcore::ConditionsInterface &	ci,
		const framework::config::Parameters &	p
	)

Class constructor.

Parameters

[in]	name	The name of the sensitive detector.
[in]	ci	interface to conditions objects
[in]	p	python configuration parameters

Definition at line 16 of file TrigScintSD.cxx.

    : SensitiveDetector(name, ci, p) {
  module_id_ = p.getParameter<int>("module_id");
  collection_name_ = p.getParameter<std::string>("collection_name");
  vol_name_ = p.getParameter<std::string>("volume_name");
}

References collection_name_, framework::config::Parameters::getParameter(), module_id_, and vol_name_.

Member Function Documentation

isSensDet()

virtual bool simcore::TrigScintSD::isSensDet ( G4LogicalVolume *  vol ) const

inlineoverridevirtual

Should the input logical volume be included in this sensitive detector?

Note

Depends on names in GDML!

In order to avoid attaching to both 'target' and 'sp_target', we intentionally exclude volumes with the string 'sp_' in their names.

Implements simcore::SensitiveDetector.

Definition at line 37 of file TrigScintSD.h.

                                                              {
    return vol->GetName().contains(vol_name_) and
           not vol->GetName().contains("sp_");
  }

References vol_name_.

OnFinishedEvent()

virtual void simcore::TrigScintSD::OnFinishedEvent ( )

inlineoverridevirtual

Cleanup SD and prepare a new-event state.

Implements simcore::SensitiveDetector.

Definition at line 57 of file TrigScintSD.h.

{ hits_.clear(); }

References hits_.

ProcessHits()

G4bool simcore::TrigScintSD::ProcessHits ( G4Step *  step, G4TouchableHistory *  history  )

overridevirtual

Process steps to create hits.

Parameters

[in]	step	The step information.
[in]	history	The readout history.

Implements simcore::SensitiveDetector.

Definition at line 25 of file TrigScintSD.cxx.

                                                                         {
  // Get the energy deposited by the particle during the step
  auto energy{step->GetTotalEnergyDeposit()};
 
  // If a non-Geantino particle doesn't deposit energy during the step,
  // skip processing it.
  if (energy == 0 and not isGeantino(step)) return false;
 
  // Create a new instance of a calorimeter hit
  //  emplace_back returns a *reference* to the hit that was constructed
  //  and we should keep that reference so that we are editing the correct hit
  ldmx::SimCalorimeterHit& hit = hits_.emplace_back();
 
  G4StepPoint* prePoint = step->GetPreStepPoint();
  G4StepPoint* postPoint = step->GetPostStepPoint();
  if (prePoint == nullptr || postPoint == nullptr) {
    return false;
  }
 
  // A Geant4 "touchable" is a way to uniquely identify a particular volume,
  // short for touchable detector element. See the detector definition and
  // response section of the Geant4 application developers manual for details.
  //
  // The TouchableHandle is just a reference counted pointer to a
  // G4TouchableHistory object, which is a concrete implementation of a
  // G4Touchable interface.
  if (!prePoint->GetTouchableHandle()) {
    return false;
  }
  auto touchableHistory{prePoint->GetTouchableHandle()->GetHistory()};
  // Affine transform for converting between local and global coordinates
  auto topTransform{touchableHistory->GetTopTransform()};
  // Set the hit position
  auto position{0.5 * (prePoint->GetPosition() + postPoint->GetPosition())};
 
  // Convert the center of the bar to its corresponding global position
  auto volumePosition{topTransform.Inverse().TransformPoint(G4ThreeVector())};
  hit.setPosition(position[0], position[1], volumePosition.z());
 
  // Get the track associated with this step
  auto track{step->GetTrack()};
 
  // Set the ID on the hit.
  auto bar{track->GetVolume()->GetCopyNo()};
  ldmx::TrigScintID id(module_id_, bar);
  hit.setID(id.raw());
 
  // add single contrib to this calorimeter hit
  //  IncidentID - this track's ID
  //  Track ID
  //  PDG ID
  //  energy deposited
  //  global time of this hit
  hit.addContrib(track->GetTrackID(), track->GetTrackID(),
                 track->GetParticleDefinition()->GetPDGEncoding(), energy,
                 track->GetGlobalTime());
 
  // Step details
  hit.setPathLength(step->GetStepLength());
  hit.setVelocity(track->GetVelocity());
  // Convert pre/post step position from global coordinates to coordinates
  // within the scintillator bar
  const auto localPreStepPoint{
      topTransform.TransformPoint(prePoint->GetPosition())};
  const auto localPostStepPoint{
      topTransform.TransformPoint(postPoint->GetPosition())};
  hit.setPreStepPosition(localPreStepPoint[0], localPreStepPoint[1],
                         localPreStepPoint[2]);
 
  hit.setPostStepPosition(localPostStepPoint[0], localPostStepPoint[1],
                          localPostStepPoint[2]);
 
  hit.setPreStepTime(prePoint->GetGlobalTime());
  hit.setPostStepTime(postPoint->GetGlobalTime());
 
  return true;
}

References ldmx::SimCalorimeterHit::addContrib(), hits_, simcore::SensitiveDetector::isGeantino(), module_id_, ldmx::SimCalorimeterHit::setID(), ldmx::SimCalorimeterHit::setPathLength(), ldmx::SimCalorimeterHit::setPosition(), ldmx::SimCalorimeterHit::setPostStepPosition(), ldmx::SimCalorimeterHit::setPostStepTime(), ldmx::SimCalorimeterHit::setPreStepPosition(), ldmx::SimCalorimeterHit::setPreStepTime(), and ldmx::SimCalorimeterHit::setVelocity().

saveHits()

virtual void simcore::TrigScintSD::saveHits ( framework::Event &  event )

inlineoverridevirtual

Save our hits collection into the event bus and reset it.

Implements simcore::SensitiveDetector.

Definition at line 53 of file TrigScintSD.h.

                                                        {
    event.add(collection_name_, hits_);
  }

References collection_name_, and hits_.

Member Data Documentation

collection_name_

std::string simcore::TrigScintSD::collection_name_

private

name of the hit collection for this SD

Definition at line 63 of file TrigScintSD.h.

Referenced by saveHits(), and TrigScintSD().

hits_

std::vector<ldmx::SimCalorimeterHit> simcore::TrigScintSD::hits_

private

our collection of hits in this SD

Definition at line 61 of file TrigScintSD.h.

Referenced by OnFinishedEvent(), ProcessHits(), and saveHits().

module_id_

int simcore::TrigScintSD::module_id_

private

the ID number for the module we are gathering hits from

Definition at line 67 of file TrigScintSD.h.

Referenced by ProcessHits(), and TrigScintSD().

vol_name_

std::string simcore::TrigScintSD::vol_name_

private

name of trigger pad volume this SD is capturing

Definition at line 65 of file TrigScintSD.h.

Referenced by isSensDet(), and TrigScintSD().

---

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

• SimCore/include/SimCore/SDs/TrigScintSD.h
• SimCore/src/SimCore/SDs/TrigScintSD.cxx