| Geant4 Cross Reference |
1 // 1
2 // *******************************************
3 // * License and Disclaimer
4 // *
5 // * The Geant4 software is copyright of th
6 // * the Geant4 Collaboration. It is provided
7 // * conditions of the Geant4 Software License
8 // * LICENSE and available at http://cern.ch/
9 // * include a list of copyright holders.
10 // *
11 // * Neither the authors of this software syst
12 // * institutes,nor the agencies providing fin
13 // * work make any representation or warran
14 // * regarding this software system or assum
15 // * use. Please see the license in the file
16 // * for the full disclaimer and the limitatio
17 // *
18 // * This code implementation is the result
19 // * technical work of the GEANT4 collaboratio
20 // * By using, copying, modifying or distri
21 // * any work based on the software) you ag
22 // * use in resulting scientific publicati
23 // * acceptance of all terms of the Geant4 Sof
24 // *******************************************
25 //
26 //
27 //
28 //
29 // -------------------------------------------
30 // GEANT 4 include file implementation
31 // -------------------------------------------
32 //
33 // Class description:
34 //
35 // G4Transportation is a process responsible f
36 // a particle, i.e. the geometrical propagatio
37 // geometrical sub-volumes of the detectors.
38 // It is also tasked with part of updating the
39
40 // ===========================================
41 // Created: 19 March 1997, J. Apostolakis
42 // ===========================================
43 #ifndef G4Transportation_hh
44 #define G4Transportation_hh 1
45
46 #include "G4VProcess.hh"
47
48 #include "G4Track.hh"
49 #include "G4Step.hh"
50 #include "G4ParticleChangeForTransport.hh"
51
52 class G4Navigator;
53 class G4PropagatorInField;
54 class G4SafetyHelper;
55 class G4TransportationLogger;
56
57 class G4Transportation : public G4VProcess
58 {
59 // Concrete class that does the geometrical
60
61 public: // with description
62
63 G4Transportation( G4int verbosityLevel= 1
64 ~G4Transportation();
65
66 G4double AlongStepGetPhysicalInterac
67 const G4Track& tr
68 G4double p
69 G4double c
70 G4double& c
71 G4GPILSelec
72 ); // override;
73
74 G4VParticleChange* AlongStepDoIt(
75 const G4Track& tr
76 const G4Step& ste
77 ); // override;
78
79 G4VParticleChange* PostStepDoIt(
80 const G4Track& tr
81 const G4Step& st
82 ); // override;
83 // Responsible for the relocation
84
85 G4double PostStepGetPhysicalInteractionLe
86 const G4Track& ,
87 G4double previo
88 G4ForceCondition*
89 ); // override;
90 // Forces the PostStepDoIt action to be
91 // but does not limit the step
92
93 inline G4bool FieldExertedForce() { retur
94
95 G4PropagatorInField* GetPropagatorInField
96 void SetPropagatorInField( G4PropagatorIn
97 // Access/set the assistant class that
98
99 inline G4double GetThresholdWarningEnergy
100 inline G4double GetThresholdImportantEner
101 inline G4int GetThresholdTrials() const;
102
103 inline void SetThresholdWarningEnergy( G4
104 inline void SetThresholdImportantEnergy(
105 inline void SetThresholdTrials(G4int newM
106 // Get/Set parameters for killing loopers
107 // Above 'important' energy a 'looping'
108 // *NOT* be abandoned, except after fTh
109 // Below Warning energy, no verbosity for
110
111 void SetHighLooperThresholds(); // Shortc
112 void SetLowLooperThresholds(); // Set low
113 void PushThresholdsToLogger(); // Inform
114 void ReportLooperThresholds(); // Print v
115
116 inline G4double GetMaxEnergyKilled() cons
117 inline G4double GetSumEnergyKilled() cons
118 inline void ResetKilledStatistics( G4int
119 // Statistics for tracks killed (currentl
120
121 inline void EnableShortStepOptimisation(G
122 // Whether short steps < safety will avoi
123
124 static G4bool EnableMagneticMoment(G4bool
125 // Whether to enable particles to be defl
126
127 static G4bool EnableGravity(G4bool useGra
128 // Whether to enable particles to be defl
129
130 static void SetSilenceLooperWarnings( G
131 // Do not warn (or throw exception) about
132 static G4bool GetSilenceLooperWarnings();
133
134 public: // without description
135 static G4bool EnableUseMagneticMoment(G4b
136 { return EnableMagneticMoment(useMoment);
137
138 public: // without description
139
140 G4double AtRestGetPhysicalInteractionLeng
141
142 { return -1.0; } // No operation in At
143
144 G4VParticleChange* AtRestDoIt( const G4Tr
145 { return 0; } // No operation in At
146
147 void StartTracking(G4Track* aTrack);
148 // Reset state for new (potentially res
149
150 virtual void ProcessDescription(std::ostr
151 void PrintStatistics( std::ostream& outSt
152
153 protected:
154
155 void SetTouchableInformation(const G4Touc
156
157 void ReportMissingLogger(const char * met
158
159 protected:
160
161 G4Navigator* fLinearNavigator;
162 // The navigator for the 'mass' geometr
163 // (the real one, that physics occurs i
164 G4PropagatorInField* fFieldPropagator;
165 // The Propagators used to transport th
166
167 G4ThreeVector fTransportEndPosition=
168 G4ThreeVector fTransportEndMomentumDir=
169 G4double fTransportEndKineticEnergy=
170 G4ThreeVector fTransportEndSpin= G4Three
171 G4bool fMomentumChanged= true;
172 G4bool fEndGlobalTimeComputed= fal
173 G4double fCandidateEndGlobalTime= 0.
174 // The particle's state after this Step
175
176 G4bool fAnyFieldExists= false;
177
178 G4bool fParticleIsLooping = false;
179 G4bool fNewTrack= true; // Flag
180 G4bool fFirstStepInVolume= true;
181 G4bool fLastStepInVolume= false; // Last
182 // (temporary
183 G4bool fGeometryLimitedStep= true;
184 // Flag to determine whether a boundary
185
186 G4bool fFieldExertedForce= false; // Duri
187
188 G4TouchableHandle fCurrentTouchableHandle
189
190 G4ThreeVector fPreviousSftOrigin;
191 G4double fPreviousSafety;
192 // Remember last safety origin & value.
193
194 G4ParticleChangeForTransport fParticleCha
195 // New ParticleChange
196
197 G4double fEndPointDistance;
198
199 // Thresholds for looping particles:
200 //
201 G4double fThreshold_Warning_Energy = 1.
202 G4double fThreshold_Important_Energy = 1.
203 G4int fThresholdTrials = 10; //
204 // Above 'important' energy a 'looping'
205 // *NOT* be abandoned, except after fTh
206 G4int fAbandonUnstableTrials = 0; //
207 //
208 // Counter for steps in which particle re
209 // ( Used if it is above 'Important' Ene
210 G4int fNoLooperTrials= 0;
211
212 // Statistics for tracks abandoned due to
213 //
214 G4double fSumEnergyKilled= 0.0;
215 G4double fSumEnerSqKilled= 0.0;
216 G4double fMaxEnergyKilled= -1.0;
217 G4int fMaxEnergyKilledPDG= 0;
218 unsigned long fNumLoopersKilled= 0;
219 G4double fSumEnergyKilled_NonElectron= 0.
220 G4double fSumEnerSqKilled_NonElectron= 0.
221 G4double fMaxEnergyKilled_NonElectron= -1
222 G4int fMaxEnergyKilled_NonElecPDG= 0;
223 unsigned long fNumLoopersKilled_NonElectr
224 G4double fSumEnergySaved= 0.0;
225 G4double fMaxEnergySaved= -1.0;
226 G4double fSumEnergyUnstableSaved = 0.0;
227 // Whether to avoid calling G4Navigator f
228 // If using it, the safety estimate for e
229 //
230 G4bool fShortStepOptimisation;
231
232 G4SafetyHelper* fpSafetyHelper; // To
233 G4TransportationLogger* fpLogger; // Rep
234
235 protected:
236
237 static G4bool fUseMagneticMoment;
238 static G4bool fUseGravity;
239 static G4bool fSilenceLooperWarnings; //
240
241 };
242
243 #include "G4Transportation.icc"
244
245 #endif
246