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 // For the special options which can be used during reconstruction and their //
23 // default values pls. see function SetOption(). //
25 ///////////////////////////////////////////////////////////////////////////////
27 #include <TObjString.h>
28 #include <TObjArray.h>
29 #include <TTreeStream.h>
30 #include <TDirectory.h>
33 #include "AliRawReader.h"
36 #include "AliTRDReconstructor.h"
37 #include "AliTRDclusterizer.h"
38 #include "AliTRDrawData.h"
39 #include "AliTRDrawStream.h"
40 #include "AliTRDdigitsManager.h"
41 #include "AliTRDtrackerV1.h"
42 #include "AliESDEvent.h"
43 #include "AliESDTrdTrack.h"
44 #include "AliESDTrdTracklet.h"
45 #include "AliESDTrdTrigger.h"
46 #include "AliTRDtrackletWord.h"
47 #include "AliTRDtrackletMCM.h"
49 #define SETFLG(n,f) ((n) |= f)
50 #define CLRFLG(n,f) ((n) &= ~f)
52 ClassImp(AliTRDReconstructor)
54 AliESDTrdTrigger AliTRDReconstructor::fgTriggerFlags;
55 TClonesArray *AliTRDReconstructor::fgClusters = NULL;
56 TClonesArray *AliTRDReconstructor::fgTracklets = NULL;
57 TClonesArray *AliTRDReconstructor::fgTracks = NULL;
58 Char_t const * AliTRDReconstructor::fgSteerNames[kNsteer] = {
61 ,"Write Online Tracklets "
62 ,"Stand Alone Tracking "
64 ,"Process Online Trklts "
66 ,"Cl. Radial Correction "
68 Char_t const * AliTRDReconstructor::fgSteerFlags[kNsteer] = {
69 "dc"// digits conversion [false]
70 ,"cw"// write clusters [true]
71 ,"tw"// write online tracklets [false]
72 ,"sa"// track seeding (stand alone tracking) [true]
73 ,"hlt"// HLT reconstruction [false]
74 ,"tp"// also use online tracklets for reconstruction [false]
75 ,"deb"// Write debug stream [false]
76 ,"cc" // Cluster radial correction during reconstruction [false]
78 Char_t const * AliTRDReconstructor::fgTaskNames[AliTRDrecoParam::kTRDreconstructionTasks] = {
83 Char_t const * AliTRDReconstructor::fgTaskFlags[AliTRDrecoParam::kTRDreconstructionTasks] = {
88 Int_t AliTRDReconstructor::fgNTimeBins = -1;
89 const Float_t AliTRDReconstructor::fgkMinClustersInTrack = 0.5; //
90 const Float_t AliTRDReconstructor::fgkLabelFraction = 0.8; //
91 const Double_t AliTRDReconstructor::fgkMaxChi2 = 12.0; //
92 const Double_t AliTRDReconstructor::fgkMaxSnp = 0.95; // Maximum local sine of the azimuthal angle
93 const Double_t AliTRDReconstructor::fgkMaxStep = 2.0; // Maximal step size in propagation
94 const Double_t AliTRDReconstructor::fgkEpsilon = 1.e-5; // Precision of radial coordinate
96 //_____________________________________________________________________________
97 AliTRDReconstructor::AliTRDReconstructor()
102 // setting default "ON" steering parameters
103 // owner of debug streamers
104 SETFLG(fSteerParam, kOwner);
105 // write clusters [cw]
106 SETFLG(fSteerParam, kWriteClusters);
107 // track seeding (stand alone tracking) [sa]
108 //SETFLG(fSteerParam, kSeeding);
109 // Cluster radial correction during reconstruction [cc]
110 //SETFLG(fSteerParam, kClRadialCorr);
111 memset(fDebugStream, 0, sizeof(TTreeSRedirector *) * AliTRDrecoParam::kTRDreconstructionTasks);
114 //_____________________________________________________________________________
115 AliTRDReconstructor::~AliTRDReconstructor()
122 fgClusters->Delete();
127 fgTracklets->Delete();
136 if(fSteerParam&kOwner){
137 for(Int_t itask = 0; itask < AliTRDrecoParam::kTRDreconstructionTasks; itask++)
138 if(fDebugStream[itask]) delete fDebugStream[itask];
147 //_____________________________________________________________________________
148 void AliTRDReconstructor::Init(){
152 SetOption(GetOption());
153 Options(fSteerParam);
156 fClusterizer = new AliTRDclusterizer(fgTaskNames[AliTRDrecoParam::kClusterizer], fgTaskNames[AliTRDrecoParam::kClusterizer]);
157 fClusterizer->SetReconstructor(this);
160 // Make Debug Streams when Debug Streaming
161 if(IsDebugStreaming()){
162 for(Int_t task = 0; task < AliTRDrecoParam::kTRDreconstructionTasks; task++){
163 TDirectory *savedir = gDirectory;
164 fDebugStream[task] = new TTreeSRedirector(Form("TRD.Debug%s.root", fgTaskNames[task]));
166 SETFLG(fSteerParam, kOwner);
171 //_____________________________________________________________________________
172 void AliTRDReconstructor::ConvertDigits(AliRawReader *rawReader
173 , TTree *digitsTree) const
176 // Convert raw data digits into digit objects in a root tree
179 //AliInfo("Convert raw data digits into digit objects [RawReader -> Digit TTree]");
181 AliTRDrawData rawData;
183 rawReader->Select("TRD");
184 AliTRDdigitsManager *manager = rawData.Raw2Digits(rawReader);
185 manager->MakeBranch(digitsTree);
186 manager->WriteDigits();
189 // take over ownership of online tracklets
190 fgTracklets = rawData.TrackletsArray();
191 rawData.SetTrackletsOwner(0x0);
193 // take over GTU tracks
194 fgTracks = rawData.TracksArray();
195 rawData.SetTracksOwner(0x0);
197 for (Int_t iSector = 0; iSector < 18; iSector++) {
198 fgTriggerFlags.SetFlags(iSector, rawData.GetTriggerFlags(iSector));
202 //_____________________________________________________________________________
203 void AliTRDReconstructor::Reconstruct(AliRawReader *rawReader
204 , TTree *clusterTree) const
207 // Reconstruct clusters
210 //AliInfo("Reconstruct TRD clusters from RAW data [RawReader -> Cluster TTree]");
214 rawReader->Select("TRD");
217 AliFatal("Clusterizer not available!");
221 fClusterizer->ResetRecPoints();
223 fClusterizer->OpenOutput(clusterTree);
224 fClusterizer->SetUseLabels(kFALSE);
225 fClusterizer->SetStoreRawSignals(kTRUE);
226 fClusterizer->Raw2ClustersChamber(rawReader);
228 fgNTimeBins = fClusterizer->GetNTimeBins();
230 // take over ownership of online tracklets
231 fgTracklets = fClusterizer->TrackletsArray();
232 fClusterizer->SetTrackletsOwner(kFALSE);
234 // take over GTU tracks
235 fgTracks = fClusterizer->TracksArray();
236 fClusterizer->SetTracksOwner(kFALSE);
238 for (Int_t iSector = 0; iSector < 18; iSector++) {
239 fgTriggerFlags.SetFlags(iSector, fClusterizer->GetTriggerFlags(iSector));
242 if(IsWritingClusters()) return;
244 // take over ownership of clusters
245 fgClusters = fClusterizer->RecPoints();
246 fClusterizer->SetClustersOwner(kFALSE);
249 //_____________________________________________________________________________
250 void AliTRDReconstructor::Reconstruct(TTree *digitsTree
251 , TTree *clusterTree) const
254 // Reconstruct clusters
257 //AliInfo("Reconstruct TRD clusters from Digits [Digit TTree -> Cluster TTree]");
259 AliTRDclusterizer clusterer(fgTaskNames[AliTRDrecoParam::kClusterizer], fgTaskNames[AliTRDrecoParam::kClusterizer]);
260 clusterer.SetReconstructor(this);
261 clusterer.SetUseLabels(kTRUE);
262 clusterer.SetStoreRawSignals(kTRUE);
263 clusterer.OpenOutput(clusterTree);
264 clusterer.ReadDigits(digitsTree);
265 clusterer.MakeClusters();
267 // read tracklets and tracks if not done during reading of raw data
269 clusterer.ReadTracklets();
270 fgTracklets = clusterer.TrackletsArray();
271 clusterer.SetTrackletsOwner(kFALSE);
274 clusterer.ReadTracks();
275 fgTracks = clusterer.TracksArray();
276 clusterer.SetTracksOwner(kFALSE);
279 fgNTimeBins = clusterer.GetNTimeBins();
281 if(IsWritingClusters()) return;
283 // take over ownership of clusters
284 fgClusters = clusterer.RecPoints();
285 clusterer.SetClustersOwner(kFALSE);
288 //_____________________________________________________________________________
289 AliTracker *AliTRDReconstructor::CreateTracker() const
292 // Create a TRD tracker
295 //return new AliTRDtracker(NULL);
296 AliTRDtrackerV1 *tracker = new AliTRDtrackerV1();
297 tracker->SetReconstructor(this);
302 //_____________________________________________________________________________
303 void AliTRDReconstructor::FillESD(TTree* /*digitsTree*/
304 , TTree* /*clusterTree*/
305 , AliESDEvent* esd) const
311 // ----- filling tracklets -----
312 AliDebug(1, Form("Filling tracklets from %p (%i)",
313 fgTracklets, fgTracklets ? fgTracklets->GetEntriesFast() : 0));
314 Int_t trackletIndex[1080] = { 0 };
316 AliTRDrawStream::SortTracklets(fgTracklets, trklList, trackletIndex);
317 TIter trackletIter(&trklList);
318 while (AliTRDtrackletBase* tracklet = (AliTRDtrackletBase*) trackletIter()) {
319 Int_t label = -2; // mark raw tracklets with label -2
320 if (AliTRDtrackletMCM *trklMCM = dynamic_cast<AliTRDtrackletMCM*> (tracklet))
321 label = trklMCM->GetLabel();
323 AliESDTrdTracklet *esdTracklet = new AliESDTrdTracklet(tracklet->GetTrackletWord(), tracklet->GetHCId(), label);
325 esd->AddTrdTracklet(esdTracklet);
328 // ----- filling GTU tracks -----
329 AliDebug(1, Form("Now filling ESD with GTU tracks from %p (%i)",
330 fgTracks, fgTracks ? fgTracks->GetEntriesFast() : 0));
332 for (Int_t iTrack = 0; iTrack < fgTracks->GetEntriesFast(); iTrack++) {
333 AliESDTrdTrack *trdTrack = (AliESDTrdTrack*) ((*fgTracks)[iTrack]);
335 UInt_t stack = trdTrack->GetStack();
338 AliTRDrawStream::AssignTracklets(trdTrack, trackletIndex, refIndex);
340 for (Int_t iLayer = 0; iLayer < 6; ++iLayer) {
341 Int_t det = trdTrack->GetSector()*30 + stack*6 + iLayer;
343 AliESDTrdTracklet *trkl = refIndex[iLayer] > -1 ? esd->GetTrdTracklet(refIndex[iLayer]) : 0x0;
345 AliDebug(5, Form("adding tracklet with index %i: 0x%08x",
346 refIndex[iLayer], trkl->GetTrackletWord()));
347 if (trkl->GetDetector() != det)
348 AliError(Form("inconsistent assignment of tracklet 0x%08x in det %i to track in %i",
349 trkl->GetTrackletWord(), trkl->GetDetector(), det));
350 trdTrack->AddTrackletReference(trkl, iLayer);
354 // only add the track when it's complete (including tracklet references)
355 esd->AddTrdTrack(trdTrack);
359 esd->SetTrdTrigger(&fgTriggerFlags);
361 // clearing variables for next event
366 //_____________________________________________________________________________
367 void AliTRDReconstructor::SetOption(Option_t *opt)
370 // Read option string into the steer param.
372 // The following string options are available during reconstruction.
373 // In square brackets the default values are given.
374 // "dc" : digits conversion [false]
375 // "cw" : write clusters [true]
376 // "tw" : write online tracklets [false]
377 // "sa" : track seeding (stand alone tracking) [true]
378 // "hlt" : HLT reconstruction [false]
379 // "tp" : also use online tracklets for reconstruction [false]
380 // "deb" : Write debug stream [false]
381 // "cc" : Cluster radial correction during reconstruction [false]
383 // To check the actual options used during reconstruction include the following line in your rec.C script
384 // AliLog::SetClassDebugLevel("AliTRDReconstructor", 1);
386 AliReconstructor::SetOption(opt);
389 TObjArray *opar = s.Tokenize(",");
390 for(Int_t ipar=0; ipar<opar->GetEntriesFast(); ipar++){
391 Bool_t processed = kFALSE;
392 TString sopt(((TObjString*)(*opar)[ipar])->String());
393 for(Int_t iopt=0; iopt<kNsteer; iopt++){
394 if(!sopt.Contains(fgSteerFlags[iopt])) continue;
395 SETFLG(fSteerParam, BIT(iopt));
396 if(sopt.Contains("!")) CLRFLG(fSteerParam, BIT(iopt));
400 if(processed) continue;
402 AliWarning(Form("Unknown option flag %s.", sopt.Data()));
407 //_____________________________________________________________________________
408 void AliTRDReconstructor::Options(UInt_t steer)
414 for(Int_t iopt=0; iopt<kNsteer; iopt++){
415 AliDebugGeneral("AliTRDReconstructor", 1, Form(" %s[%s]%s", fgSteerNames[iopt], fgSteerFlags[iopt], steer ?(((steer>>iopt)&1)?" : ON":" : OFF"):""));