MUON/mapping/AliMpSectorSegmentation.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 // $MpId: AliMpSectorSegmentation.h,v 1.15 2006/05/24 13:58:21 ivana Exp $
   6
   7 /// \ingroup sector
   8 /// \class AliMpSectorSegmentation
   9 /// \brief A segmentation of the sector.
  10 ///
  11 /// Provides methods related to pads:                                     \n
  12 /// conversion between pad indices, pad location, pad position;
  13 /// finding pad neighbour.
  14 ///
  15 /// \author David Guez, Ivana Hrivnacova; IPN Orsay
  16
  17 #ifndef ALI_MP_SECTOR_SEGMENTATION_H
  18 #define ALI_MP_SECTOR_SEGMENTATION_H
  19
  20 #include "AliMpContainers.h"
  21
  22 #include "AliMpVSegmentation.h"
  23 #include "AliMpPad.h"
  24
  25 #include <TVector2.h>
  26 #ifdef WITH_ROOT
  27 #include <TExMap.h>
  28 #endif
  29
  30 #ifdef WITH_STL
  31 #include <map>
  32 #endif
  33
  34 class AliMpSector;
  35 class AliMpMotifPosition;
  36 class AliMpVPadIterator;
  37 class AliMpIntPair;
  38 class AliMpArea;
  39
  40 class AliMpSectorSegmentation : public AliMpVSegmentation
  41 {
  42   public:
  43 #ifdef WITH_STL
  44     /// Pad dimensions map type
  45     typedef std::map<Int_t, TVector2>         PadDimensionsMap;
  46     /// Pad dimensions map iterator type
  47     typedef PadDimensionsMap::const_iterator  PadDimensionsMapCIterator;
  48 #endif
  49 #ifdef WITH_ROOT
  50     /// Pad dimensions map type
  51     typedef  TExMap      PadDimensionsMap;
  52     /// Pad dimensions map iterator type
  53     typedef  TExMapIter  PadDimensionsMapCIterator;
  54 #endif
  55
  56   public:
  57     AliMpSectorSegmentation(const AliMpSector* sector, Bool_t own = false);
  58     AliMpSectorSegmentation();
  59     virtual ~AliMpSectorSegmentation();
  60
  61     // factory methods
  62     virtual AliMpVPadIterator* CreateIterator(const AliMpArea& area) const;
  63     virtual AliMpVPadIterator* CreateIterator() const;
  64
  65     AliMpVPadIterator* CreateIterator(const AliMpPad& centerPad,
  66                                       Bool_t includeCenter=kFALSE) const;
  67
  68      Int_t GetNeighbours(const AliMpPad& pad, TObjArray& neighbours,
  69                          Bool_t includeSelf = kFALSE,
  70                          Bool_t includeVoid = kFALSE) const;
  71
  72     // methods
  73     virtual AliMpPad PadByLocation(const AliMpIntPair& location,
  74                                Bool_t warning = kTRUE) const;
  75     virtual AliMpPad PadByIndices (const AliMpIntPair& indices,
  76                                Bool_t warning = kTRUE) const;
  77     virtual AliMpPad PadByPosition(const TVector2& position ,
  78                                Bool_t warning = kTRUE) const;
  79     virtual AliMpPad PadByDirection(const TVector2& startPosition,
  80                                Double_t distance) const;
  81
  82     virtual Int_t  MaxPadIndexX() const;
  83     virtual Int_t  MaxPadIndexY() const;
  84     virtual Int_t  NofPads() const;
  85
  86     virtual Int_t    Zone(const AliMpPad& pad, Bool_t warning = kTRUE) const;
  87     virtual TVector2 PadDimensions(Int_t zone, Bool_t warning = kTRUE) const;
  88
  89     virtual Bool_t HasPad(const AliMpIntPair& indices) const;
  90     Bool_t HasMotifPosition(Int_t motifPositionID) const;
  91     TVector2 GetMinPadDimensions() const;
  92     Bool_t CircleTest(const AliMpIntPair& indices) const;
  93     void   PrintZones() const;
  94
  95     const AliMpSector* GetSector() const;
  96
  97     virtual void Print(Option_t* opt="") const;
  98
  99     virtual void GetAllElectronicCardIDs(TArrayI& ecn) const;
 100
 101     AliMp::PlaneType PlaneType() const;
 102
 103     AliMp::StationType StationType() const;
 104
 105     TVector2 Dimensions() const;
 106
 107   private:
 108     /// Not implemented
 109     AliMpSectorSegmentation(const AliMpSectorSegmentation& right);
 110     /// Not implemented
 111     AliMpSectorSegmentation&  operator = (const AliMpSectorSegmentation& right);
 112
 113 #ifdef WITH_ROOT
 114     static const Double_t   fgkS1;  ///< the separators used for conversion
 115     static const Double_t   fgkS2;  ///< of TVector2 to Long_t
 116
 117     // methods
 118     Long_t    GetIndex(const TVector2& vector2) const;
 119     TVector2  GetVector(Long_t index) const;
 120 #endif
 121
 122     // methods
 123     void  FillPadDimensionsMap();
 124     AliMpMotifPosition*  FindMotifPosition(const AliMpIntPair& indices) const;
 125     virtual AliMpPad PadByXDirection(const TVector2& startPosition,
 126                                      Double_t maxX) const;
 127     virtual AliMpPad PadByYDirection(const TVector2& startPosition,
 128                                      Double_t maxY) const;
 129
 130     // data members
 131     const AliMpSector*  fkSector;   ///< Sector
 132     Bool_t              fIsOwner;   ///< Sector ownership
 133     AliMpPad*           fPadBuffer; ///< The pad buffer
 134 #ifdef WITH_STL
 135     PadDimensionsMap    fPadDimensionsMap; ///< Map between zone IDs and pad dimensions
 136 #endif
 137 #ifdef WITH_ROOT
 138     mutable PadDimensionsMap  fPadDimensionsMap; ///< Map between zone IDs and pad dimensions
 139 #endif
 140
 141     Int_t  fMaxIndexInX;  ///< maximum pad index in x
 142     Int_t  fMaxIndexInY;  ///< maximum pad index in y
 143
 144   ClassDef(AliMpSectorSegmentation,2)  // Segmentation
 145 };
 146
 147
 148 // inline functions
 149
 150 /// Return the sector
 151 inline const AliMpSector* AliMpSectorSegmentation::GetSector() const
 152 { return fkSector; }
 153
 154 /// Return station type
 155 inline AliMp::StationType AliMpSectorSegmentation::StationType() const
 156 { return AliMp::kStation12; }
 157
 158
 159 #endif //ALI_MP_SECTOR_SEGMENTATION_H
 160