Geant4 Cross Reference

Cross-Referencing   Geant4
Geant4/geometry/management/include/G4LogicalVolume.hh

Version: [ ReleaseNotes ] [ 1.0 ] [ 1.1 ] [ 2.0 ] [ 3.0 ] [ 3.1 ] [ 3.2 ] [ 4.0 ] [ 4.0.p1 ] [ 4.0.p2 ] [ 4.1 ] [ 4.1.p1 ] [ 5.0 ] [ 5.0.p1 ] [ 5.1 ] [ 5.1.p1 ] [ 5.2 ] [ 5.2.p1 ] [ 5.2.p2 ] [ 6.0 ] [ 6.0.p1 ] [ 6.1 ] [ 6.2 ] [ 6.2.p1 ] [ 6.2.p2 ] [ 7.0 ] [ 7.0.p1 ] [ 7.1 ] [ 7.1.p1 ] [ 8.0 ] [ 8.0.p1 ] [ 8.1 ] [ 8.1.p1 ] [ 8.1.p2 ] [ 8.2 ] [ 8.2.p1 ] [ 8.3 ] [ 8.3.p1 ] [ 8.3.p2 ] [ 9.0 ] [ 9.0.p1 ] [ 9.0.p2 ] [ 9.1 ] [ 9.1.p1 ] [ 9.1.p2 ] [ 9.1.p3 ] [ 9.2 ] [ 9.2.p1 ] [ 9.2.p2 ] [ 9.2.p3 ] [ 9.2.p4 ] [ 9.3 ] [ 9.3.p1 ] [ 9.3.p2 ] [ 9.4 ] [ 9.4.p1 ] [ 9.4.p2 ] [ 9.4.p3 ] [ 9.4.p4 ] [ 9.5 ] [ 9.5.p1 ] [ 9.5.p2 ] [ 9.6 ] [ 9.6.p1 ] [ 9.6.p2 ] [ 9.6.p3 ] [ 9.6.p4 ] [ 10.0 ] [ 10.0.p1 ] [ 10.0.p2 ] [ 10.0.p3 ] [ 10.0.p4 ] [ 10.1 ] [ 10.1.p1 ] [ 10.1.p2 ] [ 10.1.p3 ] [ 10.2 ] [ 10.2.p1 ] [ 10.2.p2 ] [ 10.2.p3 ] [ 10.3 ] [ 10.3.p1 ] [ 10.3.p2 ] [ 10.3.p3 ] [ 10.4 ] [ 10.4.p1 ] [ 10.4.p2 ] [ 10.4.p3 ] [ 10.5 ] [ 10.5.p1 ] [ 10.6 ] [ 10.6.p1 ] [ 10.6.p2 ] [ 10.6.p3 ] [ 10.7 ] [ 10.7.p1 ] [ 10.7.p2 ] [ 10.7.p3 ] [ 10.7.p4 ] [ 11.0 ] [ 11.0.p1 ] [ 11.0.p2 ] [ 11.0.p3, ] [ 11.0.p4 ] [ 11.1 ] [ 11.1.1 ] [ 11.1.2 ] [ 11.1.3 ] [ 11.2 ] [ 11.2.1 ] [ 11.2.2 ] [ 11.3.0 ]

Diff markup

