1 /**************************************************************************
2 * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
4 * Author: The ALICE Off-line Project. *
5 * Contributors are mentioned in the code where appropriate. *
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 **************************************************************************/
18 ///////////////////////////////////////////////////////////////////////////////
20 // Class for TRD reconstruction //
22 ///////////////////////////////////////////////////////////////////////////////
25 #include <TObjString.h>
26 #include <TObjArray.h>
27 #include <TClonesArray.h>
29 #include "AliRunLoader.h"
30 #include "AliRawReader.h"
32 #include "AliESDTrdTrack.h"
33 #include "AliESDEvent.h"
35 #include "AliTRDReconstructor.h"
36 #include "AliTRDclusterizer.h"
37 #include "AliTRDtracker.h"
38 #include "AliTRDpidESD.h"
39 #include "AliTRDrawData.h"
40 #include "AliTRDdigitsManager.h"
41 #include "AliTRDtrackerV1.h"
42 #include "AliTRDrecoParam.h"
44 #include "TTreeStream.h"
46 #define SETFLG(n,f) ((n) |= f)
47 #define CLRFLG(n,f) ((n) &= ~f)
49 ClassImp(AliTRDReconstructor)
51 TClonesArray *AliTRDReconstructor::fgClusters = 0x0;
52 TClonesArray *AliTRDReconstructor::fgTracklets = 0x0;
53 Char_t* AliTRDReconstructor::fgSteerNames[kNsteer] = {
60 ,"8 dEdx slices in ESD "
62 ,"Write Online Tracklets "
64 ,"Stand Alone Tracking "
68 ,"Cosmic Reconstruction "
69 ,"Process Online Tracklets"
71 Char_t* AliTRDReconstructor::fgSteerFlags[kNsteer] = {
72 "dc"// digits conversion [false]
73 ,"tc"// apply tail cancellation [true]
74 ,"lut"// look-up-table for cluster shape in the r-phi direction
75 ,"gs"// gauss cluster shape in the r-phi direction
76 ,"sh"// cluster sharing between tracks
77 ,"nn"// PID method in reconstruction (NN) [true]
78 ,"8s"// 8 dEdx slices in ESD [true]
79 ,"cw"// write clusters [true]
80 ,"tw"// write online tracklets [false]
81 ,"ar"// drift gas [false] - do not update the number of exponentials in the TC !
82 ,"sa"// track seeding (stand alone tracking) [true]
83 ,"vc"// vertex constrain on stand alone track finder [false]
84 ,"ti"// improve tracklets in stand alone track finder [true]
85 ,"hlt"// HLT reconstruction [false]
86 ,"cos"// Cosmic Reconstruction [false]
87 ,"tp"// also use online tracklets for reconstruction [false]
89 Char_t* AliTRDReconstructor::fgTaskNames[kNtasks] = {
95 Char_t* AliTRDReconstructor::fgTaskFlags[kNtasks] = {
102 //_____________________________________________________________________________
103 AliTRDReconstructor::AliTRDReconstructor()
107 // setting default "ON" steering parameters
108 // owner of debug streamers
109 SETFLG(fSteerParam, kOwner);
110 // write clusters [cw]
111 SETFLG(fSteerParam, kWriteClusters);
112 // track seeding (stand alone tracking) [sa]
113 SETFLG(fSteerParam, kSeeding);
114 // PID method in reconstruction (NN) [nn]
115 SETFLG(fSteerParam, kSteerPID);
116 // number of dEdx slices in the ESD track [8s]
117 SETFLG(fSteerParam, kEightSlices);
118 // vertex constrain for stand alone track finder
119 SETFLG(fSteerParam, kVertexConstrained);
120 // improve tracklets for stand alone track finder
121 SETFLG(fSteerParam, kImproveTracklet);
122 // use look up table for cluster r-phi position
123 SETFLG(fSteerParam, kLUT);
124 // use tail cancellation
125 SETFLG(fSteerParam, kTC);
127 memset(fStreamLevel, 0, kNtasks*sizeof(UChar_t));
128 memset(fDebugStream, 0, sizeof(TTreeSRedirector *) * kNtasks);
129 // Xe tail cancellation parameters
130 fTCParams[0] = 1.156; // r1
131 fTCParams[1] = 0.130; // r2
132 fTCParams[2] = 0.114; // c1
133 fTCParams[3] = 0.624; // c2
134 // Ar tail cancellation parameters
135 fTCParams[4] = 6.; // r1
136 fTCParams[5] = 0.62; // r2
137 fTCParams[6] = 0.0087;// c1
138 fTCParams[7] = 0.07; // c2
141 //_____________________________________________________________________________
142 AliTRDReconstructor::AliTRDReconstructor(const AliTRDReconstructor &r)
144 ,fSteerParam(r.fSteerParam)
146 memcpy(fStreamLevel, r.fStreamLevel, kNtasks*sizeof(UChar_t));
147 memcpy(fTCParams, r.fTCParams, 8*sizeof(Double_t));
148 memcpy(fDebugStream, r.fDebugStream, sizeof(TTreeSRedirector *) *kNtasks);
149 // ownership of debug streamers is not taken
150 CLRFLG(fSteerParam, kOwner);
153 //_____________________________________________________________________________
154 AliTRDReconstructor::~AliTRDReconstructor()
157 fgClusters->Delete(); delete fgClusters;
160 fgTracklets->Delete(); delete fgTracklets;
162 if(fSteerParam&kOwner){
163 for(Int_t itask = 0; itask < kNtasks; itask++)
164 if(fDebugStream[itask]) delete fDebugStream[itask];
169 //_____________________________________________________________________________
170 void AliTRDReconstructor::Init(){
174 SetOption(GetOption());
175 Options(fSteerParam, fStreamLevel);
178 //_____________________________________________________________________________
179 void AliTRDReconstructor::ConvertDigits(AliRawReader *rawReader
180 , TTree *digitsTree) const
183 // Convert raw data digits into digit objects in a root tree
185 AliInfo("Feature not available for the moment."); return;
187 AliInfo("Convert raw data digits into digit objects [RawReader -> Digit TTree]");
189 AliTRDrawData rawData;
191 rawReader->Select("TRD");
192 AliTRDdigitsManager *manager = rawData.Raw2Digits(rawReader);
193 manager->MakeBranch(digitsTree);
194 manager->WriteDigits();
199 //_____________________________________________________________________________
200 void AliTRDReconstructor::Reconstruct(AliRawReader *rawReader
201 , TTree *clusterTree) const
204 // Reconstruct clusters
207 //AliInfo("Reconstruct TRD clusters from RAW data [RawReader -> Cluster TTree]");
211 rawReader->Select("TRD");
213 // New (fast) cluster finder
214 AliTRDclusterizer clusterer(fgTaskNames[kClusterizer], fgTaskNames[kClusterizer]);
215 clusterer.SetReconstructor(this);
216 clusterer.OpenOutput(clusterTree);
217 clusterer.SetUseLabels(kFALSE);
218 clusterer.Raw2ClustersChamber(rawReader);
220 if(IsWritingClusters()) return;
222 // take over ownership of clusters
223 fgClusters = clusterer.RecPoints();
224 clusterer.SetClustersOwner(kFALSE);
226 // take over ownership of online tracklets
227 fgTracklets = clusterer.TrackletsArray();
228 clusterer.SetTrackletsOwner(kFALSE);
231 //_____________________________________________________________________________
232 void AliTRDReconstructor::Reconstruct(TTree *digitsTree
233 , TTree *clusterTree) const
236 // Reconstruct clusters
239 //AliInfo("Reconstruct TRD clusters from Digits [Digit TTree -> Cluster TTree]");
241 AliTRDclusterizer clusterer(fgTaskNames[kClusterizer], fgTaskNames[kClusterizer]);
242 clusterer.SetReconstructor(this);
243 clusterer.OpenOutput(clusterTree);
244 clusterer.ReadDigits(digitsTree);
245 clusterer.MakeClusters();
247 if(IsWritingClusters()) return;
249 // take over ownership of clusters
250 fgClusters = clusterer.RecPoints();
251 clusterer.SetClustersOwner(kFALSE);
253 // take over ownership of online tracklets
254 fgTracklets = clusterer.TrackletsArray();
255 clusterer.SetTrackletsOwner(kFALSE);
258 //_____________________________________________________________________________
259 AliTracker *AliTRDReconstructor::CreateTracker() const
262 // Create a TRD tracker
265 //return new AliTRDtracker(NULL);
266 AliTRDtrackerV1 *tracker = new AliTRDtrackerV1();
267 tracker->SetReconstructor(this);
272 //_____________________________________________________________________________
273 void AliTRDReconstructor::FillESD(TTree* /*digitsTree*/
274 , TTree* /*clusterTree*/
275 , AliESDEvent* /*esd*/) const
284 //_____________________________________________________________________________
285 void AliTRDReconstructor::SetOption(Option_t *opt)
287 // Read option string into the steer param.
290 AliReconstructor::SetOption(opt);
293 TObjArray *opar = s.Tokenize(",");
294 for(Int_t ipar=0; ipar<opar->GetEntriesFast(); ipar++){
295 Bool_t PROCESSED = kFALSE;
296 TString sopt(((TObjString*)(*opar)[ipar])->String());
297 for(Int_t iopt=0; iopt<kNsteer; iopt++){
298 if(!sopt.Contains(fgSteerFlags[iopt])) continue;
299 SETFLG(fSteerParam, BIT(iopt));
300 if(sopt.Contains("!")) CLRFLG(fSteerParam, BIT(iopt));
305 if(sopt.Contains("gs") && !sopt.Contains("!")){
306 CLRFLG(fSteerParam, kLUT); PROCESSED = kTRUE;
309 if(PROCESSED) continue;
311 if(sopt.Contains("sl")){
312 TObjArray *stl = sopt.Tokenize("_");
313 if(stl->GetEntriesFast() < 3) continue;
314 TString taskstr(((TObjString*)(*stl)[1])->String());
315 TString levelstring(((TObjString*)(*stl)[2])->String());
316 Int_t level = levelstring.Atoi();
318 // Set the stream Level
320 for(Int_t it=0; it<kNtasks; it++){
321 if(taskstr.CompareTo(fgTaskFlags[it]) != 0) continue;
322 SetStreamLevel(level, ETRDReconstructorTask(it));
326 if(PROCESSED) continue;
328 AliWarning(Form("Unknown option flag %s.", sopt.Data()));
332 //_____________________________________________________________________________
333 void AliTRDReconstructor::SetStreamLevel(Int_t level, ETRDReconstructorTask task){
335 // Set the Stream Level for one of the tasks Clusterizer, Tracker or PID
337 const Int_t minLevel[4] = {1, 1, 2, 1}; // the minimum debug level upon which a debug stream is created for different tasks
338 //AliInfo(Form("Setting Stream Level for Task %s to %d", taskname.Data(),level));
339 fStreamLevel[(Int_t)task] = level;
340 // Initialize DebugStreamer if not yet done
341 if(level >= minLevel[task] && !fDebugStream[task]){
342 TDirectory *savedir = gDirectory;
343 fDebugStream[task] = new TTreeSRedirector(Form("TRD.Debug%s.root", fgTaskNames[task]));
345 SETFLG(fSteerParam, kOwner);
349 //_____________________________________________________________________________
350 void AliTRDReconstructor::Options(UInt_t steer, UChar_t *stream)
352 for(Int_t iopt=0; iopt<kNsteer; iopt++){
353 AliDebugGeneral("AliTRDReconstructor", 1, Form(" %s[%s]%s", fgSteerNames[iopt], fgSteerFlags[iopt], steer ?(((steer>>iopt)&1)?" : ON":" : OFF"):""));
355 AliDebugGeneral("AliTRDReconstructor", 1, " Debug Streaming");
356 for(Int_t it=0; it<kNtasks; it++)
357 AliDebugGeneral("AliTRDReconstructor", 1, Form(" %s [sl_%s] %d", fgTaskNames[it], fgTaskFlags[it], stream ? stream[it] : 0));