Belle II Software  release-08-01-10
SensitiveDetector Class Reference

Sensitive Detector implementation of the CLAWS detector. More...

#include <SensitiveDetector.h>

Inheritance diagram for SensitiveDetector:
Collaboration diagram for SensitiveDetector:

Public Member Functions

 SensitiveDetector ()
 Constructor.
 

Static Public Member Functions

static const std::map< std::string, RelationArray::EConsolidationAction > & getMCParticleRelations ()
 Return a list of all registered Relations with MCParticles.
 
static void setActive (bool activeStatus)
 Enable/Disable all Sensitive Detectors. More...
 
static void registerMCParticleRelation (const std::string &name, RelationArray::EConsolidationAction ignoreAction=RelationArray::c_negativeWeight)
 Register an relation involving MCParticles. More...
 
static void registerMCParticleRelation (const RelationArray &relation, RelationArray::EConsolidationAction ignoreAction=RelationArray::c_negativeWeight)
 Overload to make it easer to register MCParticle relations. More...
 

Protected Member Functions

bool step (G4Step *step, G4TouchableHistory *) override
 Step processing method. More...
 

Private Member Functions

bool finishTrack ()
 finish a track
 
virtual bool ProcessHits (G4Step *aStep, G4TouchableHistory *aROhist)
 Check if recording hits is enabled and if so call step() and set the correct MCParticle flag. More...
 

Private Attributes

G4EmSaturation * m_saturationEngine
 needed to call Birk's law
 
StoreArray< MCParticlem_mcParticles
 store array of the MCParticles
 
StoreArray< CLAWSSimHitm_simHits
 store array of the SimHits
 
RelationArray m_relMCSimHit {m_mcParticles, m_simHits}
 relation array of the MCParticle -> SimHit relation
 
std::stack< SensorTraversalm_tracks
 Stack of tracks to keep track of particles.
 
Const::EDetector m_subdetector
 Subdetector the class belongs to.
 

Static Private Attributes

static std::map< std::string, RelationArray::EConsolidationActions_mcRelations
 Static set holding all relations which have to be updated at the end of the Event.
 
static bool s_active
 Static bool which indicates wether recording of hits is enabled.
 

Detailed Description

Sensitive Detector implementation of the CLAWS detector.

Definition at line 29 of file SensitiveDetector.h.

Member Function Documentation

◆ ProcessHits()

bool ProcessHits ( G4Step *  aStep,
G4TouchableHistory *  aROhist 
)
inlineprivatevirtualinherited

Check if recording hits is enabled and if so call step() and set the correct MCParticle flag.

Called by Geant4 for each step inside the sensitive volumes attached

Definition at line 94 of file SensitiveDetectorBase.h.

◆ registerMCParticleRelation() [1/2]

static void registerMCParticleRelation ( const RelationArray relation,
RelationArray::EConsolidationAction  ignoreAction = RelationArray::c_negativeWeight 
)
inlinestaticinherited

Overload to make it easer to register MCParticle relations.

Parameters
relationRelationArray to register
ignoreAction

Definition at line 66 of file SensitiveDetectorBase.h.

◆ registerMCParticleRelation() [2/2]

void registerMCParticleRelation ( const std::string &  name,
RelationArray::EConsolidationAction  ignoreAction = RelationArray::c_negativeWeight 
)
staticinherited

Register an relation involving MCParticles.

All Relations which point from an MCParticle to something have to be registered with addMCParticleRelation() because the index of the MCParticles might change at the end of the event. During simulation, the TrackID should be used as index of the MCParticle

Parameters
nameName of the relation to register
ignoreAction

Definition at line 22 of file SensitiveDetectorBase.cc.

◆ setActive()

static void setActive ( bool  activeStatus)
inlinestaticinherited

Enable/Disable all Sensitive Detectors.

By default, all sensitive detectors won't create hits to make it possible to use the Geant4 Navigator for non-simulation purposes. Only during simulation the sensitive detectors will be enabled to record hits

Parameters
activeStatusbool to indicate wether hits should be recorded

Definition at line 50 of file SensitiveDetectorBase.h.

◆ step()

bool step ( G4Step *  step,
G4TouchableHistory *   
)
overrideprotectedvirtual

Step processing method.

Parameters
stepthe G4Step with the current step information
Returns
true if a Hit has been created, false if the hit was ignored

Implements SensitiveDetectorBase.

