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 // 26 // 27 // ------------------------------------------- 27 // ------------------------------------------------------------------- 28 // 28 // 29 // GEANT4 Class header file 29 // GEANT4 Class header file 30 // 30 // 31 // 31 // 32 // File name: G4VAtomDeexcitation 32 // File name: G4VAtomDeexcitation 33 // 33 // 34 // Author: Alfonso Mantero & Vladimir I 34 // Author: Alfonso Mantero & Vladimir Ivanchenko 35 // 35 // 36 // Creation date: 30.06.2009 36 // Creation date: 30.06.2009 37 // 37 // 38 // Modifications: 38 // Modifications: 39 // 15 Mar 2011 ALF stripped G4AtomicShellEn 39 // 15 Mar 2011 ALF stripped G4AtomicShellEnumerator to its own file 40 // 40 // 41 // Class Description: 41 // Class Description: 42 // 42 // 43 // Abstract interface to energy loss models 43 // Abstract interface to energy loss models 44 44 45 // ------------------------------------------- 45 // ------------------------------------------------------------------- 46 // 46 // 47 47 48 #ifndef G4VAtomDeexcitation_h 48 #ifndef G4VAtomDeexcitation_h 49 #define G4VAtomDeexcitation_h 1 49 #define G4VAtomDeexcitation_h 1 50 50 51 #include "globals.hh" 51 #include "globals.hh" 52 #include "G4EmParameters.hh" 52 #include "G4EmParameters.hh" 53 #include "G4AtomicShell.hh" 53 #include "G4AtomicShell.hh" 54 #include "G4AtomicShellEnumerator.hh" 54 #include "G4AtomicShellEnumerator.hh" 55 #include "G4ProductionCutsTable.hh" 55 #include "G4ProductionCutsTable.hh" 56 #include "G4Track.hh" 56 #include "G4Track.hh" 57 #include "G4Threading.hh" 57 #include "G4Threading.hh" 58 #include <vector> 58 #include <vector> 59 59 60 class G4ParticleDefinition; 60 class G4ParticleDefinition; 61 class G4DynamicParticle; 61 class G4DynamicParticle; 62 class G4MaterialCutsCouple; 62 class G4MaterialCutsCouple; 63 63 64 class G4VAtomDeexcitation { 64 class G4VAtomDeexcitation { 65 public: 65 public: 66 66 67 explicit G4VAtomDeexcitation(const G4String& 67 explicit G4VAtomDeexcitation(const G4String& modname = "Deexcitation"); 68 68 69 virtual ~G4VAtomDeexcitation(); 69 virtual ~G4VAtomDeexcitation(); 70 70 71 //========== initialization ========== 71 //========== initialization ========== 72 72 73 // Overall initialisation before new run 73 // Overall initialisation before new run 74 void InitialiseAtomicDeexcitation(); 74 void InitialiseAtomicDeexcitation(); 75 75 76 // Initialisation of deexcitation at the beg 76 // Initialisation of deexcitation at the beginning of run 77 virtual void InitialiseForNewRun() = 0; 77 virtual void InitialiseForNewRun() = 0; 78 78 79 // Initialisation for a concrete atom 79 // Initialisation for a concrete atom 80 // May be called at run time 80 // May be called at run time 81 virtual void InitialiseForExtraAtom(G4int Z) 81 virtual void InitialiseForExtraAtom(G4int Z) = 0; 82 82 83 void SetDeexcitationActiveRegion(const G4Str 83 void SetDeexcitationActiveRegion(const G4String& rname, 84 G4bool valD 84 G4bool valDeexcitation, 85 G4bool valA 85 G4bool valAuger, 86 G4bool valP 86 G4bool valPIXE); 87 87 88 // Activation of deexcitation 88 // Activation of deexcitation 89 inline void SetFluo(G4bool); 89 inline void SetFluo(G4bool); 90 inline G4bool IsFluoActive() const; 90 inline G4bool IsFluoActive() const; 91 91 92 // Activation of Auger electron production 92 // Activation of Auger electron production 93 inline void SetAuger(G4bool); 93 inline void SetAuger(G4bool); 94 inline G4bool IsAugerActive() const; 94 inline G4bool IsAugerActive() const; 95 95 96 // Activation of Auger cascade 96 // Activation of Auger cascade 97 inline void SetAugerCascade(G4bool); 97 inline void SetAugerCascade(G4bool); 98 inline G4bool IsAugerCascadeActive() const; 98 inline G4bool IsAugerCascadeActive() const; 99 99 100 // Activation of PIXE simulation 100 // Activation of PIXE simulation 101 inline void SetPIXE(G4bool); 101 inline void SetPIXE(G4bool); 102 inline G4bool IsPIXEActive() const; 102 inline G4bool IsPIXEActive() const; 103 103 104 // Deexcitation model name 104 // Deexcitation model name 105 inline const G4String& GetName() const; 105 inline const G4String& GetName() const; 106 106 107 // Access to the list of atoms active for de 107 // Access to the list of atoms active for deexcitation 108 inline const std::vector<G4bool>& GetListOfA 108 inline const std::vector<G4bool>& GetListOfActiveAtoms() const; 109 109 110 // Verbosity level 110 // Verbosity level 111 inline void SetVerboseLevel(G4int); 111 inline void SetVerboseLevel(G4int); 112 inline G4int GetVerboseLevel() const; 112 inline G4int GetVerboseLevel() const; 113 113 114 //========== Run time methods ========== 114 //========== Run time methods ========== 115 115 116 // Check if deexcitation is active for a giv 116 // Check if deexcitation is active for a given geometry volume 117 inline G4bool CheckDeexcitationActiveRegion( 117 inline G4bool CheckDeexcitationActiveRegion(G4int coupleIndex); 118 inline G4bool CheckAugerActiveRegion(G4int c 118 inline G4bool CheckAugerActiveRegion(G4int coupleIndex); 119 119 120 // Get atomic shell by shell index, used by 120 // Get atomic shell by shell index, used by discrete processes 121 // (for example, photoelectric), when shell 121 // (for example, photoelectric), when shell vacancy sampled by the model 122 virtual 122 virtual 123 const G4AtomicShell* GetAtomicShell(G4int Z, 123 const G4AtomicShell* GetAtomicShell(G4int Z, 124 G4Atomic 124 G4AtomicShellEnumerator shell) = 0; 125 125 126 // generation of deexcitation for given atom 126 // generation of deexcitation for given atom and shell vacancy 127 // and material cut couple, which defines cu 127 // and material cut couple, which defines cut values 128 void GenerateParticles(std::vector<G4Dynamic 128 void GenerateParticles(std::vector<G4DynamicParticle*>* secVect, 129 const G4AtomicShell*, 129 const G4AtomicShell*, 130 G4int Z, G4int couple 130 G4int Z, G4int coupleIndex); 131 131 132 // generation of deexcitation for given atom 132 // generation of deexcitation for given atom and shell vacancy 133 virtual void GenerateParticles(std::vector<G 133 virtual void GenerateParticles(std::vector<G4DynamicParticle*>* secVect, 134 const G4Atomi 134 const G4AtomicShell*, 135 G4int Z, G4do 135 G4int Z, G4double gammaCut, G4double eCut) = 0; 136 136 137 // access or compute PIXE cross section 137 // access or compute PIXE cross section 138 virtual G4double 138 virtual G4double 139 GetShellIonisationCrossSectionPerAtom(const 139 GetShellIonisationCrossSectionPerAtom(const G4ParticleDefinition*, 140 G4int 140 G4int Z, 141 G4Atom 141 G4AtomicShellEnumerator shell, 142 G4doub 142 G4double kinE, 143 const 143 const G4Material* mat = nullptr) = 0; 144 144 145 // access or compute PIXE cross section 145 // access or compute PIXE cross section 146 virtual G4double 146 virtual G4double 147 ComputeShellIonisationCrossSectionPerAtom( 147 ComputeShellIonisationCrossSectionPerAtom( 148 const 148 const G4ParticleDefinition*, 149 G4int 149 G4int Z, 150 G4Atom 150 G4AtomicShellEnumerator shell, 151 G4doub 151 G4double kinE, 152 const 152 const G4Material* mat = nullptr) = 0; 153 153 154 // Sampling of PIXE for ionisation processes 154 // Sampling of PIXE for ionisation processes 155 void AlongStepDeexcitation(std::vector<G4Tra 155 void AlongStepDeexcitation(std::vector<G4Track*>& tracks, 156 const G4Step& ste 156 const G4Step& step, 157 G4double& eLoss, 157 G4double& eLoss, 158 G4int coupleIndex 158 G4int coupleIndex); 159 159 160 // copy constructor and hide assignment oper 160 // copy constructor and hide assignment operator 161 G4VAtomDeexcitation(G4VAtomDeexcitation &) = 161 G4VAtomDeexcitation(G4VAtomDeexcitation &) = delete; 162 G4VAtomDeexcitation & operator=(const G4VAto 162 G4VAtomDeexcitation & operator=(const G4VAtomDeexcitation &right) = delete; 163 163 164 private: 164 private: 165 165 166 const G4ParticleDefinition* gamma; 166 const G4ParticleDefinition* gamma; 167 const G4ProductionCutsTable* theCoupleTable 167 const G4ProductionCutsTable* theCoupleTable = nullptr; 168 168 169 G4int nCouples = 0; 169 G4int nCouples = 0; 170 G4int verbose = 1; 170 G4int verbose = 1; 171 171 172 G4bool isActive = false; 172 G4bool isActive = false; 173 G4bool flagAuger = false; 173 G4bool flagAuger = false; 174 G4bool flagPIXE = false; 174 G4bool flagPIXE = false; 175 G4bool ignoreCuts = false; 175 G4bool ignoreCuts = false; 176 176 177 G4bool isActiveLocked = false; 177 G4bool isActiveLocked = false; 178 G4bool isAugerLocked = false; 178 G4bool isAugerLocked = false; 179 G4bool isPIXELocked = false; 179 G4bool isPIXELocked = false; 180 180 181 std::vector<G4bool> activeZ; 181 std::vector<G4bool> activeZ; 182 std::vector<G4bool> activeDeexcitationMedi 182 std::vector<G4bool> activeDeexcitationMedia; 183 std::vector<G4bool> activeAugerMedia; 183 std::vector<G4bool> activeAugerMedia; 184 std::vector<G4bool> activePIXEMedia; 184 std::vector<G4bool> activePIXEMedia; 185 std::vector<G4bool> deRegions; 185 std::vector<G4bool> deRegions; 186 std::vector<G4bool> AugerRegions; 186 std::vector<G4bool> AugerRegions; 187 std::vector<G4bool> PIXERegions; 187 std::vector<G4bool> PIXERegions; 188 std::vector<G4DynamicParticle*> vdyn; 188 std::vector<G4DynamicParticle*> vdyn; 189 std::vector<G4String> activeRegions; 189 std::vector<G4String> activeRegions; 190 190 191 G4String name; 191 G4String name; 192 192 193 #ifdef G4MULTITHREADED 193 #ifdef G4MULTITHREADED 194 static G4Mutex atomDeexcitationMutex; 194 static G4Mutex atomDeexcitationMutex; 195 #endif 195 #endif 196 }; 196 }; 197 197 198 inline void G4VAtomDeexcitation::SetFluo(G4boo 198 inline void G4VAtomDeexcitation::SetFluo(G4bool val) 199 { 199 { 200 if(!isActiveLocked) { isActive = val; isActi 200 if(!isActiveLocked) { isActive = val; isActiveLocked = true; } 201 } 201 } 202 202 203 inline G4bool G4VAtomDeexcitation::IsFluoActiv 203 inline G4bool G4VAtomDeexcitation::IsFluoActive() const 204 { 204 { 205 return isActive; 205 return isActive; 206 } 206 } 207 207 208 inline void G4VAtomDeexcitation::SetAuger(G4bo 208 inline void G4VAtomDeexcitation::SetAuger(G4bool val) 209 { 209 { 210 if(!isAugerLocked) { flagAuger = val; isAuge 210 if(!isAugerLocked) { flagAuger = val; isAugerLocked = true; } 211 } 211 } 212 212 213 inline G4bool G4VAtomDeexcitation::IsAugerActi 213 inline G4bool G4VAtomDeexcitation::IsAugerActive() const 214 { 214 { 215 return flagAuger; 215 return flagAuger; 216 } 216 } 217 217 218 inline void G4VAtomDeexcitation::SetAugerCasca 218 inline void G4VAtomDeexcitation::SetAugerCascade(G4bool val) 219 { 219 { 220 SetAuger(val); 220 SetAuger(val); 221 } 221 } 222 222 223 inline G4bool G4VAtomDeexcitation::IsAugerCasc 223 inline G4bool G4VAtomDeexcitation::IsAugerCascadeActive() const 224 { 224 { 225 return flagAuger; 225 return flagAuger; 226 } 226 } 227 227 228 inline void G4VAtomDeexcitation::SetPIXE(G4boo 228 inline void G4VAtomDeexcitation::SetPIXE(G4bool val) 229 { 229 { 230 if(!isPIXELocked) { flagPIXE = val; isPIXEL 230 if(!isPIXELocked) { flagPIXE = val; isPIXELocked = true; } 231 } 231 } 232 232 233 inline G4bool G4VAtomDeexcitation::IsPIXEActiv 233 inline G4bool G4VAtomDeexcitation::IsPIXEActive() const 234 { 234 { 235 return flagPIXE; 235 return flagPIXE; 236 } 236 } 237 237 238 inline const G4String& G4VAtomDeexcitation::Ge 238 inline const G4String& G4VAtomDeexcitation::GetName() const 239 { 239 { 240 return name; 240 return name; 241 } 241 } 242 242 243 inline const std::vector<G4bool>& 243 inline const std::vector<G4bool>& 244 G4VAtomDeexcitation::GetListOfActiveAtoms() co 244 G4VAtomDeexcitation::GetListOfActiveAtoms() const 245 { 245 { 246 return activeZ; 246 return activeZ; 247 } 247 } 248 248 249 inline void G4VAtomDeexcitation::SetVerboseLev 249 inline void G4VAtomDeexcitation::SetVerboseLevel(G4int val) 250 { 250 { 251 verbose = val; 251 verbose = val; 252 } 252 } 253 253 254 inline G4int G4VAtomDeexcitation::GetVerboseLe 254 inline G4int G4VAtomDeexcitation::GetVerboseLevel() const 255 { 255 { 256 return verbose; 256 return verbose; 257 } 257 } 258 258 259 inline G4bool 259 inline G4bool 260 G4VAtomDeexcitation::CheckDeexcitationActiveRe 260 G4VAtomDeexcitation::CheckDeexcitationActiveRegion(G4int idx) 261 { 261 { 262 return (idx < nCouples) ? activeDeexcitation 262 return (idx < nCouples) ? activeDeexcitationMedia[idx] : false; 263 } 263 } 264 264 265 inline G4bool 265 inline G4bool 266 G4VAtomDeexcitation::CheckAugerActiveRegion(G4 266 G4VAtomDeexcitation::CheckAugerActiveRegion(G4int idx) 267 { 267 { 268 return (idx < nCouples) ? activeAugerMedia[i 268 return (idx < nCouples) ? activeAugerMedia[idx] : false; 269 } 269 } 270 270 271 #endif 271 #endif 272 272 273 273