| 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 #ifndef G4ElectronIonPair_h 26 #ifndef G4ElectronIonPair_h
27 #define G4ElectronIonPair_h 1 27 #define G4ElectronIonPair_h 1
28 28
29 // ------------------------------------------- 29 // -------------------------------------------------------------
30 // 30 //
31 // GEANT4 Class header file 31 // GEANT4 Class header file
32 // 32 //
33 // 33 //
34 // File name: G4ElectronIonPair 34 // File name: G4ElectronIonPair
35 // 35 //
36 // Author: Vladimir Ivanchenko 36 // Author: Vladimir Ivanchenko
37 // 37 //
38 // Creation date: 08.07.2008 38 // Creation date: 08.07.2008
39 // 39 //
40 // Modifications: 40 // Modifications:
41 // 41 //
42 // 42 //
43 // Class Description: 43 // Class Description:
44 // Compution on number of electon-ion or ele 44 // Compution on number of electon-ion or electorn-hole pairs
45 // at the step of a particle and sampling io 45 // at the step of a particle and sampling ionisation points
46 // in space 46 // in space
47 // 47 //
48 // Based on ICRU Report 31, 1979 48 // Based on ICRU Report 31, 1979
49 // "Average Energy Required to Produce an Ion 49 // "Average Energy Required to Produce an Ion Pair"
50 // 50 //
51 // 06.04.2010 V. Grichine, substitute Gauss by 51 // 06.04.2010 V. Grichine, substitute Gauss by Gamma for ionisation
52 // distribution at fix 52 // distribution at fixed energy deposition
53 // 53 //
54 // ------------------------------------------- 54 // -------------------------------------------------------------
55 55
56 //....oooOO0OOooo........oooOO0OOooo........oo 56 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
57 //....oooOO0OOooo........oooOO0OOooo........oo 57 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
58 58
59 #include "globals.hh" 59 #include "globals.hh"
60 #include "G4Step.hh" 60 #include "G4Step.hh"
61 #include "G4ParticleDefinition.hh" 61 #include "G4ParticleDefinition.hh"
62 #include "G4ThreeVector.hh" 62 #include "G4ThreeVector.hh"
63 #include "G4VProcess.hh" 63 #include "G4VProcess.hh"
64 #include "Randomize.hh" 64 #include "Randomize.hh"
65 #include <vector> 65 #include <vector>
66 66
67 //....oooOO0OOooo........oooOO0OOooo........oo 67 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
68 68
69 class G4Material; 69 class G4Material;
70 70
71 class G4ElectronIonPair 71 class G4ElectronIonPair
72 { 72 {
73 public: 73 public:
74 74
75 explicit G4ElectronIonPair(G4int verb); 75 explicit G4ElectronIonPair(G4int verb);
76 76
77 virtual ~G4ElectronIonPair(); 77 virtual ~G4ElectronIonPair();
78 78
79 // compute mean number of ionisation points 79 // compute mean number of ionisation points at a step
80 G4double MeanNumberOfIonsAlongStep(const G4P 80 G4double MeanNumberOfIonsAlongStep(const G4ParticleDefinition*,
81 const G4Material*, 81 const G4Material*,
82 G4double edepTotal, 82 G4double edepTotal,
83 G4double edepNIEL = 0.0); 83 G4double edepNIEL = 0.0);
84 84
85 inline G4double MeanNumberOfIonsAlongStep(co 85 inline G4double MeanNumberOfIonsAlongStep(const G4Step*);
86 86
87 inline G4int SampleNumberOfIonsAlongStep(con 87 inline G4int SampleNumberOfIonsAlongStep(const G4Step*);
88 88
89 // returns pointer to the new vector of posi 89 // returns pointer to the new vector of positions of
90 // ionisation points in the World coordinate 90 // ionisation points in the World coordinate system
91 std::vector<G4ThreeVector>* SampleIonsAlongS 91 std::vector<G4ThreeVector>* SampleIonsAlongStep(const G4Step*);
92 92
93 // compute number of holes in the atom after 93 // compute number of holes in the atom after PostStep interaction
94 G4int ResidualeChargePostStep(const G4Partic 94 G4int ResidualeChargePostStep(const G4ParticleDefinition*,
95 const G4TrackVector* secondary = nullp 95 const G4TrackVector* secondary = nullptr,
96 G4int processSubType = -1) const; 96 G4int processSubType = -1) const;
97 97
98 inline G4int ResidualeChargePostStep(const G 98 inline G4int ResidualeChargePostStep(const G4Step*) const;
99 99
100 // find mean energies per ionisation 100 // find mean energies per ionisation
101 G4double FindG4MeanEnergyPerIonPair(const G4 101 G4double FindG4MeanEnergyPerIonPair(const G4Material*) const;
102 102
103 // dump mean energies per ionisation used in 103 // dump mean energies per ionisation used in run time
104 void DumpMeanEnergyPerIonPair() const; 104 void DumpMeanEnergyPerIonPair() const;
105 105
106 // dump G4 list 106 // dump G4 list
107 void DumpG4MeanEnergyPerIonPair() const; 107 void DumpG4MeanEnergyPerIonPair() const;
108 108
109 inline void SetVerbose(G4int); 109 inline void SetVerbose(G4int);
110 110
111 // hide assignment operator 111 // hide assignment operator
112 G4ElectronIonPair & operator=(const G4Electr 112 G4ElectronIonPair & operator=(const G4ElectronIonPair &right) = delete;
113 G4ElectronIonPair(const G4ElectronIonPair&) 113 G4ElectronIonPair(const G4ElectronIonPair&) = delete;
114 114
115 private: 115 private:
116 116
117 void Initialise(); 117 void Initialise();
118 118
119 G4double FindMeanEnergyPerIonPair(const G4Ma 119 G4double FindMeanEnergyPerIonPair(const G4Material*) const;
120 120
121 // cache 121 // cache
122 const G4Material* curMaterial; 122 const G4Material* curMaterial;
123 G4double curMeanEnergy; 123 G4double curMeanEnergy;
124 124
125 G4double invFanoFactor; 125 G4double invFanoFactor;
126 126
127 G4int verbose; 127 G4int verbose;
128 G4int nMaterials; 128 G4int nMaterials;
129 129
130 // list of G4 NIST materials with mean energ 130 // list of G4 NIST materials with mean energy per ion defined
131 std::vector<G4double> g4MatData; 131 std::vector<G4double> g4MatData;
132 std::vector<G4String> g4MatNames; 132 std::vector<G4String> g4MatNames;
133 }; 133 };
134 134
135 inline G4double 135 inline G4double
136 G4ElectronIonPair::MeanNumberOfIonsAlongStep(c 136 G4ElectronIonPair::MeanNumberOfIonsAlongStep(const G4Step* step)
137 { 137 {
138 return MeanNumberOfIonsAlongStep(step->GetTr 138 return MeanNumberOfIonsAlongStep(step->GetTrack()->GetParticleDefinition(),
139 step->GetPreStepPoint()->GetMateria 139 step->GetPreStepPoint()->GetMaterial(),
140 step->GetTotalEnergyDeposit(), 140 step->GetTotalEnergyDeposit(),
141 step->GetNonIonizingEnergyDeposit() 141 step->GetNonIonizingEnergyDeposit());
142 } 142 }
143 143
144 inline G4int 144 inline G4int
145 G4ElectronIonPair::SampleNumberOfIonsAlongStep 145 G4ElectronIonPair::SampleNumberOfIonsAlongStep(const G4Step* step)
146 { 146 {
147 // use gamma distribution with mean value n= 147 // use gamma distribution with mean value n=meanion and
148 // dispersion D=meanion/invFanoFactor 148 // dispersion D=meanion/invFanoFactor
149 G4double meanion = MeanNumberOfIonsAlongStep 149 G4double meanion = MeanNumberOfIonsAlongStep(step);
150 return G4lrint(G4RandGamma::shoot(meanion*in 150 return G4lrint(G4RandGamma::shoot(meanion*invFanoFactor,invFanoFactor));
151 } 151 }
152 152
153 inline G4int 153 inline G4int
154 G4ElectronIonPair::ResidualeChargePostStep(con 154 G4ElectronIonPair::ResidualeChargePostStep(const G4Step* step) const
155 { 155 {
156 G4int subtype = -1; 156 G4int subtype = -1;
157 const G4VProcess* proc = step->GetPostStepPo 157 const G4VProcess* proc = step->GetPostStepPoint()->GetProcessDefinedStep();
158 if(proc) { subtype = proc->GetProcessSubType 158 if(proc) { subtype = proc->GetProcessSubType(); }
159 return ResidualeChargePostStep(step->GetTrac 159 return ResidualeChargePostStep(step->GetTrack()->GetParticleDefinition(),
160 step->GetSecondary(), 160 step->GetSecondary(),
161 subtype); 161 subtype);
162 } 162 }
163 163
164 inline void G4ElectronIonPair::SetVerbose(G4in 164 inline void G4ElectronIonPair::SetVerbose(G4int val)
165 { 165 {
166 verbose = val; 166 verbose = val;
167 } 167 }
168 168
169 #endif 169 #endif
170 170
171 171