Definition at line 52 of file SensitiveDetector.cc.

53  {
54  //Get scintilator ladder and sensor number
55  const G4TouchableHistory* touchable = dynamic_cast<const G4TouchableHistory*>(step->GetPreStepPoint()->GetTouchable());
56  int ladderID = touchable->GetVolume(2)->GetCopyNo();
57  int sensorID = touchable->GetVolume(1)->GetCopyNo();
58 
59  //Get Track information
60  const G4Track& track = *step->GetTrack();
61  const int trackID = track.GetTrackID();
62  const int pdgCode = step->GetTrack()->GetDefinition()->GetPDGEncoding();
63  // deposited Energy in Geant4 Units
64  double depEnergy = step->GetTotalEnergyDeposit();
65  // get visible energy deposition
66  double visibleEnergy = m_saturationEngine->VisibleEnergyDeposition(
67  track.GetDefinition(),
68  track.GetMaterialCutsCouple(),
69  step->GetStepLength(),
70  depEnergy, 0.
71  );
72  // convert into Belle2 Units
73  depEnergy *= Unit::GeV / CLHEP::GeV;
74  visibleEnergy *= Unit::GeV / CLHEP::GeV;
75 
76  // get pre and post step point
77  const G4StepPoint& preStep = *step->GetPreStepPoint();
78  const G4StepPoint& postStep = *step->GetPostStepPoint();
79 
80  // check if this is the same sensor traversal, otherwise add one to the stack
81  if (m_tracks.empty() || (!m_tracks.top().check(trackID, ladderID, sensorID))) {
82  m_tracks.push(SensorTraversal());
83  }
84  // get the top of the stack
85  SensorTraversal& traversal = m_tracks.top();
86 
87  //If new track, remember values
88  if (traversal.getTrackID() == 0) {
89  bool isPrimary = Simulation::TrackInfo::getInfo(track).hasStatus(MCParticle::c_PrimaryParticle);
90  //Add start position
91  const G4ThreeVector preStepPos = preStep.GetPosition() / CLHEP::mm * Unit::mm;
92  const G4ThreeVector preStepMom = preStep.GetMomentum() / CLHEP::MeV * Unit::MeV;
93  const double time = preStep.GetGlobalTime() / CLHEP::ns * Unit::ns;
94  traversal.setInitial(trackID, ladderID, sensorID, pdgCode, isPrimary, preStepPos, preStepMom, time);
95  //Remember if the track came from the outside
96  if (preStep.GetStepStatus() == fGeomBoundary) traversal.hasEntered();
97  }
98 
99  //Add current step
100  const G4ThreeVector postStepPos = postStep.GetPosition() / CLHEP::mm * Unit::mm;
101  const double length = step->GetStepLength() / CLHEP::cm * Unit::cm;
102  traversal.add(postStepPos, depEnergy, visibleEnergy, length);
103 
104  //check if we are leaving the volume
105  bool isLeaving = (postStep.GetStepStatus() == fGeomBoundary);
106  if (isLeaving) traversal.hasLeft();
107 
108  //if we are leaving or the track is stopped, finish it
109  if (isLeaving || track.GetTrackStatus() >= fStopAndKill) {
110  bool contained = traversal.isContained();
111  bool saved = finishTrack();
112  //we mark all particles as important which created a hit and entered or left the volume
113  if (saved && !contained) {
114  Simulation::TrackInfo::getInfo(track).setIgnore(false);
115  }
116  return saved;
117  }
118  // Track not finished, return false right now
119  return false;
120  }
@ c_PrimaryParticle
bit 0: Particle is primary particle.
Definition: MCParticle.h:47
static Payload getInfo(Carrier &obj)
Static function to just return UserInformation attached to the obj of type Carrier.
Definition: UserInfo.h:100
static const double mm
[millimeters]
Definition: Unit.h:70
static const double MeV
[megaelectronvolt]
Definition: Unit.h:114
static const double cm
Standard units with the value = 1.
Definition: Unit.h:47
static const double ns
Standard of [time].
Definition: Unit.h:48
static const double GeV
Standard of [energy, momentum, mass].
Definition: Unit.h:51
G4EmSaturation * m_saturationEngine
needed to call Birk's law
std::stack< SensorTraversal > m_tracks
Stack of tracks to keep track of particles.
bool step(G4Step *step, G4TouchableHistory *) override
Step processing method.

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