| 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 // class G4SafetyHelper Implementation
27 //
28 // Original author: John Apostolakis, 2006
29 // --------------------------------------------------------------------
30
31 #include "G4SafetyHelper.hh"
32 #include "G4PathFinder.hh"
33 #include "G4TransportationManager.hh"
34 #include "G4Navigator.hh"
35
36 #include "globals.hh"
37
38 // --------------------------------------------------------------------
39 G4SafetyHelper::G4SafetyHelper()
40 : fLastSafetyPosition(0.0,0.0,0.0)
41 {
42 }
43
44 // --------------------------------------------------------------------
45 void G4SafetyHelper::InitialiseNavigator()
46 {
47 fpPathFinder = G4PathFinder::GetInstance();
48
49 G4TransportationManager* pTransportMgr=
50 G4TransportationManager::GetTransportationManager();
51
52 fpMassNavigator = pTransportMgr->GetNavigatorForTracking();
53
54 // Check
55 //
56 G4VPhysicalVolume* worldPV = fpMassNavigator->GetWorldVolume();
57 if( worldPV == nullptr )
58 {
59 G4Exception("G4SafetyHelper::InitialiseNavigator",
60 "GeomNav0003", FatalException,
61 "Found that existing tracking Navigator has NULL world");
62 }
63 }
64
65 // --------------------------------------------------------------------
66 void G4SafetyHelper::InitialiseHelper()
67 {
68 fLastSafetyPosition = G4ThreeVector(0.0,0.0,0.0);
69 fLastSafety = 0.0;
70 if (fFirstCall) { InitialiseNavigator(); }
71 fFirstCall = false;
72 }
73
74 G4SafetyHelper::~G4SafetyHelper() = default;
75
76 G4double
77 G4SafetyHelper::CheckNextStep(const G4ThreeVector& position,
78 const G4ThreeVector& direction,
79 const G4double currentMaxStep,
80 G4double& newSafety )
81 {
82 // Distance in the Mass geometry
83 //
84 G4double linstep = fpMassNavigator->CheckNextStep( position,
85 direction,
86 currentMaxStep,
87 newSafety);
88 fLastSafetyPosition = position;
89 fLastSafety = newSafety;
90
91 // TO-DO: Can replace this with a call to PathFinder
92 // giving id of Mass Geometry --> this avoid doing the work twice
93
94 return linstep;
95 }
96
97 // --------------------------------------------------------------------
98 G4double G4SafetyHelper::ComputeSafety( const G4ThreeVector& position,
99 G4double maxLength )
100 {
101 G4double newSafety;
102
103 // Only recompute (calling Navigator/PathFinder) if 'position'
104 // is *not* the safety location and has moved 'significantly'
105 //
106 G4double moveLengthSq = (position-fLastSafetyPosition).mag2();
107 if( (moveLengthSq > 0.0 ) )
108 {
109 if( !fUseParallelGeometries )
110 {
111 // Safety for mass geometry
112 newSafety = fpMassNavigator->ComputeSafety(position, maxLength, true);
113
114 // Only store a 'true' safety - one that was not restricted by maxLength
115 if( newSafety < maxLength )
116 {
117 fLastSafety= newSafety;
118 fLastSafetyPosition = position;
119 }
120 }
121 else
122 {
123 // Safety for all geometries
124 newSafety = fpPathFinder->ComputeSafety(position);
125
126 fLastSafety= newSafety;
127 fLastSafetyPosition = position;
128 }
129
130 }
131 else
132 {
133 // return last value if position is not (significantly) changed
134 //
135 // G4double moveLength = 0;
136 // if( moveLengthSq > 0.0 ) { moveLength= std::sqrt(moveLengthSq); }
137 newSafety = fLastSafety; // -moveLength;
138 }
139
140 return newSafety;
141 }
142
143 // --------------------------------------------------------------------
144 void G4SafetyHelper::ReLocateWithinVolume( const G4ThreeVector& newPosition )
145 {
146 #ifdef G4VERBOSE
147 if( fVerbose > 0 )
148 {
149 // There is an opportunity - and need - to check whether
150 // the proposed move is safe
151 G4ThreeVector moveVec = newPosition - fLastSafetyPosition;
152 if( moveVec.mag2() > sqr(fLastSafety) )
153 {
154 // A problem exists - we are proposing to move outside 'Safety Sphere'
155 G4ExceptionDescription ed;
156 ed << "Unsafe Move> Asked to relocate beyond 'Safety sphere'. Details: "
157 << G4endl;
158 ed << " Safety Sphere: Radius = " << fLastSafety;
159 ed << " Center = " << fLastSafetyPosition << G4endl;
160 ed << " New Location : Move = " << moveVec.mag();
161 ed << " Position = " << newPosition << G4endl;
162 G4Exception("G4SafetyHelper::ReLocateWithinVolume",
163 "GeomNav1001", JustWarning, ed);
164 }
165 }
166 #endif
167
168 if( !fUseParallelGeometries )
169 {
170 fpMassNavigator->LocateGlobalPointWithinVolume( newPosition );
171 }
172 else
173 {
174 fpPathFinder->ReLocate( newPosition );
175 }
176 }
177
178 // --------------------------------------------------------------------
179 void G4SafetyHelper::Locate( const G4ThreeVector& newPosition,
180 const G4ThreeVector& newDirection)
181 {
182 if( !fUseParallelGeometries )
183 {
184 fpMassNavigator->LocateGlobalPointAndSetup(newPosition, &newDirection,
185 true, false);
186 }
187 else
188 {
189 fpPathFinder->Locate( newPosition, newDirection );
190 }
191 }
192