Geant4 Cross Reference

Cross-Referencing   Geant4
Geant4/processes/electromagnetic/utils/include/G4VAtomDeexcitation.hh

Version: [ ReleaseNotes ] [ 1.0 ] [ 1.1 ] [ 2.0 ] [ 3.0 ] [ 3.1 ] [ 3.2 ] [ 4.0 ] [ 4.0.p1 ] [ 4.0.p2 ] [ 4.1 ] [ 4.1.p1 ] [ 5.0 ] [ 5.0.p1 ] [ 5.1 ] [ 5.1.p1 ] [ 5.2 ] [ 5.2.p1 ] [ 5.2.p2 ] [ 6.0 ] [ 6.0.p1 ] [ 6.1 ] [ 6.2 ] [ 6.2.p1 ] [ 6.2.p2 ] [ 7.0 ] [ 7.0.p1 ] [ 7.1 ] [ 7.1.p1 ] [ 8.0 ] [ 8.0.p1 ] [ 8.1 ] [ 8.1.p1 ] [ 8.1.p2 ] [ 8.2 ] [ 8.2.p1 ] [ 8.3 ] [ 8.3.p1 ] [ 8.3.p2 ] [ 9.0 ] [ 9.0.p1 ] [ 9.0.p2 ] [ 9.1 ] [ 9.1.p1 ] [ 9.1.p2 ] [ 9.1.p3 ] [ 9.2 ] [ 9.2.p1 ] [ 9.2.p2 ] [ 9.2.p3 ] [ 9.2.p4 ] [ 9.3 ] [ 9.3.p1 ] [ 9.3.p2 ] [ 9.4 ] [ 9.4.p1 ] [ 9.4.p2 ] [ 9.4.p3 ] [ 9.4.p4 ] [ 9.5 ] [ 9.5.p1 ] [ 9.5.p2 ] [ 9.6 ] [ 9.6.p1 ] [ 9.6.p2 ] [ 9.6.p3 ] [ 9.6.p4 ] [ 10.0 ] [ 10.0.p1 ] [ 10.0.p2 ] [ 10.0.p3 ] [ 10.0.p4 ] [ 10.1 ] [ 10.1.p1 ] [ 10.1.p2 ] [ 10.1.p3 ] [ 10.2 ] [ 10.2.p1 ] [ 10.2.p2 ] [ 10.2.p3 ] [ 10.3 ] [ 10.3.p1 ] [ 10.3.p2 ] [ 10.3.p3 ] [ 10.4 ] [ 10.4.p1 ] [ 10.4.p2 ] [ 10.4.p3 ] [ 10.5 ] [ 10.5.p1 ] [ 10.6 ] [ 10.6.p1 ] [ 10.6.p2 ] [ 10.6.p3 ] [ 10.7 ] [ 10.7.p1 ] [ 10.7.p2 ] [ 10.7.p3 ] [ 10.7.p4 ] [ 11.0 ] [ 11.0.p1 ] [ 11.0.p2 ] [ 11.0.p3, ] [ 11.0.p4 ] [ 11.1 ] [ 11.1.1 ] [ 11.1.2 ] [ 11.1.3 ] [ 11.2 ] [ 11.2.1 ] [ 11.2.2 ] [ 11.3.0 ]

Diff markup

