Geant4  9.6.p02
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
G4EnergyLossTables.hh
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 //
27 // $Id$
28 //
29 // $Id:
30 //
31 // -----------------------------------------------------------------------------
32 
33 #ifndef included_G4EnergyLossTables
34 #define included_G4EnergyLossTables
35 
36 #include <map>
37 #include "globals.hh"
38 
39 #include "G4PhysicsTable.hh"
40 #include "G4ParticleDefinition.hh"
41 #include "G4Material.hh"
42 #include "G4ios.hh"
43 
44 //------------------------------------------------------------------------------
45 // A utility class, containing the energy loss tables
46 // for each particle
47 //
48 // Energy loss processes have to register their tables with this
49 // class. The responsibility of creating and deleting the tables
50 // remains with the energy loss classes.
51 // -----------------------------------------------------------------------------
52 //
53 // P. Urban, 06/04/1998
54 // L. Urban, 27/05/1988 , modifications + new functions added
55 // L.Urban , 13/10/98 , revision
56 // L.Urban, 26/10/98 , revision, Interpolate removed
57 // L.Urban , 08/02/99, cache mechanism
58 // L.Urban , 12/04/99 , bug fixed
59 // don't use the helper class.
60 // It can't be hidden for Rogue Wave uses it.
61 // 10.11.99: moved from RWT hash dictionary to STL map, G.Barrand, M.Maire
62 // 26.10.01: all static functions movev from .icc to .cc file (mma)
63 // 15.01.03 Add interfaces required for "cut per region" (V.Ivanchenko)
64 // 12.03.03 Add warnings to obsolete interfaces (V.Ivanchenko)
65 // 12.04.03 move exception to new method (V.Ivanchenko)
66 //
67 // -----------------------------------------------------------------------------
68 
69 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo......
70 
71 class G4EnergyLossTablesHelper {
72 
73 friend class G4EnergyLossTables;
74  // the only instances are within the class G4EnergyLossTables
75 
76 public:
77  G4EnergyLossTablesHelper();
78 
79 private:
80  G4EnergyLossTablesHelper(const G4PhysicsTable* aDEDXTable,
81  const G4PhysicsTable* aRangeTable,
82  const G4PhysicsTable* anInverseRangeTable,
83  const G4PhysicsTable* aLabTimeTable,
84  const G4PhysicsTable* aProperTimeTable,
85  G4double aLowestKineticEnergy,
86  G4double aHighestKineticEnergy,
87  G4double aMassRatio,
88  G4int aNumberOfBins);
89  // data to be stored in the dictionary
90  const G4PhysicsTable* theDEDXTable;
91  const G4PhysicsTable* theRangeTable;
92  const G4PhysicsTable* theInverseRangeTable;
93  const G4PhysicsTable* theLabTimeTable;
94  const G4PhysicsTable* theProperTimeTable;
95  G4double theLowestKineticEnergy;
96  G4double theHighestKineticEnergy;
97  G4double theMassRatio;
98  G4int theNumberOfBins;
99 };
100 
101 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo......
102 
103 class G4MaterialCutsCouple;
104 
105 class G4EnergyLossTables {
106 
107 public:
108 
109  // get the table for a given particle
110  // (0 if the table was not found)
111  static const G4PhysicsTable* GetDEDXTable(
112  const G4ParticleDefinition* p);
113  static const G4PhysicsTable* GetRangeTable(
114  const G4ParticleDefinition* p);
115  static const G4PhysicsTable* GetInverseRangeTable(
116  const G4ParticleDefinition* p);
117  static const G4PhysicsTable* GetLabTimeTable(
118  const G4ParticleDefinition* p);
119  static const G4PhysicsTable* GetProperTimeTable(
120  const G4ParticleDefinition* p);
121 
122  // get the DEDX or the range for a given particle/energy/material
123  static G4double GetDEDX(
124  const G4ParticleDefinition *aParticle,
125  G4double KineticEnergy,
126  const G4Material *aMaterial);
127  static G4double GetRange(
128  const G4ParticleDefinition *aParticle,
129  G4double KineticEnergy,
130  const G4Material *aMaterial);
131  static G4double GetLabTime(
132  const G4ParticleDefinition *aParticle,
133  G4double KineticEnergy,
134  const G4Material *aMaterial);
135  static G4double GetDeltaLabTime(
136  const G4ParticleDefinition *aParticle,
137  G4double KineticEnergyStart,
138  G4double KineticEnergyEnd,
139  const G4Material *aMaterial);
140  static G4double GetProperTime(
141  const G4ParticleDefinition *aParticle,
142  G4double KineticEnergy,
143  const G4Material *aMaterial);
144  static G4double GetDeltaProperTime(
145  const G4ParticleDefinition *aParticle,
146  G4double KineticEnergyStart,
147  G4double KineticEnergyEnd,
148  const G4Material *aMaterial);
149 
150  static G4double GetPreciseDEDX(
151  const G4ParticleDefinition *aParticle,
152  G4double KineticEnergy,
153  const G4Material *aMaterial);
154  static G4double GetPreciseRangeFromEnergy(
155  const G4ParticleDefinition *aParticle,
156  G4double KineticEnergy,
157  const G4Material *aMaterial);
158  static G4double GetPreciseEnergyFromRange(
159  const G4ParticleDefinition *aParticle,
160  G4double range,
161  const G4Material *aMaterial);
162 
163  // get the DEDX or the range for a given particle/energy/materialCutsCouple
164  static G4double GetDEDX(
165  const G4ParticleDefinition *aParticle,
166  G4double KineticEnergy,
167  const G4MaterialCutsCouple *couple,
168  G4bool check = true);
169  static G4double GetRange(
170  const G4ParticleDefinition *aParticle,
171  G4double KineticEnergy,
172  const G4MaterialCutsCouple *couple,
173  G4bool check = true);
174 
175  static G4double GetPreciseDEDX(
176  const G4ParticleDefinition *aParticle,
177  G4double KineticEnergy,
178  const G4MaterialCutsCouple *couple);
179  static G4double GetPreciseRangeFromEnergy(
180  const G4ParticleDefinition *aParticle,
181  G4double KineticEnergy,
182  const G4MaterialCutsCouple *couple);
183  static G4double GetPreciseEnergyFromRange(
184  const G4ParticleDefinition *aParticle,
185  G4double range,
186  const G4MaterialCutsCouple *couple,
187  G4bool check = true);
188 
189  // to be called only by energy loss processes
190  static void Register(
191  const G4ParticleDefinition* p,
192  const G4PhysicsTable* tDEDX,
193  const G4PhysicsTable* tRange,
194  const G4PhysicsTable* tInverseRange,
195  const G4PhysicsTable* tLabTime,
196  const G4PhysicsTable* tProperTime,
197  G4double lowestKineticEnergy,
198  G4double highestKineticEnergy,
199  G4double massRatio,
200  G4int NumberOfBins);
201 
202 public:
203  typedef const G4ParticleDefinition* K;
204 
205 private:
206 
207  static void CPRWarning();
208  static void ParticleHaveNoLoss(const G4ParticleDefinition* aParticle, const G4String&);
209 
210  typedef std::map<K,G4EnergyLossTablesHelper,std::less<K> > helper_map;
211  static helper_map dict;
212 
213  static G4EnergyLossTablesHelper GetTables(const G4ParticleDefinition* p);
214 
215  static G4EnergyLossTablesHelper t ;
216  static G4EnergyLossTablesHelper null_loss ;
217  static const G4ParticleDefinition* lastParticle ;
218  static G4double QQPositron ;
219  static G4double Chargesquare ;
220  static G4int oldIndex ;
221  static G4double rmin,rmax,Thigh ;
222  static G4int let_counter;
223  static G4int let_max_num_warnings;
224  static G4bool first_loss;
225 
226 };
227 
228 //....oooOO0OOooo........oooOO0OOooo........oooOO0OOooo........oooOO0OOooo......
229 
230 #endif
Generated on Sat May 25 2013 14:33:38 for Geant4 by   doxygen 1.8.4