Differences between /geometry/management/include/G4LogicalVolume.hh (Version 11.3.0) and /geometry/management/include/G4LogicalVolume.hh (Version 9.2.p1)


  1 //                                                  1 //
  2 // *******************************************      2 // ********************************************************************
  3 // * License and Disclaimer                         3 // * License and Disclaimer                                           *
  4 // *                                                4 // *                                                                  *
  5 // * The  Geant4 software  is  copyright of th      5 // * The  Geant4 software  is  copyright of the Copyright Holders  of *
  6 // * the Geant4 Collaboration.  It is provided      6 // * the Geant4 Collaboration.  It is provided  under  the terms  and *
  7 // * conditions of the Geant4 Software License      7 // * conditions of the Geant4 Software License,  included in the file *
  8 // * LICENSE and available at  http://cern.ch/      8 // * LICENSE and available at  http://cern.ch/geant4/license .  These *
  9 // * include a list of copyright holders.           9 // * include a list of copyright holders.                             *
 10 // *                                               10 // *                                                                  *
 11 // * Neither the authors of this software syst     11 // * Neither the authors of this software system, nor their employing *
 12 // * institutes,nor the agencies providing fin     12 // * institutes,nor the agencies providing financial support for this *
 13 // * work  make  any representation or  warran     13 // * work  make  any representation or  warranty, express or implied, *
 14 // * regarding  this  software system or assum     14 // * regarding  this  software system or assume any liability for its *
 15 // * use.  Please see the license in the file      15 // * use.  Please see the license in the file  LICENSE  and URL above *
 16 // * for the full disclaimer and the limitatio     16 // * for the full disclaimer and the limitation of liability.         *
 17 // *                                               17 // *                                                                  *
 18 // * This  code  implementation is the result      18 // * This  code  implementation is the result of  the  scientific and *
 19 // * technical work of the GEANT4 collaboratio     19 // * technical work of the GEANT4 collaboration.                      *
 20 // * By using,  copying,  modifying or  distri     20 // * By using,  copying,  modifying or  distributing the software (or *
 21 // * any work based  on the software)  you  ag     21 // * any work based  on the software)  you  agree  to acknowledge its *
 22 // * use  in  resulting  scientific  publicati     22 // * use  in  resulting  scientific  publications,  and indicate your *
 23 // * acceptance of all terms of the Geant4 Sof     23 // * acceptance of all terms of the Geant4 Software license.          *
 24 // *******************************************     24 // ********************************************************************
 25 //                                                 25 //
 26 // G4LogicalVolume                             <<  26 //
                                                   >>  27 // $Id: G4LogicalVolume.hh,v 1.27 2008/07/10 09:40:08 gcosmo Exp $
                                                   >>  28 // GEANT4 tag $Name: geant4-09-02 $
                                                   >>  29 //
                                                   >>  30 // 
                                                   >>  31 // class G4LogicalVolume
 27 //                                                 32 //
 28 // Class description:                              33 // Class description:
 29 //                                                 34 //
 30 // Represents a leaf node or unpositioned subt     35 // Represents a leaf node or unpositioned subtree in the geometry hierarchy.
 31 // Logical volumes are named, and may have dau     36 // Logical volumes are named, and may have daughters ascribed to them.
 32 // They are responsible for retrieval of the p     37 // They are responsible for retrieval of the physical and tracking attributes
 33 // of the physical volume that it represents:      38 // of the physical volume that it represents: solid, material, magnetic field,
 34 // and optionally, user limits, sensitive dete     39 // and optionally, user limits, sensitive detectors, regions, biasing weights.
 35 //                                                 40 //
 36 // Get and Set functionality is provided for a     41 // Get and Set functionality is provided for all attributes, but note that
 37 // most set functions should not be used  when     42 // most set functions should not be used  when the geometry is `closed'.
 38 // As a  further development, `Guard' checks c     43 // As a  further development, `Guard' checks can be added to ensure
 39 // only legal operations at tracking time.         44 // only legal operations at tracking time.
 40 //                                                 45 //
 41 // On construction, solid, material and name m     46 // On construction, solid, material and name must be specified.
 42 //                                                 47 //
 43 // Daughters are ascribed and managed by means     48 // Daughters are ascribed and managed by means of a simple
 44 // GetNoDaughters,Get/SetDaughter(n),AddDaught     49 // GetNoDaughters,Get/SetDaughter(n),AddDaughter interface.
 45 //                                                 50 //
 46 // Smart voxels as used for tracking optimisat     51 // Smart voxels as used for tracking optimisation. They're also an attribute.
 47 //                                                 52 //
 48 // Logical volumes self register to the logica     53 // Logical volumes self register to the logical volume Store on construction,
 49 // and deregister on destruction.                  54 // and deregister on destruction.
 50 //                                                 55 //
 51 // NOTE: This class is currently *NOT* subclas     56 // NOTE: This class is currently *NOT* subclassed, since not meant to
 52 //       act as a base class. Therefore, the d     57 //       act as a base class. Therefore, the destructor is NOT virtual.
 53 //                                                 58 //
 54 // Data members:                                   59 // Data members:
 55 //                                                 60 //
 56 //    std::vector<G4VPhysicalVolume*> fDaughte     61 //    std::vector<G4VPhysicalVolume*> fDaughters
 57 //    - Vector of daughters. Given initial siz     62 //    - Vector of daughters. Given initial size of 0.
 58 //    G4FieldManager* fFieldManager                63 //    G4FieldManager* fFieldManager
 59 //    - Pointer (possibly 0) to (magnetic or o     64 //    - Pointer (possibly 0) to (magnetic or other) field manager object.
 60 //    G4Material* fMaterial                        65 //    G4Material* fMaterial
 61 //    - Pointer to material at this node.          66 //    - Pointer to material at this node.
 62 //    G4String fName                               67 //    G4String fName
 63 //    - Name of logical volume.                    68 //    - Name of logical volume.
 64 //    G4VSensitiveDetector *fSensitiveDetector     69 //    G4VSensitiveDetector *fSensitiveDetector
 65 //    - Pointer (possibly 0) to `Hit' object.      70 //    - Pointer (possibly 0) to `Hit' object.
 66 //    G4VSolid* fSolid                             71 //    G4VSolid* fSolid
 67 //    - Pointer to solid.                          72 //    - Pointer to solid.
 68 //    G4UserLimits* fUserLimits                    73 //    G4UserLimits* fUserLimits
 69 //    - Pointer (possibly 0) to user Step limi     74 //    - Pointer (possibly 0) to user Step limit object for this node.
 70 //    G4SmartVoxelHeader* fVoxel                   75 //    G4SmartVoxelHeader* fVoxel
 71 //    - Pointer (possibly 0) to optimisation i     76 //    - Pointer (possibly 0) to optimisation info objects.
 72 //    G4bool fOptimise                             77 //    G4bool fOptimise
 73 //    - Flag to identify if optimisation shoul     78 //    - Flag to identify if optimisation should be applied or not.
 74 //    G4bool fRootRegion                           79 //    G4bool fRootRegion
 75 //    - Flag to identify if the logical volume     80 //    - Flag to identify if the logical volume is a root region.
 76 //    G4double fSmartless                          81 //    G4double fSmartless
 77 //    - Quality for optimisation, average numb     82 //    - Quality for optimisation, average number of voxels to be spent
 78 //      per content.                               83 //      per content.
 79 //    const G4VisAttributes* fVisAttributes        84 //    const G4VisAttributes* fVisAttributes
 80 //    - Pointer (possibly 0) to visualization      85 //    - Pointer (possibly 0) to visualization attributes.
 81 //    G4Region* fRegion                            86 //    G4Region* fRegion
 82 //    - Pointer to the cuts region (if any)        87 //    - Pointer to the cuts region (if any)
 83 //    G4MaterialCutsCouple* fCutsCouple            88 //    G4MaterialCutsCouple* fCutsCouple
 84 //    - Pointer (possibly 0) to associated pro     89 //    - Pointer (possibly 0) to associated production cuts.
 85 //    G4double fBiasWeight                         90 //    G4double fBiasWeight
 86 //    - Weight used in the event biasing techn     91 //    - Weight used in the event biasing technique.
 87 //                                                 92 //
 88 // Following data members has been moved to G4     93 // Following data members has been moved to G4Region - M.Asai (Aug/18/2005)
 89 //    G4FastSimulationManager* fFastSimulation     94 //    G4FastSimulationManager* fFastSimulationManager
 90 //    - Pointer (possibly 0) to G4FastSimulati     95 //    - Pointer (possibly 0) to G4FastSimulationManager object.
 91 //    G4bool fIsEnvelope                           96 //    G4bool fIsEnvelope
 92 //    - Flags if the Logical Volume is an enve     97 //    - Flags if the Logical Volume is an envelope for a FastSimulationManager.
 93                                                    98 
 94 // 15.01.13 G.Cosmo, A.Dotti: Modified for thr <<  99 // History:
 95 // 12.11.04 G.Cosmo: Added GetMass() method fo    100 // 12.11.04 G.Cosmo: Added GetMass() method for computing mass of the tree
 96 // 24.09.02 G.Cosmo: Added flags and accessors    101 // 24.09.02 G.Cosmo: Added flags and accessors for region cuts handling
 97 // 17.05.02 G.Cosmo: Added IsToOptimise() meth    102 // 17.05.02 G.Cosmo: Added IsToOptimise() method and related flag
 98 // 18.04.01 G.Cosmo: Migrated to STL vector       103 // 18.04.01 G.Cosmo: Migrated to STL vector
 99 // 12.02.99 S.Giani: Added user defined optimi    104 // 12.02.99 S.Giani: Added user defined optimisation quality
                                                   >> 105 // 09.11.98 J.Apostolakis:  Changed G4MagneticField to G4FieldManager
