Geant4  10.03.p03
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
G4ionIonisation.cc
Go to the documentation of this file.
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.cc 96934 2016-05-18 09:10:41Z gcosmo $
27 //
28 // -------------------------------------------------------------------
29 //
30 // GEANT4 Class file
31 //
32 //
33 // File name: G4ionIonisation
34 //
35 // Author: Vladimir Ivanchenko
36 //
37 // Creation date: 07.05.2002
38 //
39 // Modifications:
40 //
41 // 23-12-02 Change interface in order to move to cut per region (V.Ivanchenko)
42 // 26-12-02 Secondary production moved to derived classes (V.Ivanchenko)
43 // 13-02-03 SubCutoff regime is assigned to a region (V.Ivanchenko)
44 // 18-04-03 Use IonFluctuations (V.Ivanchenko)
45 // 03-08-03 Add effective charge (V.Ivanchenko)
46 // 12-11-03 G4EnergyLossSTD -> G4EnergyLossProcess (V.Ivanchenko)
47 // 27-05-04 Set integral to be a default regime (V.Ivanchenko)
48 // 08-11-04 Migration to new interface of Store/Retrieve tables (V.Ivantchenko)
49 // 08-04-05 Major optimisation of internal interfaces (V.Ivantchenko)
50 // 10-01-06 SetStepLimits -> SetStepFunction (V.Ivantchenko)
51 // 10-05-06 Add a possibility to download user data (V.Ivantchenko)
52 // 13-05-06 Add data for light ion stopping in water (V.Ivantchenko)
53 // 14-01-07 use SetEmModel() and SetFluctModel() from G4VEnergyLossProcess (mma)
54 // 16-05-07 Add data for light ion stopping only for GenericIon (V.Ivantchenko)
55 // 07-11-07 Fill non-ionizing energy loss (V.Ivantchenko)
56 // 12-09-08 Removed InitialiseMassCharge and CorrectionsAlongStep (VI)
57 //
58 //
59 // -------------------------------------------------------------------
60 //
61 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
62 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
63 
64 #include "G4ionIonisation.hh"
65 #include "G4PhysicalConstants.hh"
66 #include "G4SystemOfUnits.hh"
67 #include "G4Electron.hh"
68 #include "G4Proton.hh"
69 #include "G4GenericIon.hh"
70 #include "G4BraggModel.hh"
71 #include "G4BraggIonModel.hh"
72 #include "G4BetheBlochModel.hh"
73 #include "G4UnitsTable.hh"
74 #include "G4LossTableManager.hh"
75 #include "G4WaterStopping.hh"
76 #include "G4EmCorrections.hh"
77 #include "G4IonFluctuations.hh"
78 #include "G4EmParameters.hh"
79 
80 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
81 
82 using namespace std;
83 
85  : G4VEnergyLossProcess(name),
86  theParticle(nullptr),
87  isInitialised(false),
88  stopDataActive(false)
89 {
90  SetLinearLossLimit(0.02);
94  eth = 2*MeV;
95 }
96 
97 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
98 
100 {}
101 
102 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
103 
105 {
106  return (p.GetPDGCharge() != 0.0 && !p.IsShortLived() &&
107  p.GetParticleType() == "nucleus");
108 }
109 
110 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
111 
113  const G4Material*,
114  G4double cut)
115 {
116  return
117  p->GetPDGMass()*(std::sqrt(1. + 0.5*cut/CLHEP::electron_mass_c2) - 1.0);
118 }
119 
120 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
121 
123  const G4ParticleDefinition* part,
124  const G4ParticleDefinition* bpart)
125 {
127 
128  if(!isInitialised) {
129 
130  theParticle = part;
131 
132  // define base particle
133  const G4ParticleDefinition* theBaseParticle = nullptr;
134 
135  if(part == ion) { theBaseParticle = nullptr; }
136  else if(bpart == nullptr) { theBaseParticle = ion; }
137  else { theBaseParticle = bpart; }
138 
139  SetBaseParticle(theBaseParticle);
140 
141  if (!EmModel(1)) { SetEmModel(new G4BraggIonModel(), 1); }
142 
144  EmModel(1)->SetLowEnergyLimit(param->MinKinEnergy());
145 
146  // model limit defined for protons
147  eth = (EmModel(1)->HighEnergyLimit())*part->GetPDGMass()/proton_mass_c2;
148  EmModel(1)->SetHighEnergyLimit(eth);
149 
150  if (!FluctModel()) { SetFluctModel(new G4IonFluctuations()); }
151  AddEmModel(1, EmModel(1), FluctModel());
152 
153  G4double emax = param->MaxKinEnergy();
154  if(eth < emax) {
155  if (!EmModel(2)) { SetEmModel(new G4BetheBlochModel(),2); }
156  EmModel(2)->SetLowEnergyLimit(eth);
157  EmModel(2)->SetHighEnergyLimit(emax);
158  AddEmModel(2, EmModel(2), FluctModel());
159 
160  // Add ion stoping tables for Generic Ion if the default
161  // model is used (with eth ~= 2 MeV)
162  if(part == ion) {
163  stopDataActive = true;
164  G4WaterStopping ws(corr);
165  corr->SetIonisationModels(EmModel(1),EmModel(2));
166  }
167  }
168  isInitialised = true;
169  }
170  // reinitialisation of corrections for the new run
171  if(part == ion) { corr->InitialiseForNewRun(); }
172 }
173 
174 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
175 
177 {
178  if (stopDataActive && G4GenericIon::GenericIon() == theParticle) {
179  G4cout << " Stopping Power data for "
180  << corr->GetNumberOfStoppingVectors()
181  << " ion/material pairs "
182  << G4endl;
183  }
184 }
185 
186 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
187 
189  const G4String& mname,
190  G4PhysicsVector* dVector)
191 {
192  corr->AddStoppingData(Z, A, mname, dVector);
193 }
194 
195 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo....
const XML_Char * name
Definition: expat.h:151
G4double MaxKinEnergy() const
static G4LossTableManager * Instance()
G4double HighEnergyLimit() const
Definition: G4VEmModel.hh:636
G4int GetNumberOfStoppingVectors() const
const char * p
Definition: xmltok.h:285
void SetLinearLossLimit(G4double val)
void SetFluctModel(G4VEmFluctuationModel *)
int G4int
Definition: G4Types.hh:78
void SetIonisationModels(G4VEmModel *m1=nullptr, G4VEmModel *m2=nullptr)
void AddStoppingData(G4int Z, G4int A, const G4String &materialName, G4PhysicsVector *dVector)
static constexpr double electron_mass_c2
void SetHighEnergyLimit(G4double)
Definition: G4VEmModel.hh:732
void AddEmModel(G4int, G4VEmModel *, G4VEmFluctuationModel *fluc=0, const G4Region *region=nullptr)
G4VEmFluctuationModel * FluctModel()
G4GLOB_DLL std::ostream G4cout
double A(double temperature)
virtual void PrintInfo() override
bool G4bool
Definition: G4Types.hh:79
G4EmCorrections * EmCorrections()
void AddStoppingData(G4int Z, G4int A, const G4String &materialName, G4PhysicsVector *dVector)
virtual void InitialiseEnergyLossProcess(const G4ParticleDefinition *, const G4ParticleDefinition *) override
void SetProcessSubType(G4int)
Definition: G4VProcess.hh:432
float proton_mass_c2
Definition: hepunit.py:275
const G4String & GetParticleType() const
G4double MinKinEnergy() const
void SetSecondaryParticle(const G4ParticleDefinition *p)
static const G4double emax
static G4GenericIon * GenericIon()
Definition: G4GenericIon.cc:93
G4double GetPDGMass() const
virtual ~G4ionIonisation()
static G4EmParameters * Instance()
void SetEmModel(G4VEmModel *, G4int index=1)
virtual G4bool IsApplicable(const G4ParticleDefinition &p) final
static G4Electron * Electron()
Definition: G4Electron.cc:94
#define G4endl
Definition: G4ios.hh:61
static constexpr double MeV
Definition: G4SIunits.hh:214
double G4double
Definition: G4Types.hh:76
void SetLowEnergyLimit(G4double)
Definition: G4VEmModel.hh:739
virtual G4double MinPrimaryEnergy(const G4ParticleDefinition *p, const G4Material *, G4double cut) final
G4double GetPDGCharge() const
G4ionIonisation(const G4String &name="ionIoni")
void SetBaseParticle(const G4ParticleDefinition *p)
G4VEmModel * EmModel(G4int index=1) const