MUON/AliMUONVGeometryBuilder.h

   1 /* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
   2  * See cxx source for full Copyright notice                               */
   3
   4 // $Id$
   5 // Revision of includes 07/05/2004
   6
   7 /// \ingroup geometry
   8 /// \class AliMUONVGeometryBuilder
   9 /// \brief Abstract base class for geometry construction per module(s)
  10 ///
  11 /// \author Ivana Hrivnacova, IPN Orsay
  12
  13 #ifndef ALI_MUON_V_GEOMETRY_BUILDER_H
  14 #define ALI_MUON_V_GEOMETRY_BUILDER_H
  15
  16 #include <fstream>
  17
  18 #include <TObject.h>
  19 #include <TObjArray.h>
  20 #include <TGeoMatrix.h>
  21
  22 class TGeoTranslation;
  23 class TGeoRotation;
  24 class TGeoCombiTrans;
  25
  26 class AliMUONGeometryModule;
  27 class AliMUONGeometryEnvelopeStore;
  28 class AliMUONStringIntMap;
  29
  30 class AliMUONVGeometryBuilder : public TObject
  31 {
  32   public:
  33     AliMUONVGeometryBuilder(Int_t firstModuleId, Int_t nofModules);
  34     AliMUONVGeometryBuilder();
  35     virtual ~AliMUONVGeometryBuilder();
  36
  37     // methods
  38     void  SetReferenceFrame(const TGeoCombiTrans& referenceFrame);
  39     void  RebuildSVMaps(Bool_t withEnvelopes = true) const;
  40     void  CreateDetElements() const;
  41
  42                   /// Function to be overriden in a concrete chamber/station
  43                   /// geometry builder class.
  44                   /// Only materials that are not defined in the common
  45                   /// functions should be defined here.
  46     virtual void CreateMaterials() {}  // make = 0; ?
  47
  48                   /// Function to be overriden in a concrete chamber/station
  49                   /// geometry builder class. \n
  50                   /// The geometry built there should not be placed
  51                   /// in ALIC; but all volumes going to ALIC
  52                   /// have to be added as envelopes to the chamber
  53                   /// geometries
  54                   /// (They will be then placed automatically
  55                   /// usind the provided transformation.
  56     virtual void CreateGeometry() = 0;
  57
  58                   /// Function to be overriden in a concrete chamber/station
  59                   /// geometry class. \n
  60                   /// The transformation of each chamber(s) wrt ALICE
  61                   /// should be defined and set to its geometry class.
  62     virtual void SetTransformations() = 0;
  63
  64                   /// Function to be overriden in a concrete chamber/station
  65                   /// geometry class. \n
  66                   /// The sensitive volumes Ids for each chamber
  67                   /// should be defined and set to its geometry class.
  68     virtual void SetSensitiveVolumes() = 0;
  69
  70                   /// Function to be overriden (and return false)
  71                   /// in the concrete geometry builder classes
  72                   /// which are already defined in the new ALICE
  73                   /// coordinate frame
  74     virtual bool ApplyGlobalTransformation() { return true; }
  75
  76     // access to module geometries
  77     Int_t  NofGeometries() const;
  78     AliMUONGeometryModule* Geometry(Int_t i) const;
  79                   // In difference from protected GetGeometry()
  80                   // this function access geometry via index and not
  81                   // via moduleId
  82
  83   protected:
  84     // methods
  85     AliMUONGeometryModule*         GetGeometry(Int_t moduleId) const;
  86     AliMUONGeometryEnvelopeStore*  GetEnvelopes(Int_t moduleId) const;
  87     AliMUONStringIntMap*           GetSVMap(Int_t moduleId) const;
  88     Int_t                          GetModuleId(const TString& envName) const;
  89
  90     // set module transformation
  91     void SetTranslation(Int_t moduleId,
  92                         const TGeoTranslation& translation);
  93     void SetTransformation(Int_t moduleId,
  94                         const TGeoTranslation& translation,
  95                         const TGeoRotation& rotation);
  96
  97     // set volumes
  98     void SetVolume(Int_t moduleId, const TString& volumeName,
  99                    Bool_t isVirtual = false);
 100     void SetMotherVolume(Int_t moduleId, const TString& volumeName);
 101
 102   private:
 103     //methods
 104
 105     /// Not implemented
 106     AliMUONVGeometryBuilder(const AliMUONVGeometryBuilder& rhs);
 107     /// Not implemented
 108     AliMUONVGeometryBuilder& operator = (const AliMUONVGeometryBuilder& rhs);
 109
 110     TGeoHMatrix ConvertTransform(const TGeoHMatrix& transform) const;
 111     TGeoHMatrix ConvertDETransform(const TGeoHMatrix& transform) const;
 112     TString     ComposePath(const TString& volName, Int_t copyNo) const;
 113     void        MapSV(const TString& path0,
 114                       const TString& volName, Int_t detElemId) const;
 115
 116     // data members
 117     TObjArray*  fGeometryModules;   ///< \brief the modules geometries that will be built
 118                                     /// by this builder
 119     TGeoCombiTrans fReferenceFrame; ///< \brief the transformation from the builder
 120                                     /// reference frame to that of the transform
 121                                     /// data files
 122
 123   ClassDef(AliMUONVGeometryBuilder,4) // MUON chamber geometry base class
 124 };
 125
 126 // inline functions
 127
 128 /// Return the number of geometry modules
 129 inline Int_t  AliMUONVGeometryBuilder::NofGeometries() const
 130 { return fGeometryModules->GetEntriesFast(); }
 131
 132 /// Return the \a i th geometry module
 133 inline AliMUONGeometryModule* AliMUONVGeometryBuilder::Geometry(Int_t i) const
 134 { return (AliMUONGeometryModule*)fGeometryModules->At(i); }
 135
 136 #endif //ALI_MUON_V_GEOMETRY_BUILDER_H