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 // Base Class for EMCAL description:
19 // This class contains material definitions
20 // for the EMCAL - It does not place the detector in Alice
21 //*-- Author: Yves Schutz (SUBATECH)
23 //*-- Additional Contributions: Sahal Yacoob (LBNL/UCT)
24 // : Alexei Pavlinov (WSU)
26 //////////////////////////////////////////////////////////////////////////////
28 // --- ROOT system ---
31 #include <TGeoGlobalMagField.h>
36 #include <TVirtualMC.h>
38 // --- Standard library ---
40 // --- AliRoot header files ---
45 #include "AliRunLoader.h"
46 #include "AliCDBManager.h"
47 #include "AliEMCALLoader.h"
48 #include "AliEMCALSDigitizer.h"
49 #include "AliEMCALDigitizer.h"
50 #include "AliEMCALDigit.h"
51 #include "AliEMCALRawUtils.h"
52 #include "AliCDBManager.h"
53 #include "AliCDBEntry.h"
54 #include "AliEMCALRawUtils.h"
55 #include "AliRawReader.h"
56 #include "AliEMCALTriggerData.h"
57 #include "AliEMCALRecParam.h"
58 #include "AliRawEventHeaderBase.h"
63 AliEMCALRawUtils* AliEMCAL::fgRawUtils = 0; // EMCAL raw utilities class
65 //____________________________________________________________________________
72 fCheckRunNumberAndGeoVersion(kTRUE),
79 // Should call AliEMCALGeometry::GetInstance(EMCAL->GetTitle(),"") for getting EMCAL geometry
82 //____________________________________________________________________________
83 AliEMCAL::AliEMCAL(const char* name, const char* title,
84 const Bool_t checkGeoAndRun)
85 : AliDetector(name,title),
90 fCheckRunNumberAndGeoVersion(checkGeoAndRun),
93 // ctor : title is used to identify the layout
98 //____________________________________________________________________________
106 //____________________________________________________________________________
107 void AliEMCAL::InitConstants()
109 //initialize EMCAL values
111 fBirkC1 = 0.013/1.032;
112 fBirkC2 = 9.6e-6/(1.032 * 1.032);
115 //Not needed, modify $ALICE_ROOT/data/galice.cuts instead.
116 //Load the modified one in the configuration file with SetTransPar
117 // //____________________________________________________________________________
118 // void AliEMCAL::DefineMediumParameters()
121 // // EMCAL cuts (Geant3)
123 // Int_t * idtmed = fIdtmed->GetArray() - 1599 ;
124 // // --- Set decent energy thresholds for gamma and electron tracking
126 // // Tracking threshold for photons and electrons in Lead
127 // Float_t cutgam=10.e-5; // 100 kev;
128 // Float_t cutele=10.e-5; // 100 kev;
129 // TString ntmp(GetTitle());
131 // if(ntmp.Contains("10KEV")) {
132 // cutele = cutgam = 1.e-5;
133 // } else if(ntmp.Contains("50KEV")) {
134 // cutele = cutgam = 5.e-5;
135 // } else if(ntmp.Contains("100KEV")) {
136 // cutele = cutgam = 1.e-4;
137 // } else if(ntmp.Contains("200KEV")) {
138 // cutele = cutgam = 2.e-4;
139 // } else if(ntmp.Contains("500KEV")) {
140 // cutele = cutgam = 5.e-4;
143 // gMC->Gstpar(idtmed[1600],"CUTGAM", cutgam);
144 // gMC->Gstpar(idtmed[1600],"CUTELE", cutele); // 1MEV -> 0.1MEV; 15-aug-05
145 // gMC->Gstpar(idtmed[1600],"BCUTE", cutgam); // BCUTE and BCUTM start from GUTGUM
146 // gMC->Gstpar(idtmed[1600],"BCUTM", cutgam); // BCUTE and BCUTM start from GUTGUM
147 // // --- Generate explicitly delta rays in Lead ---
148 // gMC->Gstpar(idtmed[1600], "LOSS", 3) ;
149 // gMC->Gstpar(idtmed[1600], "DRAY", 1) ;
150 // gMC->Gstpar(idtmed[1600], "DCUTE", cutele) ;
151 // gMC->Gstpar(idtmed[1600], "DCUTM", cutele) ;
153 // // --- in aluminium parts ---
154 // gMC->Gstpar(idtmed[1602],"CUTGAM", cutgam) ;
155 // gMC->Gstpar(idtmed[1602],"CUTELE", cutele) ;
156 // gMC->Gstpar(idtmed[1602],"BCUTE", cutgam); // BCUTE and BCUTM start from GUTGUM
157 // gMC->Gstpar(idtmed[1602],"BCUTM", cutgam); // BCUTE and BCUTM start from GUTGUM
158 // gMC->Gstpar(idtmed[1602], "LOSS",3.) ;
159 // gMC->Gstpar(idtmed[1602], "DRAY",1.) ;
160 // gMC->Gstpar(idtmed[1602], "DCUTE", cutele) ;
161 // gMC->Gstpar(idtmed[1602], "DCUTM", cutele) ;
163 // // --- and finally thresholds for photons and electrons in the scintillator ---
164 // gMC->Gstpar(idtmed[1601],"CUTGAM", cutgam) ;
165 // gMC->Gstpar(idtmed[1601],"CUTELE", cutele) ;// 1MEV -> 0.1MEV; 15-aug-05
166 // gMC->Gstpar(idtmed[1601],"BCUTE", cutgam); // BCUTE and BCUTM start from GUTGUM
167 // gMC->Gstpar(idtmed[1601],"BCUTM", cutgam); // BCUTE and BCUTM start from GUTGUM
168 // gMC->Gstpar(idtmed[1601], "LOSS",3) ; // generate delta rays
169 // gMC->Gstpar(idtmed[1601], "DRAY",1) ;
170 // gMC->Gstpar(idtmed[1601], "DCUTE", cutele) ;
171 // gMC->Gstpar(idtmed[1601], "DCUTM", cutele) ;
174 // gMC->Gstpar(idtmed[1603],"CUTGAM", cutgam);
175 // gMC->Gstpar(idtmed[1603],"CUTELE", cutele);
176 // gMC->Gstpar(idtmed[1603],"BCUTE", cutgam); // BCUTE and BCUTM start from GUTGUM
177 // gMC->Gstpar(idtmed[1603],"BCUTM", cutgam); // BCUTE and BCUTM start from GUTGUM
178 // // --- Generate explicitly delta rays
179 // gMC->Gstpar(idtmed[1603], "LOSS",3);
180 // gMC->Gstpar(idtmed[1603], "DRAY",1);
181 // gMC->Gstpar(idtmed[1603], "DCUTE", cutele) ;
182 // gMC->Gstpar(idtmed[1603], "DCUTM", cutele) ;
184 // AliEMCALGeometry* geom = GetGeometry();
185 // if(geom->GetILOSS()>=0) {
186 // for(int i=1600; i<=1603; i++) gMC->Gstpar(idtmed[i], "LOSS", geom->GetILOSS()) ;
188 // if(geom->GetIHADR()>=0) {
189 // for(int i=1600; i<=1603; i++) gMC->Gstpar(idtmed[i], "HADR", geom->GetIHADR()) ;
193 //____________________________________________________________________________
194 AliDigitizer* AliEMCAL::CreateDigitizer(AliDigitizationInput* digInput) const
196 //create and return the digitizer
197 return new AliEMCALDigitizer(digInput);
200 //____________________________________________________________________________
201 void AliEMCAL::CreateMaterials()
203 // Definitions of materials to build EMCAL and associated tracking media.
204 // media number in idtmed are 1599 to 1698.
206 Float_t aAir[4]={12.0107,14.0067,15.9994,39.948};
207 Float_t zAir[4]={6.,7.,8.,18.};
208 Float_t wAir[4]={0.000124,0.755267,0.231781,0.012827};
209 Float_t dAir = 1.20479E-3;
210 AliMixture(0, "Air$", aAir, zAir, dAir, 4, wAir) ;
213 AliMaterial(1, "Pb$", 207.2, 82, 11.35, 0.56, 0., 0, 0) ;
216 // --- The polysterene scintillator (CH) ---
217 Float_t aP[2] = {12.011, 1.00794} ;
218 Float_t zP[2] = {6.0, 1.0} ;
219 Float_t wP[2] = {1.0, 1.0} ;
222 AliMixture(2, "Polystyrene$", aP, zP, dP, -2, wP) ;
225 AliMaterial(3, "Al$", 26.98, 13., 2.7, 8.9, 999., 0, 0) ;
226 // --- Absorption length is ignored ^
228 // 25-aug-04 by PAI - see PMD/AliPMDv0.cxx for STEEL definition
229 Float_t asteel[4] = { 55.847,51.9961,58.6934,28.0855 };
230 Float_t zsteel[4] = { 26.,24.,28.,14. };
231 Float_t wsteel[4] = { .715,.18,.1,.005 };
232 AliMixture(4, "STAINLESS STEEL$", asteel, zsteel, 7.88, 4, wsteel);
234 // Oct 26,2010 : Multipurpose Copy Paper UNV-21200), weiht 75 g/m**2.
235 // *Cellulose C6H10O5
236 // Component C A=12.01 Z=6. W=6./21.
237 // Component H A=1. Z=1. W=10./21.
238 // Component O A=16. Z=8. W=5./21.
239 Float_t apaper[3] = { 12.01, 1.0, 16.0};
240 Float_t zpaper[3] = { 6.0, 1.0, 8.0};
241 Float_t wpaper[3] = {6./21., 10./21., 5./21.};
242 AliMixture(5, "BondPaper$", apaper, zpaper, 0.75, 3, wpaper);
244 // DEFINITION OF THE TRACKING MEDIA
245 // Look to the $ALICE_ROOT/data/galice.cuts for particular values
247 // Don't forget to add a new tracking medium with non-default cuts
249 // for EMCAL: idtmed[1599->1698] equivalent to fIdtmed[0->100]
250 Int_t isxfld = ((AliMagF*)TGeoGlobalMagField::Instance()->GetField())->Integ() ;
251 Float_t sxmgmx = ((AliMagF*)TGeoGlobalMagField::Instance()->GetField())->Max() ;
253 // Air -> idtmed[1599]
254 AliMedium(0, "Air$", 0, 0,
255 isxfld, sxmgmx, 10.0, 1.0, 0.1, 0.1, 10.0, 0, 0) ;
257 // The Lead -> idtmed[1600]
259 AliMedium(1, "Lead$", 1, 0,
260 isxfld, sxmgmx, 10.0, 0.1, 0.1, 0.1, 0.1, 0, 0) ;
262 // The scintillator of the CPV made of Polystyrene scintillator -> idtmed[1601]
263 float deemax = 0.1; // maximum fractional energy loss in one step (0 < DEEMAX < deemax )
264 AliMedium(2, "Scintillator$", 2, 1,
265 isxfld, sxmgmx, 10.0, 0.001, deemax, 0.001, 0.001, 0, 0) ;
267 // Various Aluminium parts made of Al -> idtmed[1602]
268 AliMedium(3, "Al$", 3, 0,
269 isxfld, sxmgmx, 10.0, 0.1, 0.1, 0.001, 0.001, 0, 0) ;
271 // 25-aug-04 by PAI : see PMD/AliPMDv0.cxx for STEEL definition -> idtmed[1603]
272 AliMedium(4, "S steel$", 4, 0,
273 isxfld, sxmgmx, 10.0, 0.01, 0.1, 0.001, 0.001, 0, 0) ;
275 // Oct 26,2010; Nov 24,2010 -> idtmed[1604]
277 AliMedium(5, "Paper$", 5, 0,
278 isxfld, sxmgmx, 10.0, deemax, 0.1, 0.001, 0.001, 0, 0) ;
281 //set constants for Birk's Law implentation
284 fBirkC2 = 9.6e-6/(dP * dP);
288 //____________________________________________________________________________
289 void AliEMCAL::Init()
292 //Not needed, modify $ALICE_ROOT/data/galice.cuts instead.
293 //Load the modified one in the configuration file with SetTransPar
294 //DefineMediumParameters();
297 //____________________________________________________________________________
298 void AliEMCAL::Digits2Raw() {
300 static AliEMCALRawUtils rawUtils;
301 rawUtils.Digits2Raw();
304 //____________________________________________________________________________
305 void AliEMCAL::Hits2SDigits()
307 // create summable digits
310 AliEMCALSDigitizer emcalDigitizer(fLoader->GetRunLoader()->GetFileName().Data()) ;
311 emcalDigitizer.SetEventRange(0, -1) ; // do all the events
312 emcalDigitizer.Digitize() ;
315 //______________________________________________________________________
316 Bool_t AliEMCAL::Raw2SDigits(AliRawReader* rawReader){
318 // Conversion from raw data to EMCAL sdigits.
319 // Does the same as AliEMCALReconstructor::ConvertDigits()
320 // Needed to embed real data and simulation
321 // Works on a single-event basis
325 //Get/create the sdigits tree and array
326 AliRunLoader *rl = AliRunLoader::Instance();
327 AliEMCALLoader *emcalLoader = dynamic_cast<AliEMCALLoader*>(rl->GetDetectorLoader("EMCAL"));
330 AliFatal("NULL loader");
334 emcalLoader->GetEvent();
335 emcalLoader->LoadSDigits("UPDATE");
337 TTree * treeS = emcalLoader->TreeS();
339 emcalLoader->MakeSDigitsContainer();
340 treeS = emcalLoader->TreeS();
343 if(!emcalLoader->SDigits()) {
344 AliFatal("No sdigits array available\n");
348 TClonesArray * sdigits = emcalLoader->SDigits();
352 if(!fTriggerData)fTriggerData = new AliEMCALTriggerData();
353 fTriggerData->SetMode(1);
354 const Int_t nTRU = GetGeometry()->GetNTotalTRU();
355 TClonesArray *digitsTrg = new TClonesArray("AliEMCALTriggerRawDigit", nTRU * 96);
356 Int_t bufsize = 32000;
357 treeS->Branch("EMTRG", &digitsTrg, bufsize);
360 //Only physics events
361 if (rawReader->GetType()== AliRawEventHeaderBase::kPhysicsEvent) {
363 if(!fgRawUtils) fgRawUtils = new AliEMCALRawUtils;
364 //must be done here because, in constructor, option is not yet known
365 fgRawUtils->SetOption(GetOption());
367 // Set parameters from OCDB to raw utils
368 AliEMCALRecParam* recpar = emcalLoader->ReconstructionParameters(0);
369 // fgRawUtils->SetRawFormatHighLowGainFactor(recpar->GetHighLowGainFactor());
370 // fgRawUtils->SetRawFormatOrder(recpar->GetOrderParameter());
371 // fgRawUtils->SetRawFormatTau(recpar->GetTau());
372 fgRawUtils->SetNoiseThreshold(recpar->GetNoiseThreshold());
373 fgRawUtils->SetNPedSamples(recpar->GetNPedSamples());
374 fgRawUtils->SetRemoveBadChannels(recpar->GetRemoveBadChannels());
375 fgRawUtils->SetFittingAlgorithm(recpar->GetFittingAlgorithm());
376 fgRawUtils->SetFALTROUsage(recpar->UseFALTRO());
377 // fgRawUtils->SetTimeMin(recpar->GetTimeMin());
378 // fgRawUtils->SetTimeMax(recpar->GetTimeMax());
381 fgRawUtils->Raw2Digits(rawReader,sdigits,emcalLoader->PedestalData(),digitsTrg,fTriggerData);
383 }//skip calibration event
385 AliDebug(1," Calibration Event, skip!");
388 //Final arrangements of the array, set all sdigits as embedded
390 for (Int_t iSDigit = 0 ; iSDigit < sdigits->GetEntriesFast() ; iSDigit++) {
391 AliEMCALDigit * sdigit = dynamic_cast<AliEMCALDigit *>(sdigits->At(iSDigit)) ;
393 sdigit->SetIndexInList(iSDigit) ;
394 sdigit->SetType(AliEMCALDigit::kEmbedded);
397 AliFatal("sdigit is NULL!");
401 AliDebug(1,Form("Embedded sdigits entries %d \n",sdigits->GetEntriesFast()));
403 //Write array, clean arrays, unload ..
405 Int_t bufferSize = 32000 ;
406 TBranch * sdigitsBranch = treeS->GetBranch("EMCAL");
408 sdigitsBranch->SetAddress(&sdigits);
410 treeS->Branch("EMCAL",&sdigits,bufferSize);
413 emcalLoader->WriteSDigits("OVERWRITE");
414 emcalLoader->UnloadSDigits();
423 //____________________________________________________________________________
425 AliLoader* AliEMCAL::MakeLoader(const char* topfoldername)
427 //different behaviour than standard (singleton getter)
428 // --> to be discussed and made eventually coherent
429 fLoader = new AliEMCALLoader(GetName(),topfoldername);
433 //____________________________________________________________________________
435 AliEMCALGeometry* AliEMCAL::GetGeometry() const
437 //Initializes and returns geometry
439 // Pass the transpor model name (Geant3, Geant4, Fluka) and title to the geometry
441 TString mctitle = "";
443 mcname = gMC->GetName() ;
444 mctitle = gMC->GetTitle() ;
447 TString geoName(GetTitle());
449 //Check if run number and requested geometry correspond to the same geometry as
450 //in real data taking. To prevent errors in official simulation productions
451 if(!(AliEMCALGeometry::GetInstance()))
453 // Check the transport model name and option, set sampling fraction depending on it
454 if(!fCheckRunNumberAndGeoVersion){// Set geometry with the name used in the configuration file
455 AliInfo(Form("Geometry name in use <<%s>>, requested via Config file", geoName.Data()));
456 return AliEMCALGeometry::GetInstance(GetTitle(),"EMCAL",mcname,mctitle) ;
459 {//Check run number and version and set the corresponding one.
461 //AliRunLoader *rl = AliRunLoader::Instance();
462 //Int_t runNumber = rl->GetRunNumber();
464 AliCDBManager* man = AliCDBManager::Instance();
465 Int_t runNumber = man->GetRun();
467 //Instanciate geometry depending on the run number
468 if(runNumber >= 104064 && runNumber < 140000 ){//2009-2010 runs
469 //First year geometry, 4 SM.
471 if(!geoName.Contains("FIRSTYEARV1"))
473 AliInfo(Form("*** ATTENTION *** \n \t Specified geometry name <<%s>> for run %d is not considered! \n \t In use <<EMCAL_FIRSTYEARV1>>, check run number and year \n ",
474 geoName.Data(),runNumber));
478 AliDebug(1,"Initialized geometry with name <<EMCAL_FIRSTYEARV1>>");
481 return AliEMCALGeometry::GetInstance("EMCAL_FIRSTYEARV1","EMCAL",mcname,mctitle) ;// Set geometry with the name used in the configuration file
483 else if(runNumber >= 140000 && runNumber <= 170593)
485 //Almost complete EMCAL geometry, 10 SM. Year 2011 configuration
487 if(!geoName.Contains("COMPLETEV1"))
489 AliInfo(Form("*** ATTENTION *** \n \t Specified geometry name <<%s>> for run %d is not considered! \n \t In use <<EMCAL_COMPLETEV1>>, check run number and year \n ",
490 geoName.Data(),runNumber));
494 AliDebug(1,"Initialized geometry with name <<EMCAL_COMPLETEV1>>");
497 return AliEMCALGeometry::GetInstance("EMCAL_COMPLETEV1","EMCAL",mcname,mctitle) ;// Set geometry with the name used in the configuration file
499 else if(runNumber > 176000 && runNumber <= 197692)
501 //Complete EMCAL geometry, 12 SM. Year 2012 and on
502 if(!geoName.Contains("COMPLETE12SMV1"))
504 AliInfo(Form("*** ATTENTION *** \n \t Specified geometry name <<%s>> for run %d is not considered! \n \t In use <<EMCAL_COMPLETE12SMV1>>, check run number and year \n ", geoName.Data(),runNumber));
506 AliDebug(1,"Initialized geometry with name <<EMCAL_COMPLETE12SMV1>>");
509 return AliEMCALGeometry::GetInstance("EMCAL_COMPLETE12SMV1","EMCAL",mcname,mctitle) ;// Set geometry with the name used in the configuration file
514 //EMCAL + DCAL geometry, 20 SM. Year 2014 and on
516 if(geoName.Contains("DCAL_DEV"))
518 AliInfo("*** ATTENTION *** \n \t Set geometry name <<EMCAL_COMPLETE12SMV1_DCAL_DEV>> \n ");
519 return AliEMCALGeometry::GetInstance("EMCAL_COMPLETE12SMV1_DCAL_DEV","EMCAL",mcname,mctitle) ;
521 else if(geoName.Contains("DCAL_8SM"))
523 AliInfo("*** ATTENTION *** \n \t Set geometry name <<EMCAL_COMPLETE12SMV1_DCAL_8SM>> \n ");
524 return AliEMCALGeometry::GetInstance("EMCAL_COMPLETE12SMV1_DCAL_8SM","EMCAL",mcname,mctitle) ;
527 if(!geoName.Contains("COMPLETE12SMV1"))
529 AliInfo(Form("*** ATTENTION *** \n \t Specified geometry name <<%s>> for run %d is not considered! \n \t In use <<EMCAL_COMPLETE12SMV1>>, check run number and year \n ", geoName.Data(),runNumber));
533 AliDebug(1,"Initialized geometry with name <<EMCAL_COMPLETE12SMV1>>");
536 return AliEMCALGeometry::GetInstance("EMCAL_COMPLETE12SMV1_DCAL","EMCAL",mcname,mctitle) ;// Set geometry with the name used in the configuration file
539 }// Init geometry for the first time
542 return AliEMCALGeometry::GetInstance();