Import Geant4 3.1.0 source tree

2016-06-08 16:03:00 +02:00
parent cfcb558cfe
commit 137e303ecc
2843 changed files with 37082 additions and 38426 deletions
@@ -0,0 +1,148 @@
+// This code implementation is the intellectual property of
+// the GEANT4 collaboration.
+//
+// By copying, distributing or modifying the Program (or any work
+// based on the Program) you indicate your acceptance of this statement,
+// and all its terms.
+//
+// $Id: G4AssemblyVolume.hh,v 1.4 2001/02/07 17:30:57 gcosmo Exp $
+// GEANT4 tag $Name: geant4-03-01 $
+//
+// 
+// Class G4AssemblyVolume
+//
+// Class description:
+//
+// G4AssemblyVolume is a helper class to make the build process of geometry
+// easier. It allows to combine several volumes together in an arbitrary way
+// in 3D space and then work with the result as with a single logical volume
+// for placement.
+// The resulting objects are independent copies of each of the assembled
+// logical volumes. The placements are not, however, bound one to each other
+// when placement is done. They are seen as independent physical volumes in
+// space. This is the main difference when compared to the boolean solids or
+// parametrised physical volumes.
+
+// Author:      Radovan Chytracek, John Apostolakis, Gabriele Cosmo
+// Version:     1.0
+// Date:        November 2000
+// ----------------------------------------------------------------------
+
+#ifndef G4_ASSEMBLYVOLUME_H
+#define G4_ASSEMBLYVOLUME_H 
+
+#include "g4std/vector"
+#include "G4Transform3D.hh"
+#include "G4AssemblyTriplet.hh"
+
+class G4VPhysicalVolume;
+
+class G4AssemblyVolume
+{
+ public:  // with description
+
+  G4AssemblyVolume();    
+  G4AssemblyVolume( G4LogicalVolume* volume,
+                    G4ThreeVector& translation,
+                    G4RotationMatrix* rotation);
+  ~G4AssemblyVolume();
+    //
+    // Constructors & destructor.
+    // At destruction all the generated physical volumes and associated
+    // rotation matrices of the imprints will be destroyed.
+
+  void AddPlacedVolume( G4LogicalVolume* pPlacedVolume,
+                        G4ThreeVector& translation,
+                        G4RotationMatrix* rotation);
+    //
+    // Place the given volume 'pPlacedVolume' inside the assembly.
+    //
+    // The taken approach:
+    //
+    // - Place it w.r.t. the assembly coordinate system.
+    //   This step is applied to each of the participating volumes.
+    //
+    // The other possible approaches:
+    //
+    // - Place w.r.t. the firstly added volume.
+    //   When placed the first, the virtual coordinate system becomes
+    //   the coordinate system of the first one.
+    //   Every next volume being added into the assembly will be placed
+    //   w.r.t to the first one.
+    //
+    // - Place w.r.t the last placed volume.
+    //   When placed the first, the virtual coordinate system becomes
+    //   the coordinate system of the first one.
+    //   Every next volume being added into the assembly will be placed
+    //   w.r.t to the previous one.
+
+  void AddPlacedVolume( G4LogicalVolume* pPlacedVolume,
+                        G4Transform3D&   transformation);
+    //
+    // The same as previous but takes complete 3D transformation in space
+    // as its argument.
+
+  void MakeImprint( G4LogicalVolume* pMotherLV,
+                    G4ThreeVector& translationInMother,
+                    G4RotationMatrix* pRotationInMother);
+    //
+    // Creates instance of an assembly volume inside the given mother volume.
+
+  void MakeImprint( G4LogicalVolume* pMotherLV,
+                    G4Transform3D&   transformation);
+    //
+    // The same as previous but takes complete 3D transformation in space
+    // as its argument.
+
+private:    
+
+  G4std::vector<G4AssemblyTriplet> fTriplets;
+    //
+    // Participating volumes represented as a vector of
+    // <logical volume, translation, rotation>.
+
+  G4std::vector<G4VPhysicalVolume*> fPVStore;
+    //
+    // We need to keep list of physical volumes created by MakeImprint() method
+    // in order to be able to cleanup the objects when not needed anymore.
+    // This requires the user to keep assembly objects in memory during the
+    // whole job or during the life-time of G4Navigator, log. vol store
+    // and phys. vol. store may keep pointers to physical volumes generated by
+    // the assembly volume.
+    // When an assembly object is about to die it will destroy all its
+    // generated physical volumes and rotation matrices as well !
+    // This may affect validity of detector contruction !
+
+ protected:
+
+  unsigned int GetImprintsCount() const;
+  void         SetImprintsCount( unsigned int value );
+  void         ImprintsCountPlus();
+  void         ImprintsCountMinus();
+    //
+    // Internal counting mechanism, used to compute unique the names of
+    // phys. volumes created by MakeImprint(...) method(s).
+
+ private:
+
+  unsigned int fImprintsCounter;
+    //
+    // Number of imprints of the given assembly volume.
+
+ protected:
+
+  unsigned int GetInstanceCount() const;
+  void         SetInstanceCount( unsigned int value );
+  void         InstanceCountPlus();
+  void         InstanceCountMinus();
+
+ private:
+
+  static unsigned int fsInstanceCounter;
+
+};
+
+#include "G4AssemblyVolume.icc"
+
+#endif // G4_ASSEMBLYVOLUME_H
+