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 **************************************************************************/
19 #include <Riostream.h>
24 #include "AliMUONDigitizerV3.h"
27 #include "AliMUONCalibrationData.h"
28 #include "AliMUONConstants.h"
29 #include "AliMUONData.h"
30 #include "AliMUONDataIterator.h"
31 #include "AliMUONDigit.h"
32 #include "AliMUONSegmentation.h"
33 #include "AliMUONTriggerEfficiencyCells.h"
34 #include "AliMUONTriggerElectronics.h"
35 #include "AliMUONVCalibParam.h"
37 #include "AliMpDEIterator.h"
38 #include "AliMpDEManager.h"
39 #include "AliMpIntPair.h"
41 #include "AliMpStationType.h"
42 #include "AliMpSegmentation.h"
43 #include "AliMpVSegmentation.h"
44 #include "AliMpDEManager.h"
47 #include "AliRunDigitizer.h"
48 #include "AliRunLoader.h"
52 /// \class AliMUONDigitizerV3
53 /// The digitizer is performing the transformation to go from SDigits (digits
54 /// w/o any electronic noise) to Digits (w/ electronic noise, and decalibration)
56 /// The decalibration is performed by doing the reverse operation of the
57 /// calibration, that is we do (Signal+pedestal)/gain -> ADC
59 /// Note also that the digitizer takes care of merging sdigits that belongs
60 /// to the same pad, either because we're merging several input sdigit files
61 /// or with a single file because the sdigitizer does not merge sdigits itself
62 /// (for performance reason mainly, and because anyway we know we have to do it
63 /// here, at the digitization level).
70 return static_cast<AliMUON*>(gAlice->GetModule("MUON"));
74 const Double_t AliMUONDigitizerV3::fgkNSigmas=3;
77 ClassImp(AliMUONDigitizerV3)
80 //_____________________________________________________________________________
81 AliMUONDigitizerV3::AliMUONDigitizerV3(AliRunDigitizer* manager,
82 Bool_t generateNoisyDigits)
83 : AliDigitizer(manager),
84 fIsInitialized(kFALSE),
86 fCalibrationData(0x0),
87 fTriggerProcessor(0x0),
88 fTriggerEfficiency(0x0),
89 fFindDigitIndexTimer(),
90 fGenerateNoisyDigitsTimer(),
93 fGenerateNoisyDigits(generateNoisyDigits)
97 AliDebug(1,Form("AliRunDigitizer=%p",fManager));
98 fGenerateNoisyDigitsTimer.Start(kTRUE); fGenerateNoisyDigitsTimer.Stop();
99 fExecTimer.Start(kTRUE); fExecTimer.Stop();
100 fFindDigitIndexTimer.Start(kTRUE); fFindDigitIndexTimer.Stop();
103 //_____________________________________________________________________________
104 AliMUONDigitizerV3::~AliMUONDigitizerV3()
106 /// Dtor. Note we're the owner of some pointers.
111 delete fCalibrationData;
112 delete fTriggerProcessor;
113 delete fNoiseFunction;
115 AliDebug(1, Form("Execution time for FindDigitIndex() : R:%.2fs C:%.2fs",
116 fFindDigitIndexTimer.RealTime(),fFindDigitIndexTimer.CpuTime()));
117 if ( fGenerateNoisyDigits )
119 AliDebug(1, Form("Execution time for GenerateNoisyDigits() : R:%.2fs C:%.2fs",
120 fGenerateNoisyDigitsTimer.RealTime(),
121 fGenerateNoisyDigitsTimer.CpuTime()));
123 AliDebug(1, Form("Execution time for Exec() : R:%.2fs C:%.2fs",
124 fExecTimer.RealTime(),fExecTimer.CpuTime()));
128 //_____________________________________________________________________________
130 AliMUONDigitizerV3::ApplyResponseToTrackerDigit(AliMUONDigit& digit, Bool_t addNoise)
132 /// For tracking digits, starting from an ideal digit's charge, we :
134 /// - add some noise (thus leading to a realistic charge), if requested to do so
135 /// - divide by a gain (thus decalibrating the digit)
136 /// - add a pedestal (thus decalibrating the digit)
137 /// - sets the signal to zero if below 3*sigma of the noise
139 static const Int_t kMaxADC = (1<<12)-1; // We code the charge on a 12 bits ADC.
141 Float_t signal = digit.Signal();
145 digit.SetADC(TMath::Nint(signal));
149 Int_t detElemId = digit.DetElemId();
151 Int_t manuId = digit.ManuId();
152 Int_t manuChannel = digit.ManuChannel();
154 AliMUONVCalibParam* pedestal = fCalibrationData->Pedestals(detElemId,manuId);
157 AliFatal(Form("Could not get pedestal for DE=%d manuId=%d",
160 Float_t pedestalMean = pedestal->ValueAsFloat(manuChannel,0);
161 Float_t pedestalSigma = pedestal->ValueAsFloat(manuChannel,1);
163 AliMUONVCalibParam* gain = fCalibrationData->Gains(detElemId,manuId);
166 AliFatal(Form("Could not get gain for DE=%d manuId=%d",
169 Float_t gainMean = gain->ValueAsFloat(manuChannel,0);
171 Float_t adcNoise = gRandom->Gaus(0.0,pedestalSigma);
175 if ( gainMean < 1E-6 )
177 AliError(Form("Got a too small gain %e for DE=%d manuId=%d manuChannel=%d. "
178 "Setting signal to 0.",
179 gainMean,detElemId,manuId,manuChannel));
184 adc = TMath::Nint( signal / gainMean + pedestalMean + adcNoise);///
186 if ( adc <= pedestalMean + fgkNSigmas*pedestalSigma )
192 // be sure we stick to 12 bits.
198 digit.SetPhysicsSignal(TMath::Nint(signal));
199 digit.SetSignal(adc);
203 //_____________________________________________________________________________
205 AliMUONDigitizerV3::ApplyResponseToTriggerDigit(AliMUONDigit& digit,
208 /// \todo add comment
210 if ( !fTriggerEfficiency ) return;
212 AliMUONDigit* correspondingDigit = FindCorrespondingDigit(digit,data);
214 if(!correspondingDigit)return;//reject bad correspondences
216 Int_t detElemId = digit.DetElemId();
218 AliMpSegmentation* segmentation = AliMpSegmentation::Instance();
219 const AliMpVSegmentation* segment[2] =
221 segmentation->GetMpSegmentation(detElemId,digit.Cathode()),
222 segmentation->GetMpSegmentation(detElemId,correspondingDigit->Cathode())
227 segment[0]->PadByIndices(AliMpIntPair(digit.PadX(),digit.PadY()),kTRUE),
228 segment[1]->PadByIndices(AliMpIntPair(correspondingDigit->PadX(),correspondingDigit->PadY()),kTRUE)
232 if (digit.Cathode()==0)p0=0;
234 AliMpIntPair location = pad[p0].GetLocation(0);
235 Int_t nboard = location.GetFirst();
239 fTriggerEfficiency->IsTriggered(detElemId, nboard-1,
240 isTrig[0], isTrig[1]);
242 if (!isTrig[digit.Cathode()])
247 if ( &digit != correspondingDigit )
249 if (!isTrig[correspondingDigit->Cathode()])
251 correspondingDigit->SetSignal(0);
256 //_____________________________________________________________________________
258 AliMUONDigitizerV3::ApplyResponse()
260 /// Loop over all chamber digits, and apply the response to them
261 /// Note that this method may remove digits.
263 const Bool_t kAddNoise = kTRUE;
265 for ( Int_t ich = 0; ich < AliMUONConstants::NCh(); ++ich )
267 TClonesArray* digits = fOutputData->Digits(ich);
268 Int_t n = digits->GetEntriesFast();
269 Bool_t trackingChamber = ( ich < AliMUONConstants::NTrackingCh() );
270 for ( Int_t i = 0; i < n; ++i )
272 AliMUONDigit* d = static_cast<AliMUONDigit*>(digits->UncheckedAt(i));
273 if ( trackingChamber )
275 ApplyResponseToTrackerDigit(*d,kAddNoise);
279 ApplyResponseToTriggerDigit(*d,fOutputData);
281 if ( d->Signal() <= 0 )
289 // The version below, using iterator, does not yet work (as the iterator
290 // assumes it is reading digits from the tree, while in this case it's
293 // AliMUONDigit* digit(0x0);
295 // // First loop on tracker digits
296 // AliMUONDataIterator tracker(fOutputData,"D",AliMUONDataIterator::kTrackingChambers);
298 // while ( ( digit = static_cast<AliMUONDigit*>(tracker.Next()) ) )
300 // ApplyResponseToTrackerDigit(*digit);
301 // if ( digit->Signal() <= 0 )
308 // // Then loop on trigger digits
309 // AliMUONDataIterator trigger(fOutputData,"D",AliMUONDataIterator::kTriggerChambers);
311 // while ( ( digit = static_cast<AliMUONDigit*>(trigger.Next()) ) )
313 // ApplyResponseToTriggerDigit(*digit,fOutputData);
314 // if ( digit->Signal() <= 0 )
321 //_____________________________________________________________________________
323 AliMUONDigitizerV3::AddOrUpdateDigit(TClonesArray& array,
324 const AliMUONDigit& digit)
326 /// Add or update a digit, depending on whether there's already a digit
327 /// for the corresponding channel.
329 Int_t ix = FindDigitIndex(array,digit);
333 AliMUONDigit* d = static_cast<AliMUONDigit*>(array.UncheckedAt(ix));
334 Bool_t ok = MergeDigits(digit,*d);
337 AliError("Digits are not mergeable !");
342 ix = array.GetLast() + 1;
343 new(array[ix]) AliMUONDigit(digit);
348 //_____________________________________________________________________________
350 AliMUONDigitizerV3::Exec(Option_t*)
353 /// We first loop over input files, and merge the sdigits we found there.
354 /// Second, we digitize all the resulting sdigits
355 /// Then we generate noise-only digits (for tracker only)
356 /// And we finally generate the trigger outputs.
358 AliDebug(1, "Running digitizer.");
360 if ( fManager->GetNinputs() == 0 )
362 AliWarning("No input set. Nothing to do.");
366 if ( !fIsInitialized )
368 AliError("Not initialized. Cannot perform the work. Sorry");
372 fExecTimer.Start(kFALSE);
374 Int_t nInputFiles = fManager->GetNinputs();
376 if ( fOutputData->TreeD() == 0x0 )
378 AliDebug(1,"Calling MakeDigitsContainer");
379 fOutputData->GetLoader()->MakeDigitsContainer();
381 fOutputData->MakeBranch("D,GLT");
382 fOutputData->SetTreeAddress("D,GLT");
384 // Loop over all the input files, and merge the sdigits found in those
386 for ( Int_t iFile = 0; iFile < nInputFiles; ++iFile )
388 AliMUONData* inputData = GetDataAccess(fManager->GetInputFolderName(iFile));
391 AliFatal(Form("Could not get access to input file #%d",iFile));
394 inputData->GetLoader()->LoadSDigits("READ");
395 inputData->SetTreeAddress("S");
396 inputData->GetSDigits();
398 MergeWithSDigits(*fOutputData,*inputData,fManager->GetMask(iFile));
400 inputData->ResetSDigits();
401 inputData->GetLoader()->UnloadSDigits();
405 // At this point, we do have digit arrays (one per chamber) which contains
406 // the merging of all the sdigits of the input file(s).
407 // We now massage them to apply the detector response, i.e. this
408 // is here that we do the "digitization" work.
412 if ( fGenerateNoisyDigits )
414 // Generate noise-only digits for tracker.
415 GenerateNoisyDigits();
418 // We generate the global and local trigger decisions.
419 fTriggerProcessor->ExecuteTask();
421 // Fill the output treeD
422 fOutputData->Fill("D,GLT");
424 // Write to the output tree(D).
425 // Please note that as GlobalTrigger, LocalTrigger and Digits are in the same
426 // tree (=TreeD) in different branches, this WriteDigits in fact writes all of
428 fOutputData->GetLoader()->WriteDigits("OVERWRITE");
430 // Finally, we clean up after ourselves.
431 fOutputData->ResetDigits();
432 fOutputData->ResetTrigger();
433 fOutputData->GetLoader()->UnloadDigits();
438 //_____________________________________________________________________________
440 AliMUONDigitizerV3::FindCorrespondingDigit(AliMUONDigit& digit,
441 AliMUONData* data) const
443 /// \todo add comment
445 AliMUONDataIterator it(data,"D",AliMUONDataIterator::kTriggerChambers);
449 cd = static_cast<AliMUONDigit*>(it.Next());
451 if (cd->DetElemId() == digit.DetElemId() &&
452 cd->PadX() == digit.PadX() &&
453 cd->PadY() == digit.PadY() &&
454 cd->Cathode() == digit.Cathode()){
458 //The corresponding digit is searched only forward in the AliMUONData.
459 //In this way when the first digit of the couple is given, the second digit is found and the efficiency is applied to both.
460 //Afterwards, when the second digit of the couple is given the first one is not found and hence efficiency is not applied again
462 while ( ( cd = static_cast<AliMUONDigit*>(it.Next()) ) )
464 if(!cd)continue;//avoid problems when 1 digit is removed
465 if ( cd->DetElemId() == digit.DetElemId() &&
466 cd->Hit() == digit.Hit() &&
467 cd->Cathode() != digit.Cathode() )
476 //_____________________________________________________________________________
478 AliMUONDigitizerV3::FindDigitIndex(TClonesArray& array,
479 const AliMUONDigit& digit) const
481 /// Return the index of digit within array, if that digit is there,
482 /// otherwise returns -1
484 /// \todo FIXME: this is of course not the best implementation you can think of.
485 /// Reconsider the use of hit/digit map... ? (but be sure it's needed!)
487 fFindDigitIndexTimer.Start(kFALSE);
489 Int_t n = array.GetEntriesFast();
490 for ( Int_t i = 0; i < n; ++i )
492 AliMUONDigit* d = static_cast<AliMUONDigit*>(array.UncheckedAt(i));
493 if ( d->DetElemId() == digit.DetElemId() &&
494 d->PadX() == digit.PadX() &&
495 d->PadY() == digit.PadY() &&
496 d->Cathode() == digit.Cathode() )
498 fFindDigitIndexTimer.Stop();
502 fFindDigitIndexTimer.Stop();
506 //_____________________________________________________________________________
508 AliMUONDigitizerV3::GenerateNoisyDigits()
510 /// According to a given probability, generate digits that
511 /// have a signal above the noise cut (ped+n*sigma_ped), i.e. digits
512 /// that are "only noise".
514 if ( !fNoiseFunction )
516 fNoiseFunction = new TF1("AliMUONDigitizerV3::fNoiseFunction","gaus",
517 fgkNSigmas,fgkNSigmas*10);
519 fNoiseFunction->SetParameters(1,0,1);
522 fGenerateNoisyDigitsTimer.Start(kFALSE);
524 for ( Int_t i = 0; i < AliMUONConstants::NTrackingCh(); ++i )
530 while ( !it.IsDone() )
532 for ( Int_t cathode = 0; cathode < 2; ++cathode )
534 GenerateNoisyDigitsForOneCathode(it.CurrentDE(),cathode);
540 fGenerateNoisyDigitsTimer.Stop();
543 //_____________________________________________________________________________
545 AliMUONDigitizerV3::GenerateNoisyDigitsForOneCathode(Int_t detElemId, Int_t cathode)
547 /// Generate noise-only digits for one cathode of one detection element.
548 /// Called by GenerateNoisyDigits()
550 Int_t chamberId = AliMpDEManager::GetChamberId(detElemId);
551 TClonesArray* digits = fOutputData->Digits(chamberId);
553 const AliMpVSegmentation* seg
554 = AliMpSegmentation::Instance()->GetMpSegmentation(detElemId,cathode);
555 Int_t nofPads = seg->NofPads();
557 Int_t maxIx = seg->MaxPadIndexX();
558 Int_t maxIy = seg->MaxPadIndexY();
560 static const Double_t kProbToBeOutsideNsigmas = TMath::Erfc(fgkNSigmas/TMath::Sqrt(2.0)) / 2. ;
562 Int_t nofNoisyPads = TMath::Nint(kProbToBeOutsideNsigmas*nofPads);
563 if ( !nofNoisyPads ) return;
566 TMath::Nint(gRandom->Gaus(nofNoisyPads,
567 nofNoisyPads/TMath::Sqrt(nofNoisyPads)));
569 AliDebug(3,Form("DE %d cath %d nofNoisyPads %d",detElemId,cathode,nofNoisyPads));
571 for ( Int_t i = 0; i < nofNoisyPads; ++i )
576 ix = gRandom->Integer(maxIx+1);
577 iy = gRandom->Integer(maxIy+1);
578 } while ( !seg->HasPad(AliMpIntPair(ix,iy)) );
580 d.SetDetElemId(detElemId);
581 d.SetCathode(cathode);
584 if ( FindDigitIndex(*digits,d) >= 0 )
586 // this digit is already there, and not noise-only, we simply skip it
589 AliMpPad pad = seg->PadByIndices(AliMpIntPair(ix,iy));
590 Int_t manuId = pad.GetLocation().GetFirst();
591 Int_t manuChannel = pad.GetLocation().GetSecond();
593 d.SetElectronics(manuId,manuChannel);
595 AliMUONVCalibParam* pedestals = fCalibrationData->Pedestals(detElemId,manuId);
597 Float_t pedestalMean = pedestals->ValueAsFloat(manuChannel,0);
598 Float_t pedestalSigma = pedestals->ValueAsFloat(manuChannel,1);
600 Double_t ped = fNoiseFunction->GetRandom()*pedestalSigma;
602 d.SetSignal(TMath::Nint(ped+pedestalMean+0.5));
603 d.SetPhysicsSignal(0);
605 AliDebug(3,Form("Adding a pure noise digit :"));
606 StdoutToAliDebug(3,cout << "Before Response: " << endl;
608 ApplyResponseToTrackerDigit(d,kFALSE);
609 if ( d.Signal() > 0 )
611 AddOrUpdateDigit(*digits,d);
615 AliError("Pure noise below threshold. This should not happen. Not adding "
618 StdoutToAliDebug(3,cout << "After Response: " << endl;
623 //_____________________________________________________________________________
625 AliMUONDigitizerV3::GetDataAccess(const TString& folderName)
627 /// Create an AliMUONData to deal with data found in folderName.
629 AliDebug(1,Form("Getting access to folder %s",folderName.Data()));
630 AliRunLoader* runLoader = AliRunLoader::GetRunLoader(folderName);
633 AliError(Form("Could not get RunLoader from folder %s",folderName.Data()));
636 AliLoader* loader = static_cast<AliLoader*>(runLoader->GetLoader("MUONLoader"));
639 AliError(Form("Could not get MuonLoader from folder %s",folderName.Data()));
642 AliMUONData* data = new AliMUONData(loader,"MUON","MUONDataForDigitOutput");
643 AliDebug(1,Form("AliMUONData=%p loader=%p",data,loader));
647 //_____________________________________________________________________________
649 AliMUONDigitizerV3::Init()
651 /// Initialization of the TTask :
652 /// a) set the outputData pointer
653 /// b) create the calibrationData, according to run number
654 /// c) create the trigger processing task
658 if ( fIsInitialized )
660 AliError("Object already initialized.");
666 AliError("fManager is null !");
670 fOutputData = GetDataAccess(fManager->GetOutputFolderName());
673 AliError("Can not perform digitization. I'm sorry");
676 AliDebug(1,Form("fOutputData=%p",fOutputData));
678 AliRunLoader* runLoader = fOutputData->GetLoader()->GetRunLoader();
679 AliRun* galice = runLoader->GetAliRun();
680 Int_t runnumber = galice->GetRunNumber();
682 fCalibrationData = new AliMUONCalibrationData(runnumber);
684 fTriggerProcessor = new AliMUONTriggerElectronics(fOutputData,fCalibrationData);
686 if ( muon()->GetTriggerEffCells() )
688 fTriggerEfficiency = fCalibrationData->TriggerEfficiency();
689 if ( fTriggerEfficiency )
691 AliDebug(1, "Will apply trigger efficiency");
695 AliError("I was requested to apply trigger efficiency, but I could "
700 if ( fGenerateNoisyDigits )
702 AliDebug(1, "Will generate noise-only digits for tracker");
705 fIsInitialized = kTRUE;
709 //_____________________________________________________________________________
711 AliMUONDigitizerV3::MergeDigits(const AliMUONDigit& src,
712 AliMUONDigit& srcAndDest)
714 /// Merge 2 digits (src and srcAndDest) into srcAndDest.
716 AliDebug(1,"Merging the following digits:");
717 StdoutToAliDebug(1,src.Print("tracks"););
718 StdoutToAliDebug(1,srcAndDest.Print("tracks"););
720 Bool_t check = ( src.DetElemId() == srcAndDest.DetElemId() &&
721 src.PadX() == srcAndDest.PadX() &&
722 src.PadY() == srcAndDest.PadY() &&
723 src.Cathode() == srcAndDest.Cathode() );
729 srcAndDest.AddSignal(src.Signal());
730 srcAndDest.AddPhysicsSignal(src.Physics());
731 for ( Int_t i = 0; i < src.Ntracks(); ++i )
733 srcAndDest.AddTrack(src.Track(i),src.TrackCharge(i));
735 StdoutToAliDebug(1,cout << "result:"; srcAndDest.Print("tracks"););
739 //_____________________________________________________________________________
741 AliMUONDigitizerV3::MergeWithSDigits(AliMUONData& outputData,
742 const AliMUONData& inputData, Int_t mask)
744 /// Merge the sdigits in inputData with the digits already present in outputData
748 for ( Int_t ich = 0; ich < AliMUONConstants::NCh(); ++ich )
750 TClonesArray* iDigits = inputData.SDigits(ich);
751 TClonesArray* oDigits = outputData.Digits(ich);
754 AliError(Form("Could not get sdigits for ich=%d",ich));
757 Int_t nSDigits = iDigits->GetEntriesFast();
758 for ( Int_t k = 0; k < nSDigits; ++k )
760 AliMUONDigit* sdigit = static_cast<AliMUONDigit*>(iDigits->UncheckedAt(k));
763 AliError(Form("Could not get sdigit for ich=%d and k=%d",ich,k));
767 // Update the track references using the mask.
768 // FIXME: this is dirty, for backward compatibility only.
769 // Should re-design all this way of keeping track of MC information...
770 if ( mask ) sdigit->PatchTracks(mask);
771 // Then add or update the digit to the output.
772 AddOrUpdateDigit(*oDigits,*sdigit);