STEER/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: AliReconstruction.h 63911 2013-08-19 16:46:41Z hristov $ */
   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 AliTrackleter;
  32 class AliESDVertex;
  33 class AliESDEvent;
  34 class AliESDfriend;
  35 class AliESDpid;
  36 class AliVertexerTracks;
  37 class TFile;
  38 class TTree;
  39 class TList;
  40 class AliQAManager;
  41 class TMap;
  42 class AliRecoParam;
  43 class AliDetectorRecoParam;
  44 class AliRunInfo;
  45 class AliGRPObject;
  46 class THashTable;
  47 class AliTriggerRunScalers;
  48 class AliCTPTimeParams;
  49 class AliAnalysisManager;
  50 class AliRecoInputHandler;
  51
  52 #include "AliQAv1.h"
  53 #include "AliEventInfo.h"
  54 #include "AliRecoParam.h"
  55
  56 using std::ofstream;
  57
  58 class AliReconstruction: public TSelector {
  59 public:
  60   AliReconstruction(const char* gAliceFilename = "galice.root");
  61   virtual ~AliReconstruction();
  62
  63   void           SetGAliceFile(const char* fileName);
  64   void           SetInput(const char* input);
  65   void           SetOutput(const char* output);
  66
  67   void           SetEquipmentIdMap(const char *mapFile) {fEquipIdMap = mapFile;};
  68   void           SetEventRange(Int_t firstEvent = 0, Int_t lastEvent = -1)
  69     {fFirstEvent = firstEvent; fLastEvent = lastEvent;};
  70   void           SetNumberOfEventsPerFile(UInt_t nEvents)
  71     {fNumberOfEventsPerFile = nEvents;};
  72   void           SetFractionFriends(Double32_t frac = 0.04)
  73     {fFractionFriends = frac;};
  74   void           SetOption(const char* detector, const char* option);
  75   void           SetRecoParam(const char* detector, AliDetectorRecoParam *par);
  76
  77   void           SetRunLocalReconstruction(const char* detectors) {
  78     fRunLocalReconstruction = detectors;};
  79   void           SetRunTracking(const char* detectors) {
  80     fRunTracking = detectors;};
  81   void           SetFillESD(const char* detectors) {fFillESD = detectors;};
  82   void           SetRunReconstruction(const char* detectors) {
  83     SetRunLocalReconstruction(detectors);
  84     SetRunTracking(detectors);
  85     SetFillESD(detectors);};
  86   void           SetDeleteRecPoints(const char* dets) {fDeleteRecPoints = dets;}
  87   void           SetDeleteDigits(const char* dets)    {fDeleteDigits = dets;}
  88   void           SetUseTrackingErrorsForAlignment(const char* detectors)
  89     {fUseTrackingErrorsForAlignment = detectors;};
  90   void           SetLoadAlignFromCDB(Bool_t load)  {fLoadAlignFromCDB = load;};
  91   void           SetLoadAlignData(const char* detectors)
  92     {fLoadAlignData = detectors;};
  93
  94   void           SetTreeBuffSize(Long64_t sz=30000000) {fTreeBuffSize = sz;}
  95   //*** Global reconstruction flag setters
  96   void SetRunMultFinder(Bool_t flag=kTRUE) {fRunMultFinder=flag;};
  97   void SetRunVertexFinder(Bool_t flag=kTRUE) {fRunVertexFinder=flag;};
  98   void SetRunVertexFinderTracks(Bool_t flag=kTRUE) {fRunVertexFinderTracks=flag;};
  99   void SetRunV0Finder(Bool_t flag=kTRUE) {fRunV0Finder=flag;};
 100   void SetRunCascadeFinder(Bool_t flag=kTRUE) {fRunCascadeFinder=flag;};
 101   void SetStopOnError(Bool_t flag=kTRUE) {fStopOnError=flag;}
 102   void SetStopOnMissingTriggerFile(Bool_t flag=kTRUE) {fStopOnMissingTriggerFile=flag;}
 103   void SetWriteAlignmentData(Bool_t flag=kTRUE){fWriteAlignmentData=flag;}
 104   void SetWriteESDfriend(Bool_t flag=kTRUE){fWriteESDfriend=flag;}
 105   void SetFillTriggerESD(Bool_t flag=kTRUE){fFillTriggerESD=flag;}
 106   void SetDiamondProfileSPD(AliESDVertex *dp) {fDiamondProfileSPD=dp;}
 107   void SetDiamondProfile(AliESDVertex *dp) {fDiamondProfile=dp;}
 108   void SetDiamondProfileTPC(AliESDVertex *dp) {fDiamondProfileTPC=dp;}
 109
 110   void SetCleanESD(Bool_t flag=kTRUE){fCleanESD=flag;}
 111   void SetUseHLTData(const char* detectors){fUseHLTData=detectors;}
 112   void SetV0DCAmax(Float_t d) {fV0DCAmax=d;}
 113   void SetV0CsPmin(Float_t d) {fV0CsPmin=d;}
 114   void SetDmax(Float_t d) {fDmax=d;}
 115   void SetZmax(Float_t z) {fZmax=z;}
 116   Float_t GetV0DCAmax() const {return fV0DCAmax;}
 117   Float_t GetV0CsPmin() const {return fV0CsPmin;}
 118   Float_t GetDmax() const {return fDmax;}
 119   Float_t GetZmax() const {return fZmax;}
 120
 121   Bool_t HasNextEventAfter(Int_t eventId);
 122
 123   //
 124   Bool_t  IsRunMultFinder()   const {return fRunMultFinder;}
 125
 126   // CDB storage activation
 127   void SetDefaultStorage(const char* uri);
 128   void SetSpecificStorage(const char* calibType, const char* uri);
 129   void SetCDBSnapshotMode(const char* snapshotFileName);
 130   void AddCheckRecoCDBvsSimuCDB(const char* cdbpath,const char* comment="");
 131   void RemCheckRecoCDBvsSimuCDB(const char* cdbpath);
 132   void ResetCheckRecoCDBvsSimuCDB() {fCheckRecoCDBvsSimuCDB.Delete();}
 133   void RectifyCDBurl(TString& url);
 134   const TObjArray* GetCheckRecoCDBvsSimuCDB() const {return &fCheckRecoCDBvsSimuCDB;}
 135   void CheckRecoCDBvsSimuCDB();
 136   Bool_t MisalignGeometry(const TString& detectors);
 137
 138   void           SetAlignObjArray(TObjArray *array)
 139                    {fAlignObjArray = array;
 140                    fLoadAlignFromCDB = kFALSE;}
 141
 142   virtual Int_t  Version() const {return 2;}
 143   virtual void   Begin(TTree*);
 144   virtual void   SlaveBegin(TTree*);
 145   virtual void   Init(TTree *tree);
 146   virtual Bool_t Process(Long64_t entry);
 147   virtual Bool_t ProcessEvent(Int_t iEvent);
 148   virtual void   SlaveTerminate();
 149   virtual void   Terminate();
 150   virtual Bool_t Run(const char* input = NULL);
 151   void           Abort(const char *method, EAbort what);
 152   virtual void   SetOption(const char* option) {
 153     TSelector::SetOption(option);
 154   }
 155
 156   // Trackers
 157   AliTracker* GetTracker(Int_t idx) const { return fTracker[idx]; }
 158   Bool_t      CreateTrackers(const TString& detectors);
 159   void        ImportRunLoader(AliRunLoader* rl) { fRunLoader = rl; }
 160
 161   // Quality Assurance
 162   void    SetQACycles(AliQAv1::DETECTORINDEX_t det, Int_t cycles) { fQACycles[det] = cycles ; }
 163   void    SetQAWriteExpert(AliQAv1::DETECTORINDEX_t det) { fQAWriteExpert[det] = kTRUE ; }
 164   Bool_t  SetRunQA(TString detAndAction="ALL:ALL") ;
 165   void    SetRunGlobalQA(Bool_t flag=kTRUE){fRunGlobalQA = flag;}
 166   void    SetQARefDefaultStorage(const char* uri);
 167   void    InitQA();
 168   void    MergeQA(const char *fileName = NULL);
 169   void    SetWriteQAExpert() { fWriteQAExpertData = kTRUE ; }
 170   Bool_t  IsRunQA() const { return fRunQA ; }
 171   Bool_t  IsRunGlobalQA() const { return fRunGlobalQA ; }
 172   Bool_t  IsInTasks(AliQAv1::TASKINDEX_t tsk) { return fQATasks.Contains(Form("%d", tsk)) ; }
 173
 174   // Plane Efficiency Evaluation
 175   void    SetRunPlaneEff(Bool_t flag=kFALSE)  {fRunPlaneEff = flag;}
 176
 177   enum {
 178     kNDetectors = 18   // number of detectors    + AD +FIT //alla
 179   };
 180   static Int_t   GetDetIndex(const char * detector);
 181   static const char** GetDetectorNames() { return fgkDetectorName; }
 182
 183   // Upgrade
 184  void SetUpgradeModule(const char* detectors)  {fUpgradeModule = detectors; MatchUpgradeDetector() ; }
 185  void MatchUpgradeDetector();
 186
 187   // Connection to analysis manager.
 188   // If a macro is set it should contain a function returning an analysis
 189   // manager object. The macro is ignored in case the analysis manager is
 190   // set via SetAnalysisManager
 191   void        SetAnalysisMacro(const char *macropath) {fAnalysisMacro = macropath;}
 192   const char *GetAnalysisMacro() const {return fAnalysisMacro.Data();}
 193   void        SetAnalysisManager(AliAnalysisManager *mgr) {fAnalysis = mgr;}
 194   AliAnalysisManager *GetAnalysisManager() const {return fAnalysis;}
 195
 196   // A method to declare defined trigger classes even if they are not
 197   // present in the run, needed for proper event selection based on trigger
 198   void        DeclareTriggerClasses(const char *trClasses) {fDeclTriggerClasses = trClasses;}
 199   //
 200   //
 201   void                                   CleanProcessedEvent();
 202
 203   AliESDEvent* GetESDEvent() const { return fesd; }
 204   AliESDfriend* GetESDfriend() const { return fesdf; }
 205   AliRunLoader* GetRunLoader() const { return fRunLoader;}
 206   AliRawReader* GetRawReader() const { return fRawReader; }
 207
 208   Bool_t       HasEnoughResources(int ev);
 209   void         SetStopOnResourcesExcess(int vRSS=3000,int vVMEM=4000);
 210   //
 211   //
 212   virtual Bool_t ProcessEvent(void* event);
 213   void           InitRun(const char* input);
 214
 215 protected:
 216   // Functions needed to select events for which we store the ESD friends
 217   Bool_t IsHighPt() const;
 218   Bool_t IsCosmicOrCalibSpecie() const;
 219   void WriteESDfriend();
 220
 221 private:
 222   AliReconstruction(const AliReconstruction& rec);
 223   AliReconstruction& operator = (const AliReconstruction& rec);
 224
 225   void           InitRawReader(const char* input);
 226   void           InitCDB();
 227   Bool_t         InitGRP();
 228   void           SetCDBLock();
 229   Bool_t         SetRunNumberFromData();
 230   Bool_t         LoadCDB();
 231   Bool_t         LoadTriggerScalersCDB();
 232   Bool_t         LoadCTPTimeParamsCDB();
 233   Bool_t         ReadIntensityInfoCDB();
 234   Bool_t         RunLocalEventReconstruction(const TString& detectors);
 235   Bool_t         RunVertexFinder(AliESDEvent*& esd);
 236   Bool_t         RunMuonTracking(AliESDEvent*& esd);
 237   Bool_t         RunMFTTrackingMU(AliESDEvent*& esd);      // AU
 238   Bool_t         RunSPDTrackleting(AliESDEvent*& esd);
 239   Bool_t         RunMultFinder(AliESDEvent*& esd);
 240   Bool_t         RunTracking(AliESDEvent*& esd, AliESDpid &PID);
 241   Bool_t         CleanESD(AliESDEvent *esd);
 242   Bool_t         FillESD(AliESDEvent*& esd, const TString& detectors);
 243   Bool_t         FillTriggerESD(AliESDEvent*& esd);
 244   Bool_t         FillTriggerScalers(AliESDEvent*& esd);
 245   Bool_t         FillRawEventHeaderESD(AliESDEvent*& esd);
 246   void           DeleteRecPoints(const TString& detectors);
 247   void           DeleteDigits(const TString& detectors);
 248
 249   Bool_t         IsSelected(TString detName, TString& detectors) const;
 250   Bool_t         InitRunLoader();
 251   AliReconstructor* GetReconstructor(Int_t iDet);
 252   AliVertexer*   CreateVertexer();
 253   AliTrackleter* CreateMultFinder();
 254   void           CleanUp();
 255
 256   Bool_t         ParseOutput();
 257
 258   //==========================================//
 259   void           WriteAlignmentData(AliESDEvent* esd);
 260
 261   void           FillRawDataErrorLog(Int_t iEvent, AliESDEvent* esd);
 262
 263   //Quality Assurance
 264   //  void                 CheckQA() ;
 265
 266   // Plane Efficiency evaluation
 267   Bool_t  FinishPlaneEff(); //ultimate tasks related to Plane Eff. evaluation
 268   Bool_t  InitPlaneEff();   // initialize what is needed for Plane Eff. evaluation
 269
 270   Bool_t               InitAliEVE();
 271   void                 RunAliEVE();
 272
 273   Bool_t         InitRecoParams(); // init the array with the reconstruciton parameters
 274   Bool_t         GetEventInfo();   // fill the event info inside the event loop
 275
 276   const char    *MatchDetectorList(const char *detectorList, UInt_t detectorMask);
 277
 278   //*** Global reconstruction flags *******************
 279   Bool_t         fRunVertexFinder;    // run the vertex finder
 280   Bool_t         fRunVertexFinderTracks;    // run the vertex finder with tracks
 281   Bool_t         fRunMuonTracking;    // run the MUON tracking
 282   Bool_t         fRunMFTTrackingMU;   // run the MFT+MUON tracking      // AU
 283   Bool_t         fRunV0Finder;        // run the ESD V0 finder
 284   Bool_t         fRunCascadeFinder;   // run the ESD cascade finder
 285   Bool_t         fRunMultFinder;      // run the trackleter for ITS clusters
 286   Bool_t         fStopOnError;        // stop or continue on errors
 287   Bool_t         fStopOnMissingTriggerFile; // stop if the simulated trigger file is absent
 288   Bool_t         fWriteAlignmentData; // write track space-points flag
 289   Bool_t         fWriteESDfriend;     // write ESD friend flag
 290   Bool_t         fFillTriggerESD;     // fill trigger info into ESD
 291
 292   //*** Clean ESD flag and parameters *******************
 293   Bool_t         fCleanESD;      // clean ESD flag
 294   Float_t        fV0DCAmax;      // max. allowed DCA between V0 daugthers
 295   Float_t        fV0CsPmin;      // min. allowed cosine of V0 pointing angle
 296   Float_t        fDmax;          // max. allowed transverse impact parameter
 297   Float_t        fZmax;          // max. allowed longitudinal impact parameter
 298
 299   TString        fRunLocalReconstruction; // run the local reconstruction for these detectors
 300   TString        fRunTracking;        // run the tracking for these detectors
 301   TString        fFillESD;            // fill ESD for these detectors
 302   TString        fDeleteRecPoints;    // delete recpoints after each event
 303   TString        fDeleteDigits;       // delete digits after each event
 304   TString        fLoadCDB;            // prefetch CDB entries and init reco-params for these detectors
 305   TString        fUseTrackingErrorsForAlignment; // for these detectors
 306   TString        fGAliceFileName;     // name of the galice file
 307   TString        fRawInput;           // name of input raw-data file or directory
 308   TString        fESDOutput;          //! name of output ESD file
 309   TString        fProofOutputFileName;//! name of output file in PROOF mode
 310   TString        fProofOutputLocation;//! output location in PROOF mode
 311   Bool_t         fProofOutputDataset; //! keep output file in PROOF mode in dataset or merge
 312   TString        fProofOutputArchive; //! list of file to be kept in output zip archive in PROOF mode
 313   TString        fEquipIdMap;         // name of file with equipment id map
 314   Int_t          fFirstEvent;         // index of first event to be reconstr.
 315   Int_t          fLastEvent;          // index of last event to be reconstr.
 316   UInt_t         fNumberOfEventsPerFile; // number of events per file in case of raw-data reconstruction
 317   Double32_t     fFractionFriends; // fraction of ESD friends to be stored
 318   TObjArray      fOptions;            // options for reconstructor objects
 319   Bool_t         fLoadAlignFromCDB;   // Load alignment data from CDB and apply it to geometry or not
 320   TString        fLoadAlignData;      // Load alignment data from CDB for these detectors
 321   TString        fUseHLTData;        // Detectors for which the HLT data is used as input
 322   AliRunInfo*    fRunInfo;            // an object which contains essential global conditions information
 323   AliEventInfo   fEventInfo;          // an object which contains essential event information
 324   AliTriggerRunScalers* fRunScalers;  // an object which contains the trigger counters for xsection
 325   AliCTPTimeParams* fCTPTimeParams;   // an object which contains the trigger delays
 326   AliCTPTimeParams* fCTPTimeAlign;    // an object which contains the CTP (mis)alignment data
 327   AliRunLoader*  fRunLoader;          //! current run loader object
 328   AliRawReader*  fRawReader;          //! current raw data reader
 329   AliRawReader*  fParentRawReader;    //! parent raw data reader in case of AliRawReaderHLT
 330
 331   static const char* fgkDetectorName[kNDetectors]; //! names of detectors
 332   AliReconstructor*  fReconstructor[kNDetectors];  //! array of reconstructor objects
 333   AliRecoParam   fRecoParam;                      // container for the reco-param objects for detectors
 334   AliLoader*     fLoader[kNDetectors];   //! detector loaders
 335   AliTracker*    fTracker[kNDetectors];  //! trackers
 336   AliTracker*    fSPDTrackleter;           //! trackleter [for SPD Plane Efficiency purposes]
 337   AliESDVertex*  fDiamondProfileSPD;       // (x,y) diamond profile from SPD for AliITSVertexer3D(Z)
 338   AliESDVertex*  fDiamondProfile;          // (x,y) diamond profile for AliVertexerTracks (ITS+TPC)
 339   AliESDVertex*  fDiamondProfileTPC;       // (x,y) diamond profile from TPC for AliVertexerTracks
 340   THashTable*    fListOfCosmicTriggers;    // list of cosmic triggers as defined by trigger coordination
 341
 342   AliGRPObject*  fGRPData;              // Data from the GRP/GRP/Data CDB folder
 343
 344   TObjArray*     fAlignObjArray;      //! array with the alignment objects to be applied to the geometry
 345
 346   TString        fCDBUri;             //! Uri of the default CDB storage
 347   TString        fQARefUri;         //! Uri of the default QA reference storage
 348   TObjArray      fSpecCDBUri;         //! Array with detector specific CDB storages
 349   TObjArray      fCheckRecoCDBvsSimuCDB; // Array for CDB items which must be the same in the sim and rec
 350   Bool_t         fInitCDBCalled;               //! flag to check if CDB storages are already initialized
 351   Bool_t         fCDBSnapshotMode;             //! flag true if we are setting the CDB Manager in snapshot mode
 352   Bool_t         fSetRunNumberFromDataCalled;  //! flag to check if run number is already loaded from run loader
 353
 354   //Quality Assurance
 355   Int_t  fQACycles[     AliQAv1::kNDET];  // # events over which QA data are accumulated
 356   Bool_t fQAWriteExpert[AliQAv1::kNDET];  // Flag to save or not expert QA data
 357   TString               fQADetectors ;  // list of detectors to be QA'ed
 358   TString               fQATasks ;      // list of QA tasks to be performed
 359   Bool_t                fRunQA ;        // Run QA flag
 360   Bool_t                fRunGlobalQA;   // Run global QA flag
 361   Bool_t                fSameQACycle;   //! open a new QA data file or not
 362   Bool_t                fInitQACalled;  //! control of QA intialisation
 363   Bool_t                fWriteQAExpertData ; //! decides wheter or not to write experts QA data; true by default
 364
 365   // Plane Efficiency Evaluation
 366   Bool_t         fRunPlaneEff ;      // Evaluate Plane Efficiency
 367
 368   // PID
 369   AliESDpid*     fESDpid;                      // PID object
 370
 371   // New members needed in order to split Run method
 372   // into InitRun,RunEvent,FinishRun methods
 373   AliESDEvent*         fesd;        //! Pointer to the ESD event object
 374   AliESDEvent*         fhltesd;     //! Pointer to the HLT ESD event object
 375   AliESDfriend*        fesdf;       //! Pointer to the ESD friend object
 376   TFile*               ffile;       //! Pointer to the ESD file
 377   TFile*               ffileF;      //! Pointer to the ESD friend file
 378   TTree*               ftree;       //! Pointer to the ESD tree
 379   TTree*               ftreeF;      //! Pointer to the ESD friend tree
 380   TTree*               fhlttree;    //! Pointer to the HLT ESD tree
 381   AliVertexerTracks*   ftVertexer;  //! Pointer to the vertexer based on ESD tracks
 382   Bool_t               fIsNewRunLoader; // galice.root created from scratch (real raw data case)
 383   Bool_t               fRunAliEVE;  // Run AliEVE or not
 384   Double_t             fBeamInt[2][2]; //! mean beam intensities from AliLHCData
 385
 386   TTree*              fChain;      //! The raw-data chain in case of AliRawReaderChain
 387
 388   // Counters used in WriteESDfriend()
 389   Int_t fNall;    //! Number of reconstructed events
 390   Int_t fNspecie; //! Number of events, selected by IsCosmicOrCalibSpecie
 391   Int_t fSspecie; //! Number of events, sampled from fNspecie
 392   Int_t fNhighPt; //! Number of events, selected by IsHighPt
 393   Int_t fShighPt; //! Number of events, sampled from fNhighPt
 394
 395   // Counters for SetAutoFlush configuration
 396   Long64_t fTreeBuffSize;   //  allowed uncompressed buffer size per tree
 397   Long64_t fMemCountESD;    //! accumulated ESD size before AutoSave
 398   Long64_t fMemCountESDF;   //! accumulated ESD size before AutoSave
 399   Long64_t fMemCountESDHLT; //! accumulated ESD size before AutoSave
 400   //
 401   // Upgrade detector reconstruction
 402   TString fUpgradeModule;
 403   Bool_t  fUpgradeMask[kNDetectors];
 404   // Connect an analysis manager in the event loop
 405   TString              fAnalysisMacro; // Full path to a macro creating an analysis manager train
 406   AliAnalysisManager  *fAnalysis;      //! Analysis manager
 407   AliRecoInputHandler *fRecoHandler;   //! Input handler adapted for reconstruction
 408   TString              fDeclTriggerClasses; // Declared defined trigger classes
 409   //
 410   Bool_t               fStopped;        //  flag that reco is stopped due to the limited resources
 411   Int_t                fMaxRSS;         //  max RSS memory, MB
 412   Int_t                fMaxVMEM;        //  max VMEM memory, MB
 413   static const char*   fgkStopEvFName;  //  filename for stop.event stamp
 414   //
 415   ClassDef(AliReconstruction, 49)      // class for running the reconstruction
 416 };
 417
 418 #endif