| Geant4 Cross Reference |
1 // 1 //
2 // ******************************************* 2 // ********************************************************************
3 // * License and Disclaimer 3 // * License and Disclaimer *
4 // * 4 // * *
5 // * The Geant4 software is copyright of th 5 // * The Geant4 software is copyright of the Copyright Holders of *
6 // * the Geant4 Collaboration. It is provided 6 // * the Geant4 Collaboration. It is provided under the terms and *
7 // * conditions of the Geant4 Software License 7 // * conditions of the Geant4 Software License, included in the file *
8 // * LICENSE and available at http://cern.ch/ 8 // * LICENSE and available at http://cern.ch/geant4/license . These *
9 // * include a list of copyright holders. 9 // * include a list of copyright holders. *
10 // * 10 // * *
11 // * Neither the authors of this software syst 11 // * Neither the authors of this software system, nor their employing *
12 // * institutes,nor the agencies providing fin 12 // * institutes,nor the agencies providing financial support for this *
13 // * work make any representation or warran 13 // * work make any representation or warranty, express or implied, *
14 // * regarding this software system or assum 14 // * regarding this software system or assume any liability for its *
15 // * use. Please see the license in the file 15 // * use. Please see the license in the file LICENSE and URL above *
16 // * for the full disclaimer and the limitatio 16 // * for the full disclaimer and the limitation of liability. *
17 // * 17 // * *
18 // * This code implementation is the result 18 // * This code implementation is the result of the scientific and *
19 // * technical work of the GEANT4 collaboratio 19 // * technical work of the GEANT4 collaboration. *
20 // * By using, copying, modifying or distri 20 // * By using, copying, modifying or distributing the software (or *
21 // * any work based on the software) you ag 21 // * any work based on the software) you agree to acknowledge its *
22 // * use in resulting scientific publicati 22 // * use in resulting scientific publications, and indicate your *
23 // * acceptance of all terms of the Geant4 Sof 23 // * acceptance of all terms of the Geant4 Software license. *
24 // ******************************************* 24 // ********************************************************************
25 // 25 //
26 // G4VSensitiveDetector <<
27 // 26 //
28 // Class description: << 27 // $Id: G4VSensitiveDetector.hh,v 1.4 2006/06/29 18:05:39 gunter Exp $
>> 28 // GEANT4 tag $Name: geant4-09-01-patch-02 $
29 // 29 //
30 // This is the abstract base class of the sens << 30
31 // sensitive detector which generates hits mus <<
32 // class. <<
33 // In the derived class constructor, name(s) o <<
34 // are made by the sensitive detector must be <<
35 // vector. <<
36 // <<
37 // Author: Makoto Asai <<
38 // ------------------------------------------- <<
39 #ifndef G4VSensitiveDetector_h 31 #ifndef G4VSensitiveDetector_h
40 #define G4VSensitiveDetector_h 1 32 #define G4VSensitiveDetector_h 1
41 33
42 #include "G4CollectionNameVector.hh" <<
43 #include "G4HCofThisEvent.hh" <<
44 #include "G4Step.hh" <<
45 #include "G4TouchableHistory.hh" <<
46 #include "G4VHit.hh" 34 #include "G4VHit.hh"
>> 35 #include "G4Step.hh"
>> 36 #include "G4HCofThisEvent.hh"
47 #include "G4VReadOutGeometry.hh" 37 #include "G4VReadOutGeometry.hh"
>> 38 #include "G4TouchableHistory.hh"
>> 39 #include "G4CollectionNameVector.hh"
48 #include "G4VSDFilter.hh" 40 #include "G4VSDFilter.hh"
49 41
50 class G4VSensitiveDetector << 42 // class description:
>> 43 //
>> 44 // This is the abstract base class of the sensitive detector. The user's
>> 45 // sensitive detector which generates hits must be derived from this
>> 46 // class.
>> 47 // In the derived class constructor, name(s) of hits collection(s) which
>> 48 // are made by the sensitive detector must be set to "collectionName" string
>> 49 // vector.
>> 50
>> 51 class G4VSensitiveDetector
51 { 52 {
52 public: << 53
53 // Constructors. The user's concrete class m << 54 public: // with description
54 // by the constructor initializer of the der << 55 G4VSensitiveDetector(G4String name);
55 // the sensitive detector must be unique. << 56 G4VSensitiveDetector(const G4VSensitiveDetector &right);
56 explicit G4VSensitiveDetector(const G4String << 57 // Constructors. The user's concrete class must use one of these constructors
57 G4VSensitiveDetector(const G4VSensitiveDetec << 58 // by the constructor initializer of the derived class. The name of
58 G4VSensitiveDetector& operator=(const G4VSen << 59 // the sensitive detector must be unique.
59 virtual ~G4VSensitiveDetector() = default; << 60
60 << 61 public:
61 G4bool operator==(const G4VSensitiveDetector << 62 virtual ~G4VSensitiveDetector();
62 G4bool operator!=(const G4VSensitiveDetector << 63
63 << 64 const G4VSensitiveDetector & operator=(const G4VSensitiveDetector &right);
64 // These two methods are invoked at the beg << 65
65 // event. The hits collection(s) created by << 66 G4int operator==(const G4VSensitiveDetector &right) const;
66 // be set to the G4HCofThisEvent object at o << 67 G4int operator!=(const G4VSensitiveDetector &right) const;
67 virtual void Initialize(G4HCofThisEvent*) {} << 68
68 virtual void EndOfEvent(G4HCofThisEvent*) {} << 69 public: // with description
69 << 70 virtual void Initialize(G4HCofThisEvent*);
70 // This method is invoked if the event abor << 71 virtual void EndOfEvent(G4HCofThisEvent*);
71 // created but not beibg set to G4HCofThisEv << 72 // These two methods are invoked at the begining and at the end of each
72 // deleted. Collection(s) which have already << 73 // event. The hits collection(s) created by this sensitive detector must
73 // deleted automatically. << 74 // be set to the G4HCofThisEvent object at one of these two methods.
74 virtual void clear() {} << 75 virtual void clear();
75 << 76 // This method is invoked if the event abortion is occured. Hits collections
76 virtual void DrawAll() {} << 77 // created but not beibg set to G4HCofThisEvent at the event should be deleted.
77 virtual void PrintAll() {} << 78 // Collection(s) which have already set to G4HCofThisEvent will be deleted
78 << 79 // automatically.
79 // This is the public method invoked by G4S << 80
80 // hit(s). The actual user's implementation << 81 public:
81 // implemented in GenerateHits() virtual pro << 82 virtual void DrawAll();
82 // MUST NOT be overriden. << 83 virtual void PrintAll();
83 inline G4bool Hit(G4Step* aStep) << 84
84 { << 85 protected: // with description
85 G4TouchableHistory* ROhis = nullptr; << 86 virtual G4bool ProcessHits(G4Step*aStep,G4TouchableHistory*ROhist) = 0;
86 if (! isActive()) return false; << 87 // The user MUST implement this method for generating hit(s) using the
87 if (filter != nullptr) { << 88 // information of G4Step object. Note that the volume and the position
88 if (! (filter->Accept(aStep))) return fa << 89 // information is kept in PreStepPoint of G4Step.
89 } << 90 // Be aware that this method is a protected method and it sill be invoked
90 if (ROgeometry != nullptr) { << 91 // by Hit() method of Base class after Readout geometry associated to the
91 if (! (ROgeometry->CheckROVolume(aStep, << 92 // sensitive detector is handled.
92 } << 93 // "ROhist" will be given only is a Readout geometry is defined to this
93 return ProcessHits(aStep, ROhis); << 94 // sensitive detector. The G4TouchableHistory object of the tracking geometry
94 } << 95 // is stored in the PreStepPoint object of G4Step.
95 << 96 virtual G4int GetCollectionID(G4int i);
96 // Register the Readout geometry. << 97 // This is a utility method which returns the hits collection ID of the
97 inline void SetROgeometry(G4VReadOutGeometry << 98 // "i"-th collection. "i" is the order (starting with zero) of the collection
98 << 99 // whose name is stored to the collectionName protected vector.
99 // Register a filter << 100 G4CollectionNameVector collectionName;
100 inline void SetFilter(G4VSDFilter* value) { << 101 // This protected name vector must be filled at the constructor of the user's
101 << 102 // concrete class for registering the name(s) of hits collection(s) being
102 inline G4int GetNumberOfCollections() const << 103 // created by this particular sensitive detector.
103 inline const G4String& GetCollectionName(G4i << 104
104 inline void SetVerboseLevel(G4int vl) { verb << 105 protected:
105 inline void Activate(G4bool activeFlag) { ac << 106 G4String SensitiveDetectorName; // detector name
106 inline G4bool isActive() const { return acti << 107 G4String thePathName; // directory path
107 inline const G4String& GetName() const { ret << 108 G4String fullPathName; // path + detector name
108 inline const G4String& GetPathName() const { << 109 G4int verboseLevel;
109 inline const G4String& GetFullPathName() con << 110 G4bool active;
110 inline G4VReadOutGeometry* GetROgeometry() c << 111 G4VReadOutGeometry * ROgeometry;
111 inline G4VSDFilter* GetFilter() const { retu << 112 G4VSDFilter* filter;
112 << 113
113 virtual G4VSensitiveDetector* Clone() const; << 114 public: // with description
114 << 115 inline G4bool Hit(G4Step*aStep)
115 protected: // with description << 116 {
116 // The user MUST implement this method for << 117 G4TouchableHistory* ROhis = 0;
117 // information of G4Step object. Note that t << 118 if(!isActive()) return false;
118 // information is kept in PreStepPoint of G4 << 119 if(filter)
119 // Be aware that this method is a protected << 120 { if(!(filter->Accept(aStep))) return false; }
120 // by Hit() method of Base class after Reado << 121 if(ROgeometry)
121 // sensitive detector is handled. << 122 { if(!(ROgeometry->CheckROVolume(aStep,ROhis))) return false; }
122 // "ROhist" will be given only is a Readout << 123 return ProcessHits(aStep,ROhis);
123 // sensitive detector. The G4TouchableHistor << 124 }
124 // is stored in the PreStepPoint object of G << 125 // This is the public method invoked by G4SteppingManager for generating
125 virtual G4bool ProcessHits(G4Step* aStep, G4 << 126 // hit(s). The actual user's implementation for generating hit(s) must be
126 << 127 // implemented in GenerateHits() virtual protected method. This method
127 // This is a utility method which returns t << 128 // MUST NOT be overrided.
128 // "i"-th collection. "i" is the order (star << 129 inline void SetROgeometry(G4VReadOutGeometry*value)
129 // whose name is stored to the collectionNam << 130 { ROgeometry = value; }
130 virtual G4int GetCollectionID(G4int i); << 131 // Register the Readout geometry.
131 << 132 inline void SetFilter(G4VSDFilter*value)
132 protected: << 133 { filter = value; }
133 // This protected name vector must be fille << 134 // Register a filter
134 // concrete class for registering the name(s << 135
135 // created by this particular sensitive dete << 136 public:
136 G4CollectionNameVector collectionName; << 137 inline G4int GetNumberOfCollections() const
137 << 138 { return collectionName.size(); }
138 G4String SensitiveDetectorName; // detector << 139 inline G4String GetCollectionName(G4int id) const
139 G4String thePathName; // directory path << 140 { return collectionName[id]; }
140 G4String fullPathName; // path + detector n << 141 inline void SetVerboseLevel(G4int vl)
141 G4int verboseLevel{0}; << 142 { verboseLevel = vl; }
142 G4bool active{true}; << 143 inline void Activate(G4bool activeFlag)
143 G4VReadOutGeometry* ROgeometry{nullptr}; << 144 { active = activeFlag; }
144 G4VSDFilter* filter{nullptr}; << 145 inline G4bool isActive() const
>> 146 { return active; }
>> 147 inline G4String GetName() const
>> 148 { return SensitiveDetectorName; }
>> 149 inline G4String GetPathName() const
>> 150 { return thePathName; }
>> 151 inline G4String GetFullPathName() const
>> 152 { return fullPathName; }
>> 153 inline G4VReadOutGeometry* GetROgeometry() const
>> 154 { return ROgeometry; }
>> 155 inline G4VSDFilter* GetFilter() const
>> 156 { return filter; }
145 }; 157 };
146 158
>> 159
>> 160
>> 161
147 #endif 162 #endif
>> 163
148 164