Differences between /processes/electromagnetic/utils/include/G4VAtomDeexcitation.hh (Version 11.3.0) and /processes/electromagnetic/utils/include/G4VAtomDeexcitation.hh (Version 10.3.p3)


  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 // $Id: G4VAtomDeexcitation.hh 98985 2016-08-29 07:01:17Z gcosmo $
 26 //                                                 27 //
 27 // -------------------------------------------     28 // -------------------------------------------------------------------
 28 //                                                 29 //
 29 // GEANT4 Class header file                        30 // GEANT4 Class header file
 30 //                                                 31 //
 31 //                                                 32 //
 32 // File name:     G4VAtomDeexcitation              33 // File name:     G4VAtomDeexcitation
 33 //                                                 34 //
 34 // Author:        Alfonso Mantero & Vladimir I     35 // Author:        Alfonso Mantero & Vladimir Ivanchenko
 35 //                                                 36 //
 36 // Creation date: 30.06.2009                       37 // Creation date: 30.06.2009
 37 //                                                 38 //
 38 // Modifications:                                  39 // Modifications:
 39 // 15 Mar 2011  ALF   stripped G4AtomicShellEn     40 // 15 Mar 2011  ALF   stripped G4AtomicShellEnumerator to its own file
 40 //                                                 41 //
 41 // Class Description:                              42 // Class Description:
 42 //                                                 43 //
 43 // Abstract interface to energy loss models        44 // Abstract interface to energy loss models
 44                                                    45 
 45 // -------------------------------------------     46 // -------------------------------------------------------------------
 46 //                                                 47 //
 47                                                    48 
 48 #ifndef G4VAtomDeexcitation_h                      49 #ifndef G4VAtomDeexcitation_h
 49 #define G4VAtomDeexcitation_h 1                    50 #define G4VAtomDeexcitation_h 1
 50                                                    51 
 51 #include "globals.hh"                              52 #include "globals.hh"
 52 #include "G4EmParameters.hh"                       53 #include "G4EmParameters.hh"
 53 #include "G4AtomicShell.hh"                        54 #include "G4AtomicShell.hh"
 54 #include "G4AtomicShellEnumerator.hh"              55 #include "G4AtomicShellEnumerator.hh"
 55 #include "G4ProductionCutsTable.hh"                56 #include "G4ProductionCutsTable.hh"
 56 #include "G4Track.hh"                              57 #include "G4Track.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   inline void GenerateParticles(std::vector<G4DynamicParticle*>* secVect,  
128   void GenerateParticles(std::vector<G4Dynamic << 128                                 const G4AtomicShell*, 
129                          const G4AtomicShell*, << 129                                 G4int Z,
130                          G4int Z, G4int couple << 130                                 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,
                                                   >> 136                                  G4double gammaCut,
                                                   >> 137                                  G4double eCut) = 0;
