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