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 **************************************************************************/
17 //-----------------------------------------------------------------------------
18 /// \class AliMUONReconstructor
20 /// Implementation of AliReconstructor for MUON subsystem.
22 /// The clustering mode and the associated parameters can be changed through the
23 /// AliMUONRecoParam object set in the reconstruction macro or read from the CDB
24 /// (see methods in AliMUONRecoParam.h file for details)
28 /// SIMPLEFIT : use the AliMUONClusterFinderSimpleFit clusterizer
30 /// SIMPLEFITV3 : SIMPLEFIT with preclustering=PRECLUSTERV3
32 /// MLEM : use AliMUONClusterFinderMLEM and AliMUONPreClusterFinder for preclustering (default)
33 /// MLEMV2 : MLEM with preclustering=PRECLUSTERV2
34 /// MLEMV3 : MLEM with preclustering=PRECLUSTERV3
36 /// PRECLUSTER : use only AliMUONPreClusterFinder. Only for debug as
37 /// the produced clusters do not have a position, hence the tracking will not
39 /// PRECLUSTERV2 : another version of the preclustering
40 /// PRECLUSTERV3 : yet another version of the preclustering
42 /// COG : use AliMUONClusterFinderCOG clusterizer. Not really a production
43 /// option either, as center-of-gravity is generally not a good estimate
44 /// of the cluster position...
46 /// PEAKCOG : COG cluster finder around local maxima
47 /// PEAKFIT : fit around local maxima with up to 3 peaks, COG otherwise
49 /// NOCLUSTERING : bypass completely the clustering stage
53 /// The behavior of the MUON reconstruction can also be changed, besides
54 /// the usual methods found in AliReconstruction (e.g. to disable tracking)
55 /// by using AliReconstruction::SetOption("MUON",options)
56 /// where options should be a space separated string.
58 /// Valid options are :
60 /// SAVEDIGITS : if you want to save in the TreeD the *calibrated* digits
61 /// that are used for the clustering
63 /// DIGITSTOREV1 : use the V1 implementation of the digitstore
64 /// DIGITSTOREV2R : use the V2R implementation of the digitstore
66 /// NOLOCALRECONSTRUCTION : for debug, to disable local reconstruction (and hence
67 /// "recover" old behavior)
69 /// TRIGGERDISABLE : disable the treatment of MUON trigger
71 /// NOFASTTRKDECODER : makes the digit maker class use the non-high performance decoder
72 /// AliMUONPayloadTracker instead of AliMUONTrackerDDLDecoder.
74 /// NOFASTTRGDECODER : makes the digit maker class use the non-high performance decoder
75 /// AliMUONPayloadTrigger instead of AliMUONTriggerDDLDecoder.
77 /// NOFASTDECODERS : makes the digit maker class use the non-high performance decoders
78 /// AliMUONPayloadTracker and AliMUONPayloadTrigger.
80 /// \author Laurent Aphecetche, Subatech
81 //-----------------------------------------------------------------------------
83 #include "AliMUONReconstructor.h"
85 #include "AliMUONCalibrationData.h"
86 #include "AliMUONClusterFinderCOG.h"
87 #include "AliMUONClusterFinderMLEM.h"
88 #include "AliMUONClusterFinderSimpleFit.h"
89 #include "AliMUONClusterFinderPeakCOG.h"
90 #include "AliMUONClusterFinderPeakFit.h"
91 #include "AliMUONClusterStoreV1.h"
92 #include "AliMUONClusterStoreV2.h"
93 #include "AliMUONConstants.h"
94 #include "AliMUONDigitCalibrator.h"
95 #include "AliMUONDigitMaker.h"
96 #include "AliMUONDigitStoreV1.h"
97 #include "AliMUONDigitStoreV2R.h"
98 #include "AliMUONGeometryTransformer.h"
99 #include "AliMUONPreClusterFinder.h"
100 #include "AliMUONPreClusterFinderV2.h"
101 #include "AliMUONPreClusterFinderV3.h"
102 #include "AliMUONSimpleClusterServer.h"
103 #include "AliMUONTracker.h"
104 #include "AliMUONTriggerCircuit.h"
105 #include "AliMUONTriggerStoreV1.h"
106 #include "AliMUONVClusterFinder.h"
107 #include "AliMUONVClusterServer.h"
108 #include "AliMUONVTrackStore.h"
110 #include "AliMpArea.h"
111 #include "AliMpCDB.h"
112 #include "AliMpConstants.h"
113 #include "AliMpDDLStore.h"
114 #include "AliMpSegmentation.h"
116 #include "AliRawReader.h"
117 #include "AliCDBManager.h"
118 #include "AliCodeTimer.h"
121 #include <Riostream.h>
122 #include <TObjArray.h>
123 #include <TClonesArray.h>
128 ClassImp(AliMUONReconstructor)
131 //_____________________________________________________________________________
132 AliMUONReconstructor::AliMUONReconstructor() :
135 fTransformer(new AliMUONGeometryTransformer()),
137 fTriggerCircuit(0x0),
138 fCalibrationData(0x0),
139 fDigitCalibrator(0x0),
149 // Unload and delete old mapping
150 AliCDBManager::Instance()->UnloadFromCache("MUON/Calib/Mapping");
151 AliCDBManager::Instance()->UnloadFromCache("MUON/Calib/DDLStore");
152 delete AliMpDDLStore::Instance();
153 delete AliMpSegmentation::Instance();
156 if ( ! AliMpCDB::LoadDDLStore() ) {
157 AliFatal("Could not access mapping from OCDB !");
160 // Load geometry data
161 fTransformer->LoadGeometryData();
165 //_____________________________________________________________________________
166 AliMUONReconstructor::~AliMUONReconstructor()
174 delete fTriggerCircuit;
175 delete fCalibrationData;
176 delete fDigitCalibrator;
177 delete fClusterServer;
178 delete fTriggerStore;
180 delete fClusterStore;
182 delete AliMpSegmentation::Instance(false);
183 delete AliMpDDLStore::Instance(false);
186 //_____________________________________________________________________________
188 AliMUONReconstructor::Calibrate(AliMUONVDigitStore& digitStore) const
190 /// Calibrate the digitStore
191 if (!fDigitCalibrator)
195 AliCodeTimerAuto(Form("%s::Calibrate(AliMUONVDigitStore*)",fDigitCalibrator->ClassName()))
196 fDigitCalibrator->Calibrate(digitStore);
199 //_____________________________________________________________________________
201 AliMUONReconstructor::ConvertDigits(AliRawReader* rawReader,
202 AliMUONVDigitStore* digitStore,
203 AliMUONVTriggerStore* triggerStore) const
205 /// Convert raw data into digit and trigger stores
208 AliCodeTimerStart(Form("%s::Raw2Digits(AliRawReader*,AliMUONVDigitStore*,AliMUONVTriggerStore*)",
209 fDigitMaker->ClassName()))
210 fDigitMaker->Raw2Digits(rawReader,digitStore,triggerStore);
211 AliCodeTimerStop(Form("%s::Raw2Digits(AliRawReader*,AliMUONVDigitStore*,AliMUONVTriggerStore*)",
212 fDigitMaker->ClassName()))
213 Calibrate(*digitStore);
216 //_____________________________________________________________________________
218 AliMUONReconstructor::ConvertDigits(AliRawReader* rawReader, TTree* digitsTree) const
220 /// convert raw data into a digit tree
223 Bool_t alone = ( TriggerStore() == 0 );
225 Bool_t ok = DigitStore()->Connect(*digitsTree,alone);
226 if ( TriggerStore() )
228 ok = ok && TriggerStore()->Connect(*digitsTree,kFALSE);
233 AliError("Could not make branches on TreeD");
237 ConvertDigits(rawReader,DigitStore(),TriggerStore());
238 AliCodeTimerStart("Fill digits")
240 AliCodeTimerStop("Fill digits")
241 DigitStore()->Clear();
245 //_____________________________________________________________________________
247 AliMUONReconstructor::CreateDigitMaker() const
249 /// Create (and create if necessary) the digit maker
250 if (fDigitMaker) return;
254 TString option = GetOption();
255 Bool_t enableErrorLogging = kTRUE;
256 Bool_t useFastTrackerDecoder = kTRUE;
257 Bool_t useFastTriggerDecoder = kTRUE;
258 if (option.Contains("NOFASTTRKDECODER"))
260 useFastTrackerDecoder = kFALSE;
262 if (option.Contains("NOFASTTRGDECODER"))
264 useFastTriggerDecoder = kFALSE;
266 if (option.Contains("NOFASTDECODERS"))
268 useFastTrackerDecoder = kFALSE;
269 useFastTriggerDecoder = kFALSE;
271 fDigitMaker = new AliMUONDigitMaker(
272 enableErrorLogging, useFastTrackerDecoder, useFastTriggerDecoder
275 if ( option.Contains("SAVEDIGITS" ))
277 fDigitMaker->SetMakeTriggerDigits(kTRUE);
281 //_____________________________________________________________________________
283 AliMUONReconstructor::CreateTriggerCircuit() const
285 /// Return (and create if necessary) the trigger circuit object
286 if (fTriggerCircuit) return;
290 fTriggerCircuit = new AliMUONTriggerCircuit(fTransformer);
294 //_____________________________________________________________________________
296 AliMUONReconstructor::CreateTracker() const
298 /// Create the MUONTracker object
300 CreateTriggerCircuit();
302 CreateClusterServer();
304 AliMUONTracker* tracker(0x0);
306 if ( ! GetRecoParam()->CombineClusterTrackReco() )
308 tracker = new AliMUONTracker(GetRecoParam(),
317 tracker = new AliMUONTracker(GetRecoParam(),
329 //_____________________________________________________________________________
330 AliMUONVClusterFinder*
331 AliMUONReconstructor::CreateClusterFinder(const char* clusterFinderType)
333 /// Create a given cluster finder instance
335 AliCodeTimerAutoGeneral("")
337 AliMUONVClusterFinder* clusterFinder(0x0);
339 TString opt(clusterFinderType);
342 if ( strstr(opt,"PRECLUSTERV2") )
344 clusterFinder = new AliMUONPreClusterFinderV2;
346 else if ( strstr(opt,"PRECLUSTERV3") )
348 clusterFinder = new AliMUONPreClusterFinderV3;
350 else if ( strstr(opt,"PRECLUSTER") )
352 clusterFinder = new AliMUONPreClusterFinder;
354 else if ( strstr(opt,"PEAKCOG") )
356 clusterFinder = new AliMUONClusterFinderPeakCOG(kFALSE,new AliMUONPreClusterFinder);
358 else if ( strstr(opt,"PEAKFIT") )
360 clusterFinder = new AliMUONClusterFinderPeakFit(kFALSE,new AliMUONPreClusterFinder);
362 else if ( strstr(opt,"COG") )
364 clusterFinder = new AliMUONClusterFinderCOG(new AliMUONPreClusterFinder);
366 else if ( strstr(opt,"SIMPLEFITV3") )
368 clusterFinder = new AliMUONClusterFinderSimpleFit(new AliMUONClusterFinderCOG(new AliMUONPreClusterFinderV3));
370 else if ( strstr(opt,"SIMPLEFIT") )
372 clusterFinder = new AliMUONClusterFinderSimpleFit(new AliMUONClusterFinderCOG(new AliMUONPreClusterFinder));
374 else if ( strstr(opt,"MLEM:DRAW") )
376 clusterFinder = new AliMUONClusterFinderMLEM(kTRUE,new AliMUONPreClusterFinder);
378 else if ( strstr(opt,"MLEMV3") )
380 clusterFinder = new AliMUONClusterFinderMLEM(kFALSE,new AliMUONPreClusterFinderV3);
382 else if ( strstr(opt,"MLEMV2") )
384 clusterFinder = new AliMUONClusterFinderMLEM(kFALSE,new AliMUONPreClusterFinderV2);
386 else if ( strstr(opt,"MLEM") )
388 clusterFinder = new AliMUONClusterFinderMLEM(kFALSE,new AliMUONPreClusterFinder);
392 AliErrorClass(Form("clustering mode \"%s\" does not exist",opt.Data()));
396 return clusterFinder;
399 //_____________________________________________________________________________
401 AliMUONReconstructor::CreateClusterServer() const
403 /// Create cluster server
405 if ( fClusterServer ) return;
407 AliCodeTimerAuto("");
409 AliMUONVClusterFinder* clusterFinder = CreateClusterFinder(GetRecoParam()->GetClusteringMode());
411 if ( !clusterFinder ) return;
413 AliInfo(Form("Will use %s for clusterizing",clusterFinder->ClassName()));
415 fClusterServer = new AliMUONSimpleClusterServer(clusterFinder,*fTransformer);
418 //_____________________________________________________________________________
420 AliMUONReconstructor::CreateCalibrator() const
422 /// Create the calibrator
426 Int_t runNumber = AliCDBManager::Instance()->GetRun();
428 AliInfo("Calibration will occur.");
430 fCalibrationData = new AliMUONCalibrationData(runNumber);
431 if ( !fCalibrationData->IsValid() )
433 AliError("Could not retrieve calibrations !");
434 delete fCalibrationData;
435 fCalibrationData = 0x0;
439 // Check that we get all the calibrations we'll need
440 if ( !fCalibrationData->Pedestals() ||
441 !fCalibrationData->Gains() ||
442 !fCalibrationData->HV() )
444 AliFatal("Could not access all required calibration data");
447 TString opt(GetOption());
450 if ( strstr(opt,"NOSTATUSMAP") )
452 AliWarning("NOSTATUSMAP is obsolete");
455 TString calibMode = GetRecoParam()->GetCalibrationMode();
457 fDigitCalibrator = new AliMUONDigitCalibrator(*fCalibrationData,GetRecoParam(),calibMode.Data());
460 //_____________________________________________________________________________
462 AliMUONReconstructor::DigitStore() const
464 /// Return (and create if necessary) the digit container
467 TString sopt(GetOption());
470 AliInfo(Form("Options=%s",sopt.Data()));
472 if ( sopt.Contains("DIGITSTOREV1") )
474 fDigitStore = AliMUONVDigitStore::Create("AliMUONDigitStoreV1");
476 else if ( sopt.Contains("DIGITSTOREV2R") )
478 fDigitStore = AliMUONVDigitStore::Create("AliMUONDigitStoreV2R");
480 else if ( sopt.Contains("DIGITSTOREV2S") )
482 fDigitStore = AliMUONVDigitStore::Create("AliMUONDigitStoreV2S");
485 if (!fDigitStore) fDigitStore = AliMUONVDigitStore::Create("AliMUONDigitStoreV2R");
487 AliInfo(Form("Will use %s to store digits during reconstruction",fDigitStore->ClassName()));
492 //_____________________________________________________________________________
494 AliMUONReconstructor::FillTreeR(AliMUONVTriggerStore* triggerStore,
495 TTree& clustersTree) const
497 /// Write the trigger and cluster information into TreeR
504 Bool_t alone(kTRUE); // is trigger the only info in TreeR ?
506 if ( ! GetRecoParam()->CombineClusterTrackReco() )
508 alone = kFALSE; // we'll get both tracker and trigger information in TreeR
513 ok = triggerStore->Connect(clustersTree,alone);
516 AliError("Could not create triggerStore branches in TreeR");
524 fClusterStore = new AliMUONClusterStoreV2;
527 CreateClusterServer();
529 TIter next(DigitStore()->CreateIterator());
530 fClusterServer->UseDigits(next);
534 AliDebug(1,Form("Doing full clusterization in local reconstruction using %s ",fClusterServer->ClassName()));
536 for ( Int_t i = 0; i < AliMpConstants::NofTrackingChambers(); ++i )
538 if (GetRecoParam()->UseChamber(i))
540 if ( ( i == 6 || i == 7 ) && GetRecoParam()->BypassSt4() ) continue;
541 if ( ( i == 8 || i == 9 ) && GetRecoParam()->BypassSt5() ) continue;
543 fClusterServer->Clusterize(i,*fClusterStore,area,GetRecoParam());
547 Bool_t cok = fClusterStore->Connect(clustersTree,alone);
549 if (!cok) AliError("Could not connect clusterStore to clusterTree");
551 AliDebug(1,Form("Number of clusters found = %d",fClusterStore->GetSize()));
553 StdoutToAliDebug(1,fClusterStore->Print());
556 if (ok) // at least one type of branches created successfully
561 if (fClusterStore) fClusterStore->Clear();
564 //_____________________________________________________________________________
566 AliMUONReconstructor::HasDigitConversion() const
568 /// We *do* have digit conversion, but we might advertise it only
569 /// if we want to save the digits.
571 TString opt(GetOption());
573 if ( opt.Contains("SAVEDIGITS" ) && !opt.Contains("NOLOCALRECONSTRUCTION") )
583 //_____________________________________________________________________________
585 AliMUONReconstructor::Reconstruct(AliRawReader* rawReader, TTree* clustersTree) const
587 /// This method is called by AliReconstruction if HasLocalReconstruction()==kTRUE AND
588 /// HasDigitConversion()==kFALSE
592 AliError("clustersTree is 0x0 !");
596 ConvertDigits(rawReader,DigitStore(),TriggerStore());
598 FillTreeR(TriggerStore(),*clustersTree);
601 //_____________________________________________________________________________
603 AliMUONReconstructor::Reconstruct(TTree* digitsTree, TTree* clustersTree) const
605 /// This method is called by AliReconstruction if HasLocalReconstruction()==kTRUE
606 /// AND HasDigitConversion()==kTRUE
612 if (!digitsTree || !clustersTree)
614 AliError(Form("Tree is null : digitsTree=%p clustersTree=%p",
615 digitsTree,clustersTree));
621 fDigitStore = AliMUONVDigitStore::Create(*digitsTree);
624 AliError(Form("Could not get DigitStore from %s",digitsTree->GetName()));
628 AliInfo(Form("Created %s from %s",fDigitStore->ClassName(),digitsTree->GetName()));
633 fTriggerStore = AliMUONVTriggerStore::Create(*digitsTree);
636 AliError(Form("Could not get TriggerStore from %s",digitsTree->GetName()));
640 AliInfo(Form("Created %s from %s",fTriggerStore->ClassName(),digitsTree->GetName()));
644 if (!fTriggerStore && !fDigitStore)
646 AliError("No store at all. Nothing to do.");
650 // insure we start with empty stores
653 fDigitStore->Clear();
654 Bool_t alone = ( fTriggerStore ? kFALSE : kTRUE );
655 Bool_t ok = fDigitStore->Connect(*digitsTree,alone);
658 AliError("Could not connect digitStore to digitsTree");
664 fTriggerStore->Clear();
665 Bool_t alone = ( fDigitStore ? kFALSE : kTRUE );
666 Bool_t ok = fTriggerStore->Connect(*digitsTree,alone);
669 AliError("Could not connect triggerStore to digitsTree");
674 digitsTree->GetEvent(0);
678 // Insure we got calibrated digits (if we reconstruct from pure simulated,
679 // i.e. w/o going through raw data, this will be the case)
680 TIter next(fDigitStore->CreateIterator());
681 AliMUONVDigit* digit = static_cast<AliMUONVDigit*>(next());
682 if (digit && !digit->IsCalibrated())
684 Calibrate(*fDigitStore);
688 FillTreeR(fTriggerStore,*clustersTree);
691 //_____________________________________________________________________________
692 AliMUONVTriggerStore*
693 AliMUONReconstructor::TriggerStore() const
695 /// Return (and create if necessary and allowed) the trigger container
696 TString sopt(GetOption());
699 if (sopt.Contains("TRIGGERDISABLE"))
701 delete fTriggerStore;
708 fTriggerStore = new AliMUONTriggerStoreV1;
711 return fTriggerStore;