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 //////////////////////////////////////////////////////////////////////////////
21 // Class performs digitization of Summable digits
23 // In addition it performs mixing of summable digits from different events.
25 // For each event two branches are created in TreeD:
26 // "EMCAL" - list of digits
27 // "AliEMCALDigitizer" - AliEMCALDigitizer with all parameters used in digitization
29 // Note, that one cset title for new digits branch, and repeat digitization with
30 // another set of parameters.
33 // root[0] AliEMCALDigitizer * d = new AliEMCALDigitizer() ;
34 // root[1] d->ExecuteTask()
35 // Warning in <TDatabasePDG::TDatabasePDG>: object already instantiated
36 // //Digitizes SDigitis in all events found in file galice.root
38 // root[2] AliEMCALDigitizer * d1 = new AliEMCALDigitizer("galice1.root") ;
39 // // Will read sdigits from galice1.root
40 // root[3] d1->MixWith("galice2.root")
41 // Warning in <TDatabasePDG::TDatabasePDG>: object already instantiated
42 // // Reads another portion of sdigits from galice2.root
43 // root[3] d1->MixWith("galice3.root")
44 // // Reads another portion of sdigits from galice3.root
45 // root[4] d->ExecuteTask("deb timing")
46 // // Reads SDigits from files galice1.root, galice2.root ....
47 // // mixes them and stores produced Digits in file galice1.root
48 // // deb - prints number of produced digits
49 // // deb all - prints list of produced digits
50 // // timing - prints time used for digitization
51 ////////////////////////////////////////////////////////////////////////////////////
53 //*-- Author: Sahal Yacoob (LBL)
54 // based on : AliEMCALDigitizer
56 // August 2002 Yves Schutz: clone PHOS as closely as possible and intoduction
57 // of new IO (à la PHOS)
58 ///_________________________________________________________________________________
60 // --- ROOT system ---
63 #include "TBenchmark.h"
65 // --- Standard library ---
67 // --- AliRoot header files ---
68 #include "AliRunDigitizer.h"
69 #include "AliEMCALDigit.h"
71 #include "AliEMCALGetter.h"
72 #include "AliEMCALDigitizer.h"
73 #include "AliEMCALSDigitizer.h"
74 #include "AliEMCALGeometry.h"
75 #include "AliEMCALTick.h"
77 ClassImp(AliEMCALDigitizer)
80 //____________________________________________________________________________
81 AliEMCALDigitizer::AliEMCALDigitizer():AliDigitizer("",""),
88 fDefaultInit = kTRUE ;
89 fManager = 0 ; // We work in the standalong mode
90 fEventFolderName = "" ;
93 //____________________________________________________________________________
94 AliEMCALDigitizer::AliEMCALDigitizer(TString alirunFileName, TString eventFolderName):
95 AliDigitizer("EMCAL"+AliConfig::Instance()->GetDigitizerTaskName(), alirunFileName),
96 fInputFileNames(0), fEventNames(0), fEventFolderName(eventFolderName)
102 fDefaultInit = kFALSE ;
103 fManager = 0 ; // We work in the standalong mode
106 //____________________________________________________________________________
107 AliEMCALDigitizer::AliEMCALDigitizer(const AliEMCALDigitizer & d) : AliDigitizer(d)
111 SetName(d.GetName()) ;
112 SetTitle(d.GetTitle()) ;
113 fDigitThreshold = d.fDigitThreshold ;
114 fMeanPhotonElectron = d.fMeanPhotonElectron ;
115 fPedestal = d.fPedestal ;
117 fPinNoise = d.fPinNoise ;
118 fTimeResolution = d.fTimeResolution ;
119 fTimeThreshold = d.fTimeThreshold ;
120 fTimeSignalLength = d.fTimeSignalLength ;
121 fADCchannelEC = d.fADCchannelEC ;
122 fADCpedestalEC = d.fADCpedestalEC ;
123 fNADCEC = d.fNADCEC ;
124 fEventFolderName = d.fEventFolderName;
127 //____________________________________________________________________________
128 AliEMCALDigitizer::AliEMCALDigitizer(AliRunDigitizer * rd):
129 AliDigitizer(rd,"EMCAL"+AliConfig::Instance()->GetDigitizerTaskName()),
132 // ctor Init() is called by RunDigitizer
134 fEventFolderName = fManager->GetInputFolderName(0) ;
135 SetTitle(dynamic_cast<AliStream*>(fManager->GetInputStream(0))->GetFileName(0));
137 fDefaultInit = kFALSE ;
140 //____________________________________________________________________________
141 AliEMCALDigitizer::~AliEMCALDigitizer()
143 AliEMCALGetter * gime =AliEMCALGetter::Instance(GetTitle(),fEventFolderName);
144 gime->EmcalLoader()->CleanDigitizer();
145 delete [] fInputFileNames ;
146 delete [] fEventNames ;
150 //____________________________________________________________________________
151 void AliEMCALDigitizer::Digitize(Int_t event)
154 // Makes the digitization of the collected summable digits
155 // for this it first creates the array of all EMCAL modules
156 // filled with noise (different for EMC, CPV and PPSD) and
157 // after that adds contributions from SDigits. This design
158 // helps to avoid scanning over the list of digits to add
159 // contribution of any new SDigit.
161 AliEMCALGetter * gime = AliEMCALGetter::Instance(GetTitle(), fEventFolderName) ;
162 Int_t ReadEvent = event ;
164 ReadEvent = dynamic_cast<AliStream*>(fManager->GetInputStream(0))->GetCurrentEventNumber() ;
165 Info("Digitize", "Adding event %d from input stream 0 %s %s", ReadEvent, GetTitle(), fEventFolderName.Data()) ;
166 gime->Event(ReadEvent, "S") ;
167 TClonesArray * digits = gime->Digits() ;
170 const AliEMCALGeometry *geom = gime->EMCALGeometry() ;
172 Int_t nEMC = geom->GetNPhi()*geom->GetNZ(); //max number of digits possible
176 digits->Expand(nEMC) ;
178 // get first the sdigitizer from the tasks list (must have same name as the digitizer)
179 if ( !gime->SDigitizer() )
180 gime->LoadSDigitizer();
181 AliEMCALSDigitizer * sDigitizer = gime->SDigitizer();
184 Fatal("Digitize", "SDigitizer with name %s %s not found", fEventFolderName.Data(), GetTitle() ) ;
186 //take all the inputs to add together and load the SDigits
187 TObjArray * sdigArray = new TObjArray(fInput) ;
188 sdigArray->AddAt(gime->SDigits(), 0) ;
190 for(i = 1 ; i < fInput ; i++){
191 TString tempo(fEventNames[i]) ;
193 AliEMCALGetter * gime = AliEMCALGetter::Instance(fInputFileNames[i], tempo) ;
195 ReadEvent = dynamic_cast<AliStream*>(fManager->GetInputStream(i))->GetCurrentEventNumber() ;
196 Info("Digitize", "Adding event %d from input stream %d %s %s", ReadEvent, i, fInputFileNames[i].Data(), tempo.Data()) ;
197 gime->Event(ReadEvent,"S");
198 sdigArray->AddAt(gime->SDigits(), i) ;
201 //Find the first tower with signal
202 Int_t nextSig = nEMC + 1 ;
203 TClonesArray * sdigits ;
204 for(i = 0 ; i < fInput ; i++){
205 sdigits = dynamic_cast<TClonesArray *>(sdigArray->At(i)) ;
206 if ( !sdigits->GetEntriesFast() )
208 Int_t curNext = dynamic_cast<AliEMCALDigit *>(sdigits->At(0))->GetId() ;
209 if(curNext < nextSig)
213 TArrayI index(fInput) ;
214 index.Reset() ; //Set all indexes to zero
216 AliEMCALDigit * digit ;
217 AliEMCALDigit * curSDigit ;
219 TClonesArray * ticks = new TClonesArray("AliEMCALTick",1000) ;
221 //Put Noise contribution
222 for(absID = 1; absID <= nEMC; absID++){
224 // amplitude set to zero, noise will be added later
225 new((*digits)[absID-1]) AliEMCALDigit( -1, -1, absID, 0, TimeOfNoise() ) ;
226 //look if we have to add signal?
227 digit = dynamic_cast<AliEMCALDigit *>(digits->At(absID-1)) ;
230 //Add SDigits from all inputs
233 Float_t a = digit->GetAmp() ;
234 Float_t b = TMath::Abs( a /fTimeSignalLength) ;
235 //Mark the beginning of the signal
236 new((*ticks)[contrib++]) AliEMCALTick(digit->GetTime(),0, b);
237 //Mark the end of the signal
238 new((*ticks)[contrib++]) AliEMCALTick(digit->GetTime()+fTimeSignalLength, -a, -b);
241 for(i = 0; i< fInput ; i++){ //loop over (possible) merge sources
242 if(dynamic_cast<TClonesArray *>(sdigArray->At(i))->GetEntriesFast() > index[i] )
243 curSDigit = dynamic_cast<AliEMCALDigit*>(dynamic_cast<TClonesArray *>(sdigArray->At(i))->At(index[i])) ;
246 //May be several digits will contribute from the same input
247 while(curSDigit && (curSDigit->GetId() == absID)){
248 //Shift primary to separate primaries belonging different inputs
249 Int_t primaryoffset ;
251 primaryoffset = fManager->GetMask(i) ;
254 curSDigit->ShiftPrimary(primaryoffset) ;
256 a = curSDigit->GetAmp() ;
257 b = a /fTimeSignalLength ;
258 new((*ticks)[contrib++]) AliEMCALTick(curSDigit->GetTime(),0, b);
259 new((*ticks)[contrib++]) AliEMCALTick(curSDigit->GetTime()+fTimeSignalLength, -a, -b);
261 *digit = *digit + *curSDigit ; //add energies
264 if( dynamic_cast<TClonesArray *>(sdigArray->At(i))->GetEntriesFast() > index[i] )
265 curSDigit = dynamic_cast<AliEMCALDigit*>(dynamic_cast<TClonesArray *>(sdigArray->At(i))->At(index[i])) ;
270 // add fluctuations for photo-electron creation
271 amp = sDigitizer->Calibrate(digit->GetAmp()) ; // GeV
272 amp *= static_cast<Float_t>(gRandom->Poisson(fMeanPhotonElectron)) / static_cast<Float_t>(fMeanPhotonElectron) ;
274 //calculate and set time
275 Float_t time = FrontEdgeTime(ticks) ;
276 digit->SetTime(time) ;
278 //Find next signal module
280 for(i = 0 ; i < fInput ; i++){
281 sdigits = dynamic_cast<TClonesArray *>(sdigArray->At(i)) ;
282 Int_t curNext = nextSig ;
283 if(sdigits->GetEntriesFast() > index[i] ){
284 curNext = dynamic_cast<AliEMCALDigit *>(sdigits->At(index[i]))->GetId() ;
286 if(curNext < nextSig) nextSig = curNext ;
290 amp += TMath::Abs(gRandom->Gaus(0., fPinNoise)) ;
291 digit->SetAmp(sDigitizer->Digitize(amp)) ;
297 delete sdigArray ; //We should not delete its contents
299 //remove digits below thresholds
300 for(i = 0 ; i < nEMC ; i++){
301 digit = dynamic_cast<AliEMCALDigit*>( digits->At(i) ) ;
302 Float_t threshold = fDigitThreshold ;
303 if(sDigitizer->Calibrate( digit->GetAmp() ) < threshold)
304 digits->RemoveAt(i) ;
306 digit->SetTime(gRandom->Gaus(digit->GetTime(),fTimeResolution) ) ;
311 Int_t ndigits = digits->GetEntriesFast() ;
312 digits->Expand(ndigits) ;
314 //Set indexes in list of digits
315 for (i = 0 ; i < ndigits ; i++) {
316 digit = dynamic_cast<AliEMCALDigit *>( digits->At(i) ) ;
317 digit->SetIndexInList(i) ;
318 Float_t energy = sDigitizer->Calibrate(digit->GetAmp()) ;
319 digit->SetAmp(DigitizeEnergy(energy) ) ;
323 //____________________________________________________________________________
325 Int_t AliEMCALDigitizer::DigitizeEnergy(Float_t energy)
327 Int_t channel = -999;
328 channel = static_cast<Int_t> (TMath::Ceil( (energy + fADCpedestalEC)/fADCchannelEC )) ;
329 if(channel > fNADCEC )
334 //____________________________________________________________________________
335 void AliEMCALDigitizer::Exec(Option_t *option)
337 // Steering method to process digitization for events
338 // in the range from fFirstEvent to fLastEvent.
339 // This range is optionally set by SetEventRange().
340 // if fLastEvent=-1, then process events until the end.
341 // by default fLastEvent = fFirstEvent (process only one event)
343 if (!fInit) { // to prevent overwrite existing file
344 Error( "Exec", "Give a version name different from %s", fEventFolderName.Data() ) ;
348 if (strstr(option,"print")) {
353 if(strstr(option,"tim"))
354 gBenchmark->Start("EMCALDigitizer");
356 AliEMCALGetter * gime = AliEMCALGetter::Instance(GetTitle()) ;
358 if (fLastEvent == -1)
359 fLastEvent = gime->MaxEvent() - 1 ;
361 fLastEvent = fFirstEvent ;
363 Int_t nEvents = fLastEvent - fFirstEvent + 1;
367 for (ievent = fFirstEvent; ievent <= fLastEvent; ievent++) {
369 gime->Event(ievent,"S") ;
371 Digitize(ievent) ; //Add prepared SDigits to digits and add the noise
375 if(strstr(option,"deb"))
378 //increment the total number of Digits per run
379 fDigitsInRun += gime->Digits()->GetEntriesFast() ;
382 if(strstr(option,"tim")){
383 gBenchmark->Stop("EMCALDigitizer");
384 printf("Exec: took %f seconds for Digitizing %f seconds per event",
385 gBenchmark->GetCpuTime("EMCALDigitizer"), gBenchmark->GetCpuTime("EMCALDigitizer")/nEvents ) ;
389 //____________________________________________________________________________
390 Float_t AliEMCALDigitizer::FrontEdgeTime(TClonesArray * ticks)
392 // Returns the shortest time among all time ticks
394 ticks->Sort() ; //Sort in accordance with times of ticks
396 AliEMCALTick * ctick = (AliEMCALTick *) it.Next() ;
397 Float_t time = ctick->CrossingTime(fTimeThreshold) ;
400 while((t=(AliEMCALTick*) it.Next())){
401 if(t->GetTime() < time) //This tick starts before crossing
406 time = ctick->CrossingTime(fTimeThreshold) ;
411 //____________________________________________________________________________
412 Bool_t AliEMCALDigitizer::Init()
414 // Makes all memory allocations
416 AliEMCALGetter * gime = AliEMCALGetter::Instance(GetTitle(), fEventFolderName) ;
418 Error("Init", "Could not obtain the Getter object for file %s and event %s !", GetTitle(), fEventFolderName.Data()) ;
421 TString opt("Digits") ;
422 if(gime->VersionExists(opt) ) {
423 Error( "Init", "Give a version name different from %s", fEventFolderName.Data() ) ;
427 // Post Digitizer to the white board
428 gime->PostDigitizer(this) ;
431 fLastEvent = fFirstEvent ;
434 fInput = fManager->GetNinputs() ;
438 fInputFileNames = new TString[fInput] ;
439 fEventNames = new TString[fInput] ;
440 fInputFileNames[0] = GetTitle() ;
441 fEventNames[0] = fEventFolderName.Data() ;
443 for (index = 1 ; index < fInput ; index++) {
444 fInputFileNames[index] = dynamic_cast<AliStream*>(fManager->GetInputStream(index))->GetFileName(0);
445 TString tempo = fManager->GetInputFolderName(index) ;
446 fEventNames[index] = tempo.Remove(tempo.Length()-1) ; // strip of the stream number added bt fManager
449 //to prevent cleaning of this object while GetEvent is called
450 gime->EmcalLoader()->GetDigitsDataLoader()->GetBaseTaskLoader()->SetDoNotReload(kTRUE);
455 //____________________________________________________________________________
456 void AliEMCALDigitizer::InitParameters()
458 fMeanPhotonElectron = 18200 ; // electrons per GeV
459 fPinNoise = 0.003 ; // noise equivalent GeV (random choice)
460 if (fPinNoise == 0. )
461 Warning("InitParameters", "No noise added\n") ;
462 fDigitThreshold = fPinNoise * 3; //2 sigma
463 fTimeResolution = 1.0e-9 ;
464 fTimeSignalLength = 1.0e-9 ;
466 fADCchannelEC = 0.00305; // width of one ADC channel in GeV - HG fix so that we see 200 GeV gammas
467 fADCpedestalEC = 0.005 ; // GeV
468 fNADCEC = (Int_t) TMath::Power(2,16) ; // number of channels in Tower ADC
470 fTimeThreshold = 0.001*10000000 ; //Means 1 MeV in terms of SDigits amplitude
474 //__________________________________________________________________
475 void AliEMCALDigitizer::MixWith(TString alirunFileName, TString eventFolderName)
477 // Allows to produce digits by superimposing background and signal event.
478 // It is assumed, that headers file with SIGNAL events is opened in
480 // Sets the BACKGROUND event, with which the SIGNAL event is to be mixed
481 // Thus we avoid writing (changing) huge and expensive
482 // backgound files: all output will be writen into SIGNAL, i.e.
483 // opened in constructor file.
485 // One can open as many files to mix with as one needs.
486 // However only Sdigits with the same name (i.e. constructed with the same SDigitizer)
489 if( strcmp(GetName(), "") == 0 )
493 Error("MixWith", "Cannot use this method under AliRunDigitizer") ;
496 // looking for file which contains AliRun
497 if (gSystem->AccessPathName(alirunFileName)) {// file does not exist
498 Error("MixWith", "File %s does not exist!", alirunFileName.Data()) ;
501 // looking for the file which contains SDigits
502 AliEMCALGetter * gime = AliEMCALGetter::Instance() ;
503 TString fileName( gime->GetSDigitsFileName() ) ;
504 if ( eventFolderName != AliConfig::GetDefaultEventFolderName()) // only if not the default folder name
505 fileName = fileName.ReplaceAll(".root", "") + "_" + eventFolderName + ".root" ;
506 if ( (gSystem->AccessPathName(fileName)) ) {
507 Error("MixWith", "The file %s does not exist!", fileName.Data()) ;
510 // need to increase the arrays
511 TString tempo = fInputFileNames[fInput-1] ;
512 delete [] fInputFileNames ;
513 fInputFileNames = new TString[fInput+1] ;
514 fInputFileNames[fInput-1] = tempo ;
516 tempo = fEventNames[fInput-1] ;
517 delete [] fEventNames ;
518 fEventNames = new TString[fInput+1] ;
519 fEventNames[fInput-1] = tempo ;
521 fInputFileNames[fInput] = alirunFileName ;
522 fEventNames[fInput] = eventFolderName ;
526 //__________________________________________________________________
527 void AliEMCALDigitizer::Print()const
529 // Print Digitizer's parameters
530 printf("Print: \n------------------- %s -------------", GetName() ) ;
531 if( strcmp(fEventFolderName.Data(), "") != 0 ){
532 printf(" Writing Digits to branch with title %s\n", fEventFolderName.Data()) ;
536 nStreams = GetNInputStreams() ;
541 for (index = 0 ; index < nStreams ; index++) {
542 TString tempo(fEventNames[index]) ;
544 AliEMCALGetter * gime = AliEMCALGetter::Instance(fInputFileNames[index], tempo) ;
545 TString fileName( gime->GetSDigitsFileName() ) ;
546 if ( fEventNames[index] != AliConfig::GetDefaultEventFolderName()) // only if not the default folder name
547 fileName = fileName.ReplaceAll(".root", "") + "_" + fEventNames[index] + ".root" ;
548 printf ("Adding SDigits from %s %s\n", fInputFileNames[index].Data(), fileName.Data()) ;
550 AliEMCALGetter * gime = AliEMCALGetter::Instance(GetTitle(), fEventFolderName) ;
551 printf("\nWriting digits to %s", gime->GetDigitsFileName().Data()) ;
553 printf("\nWith following parameters:\n") ;
555 printf(" Electronics noise in EMC (fPinNoise) = %f\n", fPinNoise) ;
556 printf(" Threshold in EMC (fDigitThreshold) = %f\n", fDigitThreshold) ;
557 printf("---------------------------------------------------\n") ;
560 printf("Print: AliEMCALDigitizer not initialized") ;
563 //__________________________________________________________________
564 void AliEMCALDigitizer::PrintDigits(Option_t * option){
566 AliEMCALGetter * gime = AliEMCALGetter::Instance(GetTitle(), fEventFolderName) ;
567 TClonesArray * digits = gime->Digits() ;
569 printf("PrintDigits: %d", digits->GetEntriesFast()) ;
570 printf("\nevent %d", gAlice->GetEvNumber()) ;
571 printf("\n Number of entries in Digits list %d", digits->GetEntriesFast() ) ;
573 if(strstr(option,"all")){
575 AliEMCALDigit * digit;
576 printf("\nEMC digits (with primaries):\n") ;
577 printf("\n Id Amplitude Time Index Nprim: Primaries list \n") ;
579 for (index = 0 ; index < digits->GetEntries() ; index++) {
580 digit = dynamic_cast<AliEMCALDigit *>(digits->At(index)) ;
581 printf("\n%6d %8d %6.5e %4d %2d : ",
582 digit->GetId(), digit->GetAmp(), digit->GetTime(), digit->GetIndexInList(), digit->GetNprimary()) ;
584 for (iprimary=0; iprimary<digit->GetNprimary(); iprimary++) {
585 printf("%d ",digit->GetPrimary(iprimary+1) ) ;
591 //__________________________________________________________________
592 Float_t AliEMCALDigitizer::TimeOfNoise(void)
594 // Calculates the time signal generated by noise
595 Info("TimeOfNoise", "Change me") ;
596 return gRandom->Rndm() * 1.28E-5;
599 //__________________________________________________________________
600 void AliEMCALDigitizer::Unload()
602 // Unloads the SDigits and Digits
604 for(i = 1 ; i < fInput ; i++){
605 TString tempo(fEventNames[i]) ;
607 AliEMCALGetter * gime = AliEMCALGetter::Instance(fInputFileNames[i], tempo) ;
608 gime->EmcalLoader()->UnloadSDigits() ;
611 AliEMCALGetter * gime = AliEMCALGetter::Instance(GetTitle(), fEventFolderName) ;
612 gime->EmcalLoader()->UnloadDigits() ;
615 //_________________________________________________________________________________________
616 void AliEMCALDigitizer::WriteDigits()
619 // Makes TreeD in the output file.
620 // Check if branch already exists:
621 // if yes, exit without writing: ROOT TTree does not support overwriting/updating of
622 // already existing branches.
623 // else creates branch with Digits, named "EMCAL", title "...",
624 // and branch "AliEMCALDigitizer", with the same title to keep all the parameters
625 // and names of files, from which digits are made.
627 AliEMCALGetter * gime = AliEMCALGetter::Instance(GetTitle(), fEventFolderName) ;
628 const TClonesArray * digits = gime->Digits() ;
629 TTree * treeD = gime->TreeD();
631 // -- create Digits branch
632 Int_t bufferSize = 32000 ;
633 TBranch * digitsBranch = treeD->Branch("EMCAL",&digits,bufferSize);
634 digitsBranch->SetTitle(fEventFolderName);
635 digitsBranch->Fill() ;
637 gime->WriteDigits("OVERWRITE");
638 gime->WriteDigitizer("OVERWRITE");