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 9.4.p4)


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