PWGPP/doc/comparison/userguide.tex

   1 \documentclass{elsart}
   2 \usepackage{epsfig,amsmath}
   3
   4 \begin{document}
   5
   6 \subsection{Reconstruction Performance}
   7
   8 A comparison of Monte-Carlo (MC) and reconstruction information is necessary to
   9 check the performance of the reconstruction algorithms. The PWGPP library has been started to make
  10 MC vs reconstruction comparison, to tune selection criteria (cuts) and to find the best representation
  11 of the data (observables, correlations between observables, parametrisations, etc.). The main goal is to
  12 get the best track reconstruction performance in the central barrel.
  13
  14 \subsection{PWGPP library}
  15
  16 Current implementation of PWGPP allows us to run comparison for TPC and TPC-tracks.
  17 The comparison of MC and reconstructed tracks is done in 4 steps:
  18
  19 \begin{itemize}
  20 \item[1.] Collection of MC information
  21 \item[2.] Correlation of MC and reconstruction information
  22 \item[3.] Filling of comparison objects
  23 \item[4.] Analysis of comparison objects
  24 \end{itemize}
  25
  26 In order to perform these steps the following
  27 components (classes) have been implemented in PWGPP library:
  28
  29 \begin{itemize}
  30 \item The $AliGenInfoMaker$ collects MC information stored in
  31  several simulation trees. It creates $AliMCInfo$, $AliMCKinkInfo$ and $AliMCV0Info$ objects for each MC track.
  32 \item The $AliRecInfoMaker$ correlates MC and reconstruction information (ESDs) and creates for each MC object (e.g. $AliMCInfo$) corresponding reconstruction object ($AliESDRecInfo$).
  33 \item In the third step, the comparison objects ($AliComparisonObject$)  are filled in $AliComparisonTask$ task. In this step the cuts ($AliMCInfoCuts$, $AliRecInfoCuts$) are applied. The comparison objects keep control histograms and cuts.
  34 \item Finally, the analysis of the comparison objects is done by using their own $Analyse()$
  35       functions. The result analyzed histograms can be saved for further studies.
  36 \end{itemize}
  37
  38 The advantage of such analysis scheme is that the most time consuming
  39 tasks (steps 1 and 2) can be run only once. It can be done during
  40 ESD production. Then the comparison task can be run many times (e.g. on Proof)
  41 to tune selection criteria and to find the best representation of data.
  42
  43 The basic components of the PWGPP library are: makers ($AliGenInfoMaker$, $AliRecInfoMaker$),
  44 tasks ($AliAnalysisTask$), cuts ($AliAnalysisCuts$) and comparison objects ($AliComparisonObject$).
  45
  46 The makers derive from TObject ROOT class and have functionality to collect and correlate MC and reconstruction
  47 information for ITS, TPC, TRD and TOF detectors. They can be run locally/batch. The comparison tasks derive from $AliAnalysisTask$ and must implement its virtual methods. They can be run locally/batch, on Proof and on Grid. The cut objects derive from $AliAnalysisCut$ and must implement its virtual methods. The comparison objects derive from $AliComparisonObject$ base class and must implement its virtual methods.
  48
  49 \subsection{User implementation}
  50
  51 One has to implement the following classes to run its own analysis using PWGPP library:
  52
  53 \begin{itemize}
  54 \item[1.] Implement comparison object which contains control histograms and its own cut object (ex: $PWGPP/AliComparisonDCA.h$)
  55 \item[2.] Implement (if needed) cut object which contains all cuts which will be applied while filling comparison object. It is recommended to use $IsSelected(TObject*)$ method of the cut object while applying the cuts (ex: $PWGPP/AliMCInfoCuts.h$).
  56 \end{itemize}
  57
  58 \subsection{Quick Start}
  59
  60 \begin{itemize}
  61 \item[1.] Prepare input by running $AliGenInfoMaker$ and then $AliRecInfoMaker$ makers ($PWGPP/Macros/RunMakers.C$)
  62 \item[2.] Create comparison objects
  63 \item[3.] Create cut objects and pass them to corresponding comparison objects
  64 \item[4.] Add comparison objects to comparison task \newline ($PWGPP/Macros/RunAliComparisonTask.C$)
  65 \item[5.] Run comparison analysis ($PWGPP/Macros/RunGSI.C$)
  66
  67 \end{itemize}
  68
  69 \end{document}