| Geant4 Cross Reference |
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 //
27 // -------------------------------------------------------------------
28 //
29 // GEANT4 Class file
30 //
31 //
32 // File name: G4ionIonisation
33 //
34 // Author: Vladimir Ivanchenko
35 //
36 // Creation date: 07.05.2002
37 //
38 // Modifications:
39 //
40 // 23-12-02 Change interface in order to move to cut per region (V.Ivanchenko)
41 // 26-12-02 Secondary production moved to derived classes (V.Ivanchenko)
42 // 13-02-03 SubCutoff regime is assigned to a region (V.Ivanchenko)
43 // 18-04-03 Use IonFluctuations (V.Ivanchenko)
44 // 03-08-03 Add effective charge (V.Ivanchenko)
45 // 12-11-03 G4EnergyLossSTD -> G4EnergyLossProcess (V.Ivanchenko)
46 // 27-05-04 Set integral to be a default regime (V.Ivanchenko)
47 // 08-11-04 Migration to new interface of Store/Retrieve tables (V.Ivantchenko)
48 // 08-04-05 Major optimisation of internal interfaces (V.Ivantchenko)
49 // 10-01-06 SetStepLimits -> SetStepFunction (V.Ivantchenko)
50 // 10-05-06 Add a possibility to download user data (V.Ivantchenko)
51 // 13-05-06 Add data for light ion stopping in water (V.Ivantchenko)
52 // 14-01-07 use SetEmModel() and SetFluctModel() from G4VEnergyLossProcess (mma)
53 // 16-05-07 Add data for light ion stopping only for GenericIon (V.Ivantchenko)
54 // 07-11-07 Fill non-ionizing energy loss (V.Ivantchenko)
55 // 12-09-08 Removed InitialiseMassCharge and CorrectionsAlongStep (VI)
56 //
57 //
58 // -------------------------------------------------------------------
59 //
60 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
61 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
62
63 #include "G4ionIonisation.hh"
64 #include "G4PhysicalConstants.hh"
65 #include "G4SystemOfUnits.hh"
66 #include "G4Electron.hh"
67 #include "G4GenericIon.hh"
68 #include "G4BraggModel.hh"
69 #include "G4BraggIonModel.hh"
70 #include "G4BetheBlochModel.hh"
71 #include "G4LossTableManager.hh"
72 #include "G4EmParameters.hh"
73 #include "G4EmStandUtil.hh"
74
75 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
76
77 G4ionIonisation::G4ionIonisation(const G4String& name)
78 : G4VEnergyLossProcess(name)
79 {
80 SetLinearLossLimit(0.02);
81 SetProcessSubType(fIonisation);
82 SetSecondaryParticle(G4Electron::Electron());
83 eth = 2*CLHEP::MeV;
84 }
85
86 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
87
88 G4bool G4ionIonisation::IsApplicable(const G4ParticleDefinition&)
89 {
90 return true;
91 }
92
93 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
94
95 G4double G4ionIonisation::MinPrimaryEnergy(const G4ParticleDefinition* p,
96 const G4Material*,
97 G4double cut)
98 {
99 return p->GetPDGMass()*(std::sqrt(1. + 0.5*cut/CLHEP::electron_mass_c2) - 1.0);
100 }
101
102 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
103
104 void G4ionIonisation::InitialiseEnergyLossProcess(
105 const G4ParticleDefinition* part,
106 const G4ParticleDefinition* bpart)
107 {
108 const G4ParticleDefinition* ion = G4GenericIon::GenericIon();
109
110 if(!isInitialised) {
111 theParticle = part;
112
113 // define base particle
114 const G4ParticleDefinition* theBaseParticle = nullptr;
115 const G4int pdg = part->GetPDGEncoding();
116
117 if(part == bpart) {
118 theBaseParticle = nullptr;
119 } else if(nullptr != bpart) {
120 theBaseParticle = bpart;
121 } else if(part == ion || pdg == 1000020040) {
122 theBaseParticle = nullptr;
123 } else {
124 theBaseParticle = ion;
125 }
126 SetBaseParticle(theBaseParticle);
127
128 // model limit defined for protons
129 eth = 2*CLHEP::MeV*part->GetPDGMass()/CLHEP::proton_mass_c2;
130
131 G4EmParameters* param = G4EmParameters::Instance();
132 G4double emin = param->MinKinEnergy();
133 G4double emax = param->MaxKinEnergy();
134
135 // define model of energy loss fluctuations
136 if (nullptr == FluctModel()) {
137 SetFluctModel(G4EmStandUtil::ModelOfFluctuations(true));
138 }
139
140 if (nullptr == EmModel(0)) {
141 if (pdg == 1000020040) {
142 SetEmModel(new G4BraggIonModel());
143 } else {
144 SetEmModel(new G4BraggModel());
145 }
146 }
147 // to compute ranges correctly we have to use low-energy
148 // model even if activation limit is high
149 EmModel(0)->SetLowEnergyLimit(emin);
150
151 // high energy limit may be eth or DBL_MAX
152 G4double emax1 = (EmModel(0)->HighEnergyLimit() < emax) ? eth : emax;
153 EmModel(0)->SetHighEnergyLimit(emax1);
154 AddEmModel(1, EmModel(0), FluctModel());
155
156 // second model is used if the first does not cover energy range
157 if(emax1 < emax) {
158 if (nullptr == EmModel(1)) { SetEmModel(new G4BetheBlochModel()); }
159 EmModel(1)->SetLowEnergyLimit(emax1);
160
161 // for extremely heavy particles upper limit of the model
162 // should be increased
163 emax = std::max(emax, eth*10);
164 EmModel(1)->SetHighEnergyLimit(emax);
165 AddEmModel(2, EmModel(1), FluctModel());
166 }
167 isInitialised = true;
168 }
169 }
170
171 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
172
173 void G4ionIonisation::ProcessDescription(std::ostream& out) const
174 {
175 out << " Ion ionisation";
176 G4VEnergyLossProcess::ProcessDescription(out);
177 }
178
179 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
180