Fix coverity defect
[u/mrichter/AliRoot.git] / TRD / AliTRDReconstructor.cxx
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 /* $Id$ */
17
18 ///////////////////////////////////////////////////////////////////////////////
19 //                                                                           //
20 // Class for TRD reconstruction                                              //
21 //                                                                           //   
22 // For the special options which can be used during reconstruction and their //
23 //  default values pls. see function SetOption().                            //
24 //                                                                           //
25 ///////////////////////////////////////////////////////////////////////////////
26
27 #include <TObjString.h>
28 #include <TObjArray.h>
29 #include <TTreeStream.h>
30 #include <TDirectory.h>
31
32 #include "AliRawReader.h"
33
34 #include "AliTRDReconstructor.h"
35 #include "AliTRDclusterizer.h"
36 #include "AliTRDrawData.h"
37 #include "AliTRDrawStream.h"
38 #include "AliTRDdigitsManager.h"
39 #include "AliTRDtrackerV1.h"
40
41 #define SETFLG(n,f) ((n) |= f)
42 #define CLRFLG(n,f) ((n) &= ~f)
43
44 ClassImp(AliTRDReconstructor)
45
46 TClonesArray *AliTRDReconstructor::fgClusters = NULL;
47 TClonesArray *AliTRDReconstructor::fgTracklets = NULL;
48 Char_t const * AliTRDReconstructor::fgSteerNames[kNsteer] = {
49   "DigitsConversion       "
50  ,"Write Clusters         "
51  ,"Write Online Tracklets "
52  ,"Stand Alone Tracking   "
53  ,"HLT Mode              "
54  ,"Process Online Trklts  "
55  ,"Debug Streaming       "
56  ,"Cl. Radial Correction  "
57 };
58 Char_t const * AliTRDReconstructor::fgSteerFlags[kNsteer] = {
59   "dc"// digits conversion [false]
60  ,"cw"// write clusters [true]
61  ,"tw"// write online tracklets [false]
62  ,"sa"// track seeding (stand alone tracking) [true]
63  ,"hlt"// HLT reconstruction [false]
64  ,"tp"// also use online tracklets for reconstruction [false]
65  ,"deb"// Write debug stream [false]
66  ,"cc" // Cluster radial correction during reconstruction [false]
67 };
68 Char_t const * AliTRDReconstructor::fgTaskNames[AliTRDrecoParam::kTRDreconstructionTasks] = {
69   "Clusterizer"
70  ,"Tracker"
71  ,"PID"
72 };
73 Char_t const * AliTRDReconstructor::fgTaskFlags[AliTRDrecoParam::kTRDreconstructionTasks] = {
74   "cl"
75  ,"tr"
76  ,"pd"
77 };
78 Int_t AliTRDReconstructor::fgNTimeBins = -1;
79 const  Float_t  AliTRDReconstructor::fgkMinClustersInTrack =  0.5;  //
80 const  Float_t  AliTRDReconstructor::fgkLabelFraction      =  0.8;  //
81 const  Double_t AliTRDReconstructor::fgkMaxChi2            = 12.0;  //
82 const  Double_t AliTRDReconstructor::fgkMaxSnp             =  0.95; // Maximum local sine of the azimuthal angle
83 const  Double_t AliTRDReconstructor::fgkMaxStep            =  2.0;  // Maximal step size in propagation
84 const Double_t  AliTRDReconstructor::fgkEpsilon            = 1.e-5;                  // Precision of radial coordinate
85
86 //_____________________________________________________________________________
87 AliTRDReconstructor::AliTRDReconstructor()
88   :AliReconstructor()
89   ,fSteerParam(0)
90   ,fClusterizer(NULL)
91 {
92   // setting default "ON" steering parameters
93   // owner of debug streamers 
94   SETFLG(fSteerParam, kOwner);
95   // write clusters [cw]
96   SETFLG(fSteerParam, kWriteClusters);
97   // track seeding (stand alone tracking) [sa]
98   SETFLG(fSteerParam, kSeeding);
99   // Cluster radial correction during reconstruction [cc]
100   //SETFLG(fSteerParam, kClRadialCorr);
101   memset(fDebugStream, 0, sizeof(TTreeSRedirector *) * AliTRDrecoParam::kTRDreconstructionTasks);
102 }
103
104 //_____________________________________________________________________________
105 AliTRDReconstructor::~AliTRDReconstructor()
106 {
107   //
108   // Destructor
109   //
110
111   if(fgClusters) {
112     fgClusters->Delete();
113     delete fgClusters;
114     fgClusters = NULL;
115   }
116   if(fgTracklets) {
117     fgTracklets->Delete();
118     delete fgTracklets;
119     fgTracklets = NULL;
120   }
121   if(fSteerParam&kOwner){
122     for(Int_t itask = 0; itask < AliTRDrecoParam::kTRDreconstructionTasks; itask++)
123       if(fDebugStream[itask]) delete fDebugStream[itask];
124   }
125   if(fClusterizer){
126     delete fClusterizer;
127     fClusterizer = NULL;
128   }
129 }
130
131
132 //_____________________________________________________________________________
133 void AliTRDReconstructor::Init(){
134   //
135   // Init Options
136   //
137   SetOption(GetOption());
138   Options(fSteerParam);
139
140   if(!fClusterizer){
141     fClusterizer = new AliTRDclusterizer(fgTaskNames[AliTRDrecoParam::kClusterizer], fgTaskNames[AliTRDrecoParam::kClusterizer]);
142     fClusterizer->SetReconstructor(this);
143   }
144   
145   // Make Debug Streams when Debug Streaming
146   if(IsDebugStreaming()){
147     for(Int_t task = 0; task < AliTRDrecoParam::kTRDreconstructionTasks; task++){
148       TDirectory *savedir = gDirectory;
149       fDebugStream[task] = new TTreeSRedirector(Form("TRD.Debug%s.root", fgTaskNames[task]));
150       savedir->cd();
151       SETFLG(fSteerParam, kOwner);
152     }
153   }
154 }
155
156 //_____________________________________________________________________________
157 void AliTRDReconstructor::ConvertDigits(AliRawReader *rawReader
158               , TTree *digitsTree) const
159 {
160   //
161   // Convert raw data digits into digit objects in a root tree
162   //
163
164   //AliInfo("Convert raw data digits into digit objects [RawReader -> Digit TTree]");
165
166   AliTRDrawData rawData;
167   rawReader->Reset();
168   rawReader->Select("TRD");
169   AliTRDdigitsManager *manager = rawData.Raw2Digits(rawReader);
170   manager->MakeBranch(digitsTree);
171   manager->WriteDigits();
172   delete manager;
173
174 }
175
176 //_____________________________________________________________________________
177 void AliTRDReconstructor::Reconstruct(AliRawReader *rawReader
178                                     , TTree *clusterTree) const
179 {
180   //
181   // Reconstruct clusters
182   //
183
184   //AliInfo("Reconstruct TRD clusters from RAW data [RawReader -> Cluster TTree]");
185
186
187   rawReader->Reset();
188   rawReader->Select("TRD");
189
190   if(!fClusterizer){
191     AliFatal("Clusterizer not available!");
192     return;
193   }
194
195   fClusterizer->ResetRecPoints();
196
197   fClusterizer->OpenOutput(clusterTree);
198   fClusterizer->SetUseLabels(kFALSE);
199   fClusterizer->Raw2ClustersChamber(rawReader);
200   
201   fgNTimeBins = fClusterizer->GetNTimeBins();
202   
203   if(IsWritingClusters()) return;
204
205   // take over ownership of clusters
206   fgClusters = fClusterizer->RecPoints();
207   fClusterizer->SetClustersOwner(kFALSE);
208
209   // take over ownership of online tracklets
210   fgTracklets = fClusterizer->TrackletsArray();
211   fClusterizer->SetTrackletsOwner(kFALSE);
212 }
213
214 //_____________________________________________________________________________
215 void AliTRDReconstructor::Reconstruct(TTree *digitsTree
216                                     , TTree *clusterTree) const
217 {
218   //
219   // Reconstruct clusters
220   //
221
222   //AliInfo("Reconstruct TRD clusters from Digits [Digit TTree -> Cluster TTree]");
223   
224   AliTRDclusterizer clusterer(fgTaskNames[AliTRDrecoParam::kClusterizer], fgTaskNames[AliTRDrecoParam::kClusterizer]);
225   clusterer.SetReconstructor(this);
226   clusterer.OpenOutput(clusterTree);
227   clusterer.ReadDigits(digitsTree);
228   clusterer.MakeClusters();
229
230   fgNTimeBins = clusterer.GetNTimeBins();
231
232   if(IsWritingClusters()) return;
233
234   // take over ownership of clusters
235   fgClusters = clusterer.RecPoints();
236   clusterer.SetClustersOwner(kFALSE);
237
238   // take over ownership of online tracklets
239   fgTracklets = clusterer.TrackletsArray();
240   clusterer.SetTrackletsOwner(kFALSE);
241
242 }
243
244 //_____________________________________________________________________________
245 AliTracker *AliTRDReconstructor::CreateTracker() const
246 {
247   //
248   // Create a TRD tracker
249   //
250
251   //return new AliTRDtracker(NULL);
252   AliTRDtrackerV1 *tracker = new AliTRDtrackerV1();
253   tracker->SetReconstructor(this);
254   return tracker;
255
256 }
257
258 //_____________________________________________________________________________
259 void AliTRDReconstructor::FillESD(TTree* /*digitsTree*/
260         , TTree* /*clusterTree*/
261         , AliESDEvent* /*esd*/) const
262 {
263   //
264   // Fill ESD
265   //
266
267 }
268
269 //_____________________________________________________________________________
270 void AliTRDReconstructor::SetOption(Option_t *opt)
271 {
272   //
273   // Read option string into the steer param.
274   //
275   // The following string options are available during reconstruction.
276   // In square brackets the default values are given.
277   //   "dc"  : digits conversion [false]
278   //   "cw"  : write clusters [true]
279   //   "tw"  : write online tracklets [false]
280   //   "sa"  : track seeding (stand alone tracking) [true]
281   //   "hlt" : HLT reconstruction [false]
282   //   "tp"  : also use online tracklets for reconstruction [false]
283   //   "deb" : Write debug stream [false]
284   //   "cc"  : Cluster radial correction during reconstruction [false]
285   //
286   // To check the actual options used during reconstruction include the following line in your rec.C script
287   // AliLog::SetClassDebugLevel("AliTRDReconstructor", 1);
288
289   AliReconstructor::SetOption(opt);
290
291   TString s(opt);
292   TObjArray *opar = s.Tokenize(",");
293   for(Int_t ipar=0; ipar<opar->GetEntriesFast(); ipar++){
294     Bool_t processed = kFALSE;
295     TString sopt(((TObjString*)(*opar)[ipar])->String());
296     for(Int_t iopt=0; iopt<kNsteer; iopt++){
297       if(!sopt.Contains(fgSteerFlags[iopt])) continue;
298       SETFLG(fSteerParam, BIT(iopt));
299       if(sopt.Contains("!")) CLRFLG(fSteerParam, BIT(iopt));
300       processed = kTRUE;
301       break;    
302     }
303     if(processed) continue;
304
305     AliWarning(Form("Unknown option flag %s.", sopt.Data()));
306   }
307 }
308
309 //_____________________________________________________________________________
310 void AliTRDReconstructor::Options(UInt_t steer)
311 {
312   //
313   // Print the options
314   //
315
316   for(Int_t iopt=0; iopt<kNsteer; iopt++){
317     AliDebugGeneral("AliTRDReconstructor", 1, Form(" %s[%s]%s", fgSteerNames[iopt], fgSteerFlags[iopt], steer ?(((steer>>iopt)&1)?" : ON":" : OFF"):""));
318   }
319 }
320