Coding convention
[u/mrichter/AliRoot.git] / PHOS / AliPHOSTrackSegmentMakerv1.h
index c3b84aa7b5f037f8dc287f1f28390c01f2d6a692..15a90faa356b9cc5d516530ba96c2866ba8eeeb4 100644 (file)
@@ -5,13 +5,12 @@
 
 /* $Id$ */
 
-///////////////////////////////////////////////////
-//  Track Segment Maker class for PHOS           //
-//  Version SUBATECH                             //
-//  Author Dmitri Peressounko RRC Ki             //
-//     comment: finds pairs of clusters EMC+PPSD //  
-//              performs unfolding.              //
-///////////////////////////////////////////////////
+//_________________________________________________________________________
+// Implementation version 1 of algorithm class to construct PHOS track segments
+// Associates EMC and PPSD clusters
+// Unfolds the EMC cluster   
+//                  
+//*-- Author: Dmitri Peressounko (RRC Ki & SUBATECH)
 
 // --- ROOT system ---
 
@@ -31,40 +30,65 @@ class  AliPHOSTrackSegmentMakerv1 : public AliPHOSTrackSegmentMaker {
 public:
 
   AliPHOSTrackSegmentMakerv1() ;                     
+  AliPHOSTrackSegmentMakerv1(const AliPHOSTrackSegmentMakerv1 & tsm) {
+    // cpy ctor: no implementation yet
+    // requested by the Coding Convention
+    assert(0==1) ; 
+  }
+   
   virtual ~ AliPHOSTrackSegmentMakerv1() ; // dtor
   
   Bool_t  FindFit(AliPHOSEmcRecPoint * emcRP, int * MaxAt, Float_t * maxAtEnergy, 
                  Int_t NPar, Float_t * FitParametres) ; //Used in UnfoldClusters, calls TMinuit
-
-  void    FillOneModule(DigitsList * Dl, RecPointsList * emcIn, TObjArray * emcOut, RecPointsList * ppsdIn, 
-                       TObjArray * ppsdOutUp, TObjArray * ppsdOutLow, Int_t &PHOSModule, Int_t & emcStopedAt, 
+  void    FillOneModule(DigitsList * Dl, AliPHOSRecPoint::RecPointsList * emcIn, 
+                       TObjArray * emcOut, 
+                       AliPHOSRecPoint::RecPointsList * ppsdIn, 
+                       TObjArray * ppsdOutUp, 
+                       TObjArray * ppsdOutLow, 
+                       Int_t &PHOSModule, 
+                       Int_t & emcStopedAt, 
                        Int_t & ppsdStopedAt) ; // Unfolds clusters and fills temporary arrais   
-
   Float_t GetDistanceInPHOSPlane(AliPHOSEmcRecPoint * EmcClu , AliPHOSPpsdRecPoint * Ppsd , Bool_t & TooFar ) ; // see R0
 
   void    MakeLinks(TObjArray * EmcRecPoints, TObjArray * PpsdRecPointsUp, TObjArray * PpsdRecPointsLow, 
                    TClonesArray * LinkLowArray, TClonesArray *LinkUpArray) ; //Evaluates distances(links) between EMC and PPSD
-
-  void    MakePairs(TObjArray * EmcRecPoints, TObjArray * PpsdRecPointsUp, TObjArray * PpsdRecPointsLow, 
-                   TClonesArray * LinkLowArray, TClonesArray * LinkUpArray, TrackSegmentsList * trsl) ; 
-                    //Finds pairs(triplets) with smallest link
-
-  void    MakeTrackSegments(DigitsList * DL, RecPointsList * emcl, RecPointsList * ppsdl, TrackSegmentsList * trsl ) ; // does the job
-
-  void    SetMaxEmcPpsdDistance(Float_t r){ fR0 = r ;} //Radius within which we look for ppsd cluster
-
+  void    MakePairs(TObjArray * EmcRecPoints, 
+                   TObjArray * PpsdRecPointsUp, 
+                   TObjArray * PpsdRecPointsLow, 
+                   TClonesArray * LinkLowArray, 
+                   TClonesArray * LinkUpArray, 
+                   AliPHOSTrackSegment::TrackSegmentsList * trsl) ; //Finds pairs(triplets) with smallest link
+  void    MakeTrackSegments(DigitsList * DL, 
+                           AliPHOSRecPoint::RecPointsList * emcl, 
+                           AliPHOSRecPoint::RecPointsList * ppsdl, 
+                           AliPHOSTrackSegment::TrackSegmentsList * trsl ) ; // does the job
+  virtual void SetMaxEmcPpsdDistance(Float_t r){ fR0 = r ;}
+  virtual void    SetUnfoldFlag() { fUnfoldFlag = kTRUE ; } ; 
   static Double_t ShowerShape(Double_t r) ; // Shape of shower used in unfolding; class member function (not object member function)
-
-  void    UnfoldClusters(DigitsList * DL, RecPointsList * emcIn, AliPHOSEmcRecPoint * iniEmc, Int_t Nmax, 
-                        int * maxAt, Float_t * maxAtEnergy, TObjArray * emclist) ; //Unfolds overlaping clusters using TMinuit package
+  void  UnfoldClusters(DigitsList * DL, 
+                      AliPHOSRecPoint::RecPointsList * emcIn, 
+                      AliPHOSEmcRecPoint * iniEmc, 
+                      Int_t Nmax, 
+                      int * maxAt, 
+                      Float_t * maxAtEnergy, 
+                      TObjArray * emclist) ; //Unfolds overlaping clusters using TMinuit package
+  virtual void UnsetUnfoldFlag() { fUnfoldFlag = kFALSE ; } 
+
+  AliPHOSTrackSegmentMakerv1 & operator = (const AliPHOSTrackSegmentMakerv1 & rvalue)  {
+    // assignement operator requested by coding convention
+    // but not needed
+    assert(0==1) ;
+    return *this ; 
+  }
 
 private:
 
-  Float_t fDelta ;    // parameter used for sorting
-  Float_t fR0 ;       // Maximal distance between EMC and PPSD clusters of one Track Segment in module plane
-  TMinuit * fMinuit ; // Minuit object needed by cluster unfolding
+  Float_t fDelta ;     // parameter used for sorting
+  TMinuit * fMinuit ;  // Minuit object needed by cluster unfolding
+  Float_t fR0 ;        // Maximum distance between a EMC RecPoint and a PPSD RecPoint   
+  Bool_t fUnfoldFlag ; // Directive to unfold or not the clusters in case of multiple maxima
 
-  ClassDef( AliPHOSTrackSegmentMakerv1,1)  // track segment maker implementation , version 1
+  ClassDef( AliPHOSTrackSegmentMakerv1,1)  // Implementation version 1 of algorithm class to make PHOS track segments 
 
 };