1 | // |
---|
2 | // ******************************************************************** |
---|
3 | // * License and Disclaimer * |
---|
4 | // * * |
---|
5 | // * The Geant4 software is copyright of the Copyright Holders of * |
---|
6 | // * the Geant4 Collaboration. It is provided under the terms and * |
---|
7 | // * conditions of the Geant4 Software License, included in the file * |
---|
8 | // * LICENSE and available at http://cern.ch/geant4/license . These * |
---|
9 | // * include a list of copyright holders. * |
---|
10 | // * * |
---|
11 | // * Neither the authors of this software system, nor their employing * |
---|
12 | // * institutes,nor the agencies providing financial support for this * |
---|
13 | // * work make any representation or warranty, express or implied, * |
---|
14 | // * regarding this software system or assume any liability for its * |
---|
15 | // * use. Please see the license in the file LICENSE and URL above * |
---|
16 | // * for the full disclaimer and the limitation of liability. * |
---|
17 | // * * |
---|
18 | // * This code implementation is the result of the scientific and * |
---|
19 | // * technical work of the GEANT4 collaboration. * |
---|
20 | // * By using, copying, modifying or distributing the software (or * |
---|
21 | // * any work based on the software) you agree to acknowledge its * |
---|
22 | // * use in resulting scientific publications, and indicate your * |
---|
23 | // * acceptance of all terms of the Geant4 Software license. * |
---|
24 | // ******************************************************************** |
---|
25 | // |
---|
26 | // $Id: G4ionIonisation.hh,v 1.50 2007/11/09 11:45:45 vnivanch Exp $ |
---|
27 | // GEANT4 tag $Name: geant4-09-01-patch-02 $ |
---|
28 | // |
---|
29 | // ------------------------------------------------------------------- |
---|
30 | // |
---|
31 | // GEANT4 Class header file |
---|
32 | // |
---|
33 | // |
---|
34 | // File name: G4ionIonisation |
---|
35 | // |
---|
36 | // Author: Vladimir Ivanchenko |
---|
37 | // |
---|
38 | // Creation date: 07.05.2002 |
---|
39 | // |
---|
40 | // Modifications: |
---|
41 | // |
---|
42 | // 26-12-02 Secondary production moved to derived classes (VI) |
---|
43 | // 24-01-03 Make models region aware (V.Ivanchenko) |
---|
44 | // 05-02-03 Fix compilation warnings (V.Ivanchenko) |
---|
45 | // 13-02-03 SubCutoff regime is assigned to a region (V.Ivanchenko) |
---|
46 | // 15-02-03 Add control on delta pointer (V.Ivanchenko) |
---|
47 | // 23-05-03 Add fluctuation model as a member function (V.Ivanchenko) |
---|
48 | // 03-08-03 Add effective charge and saturation of tmax (V.Ivanchenko) |
---|
49 | // 12-11-03 Fix problem of negative effective charge (V.Ivanchenko) |
---|
50 | // 12-11-03 G4EnergyLossSTD -> G4EnergyLossProcess (V.Ivanchenko) |
---|
51 | // 21-01-04 Migrade to G4ParticleChangeForLoss (V.Ivanchenko) |
---|
52 | // 08-11-04 Migration to new interface of Store/Retrieve tables (V.Ivantchenko) |
---|
53 | // 08-04-05 Major optimisation of internal interfaces (V.Ivantchenko) |
---|
54 | // 11-04-05 Move MaxSecondary energy to model (V.Ivanchneko) |
---|
55 | // 11-04-04 Move MaxSecondaryEnergy to models (V.Ivanchenko) |
---|
56 | // 10-05-06 Add a possibility to download user data (V.Ivantchenko) |
---|
57 | // 22-07-06 Remove obsolete method (V.Ivantchenko) |
---|
58 | // 07-11-07 Moved CorrectionsAlongStep to cc (V.Ivantchenko) |
---|
59 | // |
---|
60 | // Class Description: |
---|
61 | // |
---|
62 | // This class manages the ionisation process for ions. Effective charge, |
---|
63 | // nuclear stopping power, energy loss corrections are taken into account. |
---|
64 | // It inherites from G4VEnergyLossLoss. |
---|
65 | // |
---|
66 | |
---|
67 | // ------------------------------------------------------------------- |
---|
68 | // |
---|
69 | |
---|
70 | #ifndef G4ionIonisation_h |
---|
71 | #define G4ionIonisation_h 1 |
---|
72 | |
---|
73 | #include "G4VEnergyLossProcess.hh" |
---|
74 | #include "G4ionEffectiveCharge.hh" |
---|
75 | #include "G4VEmModel.hh" |
---|
76 | #include "G4EmCorrections.hh" |
---|
77 | |
---|
78 | class G4Material; |
---|
79 | class G4PhysicsVector; |
---|
80 | class G4BraggIonModel; |
---|
81 | |
---|
82 | class G4ionIonisation : public G4VEnergyLossProcess |
---|
83 | { |
---|
84 | public: |
---|
85 | |
---|
86 | G4ionIonisation(const G4String& name = "ionIoni"); |
---|
87 | |
---|
88 | virtual ~G4ionIonisation(); |
---|
89 | |
---|
90 | inline G4bool IsApplicable(const G4ParticleDefinition& p); |
---|
91 | |
---|
92 | // Print out of the class parameters |
---|
93 | virtual void PrintInfo(); |
---|
94 | |
---|
95 | void AddStoppingData(G4int Z, G4int A, const G4String& materialName, |
---|
96 | G4PhysicsVector& dVector); |
---|
97 | |
---|
98 | void ActivateStoppingData(G4bool); |
---|
99 | |
---|
100 | void ActivateNuclearStopping(G4bool); |
---|
101 | |
---|
102 | protected: |
---|
103 | |
---|
104 | virtual void InitialiseEnergyLossProcess(const G4ParticleDefinition*, |
---|
105 | const G4ParticleDefinition*); |
---|
106 | |
---|
107 | virtual void CorrectionsAlongStep(const G4MaterialCutsCouple*, |
---|
108 | const G4DynamicParticle*, |
---|
109 | G4double& eloss, |
---|
110 | G4double& length); |
---|
111 | |
---|
112 | inline void InitialiseMassCharge(const G4Track&); |
---|
113 | |
---|
114 | inline G4double MinPrimaryEnergy(const G4ParticleDefinition* p, |
---|
115 | const G4Material*, G4double cut); |
---|
116 | |
---|
117 | inline G4double BetheBlochEnergyThreshold(); |
---|
118 | |
---|
119 | inline G4bool NuclearStoppingFlag(); |
---|
120 | |
---|
121 | // protected pointers |
---|
122 | G4ionEffectiveCharge* effCharge; |
---|
123 | G4EmCorrections* corr; |
---|
124 | |
---|
125 | private: |
---|
126 | |
---|
127 | // hide assignment operator |
---|
128 | G4ionIonisation & operator=(const G4ionIonisation &right); |
---|
129 | G4ionIonisation(const G4ionIonisation&); |
---|
130 | |
---|
131 | // cash |
---|
132 | const G4Material* curMaterial; |
---|
133 | const G4ParticleDefinition* curParticle; |
---|
134 | const G4ParticleDefinition* theParticle; |
---|
135 | const G4ParticleDefinition* theBaseParticle; |
---|
136 | |
---|
137 | G4double preKinEnergy; |
---|
138 | |
---|
139 | G4double eth; |
---|
140 | G4double baseMass; |
---|
141 | G4double massRatio; |
---|
142 | G4double massFactor; |
---|
143 | G4double charge2; |
---|
144 | |
---|
145 | G4bool isInitialised; |
---|
146 | G4bool stopDataActive; |
---|
147 | G4bool nuclearStopping; |
---|
148 | }; |
---|
149 | |
---|
150 | //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo.... |
---|
151 | //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo.... |
---|
152 | |
---|
153 | inline G4bool G4ionIonisation::IsApplicable(const G4ParticleDefinition& p) |
---|
154 | { |
---|
155 | return (p.GetPDGCharge() != 0.0 && !p.IsShortLived() && |
---|
156 | p.GetParticleType() == "nucleus"); |
---|
157 | } |
---|
158 | |
---|
159 | //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo.... |
---|
160 | |
---|
161 | inline G4double G4ionIonisation::MinPrimaryEnergy( |
---|
162 | const G4ParticleDefinition*, const G4Material*, G4double cut) |
---|
163 | { |
---|
164 | G4double x = 0.5*cut/electron_mass_c2; |
---|
165 | G4double g = std::sqrt(1. + x); |
---|
166 | return proton_mass_c2*(g - 1.0); |
---|
167 | } |
---|
168 | |
---|
169 | //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo.... |
---|
170 | |
---|
171 | inline void G4ionIonisation::InitialiseMassCharge(const G4Track& track) |
---|
172 | { |
---|
173 | preKinEnergy = track.GetKineticEnergy(); |
---|
174 | massRatio = baseMass/track.GetDynamicParticle()->GetMass(); |
---|
175 | charge2 = effCharge->EffectiveChargeSquareRatio(track.GetDefinition(), |
---|
176 | track.GetMaterial(), |
---|
177 | preKinEnergy); |
---|
178 | SetDynamicMassCharge(massRatio, charge2); |
---|
179 | } |
---|
180 | |
---|
181 | //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo.... |
---|
182 | |
---|
183 | inline void G4ionIonisation::ActivateStoppingData(G4bool val) |
---|
184 | { |
---|
185 | stopDataActive = val; |
---|
186 | } |
---|
187 | |
---|
188 | //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo.... |
---|
189 | |
---|
190 | inline void G4ionIonisation::ActivateNuclearStopping(G4bool val) |
---|
191 | { |
---|
192 | nuclearStopping = val; |
---|
193 | } |
---|
194 | |
---|
195 | //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo.... |
---|
196 | |
---|
197 | inline G4double G4ionIonisation::BetheBlochEnergyThreshold() |
---|
198 | { |
---|
199 | return eth; |
---|
200 | } |
---|
201 | |
---|
202 | //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo.... |
---|
203 | |
---|
204 | inline G4bool G4ionIonisation::NuclearStoppingFlag() |
---|
205 | { |
---|
206 | return nuclearStopping; |
---|
207 | } |
---|
208 | |
---|
209 | //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo.... |
---|
210 | |
---|
211 | #endif |
---|