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     TVector2 Dimensions() const;
 104
 105   private:
 106     /// Not implemented
 107     AliMpSectorSegmentation(const AliMpSectorSegmentation& right);
 108     /// Not implemented
 109     AliMpSectorSegmentation&  operator = (const AliMpSectorSegmentation& right);
 110
 111 #ifdef WITH_ROOT
 112     static const Double_t   fgkS1;  ///< the separators used for conversion
 113     static const Double_t   fgkS2;  ///< of TVector2 to Long_t
 114
 115     // methods
 116     Long_t    GetIndex(const TVector2& vector2) const;
 117     TVector2  GetVector(Long_t index) const;
 118 #endif
 119
 120     // methods
 121     void  FillPadDimensionsMap();
 122     AliMpMotifPosition*  FindMotifPosition(const AliMpIntPair& indices) const;
 123     virtual AliMpPad PadByXDirection(const TVector2& startPosition,
 124                                      Double_t maxX) const;
 125     virtual AliMpPad PadByYDirection(const TVector2& startPosition,
 126                                      Double_t maxY) const;
 127
 128     // data members
 129     const AliMpSector*  fkSector;   ///< Sector
 130     Bool_t              fIsOwner;   ///< Sector ownership
 131     AliMpPad*           fPadBuffer; ///< The pad buffer
 132 #ifdef WITH_STL
 133     PadDimensionsMap    fPadDimensionsMap; ///< Map between zone IDs and pad dimensions
 134 #endif
 135 #ifdef WITH_ROOT
 136     mutable PadDimensionsMap  fPadDimensionsMap; ///< Map between zone IDs and pad dimensions
 137 #endif
 138
 139     Int_t  fMaxIndexInX;  ///< maximum pad index in x
 140     Int_t  fMaxIndexInY;  ///< maximum pad index in y
 141
 142   ClassDef(AliMpSectorSegmentation,2)  // Segmentation
 143 };
 144
 145
 146 // inline functions
 147
 148 /// Return the sector
 149 inline const AliMpSector* AliMpSectorSegmentation::GetSector() const
 150 { return fkSector; }
 151
 152 #endif //ALI_MP_SECTOR_SEGMENTATION_H
 153