CORRFW/AliCFTrackIsPrimaryCuts.h

   1 /**************************************************************************
   2  * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
   3  *                                                                        *
   4  * Author: The ALICE Off-line Project.                                    *
   5  * Contributors are mentioned in the code where appropriate.              *
   6  *                                                                        *
   7  * Permission to use, copy, modify and distribute this software and its   *
   8  * documentation strictly for non-commercial purposes is hereby granted   *
   9  * without fee, provided that the above copyright notice appears in all   *
  10  * copies and that both the copyright notice and this permission notice   *
  11  * appear in the supporting documentation. The authors make no claims     *
  12  * about the suitability of this software for any purpose. It is          *
  13  * provided "as is" without express or implied warranty.                  *
  14  **************************************************************************/
  15
  16 // The class AliCFTrackIsPrimaryCut is designed to select reconstructed tracks
  17 // with a small impact parameter and tracks which are (not) daughters of kink
  18 // decays and to provide corresponding QA histograms.
  19 // This class inherits from the Analysis' Framework abstract base class
  20 // AliAnalysisCuts and is a part of the Correction Framework.
  21 // This class acts on single, reconstructed tracks, it is applicable on
  22 // ESD and AOD data.
  23 // It mainly consists of a IsSelected function that returns a boolean.
  24 // This function checks whether the considered track passes a set of cuts:
  25 // - min. and max. distance to main vertex in transverse plane (xy)
  26 // - min. and max. longitudinal distance to main vertex (z)
  27 // - min. and max. distance to main vertex as ellpise in xy - z plane
  28 // - all above cuts on absolute values or in units of sigma (resolution)
  29 // - min. and max. distance to main vertex in units of sigma (resolution)
  30 // - max. transverse (xy) and longitudinal (z) impact parameter resolution
  31 // - require that the dca calculation doesn't fail
  32 // - accept or not accept daughter tracks of kink decays
  33 //
  34 // By default, the distance to 'vertex calculated from tracks' is used.
  35 // Optionally the SPD (tracklet based) or TPC (TPC only tracks based) vertex
  36 // can be used.
  37 // Note: the distance to the TPC-vertex is already stored in the ESD,
  38 // the distance to the SPD-vertex has to be re-calculated by propagating each
  39 // track while executing this cut.
  40 //
  41 // The cut values for these cuts are set with the corresponding set functions.
  42 // All cut classes provided by the correction framework are supposed to be
  43 // added in the Analysis Framwork's class AliAnalysisFilter and applied by
  44 // the filter via a loop.
  45 //
  46 // author: I. Kraus (Ingrid.Kraus@cern.ch)
  47 // idea taken form
  48 // AliESDtrackCuts writte by Jan Fiete Grosse-Oetringhaus and
  49 // AliRsnDaughterCut class written by A. Pulvirenti.
  50
  51 #ifndef ALICFTRACKISPRIMARYCUTS_H
  52 #define ALICFTRACKISPRIMARYCUTS_H
  53
  54 #include "AliCFCutBase.h"
  55 #include "AliAODTrack.h"
  56 #include <TH2.h>
  57 #include "AliESDtrackCuts.h"
  58 class TBits;
  59 class AliESDtrack;
  60 class AliAODTrack;
  61 class AliVEvent;
  62
  63 class AliCFTrackIsPrimaryCuts : public AliCFCutBase
  64 {
  65  public :
  66   AliCFTrackIsPrimaryCuts() ;
  67   AliCFTrackIsPrimaryCuts(Char_t* name, Char_t* title) ;
  68   AliCFTrackIsPrimaryCuts(const AliCFTrackIsPrimaryCuts& c) ;
  69   AliCFTrackIsPrimaryCuts& operator=(const AliCFTrackIsPrimaryCuts& c) ;
  70   ~AliCFTrackIsPrimaryCuts();
  71   void Copy(TObject &c) const;
  72
  73   Bool_t IsSelected(TObject* obj);
  74   Bool_t IsSelected(TList* /*list*/) {return kTRUE;}
  75
  76   // cut value setter
  77   void UseSPDvertex(Bool_t b=kFALSE);
  78   void UseTPCvertex(Bool_t b=kFALSE);
  79   void SetMinDCAToVertexXY(Float_t dist=0.)             {fMinDCAToVertexXY = dist;}
  80   void SetMinDCAToVertexZ(Float_t dist=0.)              {fMinDCAToVertexZ = dist;}
  81   void SetMaxDCAToVertexXY(Float_t dist=1e10)           {fMaxDCAToVertexXY = dist;}
  82   void SetMaxDCAToVertexZ(Float_t dist=1e10)            {fMaxDCAToVertexZ = dist;}
  83   void SetDCAToVertex2D(Bool_t b=kFALSE)                {fDCAToVertex2D = b;}
  84   void SetAbsDCAToVertex(Bool_t b=kTRUE)                {fAbsDCAToVertex = b;}
  85   void SetMinNSigmaToVertex(Double_t sigmaMin=0.)       {fNSigmaToVertexMin = sigmaMin;}
  86   void SetMaxNSigmaToVertex(Double_t sigmaMax=1.e+10)   {fNSigmaToVertexMax = sigmaMax;}
  87   void SetMaxSigmaDCAxy(Double_t sigmaMax=1.e+10)       {fSigmaDCAxy = sigmaMax;}
  88   void SetMaxSigmaDCAz(Double_t sigmaMax=1.e+10)        {fSigmaDCAz = sigmaMax;}
  89   void SetRequireSigmaToVertex(Bool_t b=kFALSE)         {fRequireSigmaToVertex=b;}
  90   void SetAcceptKinkDaughters(Bool_t b=kTRUE)           {fAcceptKinkDaughters=b;}
  91   void SetAODType(Char_t type=AliAODTrack::kUndef)      {fAODType = type;}
  92
  93   // QA histograms
  94   void DrawHistograms();
  95   void SaveHistograms(const Char_t* dir = 0);
  96   void AddQAHistograms(TList *qaList);
  97   // QA histogram setter
  98   // please use indices from the enumeration below
  99   void SetHistogramBins(Int_t index, Int_t nbins, Double_t *bins);
 100   void SetHistogramBins(Int_t index, Int_t nbins, Double_t xmin, Double_t xmax);
 101   virtual void SetRecEventInfo(const TObject* esd);
 102
 103   // indeces/counters for single selections
 104   enum {
 105     kCutNSigmaToVertex=0,       // tracks's distance to main vertex in units of sigma
 106     kCutRequireSigmaToVertex,   // calculation is successful
 107     kCutAcceptKinkDaughters,    // do (not) accept secondaries
 108     kDcaXY,                     // controll histogram: dca in xy plane
 109     kDcaZ,                      // controll histogram: dca along z axis
 110     kDcaXYnorm,                 // controll histogram: normalised dca in xy plane
 111     kDcaZnorm,                  // controll histogram: normalised dca along z axis
 112     kSigmaDcaXY,                // controll histogram: impact parameter resolution in transverse plane
 113     kSigmaDcaZ,                 // controll histogram: impact parameter resolution along z axis
 114     kCutAODType,                // cut on AliAODTrack::fType
 115     kNCuts=9,                   // number of single selections
 116     kNStepQA=2,                 // number of QA steps (before/after the cuts)
 117     kNHist=9                    // number of QA histograms
 118   };
 119
 120  private:
 121   void SelectionBitMap(TObject* obj);
 122   void GetDCA(AliESDtrack* esdTrack);
 123   void GetDCA(AliAODTrack* aodTrack);
 124   void DefineHistograms();              // books histograms and TList
 125   void Initialise();                    // sets everything to 0
 126   void FillHistograms(TObject* obj, Bool_t b);
 127                                         // Fills histograms before and after cuts
 128   AliVEvent*  fEvt;                     // pointer to event, needed for SPD vertex and DCA in AODs
 129   Bool_t   fUseSPDvertex;               // flag: calculate dca to SPD-vertex, off by default
 130   Bool_t   fUseTPCvertex;               // flag: calculate dca to TPC-vertex, off by default
 131   Double_t fMinDCAToVertexXY;           // cut value: min distance to main vertex in transverse plane
 132   Double_t fMinDCAToVertexZ;            // cut value: min longitudinal distance to main vertex
 133   Double_t fMaxDCAToVertexXY;           // cut value: max distance to main vertex in transverse plane
 134   Double_t fMaxDCAToVertexZ;            // cut value: max longitudinal distance to main vertex
 135   Bool_t   fDCAToVertex2D;              // flag: cut on ellipse in xy - z plane
 136   Bool_t   fAbsDCAToVertex;             // flag: cut on absolute values or in units of sigma
 137   Double_t fNSigmaToVertexMin;          // cut value: min distance to main vertex in units of sigma
 138   Double_t fNSigmaToVertexMax;          // cut value: max distance to main vertex in units of sigma
 139   Double_t fSigmaDCAxy;                 // cut value: impact parameter resolution in xy plane
 140   Double_t fSigmaDCAz;                  // cut value: impact parameter resolution in z direction
 141   Double_t fDCA[6];                     // impact parameters
 142   Bool_t   fRequireSigmaToVertex;       // require calculable distance to main vertex
 143   Char_t   fAODType;                    // type of AOD track (undef, primary, secondary, orphan)
 144                                         // applicable at AOD level only !
 145
 146   TH2F* fhDcaXYvsDcaZ[2];               // Histogram: dca xy vs. z
 147   Bool_t fAcceptKinkDaughters;          // accepting kink daughters
 148
 149   TH1F* fhCutStatistics;                // Histogram: statistics of what cuts the tracks did not survive
 150   TH2F* fhCutCorrelation;               // Histogram: 2d statistics plot
 151
 152   TH1F* fhQA[kNHist][kNStepQA];         // QA Histograms
 153   TBits *fBitmap ;                      // stores single selection decisions
 154
 155   // QA histogram setters
 156   Int_t fhNBinsNSigma;                  // number of bins+1: dca in units of sigma
 157   Int_t fhNBinsRequireSigma;            // number of bins+1: require successful calcuation
 158   Int_t fhNBinsAcceptKink;              // number of bins+1: acceptkink daughters
 159   Int_t fhNBinsDcaXY;                   // number of bins+1: dca in transverse plane
 160   Int_t fhNBinsDcaZ;                    // number of bins+1: dca along beam axis
 161   Int_t fhNBinsDcaXYnorm;               // number of bins+1: normalised dca in transverse plane
 162   Int_t fhNBinsDcaZnorm;                // number of bins+1: normalised dca along beam axis
 163   Int_t fhNBinsSigmaDcaXY;              // number of bins+1: impact parameter resolution in transverse plane
 164   Int_t fhNBinsSigmaDcaZ;               // number of bins+1: impact parameter resolution along beam axis
 165
 166   Double_t *fhBinLimNSigma; //[fhNBinsNSigma] bin limits: dca in units of sigma
 167   Double_t *fhBinLimRequireSigma;//[fhNBinsRequireSigma] bin limits: require successful calcuation
 168   Double_t *fhBinLimAcceptKink;//[fhNBinsAcceptKink] bin limits: acceptkink daughters
 169   Double_t *fhBinLimDcaXY;//[fhNBinsDcaXY] bin limits: dca in transverse plane
 170   Double_t *fhBinLimDcaZ; //[fhNBinsDcaZ] bin limits: dca along beam axis
 171   Double_t *fhBinLimDcaXYnorm; //[fhNBinsDcaXYnorm] bin limits: normalised dca in transverse plane
 172   Double_t *fhBinLimDcaZnorm;//[fhNBinsDcaZnorm] bin limits: normalised dca along beam axis
 173   Double_t *fhBinLimSigmaDcaXY; //[fhNBinsSigmaDcaXY] bin limits: impact parameter in transverse plane
 174   Double_t *fhBinLimSigmaDcaZ; //[fhNBinsSigmaDcaZ] bin limits: impact parameter along beam axis
 175
 176   ClassDef(AliCFTrackIsPrimaryCuts,3);
 177 };
 178
 179 #endif