136                                                   138 
137   // access or compute PIXE cross section         139   // access or compute PIXE cross section 
138   virtual G4double                                140   virtual G4double 
139   GetShellIonisationCrossSectionPerAtom(const     141   GetShellIonisationCrossSectionPerAtom(const G4ParticleDefinition*, 
140                                         G4int     142                                         G4int Z, 
141                                         G4Atom    143                                         G4AtomicShellEnumerator shell,
142                                         G4doub    144                                         G4double kinE,
143                                         const     145                                         const G4Material* mat = nullptr) = 0;
144                                                   146 
145   // access or compute PIXE cross section         147   // access or compute PIXE cross section 
146   virtual G4double                                148   virtual G4double 
147   ComputeShellIonisationCrossSectionPerAtom(      149   ComputeShellIonisationCrossSectionPerAtom(
148                                         const     150                                         const G4ParticleDefinition*, 
149                                         G4int     151                                         G4int Z, 
150                                         G4Atom    152                                         G4AtomicShellEnumerator shell,
151                                         G4doub    153                                         G4double kinE,
152                                         const     154                                         const G4Material* mat = nullptr) = 0;
153                                                   155 
154   // Sampling of PIXE for ionisation processes    156   // Sampling of PIXE for ionisation processes
155   void AlongStepDeexcitation(std::vector<G4Tra    157   void AlongStepDeexcitation(std::vector<G4Track*>& tracks,  
156                              const G4Step& ste    158                              const G4Step& step, 
157                              G4double& eLoss,     159                              G4double& eLoss,
158                              G4int coupleIndex    160                              G4int coupleIndex);
159                                                   161 
                                                   >> 162 private:
                                                   >> 163 
160   // copy constructor and hide assignment oper    164   // copy constructor and hide assignment operator
161   G4VAtomDeexcitation(G4VAtomDeexcitation &) =    165   G4VAtomDeexcitation(G4VAtomDeexcitation &) = delete;
162   G4VAtomDeexcitation & operator=(const G4VAto    166   G4VAtomDeexcitation & operator=(const G4VAtomDeexcitation &right) = delete;
163                                                   167 
164 private:                                       << 168   G4EmParameters*             theParameters;  
165                                                << 
166   const G4ParticleDefinition* gamma;              169   const G4ParticleDefinition* gamma;
167   const G4ProductionCutsTable* theCoupleTable  << 
168                                                   170 
169   G4int    nCouples = 0;                       << 171   G4ProductionCutsTable* theCoupleTable;
170   G4int    verbose = 1;                        << 172   G4int    verbose;
                                                   >> 173   G4String name;
171                                                   174 
172   G4bool   isActive = false;                   << 175   G4bool   isActive;
173   G4bool   flagAuger = false;                  << 176   G4bool   flagAuger;
174   G4bool   flagPIXE = false;                   << 177   G4bool   flagAugerCascade;
175   G4bool   ignoreCuts = false;                 << 178   G4bool   flagPIXE;
176                                                << 179   G4bool   ignoreCuts;
177   G4bool   isActiveLocked = false;             << 180 
178   G4bool   isAugerLocked = false;              << 181   G4bool   isActiveLocked;
179   G4bool   isPIXELocked = false;               << 182   G4bool   isAugerLocked;
                                                   >> 183   G4bool   isAugerCascadeLocked;
                                                   >> 184   G4bool   isPIXELocked;
180                                                   185 
181   std::vector<G4bool>   activeZ;                  186   std::vector<G4bool>   activeZ;
182   std::vector<G4bool>   activeDeexcitationMedi    187   std::vector<G4bool>   activeDeexcitationMedia;
183   std::vector<G4bool>   activeAugerMedia;         188   std::vector<G4bool>   activeAugerMedia;
184   std::vector<G4bool>   activePIXEMedia;          189   std::vector<G4bool>   activePIXEMedia;
                                                   >> 190   std::vector<G4String> activeRegions;
185   std::vector<G4bool>   deRegions;                191   std::vector<G4bool>   deRegions;
186   std::vector<G4bool>   AugerRegions;             192   std::vector<G4bool>   AugerRegions;
187   std::vector<G4bool>   PIXERegions;              193   std::vector<G4bool>   PIXERegions;
188   std::vector<G4DynamicParticle*> vdyn;           194   std::vector<G4DynamicParticle*> vdyn;
189   std::vector<G4String> activeRegions;         << 
190                                                << 
191   G4String name;                               << 
192                                                   195 
193 #ifdef G4MULTITHREADED                         << 196   static G4int pixeIDg;
194   static G4Mutex atomDeexcitationMutex;        << 197   static G4int pixeIDe;
195 #endif                                         << 
196 };                                                198 };
197                                                   199 
198 inline void G4VAtomDeexcitation::SetFluo(G4boo    200 inline void G4VAtomDeexcitation::SetFluo(G4bool val)
199 {                                                 201 {
200   if(!isActiveLocked) { isActive = val; isActi    202   if(!isActiveLocked) { isActive = val; isActiveLocked = true; }
201 }                                                 203 }
202                                                   204 
203 inline G4bool G4VAtomDeexcitation::IsFluoActiv    205 inline G4bool G4VAtomDeexcitation::IsFluoActive() const
204 {                                                 206 {
205   return isActive;                                207   return isActive;
206 }                                                 208 }
207                                                   209 
208 inline void G4VAtomDeexcitation::SetAuger(G4bo    210 inline void G4VAtomDeexcitation::SetAuger(G4bool val)
209 {                                                 211 {
210   if(!isAugerLocked) { flagAuger = val; isAuge    212   if(!isAugerLocked) { flagAuger = val; isAugerLocked = true; }
211 }                                                 213 }
212                                                   214 
213 inline G4bool G4VAtomDeexcitation::IsAugerActi    215 inline G4bool G4VAtomDeexcitation::IsAugerActive() const
214 {                                                 216 {
215   return flagAuger;                               217   return flagAuger;
216 }                                                 218 }
217                                                   219 
218 inline void G4VAtomDeexcitation::SetAugerCasca    220 inline void G4VAtomDeexcitation::SetAugerCascade(G4bool val)
219 {                                                 221 {
220   SetAuger(val);                               << 222   if(!isAugerCascadeLocked) { flagAugerCascade = val;  isAugerCascadeLocked = true; }
221 }                                                 223 }
222                                                   224 
223 inline G4bool G4VAtomDeexcitation::IsAugerCasc    225 inline G4bool G4VAtomDeexcitation::IsAugerCascadeActive() const
224 {                                                 226 {
225   return flagAuger;                            << 227   return flagAugerCascade;
226 }                                                 228 }
227                                                   229 
228 inline void G4VAtomDeexcitation::SetPIXE(G4boo    230 inline void G4VAtomDeexcitation::SetPIXE(G4bool val)
229 {                                                 231 {
230   if(!isPIXELocked) { flagPIXE = val;  isPIXEL    232   if(!isPIXELocked) { flagPIXE = val;  isPIXELocked = true; }
231 }                                                 233 }
232                                                   234 
233 inline G4bool G4VAtomDeexcitation::IsPIXEActiv    235 inline G4bool G4VAtomDeexcitation::IsPIXEActive() const
234 {                                                 236 {
235   return flagPIXE;                                237   return flagPIXE;
236 }                                                 238 }
237                                                   239 
238 inline const G4String& G4VAtomDeexcitation::Ge    240 inline const G4String& G4VAtomDeexcitation::GetName() const
239 {                                                 241 {
240   return name;                                    242   return name;
241 }                                                 243 }
242                                                   244 
243 inline const std::vector<G4bool>&                 245 inline const std::vector<G4bool>& 
244 G4VAtomDeexcitation::GetListOfActiveAtoms() co    246 G4VAtomDeexcitation::GetListOfActiveAtoms() const
245 {                                                 247 {
246   return activeZ;                                 248   return activeZ;
247 }                                                 249 }
248                                                   250 
249 inline void G4VAtomDeexcitation::SetVerboseLev    251 inline void G4VAtomDeexcitation::SetVerboseLevel(G4int val)
250 {                                                 252 {
251   verbose = val;                                  253   verbose = val;
252 }                                                 254 }
253                                                   255 
254 inline G4int G4VAtomDeexcitation::GetVerboseLe    256 inline G4int G4VAtomDeexcitation::GetVerboseLevel() const
255 {                                                 257 {
256   return verbose;                                 258   return verbose;
257 }                                                 259 }
258                                                   260 
259 inline G4bool                                     261 inline G4bool 
260 G4VAtomDeexcitation::CheckDeexcitationActiveRe << 262 G4VAtomDeexcitation::CheckDeexcitationActiveRegion(G4int coupleIndex)
261 {                                                 263 {
262   return (idx < nCouples) ? activeDeexcitation << 264   return (activeDeexcitationMedia[coupleIndex]);
263 }                                                 265 }
264                                                   266 
265 inline G4bool                                     267 inline G4bool 
266 G4VAtomDeexcitation::CheckAugerActiveRegion(G4 << 268 G4VAtomDeexcitation::CheckAugerActiveRegion(G4int coupleIndex)
267 {                                                 269 {
268   return (idx < nCouples) ? activeAugerMedia[i << 270   return (activeAugerMedia[coupleIndex]);
                                                   >> 271 }
                                                   >> 272 
                                                   >> 273 inline void 
                                                   >> 274 G4VAtomDeexcitation::GenerateParticles(std::vector<G4DynamicParticle*>* v,  
                                                   >> 275                                        const G4AtomicShell* as, 
                                                   >> 276                                        G4int Z,
                                                   >> 277                                        G4int idx)
                                                   >> 278 {
                                                   >> 279   G4double gCut = DBL_MAX;
                                                   >> 280   if(ignoreCuts) {
                                                   >> 281     gCut = 0.0;
                                                   >> 282   } else if (theCoupleTable) {
                                                   >> 283     gCut = (*(theCoupleTable->GetEnergyCutsVector(0)))[idx];
                                                   >> 284   }
                                                   >> 285   if(gCut < as->BindingEnergy()) {
                                                   >> 286     G4double eCut = DBL_MAX;
                                                   >> 287     if(CheckAugerActiveRegion(idx)) {
                                                   >> 288       if(ignoreCuts) {
                                                   >> 289         eCut = 0.0;
                                                   >> 290       } else if (theCoupleTable) {
                                                   >> 291         eCut = (*(theCoupleTable->GetEnergyCutsVector(1)))[idx];
                                                   >> 292       }
                                                   >> 293     }
                                                   >> 294     GenerateParticles(v, as, Z, gCut, eCut);
                                                   >> 295   }
269 }                                                 296 }
270                                                   297 
271 #endif                                            298 #endif
272                                                   299 
273                                                   300