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 AliMUONGeometryStore;
  29 class AliMUONStringIntMap;
  30
  31 class AliMUONVGeometryBuilder : public TObject
  32 {
  33   public:
  34     AliMUONVGeometryBuilder(Int_t geometryModuleId1,
  35                             Int_t geometryModuleId2 = -1,
  36                             Int_t geometryModuleId3 = -1,
  37                             Int_t geometryModuleId4 = -1,
  38                             Int_t geometryModuleId5 = -1,
  39                             Int_t geometryModuleId6 = -1);
  40     AliMUONVGeometryBuilder();
  41     virtual ~AliMUONVGeometryBuilder();
  42
  43     // methods
  44     void  SetReferenceFrame(const TGeoCombiTrans& referenceFrame);
  45     void  RebuildSVMaps(Bool_t withEnvelopes = true) const;
  46     void  CreateDetElements() const;
  47
  48     virtual void CreateMaterials() {}  // make = 0; ?
  49                   // Function to be overriden in a concrete chamber/station
  50                   // geometry builder class.
  51                   // Only materials that are not defined in the common
  52                   // functions should be defined here.
  53
  54     virtual void CreateGeometry() = 0;
  55                   // Function to be overriden in a concrete chamber/station
  56                   // geometry builder class.
  57                   // The geometry built there should not be placed
  58                   // in ALIC; but all volumes going to ALIC
  59                   // have to be added as envelopes to the chamber
  60                   // geometries
  61                   // (They will be then placed automatically
  62                   // usind the provided transformation.
  63
  64     virtual void SetTransformations() = 0;
  65                   // Function to be overriden in a concrete chamber/station
  66                   // geometry class.
  67                   // The transformation of each chamber(s) wrt ALICE
  68                   // should be defined and set to its geometry class.
  69
  70     virtual void SetSensitiveVolumes() = 0;
  71                   // Function to be overriden in a concrete chamber/station
  72                   // geometry class.
  73                   // The sensitive volumes Ids for each chamber
  74                   // should be defined and set to its geometry class.
  75
  76     virtual bool ApplyGlobalTransformation() { return true; }
  77                   // Function to be overriden (and return false)
  78                   // in the concrete geometry builder classes
  79                   // which are already defined in the new ALICE
  80                   // coordinate frame
  81
  82     // access to module geometries
  83     Int_t  NofGeometries() const;
  84     AliMUONGeometryModule* Geometry(Int_t i) const;
  85                   // In difference from protected GetGeometry()
  86                   // this function access geometry via index and not
  87                   // via moduleId
  88
  89   protected:
  90     AliMUONVGeometryBuilder(const AliMUONVGeometryBuilder& rhs);
  91
  92     // operators
  93     AliMUONVGeometryBuilder& operator = (const AliMUONVGeometryBuilder& rhs);
  94
  95     // methods
  96     AliMUONGeometryModule*         GetGeometry(Int_t moduleId) const;
  97     AliMUONGeometryEnvelopeStore*  GetEnvelopes(Int_t moduleId) const;
  98     AliMUONStringIntMap*           GetSVMap(Int_t moduleId) const;
  99
 100     // set module transformation
 101     void SetTranslation(Int_t moduleId,
 102                         const TGeoTranslation& translation);
 103     void SetTransformation(Int_t moduleId,
 104                         const TGeoTranslation& translation,
 105                         const TGeoRotation& rotation);
 106
 107     // set volumes
 108     void SetVolume(Int_t moduleId, const TString& volumeName,
 109                    Bool_t isVirtual = false);
 110     void SetMotherVolume(Int_t moduleId, const TString& volumeName);
 111
 112   private:
 113     //methods
 114     TGeoHMatrix ConvertTransform(const TGeoHMatrix& transform) const;
 115     TGeoHMatrix ConvertDETransform(const TGeoHMatrix& transform) const;
 116     TString     ComposePath(const TString& volName, Int_t copyNo) const;
 117     void        MapSV(const TString& path0,
 118                       const TString& volName, Int_t detElemId) const;
 119
 120     // data members
 121     TObjArray*  fGeometryModules;   // the modules geometries that will be built
 122                                     // by this builder
 123     TGeoCombiTrans fReferenceFrame; // the transformation from the builder
 124                                     // reference frame to that of the transform
 125                                     // data files
 126
 127   ClassDef(AliMUONVGeometryBuilder,4) // MUON chamber geometry base class
 128 };
 129
 130 // inline functions
 131
 132 inline Int_t  AliMUONVGeometryBuilder::NofGeometries() const
 133 { return fGeometryModules->GetEntriesFast(); }
 134
 135 inline AliMUONGeometryModule* AliMUONVGeometryBuilder::Geometry(Int_t i) const
 136 { return (AliMUONGeometryModule*)fGeometryModules->At(i); }
 137
 138 #endif //ALI_MUON_V_GEOMETRY_BUILDER_H