100 // 09.11.98 M.Verderi, J.Apostolakis: Added Bi    106 // 09.11.98 M.Verderi, J.Apostolakis: Added BiasWeight member and accessors
101 // 10.20.97 P.M.DeFreitas, J.Apostolakis: Adde << 107 // 10.20.97 P.M.DeFreitas: Added pointer to a FastSimulation
102 // 11.07.95 P.Kent: Initial version            << 108 //          J.Apostolakis: & flag to indicate if it is an Envelope for it
                                                   >> 109 // 19.11.96 J.Allison: Replaced G4Visible with explicit const G4VisAttributes*
                                                   >> 110 // 19.08.96 P.Kent: Split -> hh/icc/cc files; G4VSensitiveDetector change
                                                   >> 111 // 11.07.95 P.Kent: Initial version.
103 // -------------------------------------------    112 // ------------------------------------------------------------------------
104 #ifndef G4LOGICALVOLUME_HH                        113 #ifndef G4LOGICALVOLUME_HH
105 #define G4LOGICALVOLUME_HH 1                   << 114 #define G4LOGICALVOLUME_HH
106                                                << 
107 #include <vector>                              << 
108 #include <memory>                              << 
109                                                   115 
110 #include "G4Types.hh"                             116 #include "G4Types.hh"
111 #include "G4Region.hh"           // Required b    117 #include "G4Region.hh"           // Required by inline methods
112 #include "G4VPhysicalVolume.hh"  // Need opera    118 #include "G4VPhysicalVolume.hh"  // Need operator == for vector fdaughters
113 #include "G4GeomSplitter.hh"     // Needed for << 119 #include <vector>
114 #include "G4Threading.hh"                      << 120 #include <assert.h>
115                                                   121 
116 // Forward declarations                           122 // Forward declarations
117 //                                                123 //
118 class G4FieldManager;                             124 class G4FieldManager;
119 class G4Material;                                 125 class G4Material;
120 class G4VSensitiveDetector;                       126 class G4VSensitiveDetector;
121 class G4VSolid;                                   127 class G4VSolid;
122 class G4UserLimits;                               128 class G4UserLimits;
123 class G4SmartVoxelHeader;                         129 class G4SmartVoxelHeader;
                                                   >> 130 class G4VisAttributes;
