PWGPP/TRD/AliTRDresolution.h

   1 #ifndef ALITRDRESOLUTION_H
   2 #define ALITRDRESOLUTION_H
   3 /* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
   4  * See cxx source for full Copyright notice                               */
   5
   6 /* $Id: AliTRDresolution.h 27496 2008-07-22 08:35:45Z cblume $ */
   7
   8 ////////////////////////////////////////////////////////////////////////////
   9 //                                                                        //
  10 //  TRD Resolution performance                                            //
  11 //                                                                        //
  12 //  Authors:                                                              //
  13 //    Alexandru Bercuci <A.Bercuci@gsi.de>                                //
  14 //    Markus Fasel <M.Fasel@gsi.de>                                       //
  15 //                                                                        //
  16 ////////////////////////////////////////////////////////////////////////////
  17
  18 #ifndef ALITRDRECOTASK_H
  19 #include "AliTRDrecoTask.h"
  20 #endif
  21
  22 #ifndef Root_TNamed
  23 #include "TNamed.h"
  24 #endif
  25
  26 class TH1;
  27 class TH2;
  28 class TF1;
  29 class TGraphErrors;
  30 class TObjArray;
  31 class TDatabasePDG;
  32 class AliTRDrecoParam;
  33 class AliTRDseedV1;
  34 class AliTRDtrackInfo;
  35 class AliTrackPoint;
  36 class AliTRDresolution : public AliTRDrecoTask
  37 {
  38 public:
  39   enum ETRDresolutionSteer {
  40      kVerbose    = BIT(18) // switch verbosity
  41     ,kVisual     = BIT(19) // show partial results during processing
  42     ,kTrackRefit = BIT(20) // steer track refit
  43     ,kTrackSelect= BIT(21) // steer track selection
  44     ,kXchange    = BIT(22) // use exchange containers
  45   };
  46   enum ETRDresolutionSlots {
  47      kClToTrk    = 2
  48     ,kClToMC
  49     ,kTrkltToTrk
  50     ,kTrkltToMC
  51     ,kNSlots     = 4
  52   };
  53   enum ETRDresolutionClass {
  54      kDetector=0      // cluster - detector
  55     ,kCluster         // cluster - track
  56     ,kTracklet        // tracklet - track residuals/pulls
  57     ,kTrackIn         // tracklet - track residuals/pulls at lower TRD entrance
  58     ,kMCcluster       // cluster-mc resolution/pulls
  59     ,kMCtracklet      // tracklet-mc resolution/pulls
  60     ,kMCtrackIn       // TPC track monitor
  61     ,kMCtrack         // TRD track monitor
  62 /*    ,kTrackOut        // tracklet - track residuals/pulls at lower TRD entrance during refit
  63     ,kMCtrackOut      // TOF/HMPID track monitor*/
  64     ,kNclasses        // total number of resolution classes
  65   };
  66   enum ETRDresolutionClassProjs {
  67     kDetNproj=460      // detector projections
  68     ,kClNproj=2800     // cluster projections
  69     ,kTrkltNproj=8000  // tracklet projections
  70     ,kTrkInNproj=300   // trackIn projections
  71     ,kTrkNproj=2500    // track projections
  72     ,kMCTrkInNproj=260 // trackIn projections
  73   };
  74   enum ETRDresolutionProjs {
  75     kBC    = 0 // bunch cross
  76     ,kPhi
  77     ,kEta
  78     ,kYrez
  79     ,kPrez
  80     ,kZrez
  81     ,kSpeciesChgRC
  82     ,kPt
  83     ,kNdim  // no of dimensions in the THnSparse
  84     ,kNdimDet     = 4
  85     ,kNdimCl      = 4
  86     ,kNdimTrklt   = 4
  87     ,kNdimTrkIn   = 7
  88     ,kNbunchCross = 3  // no of classes for bunch crossing
  89     ,kNpt         = 3  // no of log bins in pt spectrum
  90     ,kNspc        = 3  // no of species e, mu+pi, K+p
  91     ,kNcharge     = 2  // no of charges
  92     ,kNpads       = 4  // no of charges
  93   };
  94
  95   AliTRDresolution();
  96   AliTRDresolution(char* name, Bool_t xchange=kTRUE);
  97   AliTRDresolution(const AliTRDresolution&);
  98   AliTRDresolution& operator=(const AliTRDresolution&);
  99   virtual ~AliTRDresolution();
 100
 101   static Bool_t   FitTrack(const Int_t np, AliTrackPoint *points, Float_t params[10]);
 102   static Bool_t   FitTracklet(const Int_t ly, const Int_t np, const AliTrackPoint *points, const Float_t trackPars[10], Float_t trackletPars[3]);
 103   void            UserCreateOutputObjects();
 104 //  Float_t GetCorrectionX(Int_t det, Int_t tb) const {return fXcorr[det][tb];}
 105   static void     GetRangeZ(TH2 *h2, Float_t &m, Float_t &M);
 106   Float_t         GetDyRange() const {return fDyRange;}
 107   Float_t         GetPtThreshold() const {return fPtThreshold;}
 108   static Int_t    GetPtBin(Float_t pt);
 109   Bool_t          GetRefFigure(Int_t ifig);
 110
 111   virtual TObjArray*  Histos();
 112 //  Bool_t  Load(const Char_t *file = "AnalysisResults.root", const Char_t *dir="TRD_Performance");
 113 //  Bool_t  LoadCorrection(const Char_t *file=NULL);
 114   void            MakeSummary();
 115   static void     MakePtSegmentation(Float_t pt0=0.5, Float_t dpt=0.002);
 116
 117   TObjArray*      Results(ETRDresolutionClass c) const  { if(!fProj) return NULL; return (TObjArray*)fProj->At(c);}
 118   void            UserExec(Option_t * opt);
 119   void            InitExchangeContainers();
 120   Bool_t          HasTrackRefit() const                 { return TestBit(kTrackRefit);}
 121   Bool_t          HasTrackSelection() const             { return TestBit(kTrackSelect);}
 122   Bool_t          IsVerbose() const                     { return TestBit(kVerbose);}
 123   Bool_t          IsVisual() const                      { return TestBit(kVisual);}
 124   Bool_t          UseBCselectTOF() const                { return fBCbinTOF>0;}
 125   Bool_t          UseBCselectFill() const               { return fBCbinFill>0;}
 126   Bool_t          UseExchangeContainers() const         { return TestBit(kXchange);}
 127   Bool_t          PostProcess();
 128
 129   TH1*            DetCluster(const TObjArray *cl=NULL);
 130   TH1*            PlotCluster(const AliTRDtrackV1 *t=NULL);
 131   TH1*            PlotTracklet(const AliTRDtrackV1 *t=NULL);
 132   TH1*            PlotTrackIn(const AliTRDtrackV1 *t=NULL);
 133 //  TH1*            PlotTrackOut(const AliTRDtrackV1 *t=NULL);
 134   TH1*            PlotMC(const AliTRDtrackV1 *t=NULL);
 135
 136   static Bool_t   Process(TH2* const /*h2*/, TGraphErrors **/*g*/, Int_t stat=100){ return Bool_t(stat);}
 137   void            SetDyRange(Float_t dy) {fDyRange = dy;}
 138   void            SetPtThreshold(Float_t pt)            { fPtThreshold = pt;}
 139   void            SetBCselectTOF(Int_t b=0)             { fBCbinTOF = b==0?2:(b<0?1:3);}
 140   void            SetBCselectFill(Int_t b=0)            { fBCbinFill = b<0||b>3499?1:b+1;}
 141   void            SetBsign(Int_t b=0)                   { fBsign = Bool_t(b);}
 142   void            SetProcesses(Bool_t det, Bool_t cl, Bool_t trklt, Bool_t trkin);
 143   void            SetDump3D(Bool_t det, Bool_t cl, Bool_t trklt, Bool_t trkin);
 144   void            SetVerbose(Bool_t v = kTRUE)          { SetBit(kVerbose, v);}
 145   void            SetVisual(Bool_t v = kTRUE)           { SetBit(kVisual, v);}
 146   void            SetTrackRefit(Bool_t v = kTRUE)       { SetBit(kTrackRefit, v);}
 147   void            SetTrackSelection(Bool_t v = kTRUE)   { SetBit(kTrackSelect, v);}
 148   void            SetUseExchangeContainers(Bool_t v = kTRUE) { SetBit(kXchange, v);}
 149
 150   void            Terminate(Option_t * opt);
 151   static Bool_t   UseTrack(const Int_t np, const AliTrackPoint *points, Float_t params[10]);
 152
 153   void        AdjustF1(TH1 *h, TF1 *f);
 154   TObjArray*  BuildMonitorContainerCluster(const char* name, Bool_t expand=kFALSE, Float_t range=-1.);
 155   TObjArray*  BuildMonitorContainerTracklet(const char* name, Bool_t expand=kFALSE);
 156   TObjArray*  BuildMonitorContainerTrack(const char* name);
 157   void        DrawSigma(TH2 *h2, const Char_t *t, Float_t m=0., Float_t M=-1., Float_t scale=1);
 158   void        GetLandauMpvFwhm(TF1 * const f, Float_t &mpv, Float_t &xm, Float_t &xM);
 159   void        GetRange(TH2 *h2, Char_t mod, Float_t *range);
 160
 161 protected:
 162   Bool_t      HasDump3DFor(ETRDresolutionClass cls) const { return TESTBIT(fSteer, 4+cls);}
 163   Bool_t      HasProcess(ETRDresolutionClass cls) const   { return TESTBIT(fSteer, cls);}
 164   Bool_t      MakeProjectionDetector();
 165   Bool_t      MakeProjectionCluster(Bool_t mc=kFALSE);
 166   Bool_t      MakeProjectionTracklet(Bool_t mc=kFALSE);
 167   Bool_t      MakeProjectionTrackIn(Bool_t mc=kFALSE);
 168   Bool_t      MakeProjectionTrack();
 169   Bool_t      Process(TH2* const /*h2*/, TF1 */*f*/, Float_t /*k*/, TGraphErrors **/*g*/) { return kTRUE;}
 170   Bool_t      Pulls(Double_t dyz[2], Double_t cc[3], Double_t tilt) const;
 171
 172   UShort_t              fSteer;           // bit map to steer internal behaviour of class
 173                                           // MakeProjection [kTrackIn kTracklet kCluster kDetector]
 174                                           // Dump3D [4+kTrackIn 4+kTracklet 4+kCluster 4+kDetector]
 175   UShort_t              fIdxFrame;        // frame counter (internal)
 176   Float_t               fPtThreshold;     // pt threshold for some performance plots
 177   Float_t               fDyRange;         // min/max dy
 178   Int_t                 fBCbinTOF;        // set/select by TOF BC index
 179   Int_t                 fBCbinFill;       // set/select by Bunch Fill index
 180   Bool_t                fBsign;           // sign of magnetic field (kFALSE[-] kTRUE[+])
 181   static Char_t const  *fgPerformanceName[kNclasses]; //! name of performance plot
 182   static Int_t const    fgkNbins[kNdim];  //! no of bins/projection
 183   static Double_t const fgkMin[kNdim];    //! low limits for projections
 184   static Double_t const fgkMax[kNdim];    //! high limits for projections
 185   static Char_t const  *fgkTitle[kNdim];  //! title of projection
 186   static Float_t        fgPtBin[25];      //! pt segmentation
 187   TObjArray            *fProj;            //! result holder - sigma values
 188   TDatabasePDG         *fDBPDG;           //! PDG database
 189
 190   // calibration containers
 191   TObjArray            *fCl;              //! cluster2track calib
 192   TObjArray            *fMCcl;            //! cluster2mc calib
 193
 194   ClassDef(AliTRDresolution, 10) // TRD tracking resolution task
 195 };
 196 #endif