| 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 // $Id: G4ionIonisation.hh,v 1.41 2006/06/29 19:52:34 gunter Exp $
>> 27 // GEANT4 tag $Name: geant4-08-01-patch-01 $
26 // 28 //
27 // ------------------------------------------- 29 // -------------------------------------------------------------------
28 // 30 //
29 // GEANT4 Class header file 31 // GEANT4 Class header file
30 // 32 //
31 // 33 //
32 // File name: G4ionIonisation 34 // File name: G4ionIonisation
33 // 35 //
34 // Author: Vladimir Ivanchenko 36 // Author: Vladimir Ivanchenko
35 // 37 //
36 // Creation date: 07.05.2002 38 // Creation date: 07.05.2002
37 // 39 //
38 // Modifications: 40 // Modifications:
39 // 41 //
40 // 26-12-02 Secondary production moved to deri 42 // 26-12-02 Secondary production moved to derived classes (VI)
41 // 24-01-03 Make models region aware (V.Ivanch 43 // 24-01-03 Make models region aware (V.Ivanchenko)
42 // 05-02-03 Fix compilation warnings (V.Ivanch 44 // 05-02-03 Fix compilation warnings (V.Ivanchenko)
43 // 13-02-03 SubCutoff regime is assigned to a 45 // 13-02-03 SubCutoff regime is assigned to a region (V.Ivanchenko)
44 // 15-02-03 Add control on delta pointer (V.Iv 46 // 15-02-03 Add control on delta pointer (V.Ivanchenko)
45 // 23-05-03 Add fluctuation model as a member 47 // 23-05-03 Add fluctuation model as a member function (V.Ivanchenko)
46 // 03-08-03 Add effective charge and saturatio 48 // 03-08-03 Add effective charge and saturation of tmax (V.Ivanchenko)
47 // 12-11-03 Fix problem of negative effective 49 // 12-11-03 Fix problem of negative effective charge (V.Ivanchenko)
48 // 12-11-03 G4EnergyLossSTD -> G4EnergyLossPro 50 // 12-11-03 G4EnergyLossSTD -> G4EnergyLossProcess (V.Ivanchenko)
49 // 21-01-04 Migrade to G4ParticleChangeForLoss 51 // 21-01-04 Migrade to G4ParticleChangeForLoss (V.Ivanchenko)
50 // 08-11-04 Migration to new interface of Stor 52 // 08-11-04 Migration to new interface of Store/Retrieve tables (V.Ivantchenko)
51 // 08-04-05 Major optimisation of internal int 53 // 08-04-05 Major optimisation of internal interfaces (V.Ivantchenko)
52 // 11-04-05 Move MaxSecondary energy to model 54 // 11-04-05 Move MaxSecondary energy to model (V.Ivanchneko)
53 // 11-04-04 Move MaxSecondaryEnergy to models 55 // 11-04-04 Move MaxSecondaryEnergy to models (V.Ivanchenko)
54 // 10-05-06 Add a possibility to download user 56 // 10-05-06 Add a possibility to download user data (V.Ivantchenko)
55 // 22-07-06 Remove obsolete method (V.Ivantche <<
56 // 07-11-07 Moved CorrectionsAlongStep to cc ( <<
57 // 12-09-08 Removed InitialiseMassCharge and C <<
58 // 57 //
59 // Class Description: 58 // Class Description:
60 // 59 //
61 // This class manages the ionisation process f << 60 // This class manages the ionisation process for ions.
62 // nuclear stopping power, energy loss correct << 61 // it inherites from G4VContinuousDiscreteProcess via G4VEnergyLoss.
63 // It inherites from G4VEnergyLossLoss. <<
64 // 62 //
65 63
66 // ------------------------------------------- 64 // -------------------------------------------------------------------
67 // 65 //
68 66
69 #ifndef G4ionIonisation_h 67 #ifndef G4ionIonisation_h
70 #define G4ionIonisation_h 1 68 #define G4ionIonisation_h 1
71 69
72 #include "G4VEnergyLossProcess.hh" 70 #include "G4VEnergyLossProcess.hh"
>> 71 #include "G4ionEffectiveCharge.hh"
>> 72 #include "G4VEmModel.hh"
>> 73 #include "G4EmCorrections.hh"
73 74
74 class G4Material; 75 class G4Material;
>> 76 class G4VEmFluctuationModel;
>> 77 class G4PhysicsVector;
>> 78 class G4BraggIonModel;
75 79
76 class G4ionIonisation : public G4VEnergyLossPr 80 class G4ionIonisation : public G4VEnergyLossProcess
77 { 81 {
78 public: 82 public:
79 83
80 explicit G4ionIonisation(const G4String& nam << 84 G4ionIonisation(const G4String& name = "ionIoni");
81 85
82 ~G4ionIonisation() override = default; << 86 virtual ~G4ionIonisation();
83 87
84 G4bool IsApplicable(const G4ParticleDefiniti << 88 G4bool IsApplicable(const G4ParticleDefinition& p);
>> 89
>> 90 // Print out of the class parameters
>> 91 virtual void PrintInfo();
85 92
86 void AddStoppingData(G4int Z, G4int A, const 93 void AddStoppingData(G4int Z, G4int A, const G4String& materialName,
87 G4PhysicsVector* dVector); << 94 G4PhysicsVector& dVector);
88 95
89 void ActivateStoppingData(G4bool); 96 void ActivateStoppingData(G4bool);
90 97
91 // print documentation in html format <<
92 void ProcessDescription(std::ostream&) const <<
93 <<
94 // hide assignment operator <<
95 G4ionIonisation & operator=(const G4ionIonis <<
96 G4ionIonisation(const G4ionIonisation&) = de <<
97 <<
98 protected: 98 protected:
99 99
>> 100 void CorrectionsAlongStep(
>> 101 const G4MaterialCutsCouple*,
>> 102 const G4DynamicParticle*,
>> 103 G4double& eloss,
>> 104 G4double& length);
>> 105
>> 106 virtual std::vector<G4DynamicParticle*>* SecondariesPostStep(
>> 107 G4VEmModel*,
>> 108 const G4MaterialCutsCouple*,
>> 109 const G4DynamicParticle*,
>> 110 G4double&);
>> 111
100 void InitialiseEnergyLossProcess(const G4Par 112 void InitialiseEnergyLossProcess(const G4ParticleDefinition*,
101 const G4ParticleDefinition*) overri << 113 const G4ParticleDefinition*);
102 114
103 G4double MinPrimaryEnergy(const G4ParticleDe << 115 G4double GetMeanFreePath(const G4Track& track,
104 const G4Material*, G4double cut) fin << 116 G4double previousStepSize,
>> 117 G4ForceCondition* condition);
105 118
106 inline G4double BetheBlochEnergyThreshold(); << 119 virtual G4double MinPrimaryEnergy(const G4ParticleDefinition* p,
>> 120 const G4Material*, G4double cut);
107 121
108 private: 122 private:
109 123
>> 124 void DefineMassCharge(const G4ParticleDefinition* pd,
>> 125 const G4Material* mat,
>> 126 G4double mass,
>> 127 G4double kinEnergy);
>> 128
>> 129 // hide assignment operator
>> 130 G4ionIonisation & operator=(const G4ionIonisation &right);
>> 131 G4ionIonisation(const G4ionIonisation&);
110 132
111 const G4ParticleDefinition* theParticle = nu << 133 G4ionEffectiveCharge* effCharge;
112 G4double eth; << 134 G4VEmFluctuationModel* flucModel;
>> 135 G4EmCorrections* corr;
>> 136
>> 137 // cash
>> 138 const G4Material* curMaterial;
>> 139 const G4ParticleDefinition* curParticle;
>> 140 const G4ParticleDefinition* theParticle;
>> 141 const G4ParticleDefinition* theBaseParticle;
>> 142
>> 143 G4double preKinEnergy;
>> 144
>> 145 G4double eth;
>> 146 G4double baseMass;
>> 147 G4double massRatio;
>> 148 G4double massFactor;
>> 149 G4double charge2;
113 150
114 G4bool isInitialised = false; << 151 G4bool isInitialised;
>> 152 G4bool stopDataActive;
115 }; 153 };
116 154
117 //....oooOO0OOooo........oooOO0OOooo........oo 155 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
>> 156 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
>> 157
>> 158 inline G4bool G4ionIonisation::IsApplicable(const G4ParticleDefinition& p)
>> 159 {
>> 160 return (p.GetPDGCharge() != 0.0 && !p.IsShortLived() &&
>> 161 p.GetParticleType() == "nucleus");
>> 162 }
>> 163
>> 164 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
>> 165
>> 166 inline G4double G4ionIonisation::MinPrimaryEnergy(
>> 167 const G4ParticleDefinition*, const G4Material*, G4double cut)
>> 168 {
>> 169 G4double x = 0.5*cut/electron_mass_c2;
>> 170 G4double g = std::sqrt(1. + x);
>> 171 return proton_mass_c2*(g - 1.0);
>> 172 }
>> 173
>> 174 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
>> 175
>> 176 inline void G4ionIonisation::DefineMassCharge(const G4ParticleDefinition* pd,
>> 177 const G4Material* mat,
>> 178 G4double mass,
>> 179 G4double kinEnergy)
>> 180 {
>> 181 preKinEnergy = kinEnergy;
>> 182 massRatio = baseMass/mass;
>> 183 charge2 = effCharge->EffectiveChargeSquareRatio(pd,mat,kinEnergy);
>> 184 SetDynamicMassCharge(massRatio, charge2);
>> 185 }
>> 186
>> 187 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
>> 188
>> 189 inline void G4ionIonisation::CorrectionsAlongStep(
>> 190 const G4MaterialCutsCouple* couple,
>> 191 const G4DynamicParticle* dp,
>> 192 G4double& eloss,
>> 193 G4double& s)
>> 194 {
>> 195 if(eloss < preKinEnergy) {
>> 196 const G4ParticleDefinition* part = dp->GetDefinition();
>> 197 const G4Material* mat = couple->GetMaterial();
>> 198 if(preKinEnergy*massRatio > eth)
>> 199 eloss += s*corr->HighOrderCorrections(part,mat,preKinEnergy);
>> 200 else {
>> 201 if(stopDataActive)
>> 202 eloss *= corr->EffectiveChargeCorrection(part,mat,preKinEnergy);
>> 203 eloss += s*corr->NuclearDEDX(part,mat,preKinEnergy - eloss*0.5);
>> 204 }
>> 205 fParticleChange.SetProposedCharge(effCharge->EffectiveCharge(part,
>> 206 mat,preKinEnergy-eloss));
>> 207 }
>> 208 }
>> 209
>> 210 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
>> 211
>> 212 inline std::vector<G4DynamicParticle*>* G4ionIonisation::SecondariesPostStep(
>> 213 G4VEmModel* model,
>> 214 const G4MaterialCutsCouple* couple,
>> 215 const G4DynamicParticle* dp,
>> 216 G4double& tcut)
>> 217 {
>> 218 return model->SampleSecondaries(couple, dp, tcut);
>> 219 }
>> 220
>> 221 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
118 222
119 inline G4double G4ionIonisation::BetheBlochEne << 223 inline void G4ionIonisation::ActivateStoppingData(G4bool val)
120 { 224 {
121 return eth; << 225 stopDataActive = val;
122 } 226 }
123 227
124 //....oooOO0OOooo........oooOO0OOooo........oo 228 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
125 229
126 #endif 230 #endif
127 231