124 class G4FastSimulationManager;                    131 class G4FastSimulationManager;
125 class G4MaterialCutsCouple;                       132 class G4MaterialCutsCouple;
126 class G4VisAttributes;                         << 
127                                                << 
128 class G4LVData                                 << 
129 {                                              << 
130   // Encapsulates the fields associated to the << 
131   // G4LogicalVolume that may not be read-only << 
132                                                << 
133   public:                                      << 
134                                                << 
135     G4LVData();                                << 
136     void initialize()                          << 
137     {                                          << 
138       fSolid = nullptr;                        << 
139       fSensitiveDetector = nullptr;            << 
140       fFieldManager = nullptr;                 << 
141       fMaterial = nullptr;                     << 
142       fMass = 0.0;                             << 
143       fCutsCouple = nullptr;                   << 
144     }                                          << 
145                                                << 
146   public:                                      << 
147                                                << 
148     G4VSolid* fSolid = nullptr;                << 
149       // Pointer to solid.                     << 
150     G4VSensitiveDetector* fSensitiveDetector = << 
151       // Pointer to sensitive detector.        << 
152     G4FieldManager* fFieldManager = nullptr;   << 
153       // Pointer (possibly nullptr) to (magnet << 
154     G4Material* fMaterial = nullptr;           << 
155       // Pointer to material at this node.     << 
156     G4double fMass = 0.0;                      << 
157       // Mass of the logical volume tree.      << 
158     G4MaterialCutsCouple* fCutsCouple = nullpt << 
159       // Pointer (possibly nullptr) to associa << 
160 };                                             << 
161                                                << 
162 // The type G4LVManager is introduced to encap << 
163 // both the master thread and worker threads t << 
164 // the fields encapsulated by the class G4LVDa << 
165 // initializes the value for these fields, it  << 
166 // definition defined below. For every G4Logic << 
167 // a corresponding G4LVData instance. All G4LV << 
168 // by the class G4LVManager as an array.       << 
169 // The field "int instanceID" is added to the  << 
170 // The value of this field in each G4LogicalVo << 
171 // of the corresponding G4LVData instance.     << 
172 // In order to use the class G4LVManager, we a << 
173 // G4LogicalVolume as follows: "static G4LVMan << 
174 // For the master thread, the array for G4LVDa << 
175 // along with G4LogicalVolume instances are cr << 
176 // it copies the array of G4LVData instances f << 
177 // In addition, it invokes a method similiar t << 
178 // to achieve the partial effect for each inst << 
179 //                                             << 
180 using G4LVManager = G4GeomSplitter<G4LVData>;  << 
181                                                   133 
182 class G4LogicalVolume                             134 class G4LogicalVolume
183 {                                                 135 {
184   public:                                      << 136   typedef std::vector<G4VPhysicalVolume*> G4PhysicalVolumeList;
185                                                << 137 
                                                   >> 138   public:  // with description
                                                   >> 139   
186     G4LogicalVolume(G4VSolid* pSolid,             140     G4LogicalVolume(G4VSolid* pSolid,
187                     G4Material* pMaterial,        141                     G4Material* pMaterial,
188               const G4String& name,               142               const G4String& name,
189                     G4FieldManager* pFieldMgr  << 143                     G4FieldManager* pFieldMgr=0,
190                     G4VSensitiveDetector* pSDe << 144                     G4VSensitiveDetector* pSDetector=0,
191                     G4UserLimits* pULimits = n << 145                     G4UserLimits* pULimits=0,
192                     G4bool optimise = true);   << 146                     G4bool optimise=true);
193       // Constructor. The solid and material p    147       // Constructor. The solid and material pointer must be non null.
194       // The parameters for field, detector an    148       // The parameters for field, detector and user limits are optional.
195       // The volume also enters itself into th    149       // The volume also enters itself into the logical volume Store.
196       // Optimisation of the geometry (voxelis    150       // Optimisation of the geometry (voxelisation) for the volume
197       // hierarchy is applied by default. For     151       // hierarchy is applied by default. For parameterised volumes in
198       // the hierarchy, optimisation is -alway    152       // the hierarchy, optimisation is -always- applied.
199                                                   153 
200     virtual ~G4LogicalVolume();                << 154     ~G4LogicalVolume();
201       // Destructor. Removes the logical volum    155       // Destructor. Removes the logical volume from the logical volume Store.
202       // This class is NOT meant to act as bas << 156       // NOT virtual, since not meant to act as base class.
203       // circumstances of extended types used  << 
204                                                << 
205     G4LogicalVolume(const G4LogicalVolume&) =  << 
206     G4LogicalVolume& operator=(const G4Logical << 
207       // Copy-constructor and assignment opera << 
208                                                   157 
209     inline const G4String& GetName() const;    << 158     inline G4String GetName() const;
210     void SetName(const G4String& pName);       << 159     inline void SetName(const G4String& pName);
211       // Returns and sets the name of the logi    160       // Returns and sets the name of the logical volume.
212                                                   161 
213     inline std::size_t GetNoDaughters() const; << 162     inline G4int GetNoDaughters() const;
214       // Returns the number of daughters (0 to    163       // Returns the number of daughters (0 to n).
215     inline G4VPhysicalVolume* GetDaughter(cons << 164     inline G4VPhysicalVolume* GetDaughter(const G4int i) const;
216       // Returns the ith daughter. Note number    165       // Returns the ith daughter. Note numbering starts from 0,
217       // and no bounds checking is performed.     166       // and no bounds checking is performed.
218     void AddDaughter(G4VPhysicalVolume* p);    << 167     inline void AddDaughter(G4VPhysicalVolume* p);
219       // Adds the volume p as a daughter of th    168       // Adds the volume p as a daughter of the current logical volume.
220     inline G4bool IsDaughter(const G4VPhysical    169     inline G4bool IsDaughter(const G4VPhysicalVolume* p) const;
221       // Returns true if the volume p is a dau    170       // Returns true if the volume p is a daughter of the current
222       // logical volume.                          171       // logical volume.
223     G4bool IsAncestor(const G4VPhysicalVolume*    172     G4bool IsAncestor(const G4VPhysicalVolume* p) const;
224       // Returns true if the volume p is part     173       // Returns true if the volume p is part of the hierarchy of
225       // volumes established by the current lo    174       // volumes established by the current logical volume. Scans
226       // recursively the volume tree.             175       // recursively the volume tree.
227     void RemoveDaughter(const G4VPhysicalVolum << 176     inline void RemoveDaughter(const G4VPhysicalVolume* p);
228       // Removes the volume p from the List of    177       // Removes the volume p from the List of daughter of the current
229       // logical volume.                          178       // logical volume.
230     void ClearDaughters();                     << 179     inline void ClearDaughters();
231       // Clears the list of daughters. Used by    180       // Clears the list of daughters. Used by the phys-volume store when
232       // the geometry tree is cleared, since m    181       // the geometry tree is cleared, since modified at run-time.
233     G4int TotalVolumeEntities() const;            182     G4int TotalVolumeEntities() const;
234       // Returns the total number of physical     183       // Returns the total number of physical volumes (replicated or placed)
235       // in the tree represented by the curren    184       // in the tree represented by the current logical volume.
236     inline EVolume CharacteriseDaughters() con << 185 
237       // Characterise the daughters of this lo << 186 
238     inline EVolume DeduceDaughtersType() const << 187     inline G4VSolid* GetSolid() const;
239       // Used by CharacteriseDaughters().      << 188     inline void SetSolid(G4VSolid *pSolid);
240                                                << 
241     G4VSolid* GetSolid() const;                << 
242     void SetSolid(G4VSolid* pSolid);           << 
243       // Gets and sets the current solid.         189       // Gets and sets the current solid.
244                                                   190 
245     G4Material* GetMaterial() const;           << 191     inline G4Material* GetMaterial() const;
246     void SetMaterial(G4Material* pMaterial);   << 192     inline void SetMaterial(G4Material *pMaterial);
247       // Gets and sets the current material.      193       // Gets and sets the current material.
248     void UpdateMaterial(G4Material* pMaterial) << 194     inline void UpdateMaterial(G4Material *pMaterial);
249       // Sets material and corresponding Mater    195       // Sets material and corresponding MaterialCutsCouple.
250       // This method is invoked by G4Navigator    196       // This method is invoked by G4Navigator while it is navigating through 
251       // material parameterization.               197       // material parameterization.
252     G4double GetMass(G4bool forced = false, G4 << 198     G4double GetMass(G4bool forced=false, G4bool propagate=true,
253                      G4Material* parMaterial = << 199                      G4Material* parMaterial=0);
254       // Returns the mass of the logical volum    200       // Returns the mass of the logical volume tree computed from the
255       // estimated geometrical volume of each     201       // estimated geometrical volume of each solid and material associated
256       // to the logical volume and (by default    202       // to the logical volume and (by default) to its daughters.
257       // NOTE: the computation may require a c    203       // NOTE: the computation may require a considerable amount of time,
258       //       depending from the complexity o    204       //       depending from the complexity of the geometry tree.
259       //       The returned value is cached an    205       //       The returned value is cached and can be used for successive
260       //       calls (default), unless recompu    206       //       calls (default), unless recomputation is forced by providing
261       //       'true' for the boolean argument    207       //       'true' for the boolean argument in input. Computation should
262       //       be forced if the geometry setup    208       //       be forced if the geometry setup has changed after the previous
263       //       call. By setting the 'propagate    209       //       call. By setting the 'propagate' boolean flag to 'false' the 
264       //       method returns the mass of the     210       //       method returns the mass of the present logical volume only 
265       //       (subtracted for the volume occu    211       //       (subtracted for the volume occupied by the daughter volumes).
266       //       An optional argument to specify    212       //       An optional argument to specify a material is also provided.
267     void ResetMass();                          << 213 
268       // Ensure that cached value of Mass is i << 214     inline G4FieldManager* GetFieldManager() const;
269       //  state, e.g. change of size of Solid, << 
270       //              or the addition/deletion << 
271                                                << 
272     G4FieldManager* GetFieldManager() const;   << 
273       // Gets current FieldManager.               215       // Gets current FieldManager.
274     void SetFieldManager(G4FieldManager* pFiel << 216     void SetFieldManager(G4FieldManager *pFieldMgr, G4bool forceToAllDaughters); 
275       // Sets FieldManager and propagates it:     217       // Sets FieldManager and propagates it:
276       //  i) only to daughters with G4FieldMan << 218       //  i) only to daughters with G4FieldManager = 0
277       //     if forceToAllDaughters=false         219       //     if forceToAllDaughters=false
278       // ii) to all daughters                     220       // ii) to all daughters
279       //     if forceToAllDaughters=true          221       //     if forceToAllDaughters=true
280                                                   222 
281     G4VSensitiveDetector* GetSensitiveDetector << 223     inline G4VSensitiveDetector* GetSensitiveDetector() const;
282       // Gets current SensitiveDetector.          224       // Gets current SensitiveDetector.
283     void SetSensitiveDetector(G4VSensitiveDete << 225     inline void SetSensitiveDetector(G4VSensitiveDetector *pSDetector);
284       // Sets SensitiveDetector (can be nullpt << 226       // Sets SensitiveDetector (can be 0).
285                                                   227 
286     inline G4UserLimits* GetUserLimits() const    228     inline G4UserLimits* GetUserLimits() const;
287     inline void SetUserLimits(G4UserLimits *pU    229     inline void SetUserLimits(G4UserLimits *pULimits);
288       // Gets and sets current UserLimits.        230       // Gets and sets current UserLimits.
289                                                   231 
290     inline G4SmartVoxelHeader* GetVoxelHeader(    232     inline G4SmartVoxelHeader* GetVoxelHeader() const;
291     inline void SetVoxelHeader(G4SmartVoxelHea    233     inline void SetVoxelHeader(G4SmartVoxelHeader *pVoxel);
292       // Gets and sets current VoxelHeader.       234       // Gets and sets current VoxelHeader.
293                                                   235     
294     inline G4double GetSmartless() const;         236     inline G4double GetSmartless() const;
295     inline void SetSmartless(G4double s);         237     inline void SetSmartless(G4double s);
296       // Gets and sets user defined optimisati    238       // Gets and sets user defined optimisation quality.
297                                                   239 
298     inline G4bool IsToOptimise() const;           240     inline G4bool IsToOptimise() const;
299       // Replies if geometry optimisation (vox    241       // Replies if geometry optimisation (voxelisation) is to be
300       // applied for this volume hierarchy.       242       // applied for this volume hierarchy.
301     inline void SetOptimisation(G4bool optim);    243     inline void SetOptimisation(G4bool optim);
302       // Specifies if to apply or not geometry    244       // Specifies if to apply or not geometry optimisation to this
303       // volume hierarchy. Note that for param    245       // volume hierarchy. Note that for parameterised volumes in the
304       // hierarchy, optimisation is always app    246       // hierarchy, optimisation is always applied. 
305                                                   247 
306     inline G4bool IsRootRegion() const;           248     inline G4bool IsRootRegion() const;
307       // Replies if the logical volume represe    249       // Replies if the logical volume represents a root region or not.
308     inline void SetRegionRootFlag(G4bool rreg)    250     inline void SetRegionRootFlag(G4bool rreg);
309       // Sets/unsets the volume as a root regi    251       // Sets/unsets the volume as a root region for cuts.
310     inline G4bool IsRegion() const;               252     inline G4bool IsRegion() const;
311       // Replies if the logical volume is part    253       // Replies if the logical volume is part of a cuts region or not.
312     inline void SetRegion(G4Region* reg);         254     inline void SetRegion(G4Region* reg);
313       // Sets/unsets the volume as cuts region    255       // Sets/unsets the volume as cuts region.
314     inline G4Region* GetRegion() const;           256     inline G4Region* GetRegion() const;
315       // Return the region to which the volume    257       // Return the region to which the volume belongs, if any.
316     inline void PropagateRegion();                258     inline void PropagateRegion();
317       // Propagates region pointer to daughter    259       // Propagates region pointer to daughters.
318                                                   260 
319     const G4MaterialCutsCouple* GetMaterialCut << 261     inline const G4MaterialCutsCouple* GetMaterialCutsCouple() const;
320     void SetMaterialCutsCouple(G4MaterialCutsC << 262     inline void SetMaterialCutsCouple(G4MaterialCutsCouple* cuts);
321       // Accessors for production cuts.           263       // Accessors for production cuts.
322                                                   264 
323     G4bool operator == (const G4LogicalVolume&    265     G4bool operator == (const G4LogicalVolume& lv) const;
324       // Equality defined by address only.        266       // Equality defined by address only.
325       // Returns true if objects are at same a    267       // Returns true if objects are at same address, else false.
326                                                   268 
327     const G4VisAttributes* GetVisAttributes () << 269     inline const G4VisAttributes* GetVisAttributes () const;
328     void SetVisAttributes (const G4VisAttribut << 270     inline void  SetVisAttributes (const G4VisAttributes* pVA);
329     void SetVisAttributes (const G4VisAttribut << 271     void  SetVisAttributes (const G4VisAttributes& VA);
330       // Gets and sets visualization attribute << 272       // Gets and sets visualization attributes. A copy of 'VA' on the heap
331       // Arguments are converted to shared_ptr << 273       // will be made in the case the call with a const reference is used.
332                                                   274 
333     inline G4FastSimulationManager* GetFastSim    275     inline G4FastSimulationManager* GetFastSimulationManager () const;
334       // Gets current FastSimulationManager po    276       // Gets current FastSimulationManager pointer if exists, otherwise null.
335                                                   277 
336     inline void SetBiasWeight (G4double w);       278     inline void SetBiasWeight (G4double w);
337     inline G4double GetBiasWeight() const;        279     inline G4double GetBiasWeight() const;
338       // Sets and gets bias weight.               280       // Sets and gets bias weight.
339                                                   281 
340   public:                                      << 282   public:  // without description
341                                                   283 
342     G4LogicalVolume(__void__&);                   284     G4LogicalVolume(__void__&);
343       // Fake default constructor for usage re    285       // Fake default constructor for usage restricted to direct object
344       // persistency for clients requiring pre    286       // persistency for clients requiring preallocation of memory for
345       // persistifiable objects.                  287       // persistifiable objects.
346                                                   288 
347     virtual G4bool IsExtended() const;         << 
348       // Return true if it is not a base-class << 
349                                                << 
350     inline G4FieldManager* GetMasterFieldManag << 
351       // Gets current FieldManager for the mas << 
352     inline G4VSensitiveDetector* GetMasterSens << 
353       // Gets current SensitiveDetector for th << 
354     inline G4VSolid* GetMasterSolid() const;   << 
355       // Gets current Solid for the master thr << 
356                                                << 
357     inline G4int GetInstanceID() const;        << 
358       // Returns the instance ID.              << 
359                                                << 
360     static const G4LVManager& GetSubInstanceMa << 
361       // Returns the private data instance man << 
362                                                << 
363     static void Clean();                       << 
364       // Clear memory allocated by sub-instanc << 
365                                                << 
366     inline void Lock();                           289     inline void Lock();
367       // Set lock identifier for final deletio    290       // Set lock identifier for final deletion of entity.
368                                                   291 
369     void InitialiseWorker(G4LogicalVolume* ptr << 292   private:
370                           G4VSolid* pSolid, G4 << 
371       // This method is similar to the constru << 
372       // thread to achieve the partial effect  << 
373                                                << 
374     void TerminateWorker(G4LogicalVolume* ptrM << 
375       // This method is similar to the destruc << 
376       // thread to achieve the partial effect  << 
377                                                   293 
378     void AssignFieldManager(G4FieldManager* fl << 294     G4LogicalVolume(const G4LogicalVolume&);
379       // Set the FieldManager - only at this l << 295     G4LogicalVolume& operator=(const G4LogicalVolume&);
380                                                << 296       // Private copy-constructor and assignment operator.
381     static G4VSolid* GetSolid(G4LVData& instLV << 
382     static void SetSolid(G4LVData& instLVdata, << 
383       // Optimised Methods - passing thread in << 
384                                                << 
385     G4bool ChangeDaughtersType(EVolume atype); << 
386       // Change the type of the daughters volu << 
387       // Meant for the user who wants to use t << 
388       // the contents of a volume.             << 
389       // Returns: success (true) or failure (f << 
390                                                   297 
391   private:                                        298   private:
392                                                   299 
393     using G4PhysicalVolumeList = std::vector<G << 300     // Data members:   
394                                                << 
395     G4GEOM_DLL static G4LVManager subInstanceM << 
396       // This new field helps to use the class << 
397                                                   301 
398     G4PhysicalVolumeList fDaughters;              302     G4PhysicalVolumeList fDaughters;
399       // Vector of daughters. Given initial si    303       // Vector of daughters. Given initial size of 0.
                                                   >> 304     G4FieldManager* fFieldManager;
                                                   >> 305       // Pointer (possibly 0) to (magnetic or other) field manager object.
                                                   >> 306     G4Material* fMaterial;
                                                   >> 307       // Pointer to material at this node.
400     G4String fName;                               308     G4String fName;
401       // Name of logical volume.                  309       // Name of logical volume.
402     G4UserLimits* fUserLimits = nullptr;       << 310     G4VSensitiveDetector* fSensitiveDetector;
403       // Pointer (possibly nullptr) to user St << 311       // Pointer (possibly 0) to `Hit' object.
404     G4SmartVoxelHeader* fVoxel = nullptr;      << 312     G4VSolid* fSolid;
405       // Pointer (possibly nullptr) to optimis << 313       // Pointer to solid.
406     G4double fSmartless = 2.0;                 << 314     G4UserLimits* fUserLimits;
407       // Quality for optimisation, average num << 315       // Pointer (possibly 0) to user Step limit object for this node.
408       // per content.                          << 316     G4SmartVoxelHeader* fVoxel;
409     G4Region* fRegion = nullptr;               << 317       // Pointer (possibly 0) to optimisation info objects.
410       // Pointer to the cuts region (if any).  << 318     G4bool fOptimise;
411     G4double fBiasWeight = 1.0;                << 
412       // Weight used in the event biasing tech << 
413     std::shared_ptr<const G4VisAttributes> fVi << 
414       // Pointer to visualization attributes.  << 
415                                                << 
416     // Shadow of master pointers.              << 
417     // Each worker thread can access this fiel << 
418     // through these pointers.                 << 
419     //                                         << 
420     G4VSolid* fSolid = nullptr;                << 
421     G4VSensitiveDetector* fSensitiveDetector = << 
422     G4FieldManager* fFieldManager = nullptr;   << 
423     G4LVData* lvdata = nullptr;  // For use of << 
424                                                << 
425     G4int instanceID;                          << 
426       // This new field is used as instance ID << 
427     EVolume fDaughtersVolumeType;              << 
428       // Are contents of volume placements, re << 
429     G4bool fOptimise = true;                   << 
430       // Flag to identify if optimisation shou    319       // Flag to identify if optimisation should be applied or not.
431     G4bool fRootRegion = false;                << 320     G4bool fRootRegion;
432       // Flag to identify if the logical volum    321       // Flag to identify if the logical volume is a root region.
433     G4bool fLock = false;                      << 322     G4bool fLock;
434       // Flag to identify if entity is locked     323       // Flag to identify if entity is locked for final deletion.
                                                   >> 324     G4double fSmartless;
                                                   >> 325       // Quality for optimisation, average number of voxels to be spent
                                                   >> 326       // per content.
                                                   >> 327     G4double fMass;
                                                   >> 328       // Mass of the logical volume tree.
                                                   >> 329     const G4VisAttributes* fVisAttributes;
                                                   >> 330       // Pointer (possibly 0) to visualization attributes.
                                                   >> 331     G4Region* fRegion;
                                                   >> 332       // Pointer to the cuts region (if any)
                                                   >> 333     G4MaterialCutsCouple* fCutsCouple;
                                                   >> 334       // Pointer (possibly 0) to associated production cuts.
                                                   >> 335     G4double fBiasWeight;
                                                   >> 336       // Weight used in the event biasing technique.
435 };                                                337 };
436                                                   338 
437 #include "G4LogicalVolume.icc"                    339 #include "G4LogicalVolume.icc"
438                                                   340 
439 #endif                                            341 #endif
440                                                   342