Adding comment lines to class description needed for Root documentation,

[u/mrichter/AliRoot.git] / MUON / mapping / AliMpVSegmentation.cxx

diff --git a/MUON/mapping/AliMpVSegmentation.cxx b/MUON/mapping/AliMpVSegmentation.cxx
index 37cc74e0004f37060a6dd071e55612de01e4fd9a..f064896efe58042b4c4ed195448c39aa0740c77d 100644 (file)
--- a/MUON/mapping/AliMpVSegmentation.cxx
+++ b/MUON/mapping/AliMpVSegmentation.cxx
@@ -16,7 +16,8 @@
 // $Id$
 // $MpId: AliMpVSegmentation.cxx,v 1.5 2006/05/24 13:58:29 ivana Exp $
 // Category: basic
-//
+
+//-----------------------------------------------------------------------------
 // Class AliMpVSegmentation
 // ------------------------
 // The abstract base class for the segmentation.
@@ -26,10 +27,19 @@
 //
 // Included in AliRoot: 2003/05/02
 // Authors: David Guez, Ivana Hrivnacova; IPN Orsay
+//         Laurent Aphecetche, SUBATECH
+//-----------------------------------------------------------------------------
+
 
 #include "AliMpVSegmentation.h"
+#include "AliMpArea.h"
 #include "AliMpConstants.h"
 
+#include "AliLog.h"
+
+#include "TVector2.h"
+#include "TObjArray.h"
+
 /// \cond CLASSIMP
 ClassImp(AliMpVSegmentation)
 /// \endcond
@@ -47,10 +57,6 @@ AliMpVSegmentation::~AliMpVSegmentation()
 /// Destructor 
 }
 
-//
-// private methods
-//
-
 //_____________________________________________________________________________
 AliMpPadPair AliMpVSegmentation::FindPads(const TVector2& position1, 
                                           const TVector2& position2) const
@@ -66,6 +72,114 @@ AliMpPadPair AliMpVSegmentation::FindPads(const TVector2& position1,
   return AliMpPadPair(pad1, pad2);
 }  
 
+//_____________________________________________________________________________
+Int_t 
+AliMpVSegmentation::GetNeighbours(const AliMpPad& pad, 
+                                  TObjArray& neighbours,
+                                  Bool_t includeSelf,
+                                  Bool_t includeVoid) const
+{
+  /// Returns the list of neighbours of pad
+  static TVector2* testPositions(0x0);
+  static const Int_t kNofTestPositions(11);
+  static const Double_t kEpsilon(AliMpConstants::LengthTolerance()*2.0);
+  static Int_t centerIndex(-1);
+  
+  // testPositions are the positions (L,T,R,B) relative to pad's center (O)
+  // were we'll try to get a neighbouring pad, by getting a little
+  // bit outside the pad itself.
+  // Note that it's not symmetric as we assume that pad density
+  // can always decrease when going from left to right (or from bottom to top)
+  //
+  // L--T--R
+  // |     |
+  // L     |
+  // |  O  R
+  // L     |
+  // |     |
+  // L-B-B-R
+  //
+  // The order in which we actually test the positions has some importance,
+  // i.e. when using this information to compute status map later on. Here's
+  // the sequence :
+  //
+  // 4-- 5-- 6
+  // |       |
+  // 3       |
+  // |   0   7
+  // 2       |
+  // |       |
+  // 1-10- 9-8
+  
+  neighbours.Delete();
+  neighbours.SetOwner(kTRUE);
+  
+  if (!pad.IsValid()) return 0;
+  
+  if (!testPositions)
+  {
+    testPositions = new TVector2[kNofTestPositions];
+    Int_t n(0); 
+    // starting center
+    centerIndex = 0;
+    testPositions[n++] = TVector2(0,0); // O (pad center)
+    // then left column (L), starting from bottom
+    testPositions[n++] = TVector2(-1,-1); // 1
+    testPositions[n++] = TVector2(-1,-1/3.0); // 2 
+    testPositions[n++] = TVector2(-1,1/3.0); // 3
+    testPositions[n++] = TVector2(-1,1); // 4
+    // top (T)
+    testPositions[n++] = TVector2(0,1); // 5
+    // right column (R), starting from top
+    testPositions[n++] = TVector2(1,1); // 6
+    testPositions[n++] = TVector2(1,0); // 7
+    testPositions[n++] = TVector2(1,-1); // 8
+    // bottom (B), starting from right
+    testPositions[n++] = TVector2(1/3.0,-1); // 9 
+    testPositions[n++] = TVector2(-1/3.0,-1); // 10
+    // pad center
+    if ( n != kNofTestPositions ) {
+      AliError("Test on number of test positions failed.");
+    }  
+  }
+  
+  Int_t n(0);
+  
+  AliMpPad previous(AliMpPad::Invalid());
+  
+  for ( Int_t i = 0; i < kNofTestPositions; ++i ) 
+  {
+    if ( i == centerIndex && !includeSelf )
+    {
+      if ( includeVoid ) 
+      {
+        previous = AliMpPad::Invalid();
+        neighbours.Add(new AliMpPad(previous));
+        ++n;
+      }
+      continue;
+    }
+    
+    TVector2 shift = testPositions[i];
+    TVector2 pos = pad.Position();
+    pos += TVector2((pad.Dimensions().X()+kEpsilon)*shift.X(),
+                    (pad.Dimensions().Y()+kEpsilon)*shift.Y());
+
+    
+    AliMpPad p = PadByPosition(pos,kFALSE);
+    
+    if ( !p.IsValid() && !includeVoid ) continue;
+    
+    if ( p != previous || !previous.IsValid() ) 
+    {
+      previous = p;
+      neighbours.Add(new AliMpPad(p));
+      ++n;
+    }
+  }
+  return n;
+}
+
 //
 // public methods
 //