STEER/AliReconstruction.h

   1 #ifndef ALIRECONSTRUCTION_H
   2 #define ALIRECONSTRUCTION_H
   3 /* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
   4  * See cxx source for full Copyright notice                               */
   5
   6 /* $Id$ */
   7
   8 ///////////////////////////////////////////////////////////////////////////////
   9 //                                                                           //
  10 // class for running the reconstruction                                      //
  11 // Clusters and tracks are created for all detectors and all events by       //
  12 // typing:                                                                   //
  13 //                                                                           //
  14 //   AliReconstruction rec;                                                  //
  15 //   rec.Run();                                                              //
  16 //                                                                           //
  17 ///////////////////////////////////////////////////////////////////////////////
  18
  19
  20 #include <TSelector.h>
  21 #include <TString.h>
  22 #include <TObjArray.h>
  23
  24 class AliReconstructor;
  25 class AliRunLoader;
  26 class AliRawReader;
  27 class AliLoader;
  28 class AliTracker;
  29 class AliMagF;
  30 class AliVertexer;
  31 class AliESDVertex;
  32 class AliESDEvent;
  33 class AliESDfriend;
  34 class AliVertexerTracks;
  35 class TFile;
  36 class TTree;
  37 class TList;
  38 class AliQAManager;
  39 class TMap;
  40 class AliRecoParam;
  41 class AliDetectorRecoParam;
  42 class AliRunInfo;
  43 class AliGRPObject;
  44 #include "AliQAv1.h"
  45 #include "AliEventInfo.h"
  46 #include "AliRecoParam.h"
  47
  48 class AliReconstruction: public TSelector {
  49 public:
  50   AliReconstruction(const char* gAliceFilename = "galice.root");
  51   virtual ~AliReconstruction();
  52
  53   void           SetGAliceFile(const char* fileName);
  54   void           SetInput(const char* input);
  55
  56   void           SetEquipmentIdMap(const char *mapFile) {fEquipIdMap = mapFile;};
  57   void           SetEventRange(Int_t firstEvent = 0, Int_t lastEvent = -1)
  58     {fFirstEvent = firstEvent; fLastEvent = lastEvent;};
  59   void           SetNumberOfEventsPerFile(UInt_t nEvents)
  60     {fNumberOfEventsPerFile = nEvents;};
  61   void           SetOption(const char* detector, const char* option);
  62   void           SetRecoParam(const char* detector, AliDetectorRecoParam *par);
  63
  64   void           SetRunLocalReconstruction(const char* detectors) {
  65     fRunLocalReconstruction = detectors;};
  66   void           SetRunTracking(const char* detectors) {
  67     fRunTracking = detectors;};
  68   void           SetFillESD(const char* detectors) {fFillESD = detectors;};
  69   void           SetRunReconstruction(const char* detectors) {
  70     SetRunLocalReconstruction(detectors);
  71     SetRunTracking(detectors);
  72     SetFillESD(detectors);};
  73   void           SetUseTrackingErrorsForAlignment(const char* detectors)
  74     {fUseTrackingErrorsForAlignment = detectors;};
  75   void           SetLoadAlignFromCDB(Bool_t load)  {fLoadAlignFromCDB = load;};
  76   void           SetLoadAlignData(const char* detectors)
  77     {fLoadAlignData = detectors;};
  78
  79   //*** Magnetic field setters
  80   void SetUniformFieldTracking(Bool_t flag=kTRUE){fUniformField=flag;}
  81   Bool_t SetFieldMap(Float_t l3Current=30000., Float_t diCurrent=6000.,
  82                      Float_t l3Pol=1., Float_t dipPol=1., Float_t benergy=7000.,
  83                      const Char_t* btype="pp",
  84                      const Char_t* path="$(ALICE_ROOT)/data/maps/mfchebKGI_sym.root");
  85
  86   //*** Global reconstruction flag setters
  87   void SetRunVertexFinder(Bool_t flag=kTRUE) {fRunVertexFinder=flag;};
  88   void SetRunVertexFinderTracks(Bool_t flag=kTRUE) {fRunVertexFinderTracks=flag;};
  89   void SetRunHLTTracking(Bool_t flag=kTRUE) {fRunHLTTracking=flag;};
  90   void SetRunV0Finder(Bool_t flag=kTRUE) {fRunV0Finder=flag;};
  91   void SetRunCascadeFinder(Bool_t flag=kTRUE) {fRunCascadeFinder=flag;};
  92   void SetStopOnError(Bool_t flag=kTRUE) {fStopOnError=flag;}
  93   void SetWriteAlignmentData(Bool_t flag=kTRUE){fWriteAlignmentData=flag;}
  94   void SetWriteESDfriend(Bool_t flag=kTRUE){fWriteESDfriend=flag;}
  95   void SetFillTriggerESD(Bool_t flag=kTRUE){fFillTriggerESD=flag;}
  96   void SetDiamondProfileSPD(AliESDVertex *dp) {fDiamondProfileSPD=dp;}
  97   void SetDiamondProfile(AliESDVertex *dp) {fDiamondProfile=dp;}
  98   void SetDiamondProfileTPC(AliESDVertex *dp) {fDiamondProfileTPC=dp;}
  99
 100   void SetCleanESD(Bool_t flag=kTRUE){fCleanESD=flag;}
 101   void SetUseHLTData(const char* detectors){fUseHLTData=detectors;}
 102   void SetV0DCAmax(Float_t d) {fV0DCAmax=d;}
 103   void SetV0CsPmin(Float_t d) {fV0CsPmin=d;}
 104   void SetDmax(Float_t d) {fDmax=d;}
 105   void SetZmax(Float_t z) {fZmax=z;}
 106   Float_t GetV0DCAmax() const {return fV0DCAmax;}
 107   Float_t GetV0CsPmin() const {return fV0CsPmin;}
 108   Float_t GetDmax() const {return fDmax;}
 109   Float_t GetZmax() const {return fZmax;}
 110
 111   // CDB storage activation
 112   void SetDefaultStorage(const char* uri);
 113   void SetSpecificStorage(const char* calibType, const char* uri);
 114
 115   Bool_t MisalignGeometry(const TString& detectors);
 116
 117   void           SetAlignObjArray(TObjArray *array)
 118                    {fAlignObjArray = array;
 119                    fLoadAlignFromCDB = kFALSE;}
 120
 121   virtual Int_t  Version() const {return 2;}
 122   virtual void   Begin(TTree*);
 123   virtual void   SlaveBegin(TTree*);
 124   virtual void   Init(TTree *tree);
 125   virtual Bool_t Process(Long64_t entry);
 126   virtual Bool_t ProcessEvent(Int_t iEvent);
 127   virtual void   SlaveTerminate();
 128   virtual void   Terminate();
 129   virtual Bool_t Run(const char* input = NULL);
 130   void           Abort(const char *method, EAbort what);
 131   virtual void   SetOption(const char* option) {
 132     TSelector::SetOption(option);
 133   }
 134
 135   // Trackers
 136   AliTracker* GetTracker(Int_t idx) const { return fTracker[idx]; }
 137   Bool_t      CreateTrackers(const TString& detectors);
 138   void        ImportRunLoader(AliRunLoader* rl) { fRunLoader = rl; }
 139
 140   // Quality Assurance
 141   void    SetQACycles(AliQAv1::DETECTORINDEX_t det, Int_t cycles) { fQACycles[det] = cycles ; }
 142   void    SetQAWriteExpert(AliQAv1::DETECTORINDEX_t det) { fQAWriteExpert[det] = kTRUE ; }
 143   Bool_t  SetRunQA(TString detAndAction="ALL:ALL") ;
 144   void    SetRunGlobalQA(Bool_t flag=kTRUE){fRunGlobalQA = flag;}
 145   void    SetQARefDefaultStorage(const char* uri);
 146   void    InitQA();
 147   void    MergeQA();
 148   void    SetWriteQAExpert() { fWriteQAExpertData = kTRUE ; }
 149
 150   // Plane Efficiency Evaluation
 151   void    SetRunPlaneEff(Bool_t flag=kFALSE)  {fRunPlaneEff = flag;}
 152
 153   enum {
 154     kNDetectors = 15   // number of detectors
 155   };
 156   static Int_t   GetDetIndex(const char * detector);
 157
 158 private:
 159   AliReconstruction(const AliReconstruction& rec);
 160   AliReconstruction& operator = (const AliReconstruction& rec);
 161
 162   void           InitRun(const char* input);
 163   void           InitRawReader(const char* input);
 164   void           InitCDB();
 165   Bool_t         InitGRP();
 166   void           SetCDBLock();
 167   Bool_t         SetRunNumberFromData();
 168   Bool_t         LoadCDB();
 169   Bool_t         RunLocalEventReconstruction(const TString& detectors);
 170   Bool_t         RunVertexFinder(AliESDEvent*& esd);
 171   Bool_t         RunHLTTracking(AliESDEvent*& esd);
 172   Bool_t         RunMuonTracking(AliESDEvent*& esd);
 173   Bool_t         RunSPDTrackleting(AliESDEvent*& esd);
 174   Bool_t         RunTracking(AliESDEvent*& esd);
 175   Bool_t         CleanESD(AliESDEvent *esd);
 176   Bool_t         FillESD(AliESDEvent*& esd, const TString& detectors);
 177   Bool_t         FillTriggerESD(AliESDEvent*& esd);
 178   Bool_t         FillRawEventHeaderESD(AliESDEvent*& esd);
 179
 180   Bool_t         IsSelected(TString detName, TString& detectors) const;
 181   Bool_t         InitRunLoader();
 182   AliReconstructor* GetReconstructor(Int_t iDet);
 183   AliVertexer*   CreateVertexer();
 184   void           CleanUp();
 185
 186   //==========================================//
 187   void           WriteAlignmentData(AliESDEvent* esd);
 188
 189   void           FillRawDataErrorLog(Int_t iEvent, AliESDEvent* esd);
 190
 191   //Quality Assurance
 192   void                 CheckQA() ;
 193
 194   // Plane Efficiency evaluation
 195   Bool_t  FinishPlaneEff(); //ultimate tasks related to Plane Eff. evaluation
 196   Bool_t  InitPlaneEff();   // initialize what is needed for Plane Eff. evaluation
 197
 198   Bool_t               InitAliEVE();
 199   void                 RunAliEVE();
 200
 201   Bool_t         InitRecoParams(); // init the array with the reconstruciton parameters
 202   Bool_t         GetEventInfo();   // fill the event info inside the event loop
 203
 204   const char    *MatchDetectorList(const char *detectorList, UInt_t detectorMask);
 205
 206   //*** Magnetic field map settings *******************
 207   Bool_t         fUniformField;       // uniform field tracking flag
 208
 209   //*** Global reconstruction flags *******************
 210   Bool_t         fRunVertexFinder;    // run the vertex finder
 211   Bool_t         fRunVertexFinderTracks;    // run the vertex finder with tracks
 212   Bool_t         fRunHLTTracking;     // run the HLT tracking
 213   Bool_t         fRunMuonTracking;    // run the HLT tracking
 214   Bool_t         fRunV0Finder;        // run the ESD V0 finder
 215   Bool_t         fRunCascadeFinder;   // run the ESD cascade finder
 216   Bool_t         fStopOnError;        // stop or continue on errors
 217   Bool_t         fWriteAlignmentData; // write track space-points flag
 218   Bool_t         fWriteESDfriend;     // write ESD friend flag
 219   Bool_t         fFillTriggerESD;     // fill trigger info into ESD
 220
 221   //*** Clean ESD flag and parameters *******************
 222   Bool_t         fCleanESD;      // clean ESD flag
 223   Float_t        fV0DCAmax;      // max. allowed DCA between V0 daugthers
 224   Float_t        fV0CsPmin;      // min. allowed cosine of V0 pointing angle
 225   Float_t        fDmax;          // max. allowed transverse impact parameter
 226   Float_t        fZmax;          // max. allowed longitudinal impact parameter
 227
 228   TString        fRunLocalReconstruction; // run the local reconstruction for these detectors
 229   TString        fRunTracking;        // run the tracking for these detectors
 230   TString        fFillESD;            // fill ESD for these detectors
 231   TString        fLoadCDB;            // prefetch CDB entries and init reco-params for these detectors
 232   TString        fUseTrackingErrorsForAlignment; // for these detectors
 233   TString        fGAliceFileName;     // name of the galice file
 234   TString        fRawInput;           // name of input raw-data file or directory
 235   TString        fEquipIdMap;         // name of file with equipment id map
 236   Int_t          fFirstEvent;         // index of first event to be reconstr.
 237   Int_t          fLastEvent;          // index of last event to be reconstr.
 238   UInt_t         fNumberOfEventsPerFile; // number of events per file in case of raw-data reconstruction
 239   TObjArray      fOptions;            // options for reconstructor objects
 240   Bool_t         fLoadAlignFromCDB;   // Load alignment data from CDB and apply it to geometry or not
 241   TString        fLoadAlignData;      // Load alignment data from CDB for these detectors
 242   TString        fUseHLTData;        // Detectors for which the HLT data is used as input
 243   AliRunInfo*    fRunInfo;            // an object which contains essential global conditions information
 244   AliEventInfo   fEventInfo;          // an object which contains essential event information
 245
 246   AliRunLoader*  fRunLoader;          //! current run loader object
 247   AliRawReader*  fRawReader;          //! current raw data reader
 248   AliRawReader*  fParentRawReader;    //! parent raw data reader in case of AliRawReaderHLT
 249
 250   static const char* fgkDetectorName[kNDetectors]; //! names of detectors
 251   AliReconstructor*  fReconstructor[kNDetectors];  //! array of reconstructor objects
 252   AliRecoParam   fRecoParam;                      // container for the reco-param objects for detectors
 253   AliLoader*     fLoader[kNDetectors];   //! detector loaders
 254   AliTracker*    fTracker[kNDetectors];  //! trackers
 255   AliTracker*    fSPDTrackleter;           //! trackleter [for SPD Plane Efficiency purposes]
 256   AliESDVertex*  fDiamondProfileSPD;       // (x,y) diamond profile from SPD for AliITSVertexer3D(Z)
 257   AliESDVertex*  fDiamondProfile;          // (x,y) diamond profile for AliVertexerTracks (ITS+TPC)
 258   AliESDVertex*  fDiamondProfileTPC;       // (x,y) diamond profile from TPC for AliVertexerTracks
 259
 260   AliGRPObject*  fGRPData;              // Data from the GRP/GRP/Data CDB folder
 261
 262   TObjArray*     fAlignObjArray;      //! array with the alignment objects to be applied to the geometry
 263
 264   TString        fCDBUri;             //! Uri of the default CDB storage
 265   TString        fQARefUri;         //! Uri of the default QA reference storage
 266   TObjArray      fSpecCDBUri;         //! Array with detector specific CDB storages
 267   Bool_t         fInitCDBCalled;               //! flag to check if CDB storages are already initialized
 268   Bool_t         fSetRunNumberFromDataCalled;  //! flag to check if run number is already loaded from run loader
 269
 270   //Quality Assurance
 271   Int_t  fQACycles[     AliQAv1::kNDET];  // # events over which QA data are accumulated
 272   Bool_t fQAWriteExpert[AliQAv1::kNDET];  // Flag to save or not expert QA data
 273   TString               fQADetectors ;  // list of detectors to be QA'ed
 274   AliQAManager * fQAManager    ;   //! steering class to run QA
 275   TString               fQATasks ;      // list of QA tasks to be performed
 276   Bool_t                fRunQA ;        // Run QA flag
 277   Bool_t                fRunGlobalQA;   // Run global QA flag
 278   Bool_t                fSameQACycle;   //! open a new QA data file or not
 279   Bool_t                fInitQACalled;  //! control of QA intialisation
 280   Bool_t                fWriteQAExpertData ; //! decides wheter or not to write experts QA data; true by default
 281
 282   // Plane Efficiency Evaluation
 283   Bool_t         fRunPlaneEff ;      // Evaluate Plane Efficiency
 284
 285   // New members needed in order to split Run method
 286   // into InitRun,RunEvent,FinishRun methods
 287   AliESDEvent*         fesd;        //! Pointer to the ESD event object
 288   AliESDEvent*         fhltesd;     //! Pointer to the HLT ESD event object
 289   AliESDfriend*        fesdf;       //! Pointer to the ESD friend object
 290   TFile*               ffile;       //! Pointer to the ESD file
 291   TTree*               ftree;       //! Pointer to the ESD tree
 292   TTree*               fhlttree;    //! Pointer to the HLT ESD tree
 293   AliVertexerTracks*   ftVertexer;  //! Pointer to the vertexer based on ESD tracks
 294   Bool_t               fIsNewRunLoader; // galice.root created from scratch (real raw data case)
 295   Bool_t               fRunAliEVE;  // Run AliEVE or not
 296
 297   TTree*              fChain;      //! The raw-data chain in case of AliRawReaderChain
 298
 299   ClassDef(AliReconstruction, 31)      // class for running the reconstruction
 300 };
 301
 302 #endif