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 //_________________________________________________________________________
19 // Implementation version v1 of PHOS Manager class
21 // Layout EMC + PPSD has name GPS2:
22 // Produces cumulated hits
24 // Layout EMC + CPV has name IHEP:
25 // Produces hits for CPV, cumulated hits
27 // Layout EMC + CPV + PPSD has name GPS:
28 // Produces hits for CPV, cumulated hits
30 //*-- Author: Yves Schutz (SUBATECH)
33 // --- ROOT system ---
41 // --- Standard library ---
46 #include <strstream.h>
48 // --- AliRoot header files ---
50 #include "AliPHOSv1.h"
51 #include "AliPHOSHit.h"
52 #include "AliPHOSCPVDigit.h"
56 #include "AliPHOSGeometry.h"
57 #include "AliPHOSQAIntCheckable.h"
58 #include "AliPHOSQAFloatCheckable.h"
59 #include "AliPHOSQAMeanChecker.h"
63 //____________________________________________________________________________
64 AliPHOSv1::AliPHOSv1():
67 // default ctor: initialze data memebers
73 fLightYieldMean = 0. ;
74 fIntrinsicPINEfficiency = 0. ;
75 fLightYieldAttenuation = 0. ;
76 fRecalibrationFactor = 0. ;
77 fElectronsPerGeV = 0. ;
84 //____________________________________________________________________________
85 AliPHOSv1::AliPHOSv1(const char *name, const char *title):
90 // - fHits (the "normal" one), which retains the hits associated with
91 // the current primary particle being tracked
92 // (this array is reset after each primary has been tracked).
97 // We do not want to save in TreeH the raw hits
98 // But save the cumulated hits instead (need to create the branch myself)
99 // It is put in the Digit Tree because the TreeH is filled after each primary
100 // and the TreeD at the end of the event (branch is set in FinishEvent() ).
102 fHits= new TClonesArray("AliPHOSHit",1000) ;
106 fIshunt = 1 ; // All hits are associated with primary particles
108 //Photoelectron statistics:
109 // The light yield is a poissonian distribution of the number of
110 // photons created in the PbWo4 crystal, calculated using following formula
111 // NumberOfPhotons = EnergyLost * LightYieldMean* APDEfficiency *
112 // exp (-LightYieldAttenuation * DistanceToPINdiodeFromTheHit);
113 // LightYieldMean is parameter calculated to be over 47000 photons per GeV
114 // APDEfficiency is 0.02655
115 // k_0 is 0.0045 from Valery Antonenko
116 // The number of electrons created in the APD is
117 // NumberOfElectrons = APDGain * LightYield
118 // The APD Gain is 300
119 fLightYieldMean = 47000;
120 fIntrinsicPINEfficiency = 0.02655 ; //APD= 0.1875/0.1271 * 0.018 (PIN)
121 fLightYieldAttenuation = 0.0045 ;
122 fRecalibrationFactor = 13.418/ fLightYieldMean ;
123 fElectronsPerGeV = 2.77e+8 ;
125 fLightFactor = fLightYieldMean * fIntrinsicPINEfficiency ;
126 fAPDFactor = (fRecalibrationFactor/100.) * fAPDGain ;
129 Int_t nb = GetGeometry()->GetNModules() ;
132 fQAHitsMul = new AliPHOSQAIntCheckable("HitsM") ;
133 fQATotEner = new AliPHOSQAFloatCheckable("TotEn") ;
134 fQAHitsMulB = new TClonesArray("AliPHOSQAIntCheckable",nb) ;
135 fQATotEnerB = new TClonesArray("AliPHOSQAFloatCheckable", nb);
138 for ( i = 0 ; i < nb ; i++ ) {
139 sprintf(tempo, "HitsMB%d", i+1) ;
140 new( (*fQAHitsMulB)[i]) AliPHOSQAIntCheckable(tempo) ;
141 sprintf(tempo, "TotEnB%d", i+1) ;
142 new( (*fQATotEnerB)[i] ) AliPHOSQAFloatCheckable(tempo) ;
145 AliPHOSQAMeanChecker * hmc = new AliPHOSQAMeanChecker("HitsMul", 100. ,25.) ;
146 AliPHOSQAMeanChecker * emc = new AliPHOSQAMeanChecker("TotEner", 10. ,5.) ;
147 AliPHOSQAMeanChecker * bhmc = new AliPHOSQAMeanChecker("HitsMulB", 100. ,5.) ;
148 AliPHOSQAMeanChecker * bemc = new AliPHOSQAMeanChecker("TotEnerB", 2. ,.5) ;
150 // associate checkables and checkers
151 fQAHitsMul->AddChecker(hmc) ;
152 fQATotEner->AddChecker(emc) ;
153 for ( i = 0 ; i < nb ; i++ ) {
154 (static_cast<AliPHOSQAIntCheckable*>((*fQAHitsMulB)[i]))->AddChecker(bhmc) ;
155 (static_cast<AliPHOSQAFloatCheckable*>((*fQATotEnerB)[i]))->AddChecker(bemc) ;
160 //____________________________________________________________________________
161 AliPHOSv1::~AliPHOSv1()
174 //____________________________________________________________________________
175 void AliPHOSv1::AddHit(Int_t shunt, Int_t primary, Int_t tracknumber, Int_t Id, Float_t * hits)
177 // Add a hit to the hit list.
178 // A PHOS hit is the sum of all hits in a single crystal from one primary and within soem taime gate
183 Bool_t deja = kFALSE ;
184 AliPHOSGeometry * geom = GetGeometry() ;
186 newHit = new AliPHOSHit(shunt, primary, tracknumber, Id, hits) ;
188 for ( hitCounter = fNhits-1 ; hitCounter >= 0 && !deja ; hitCounter-- ) {
189 curHit = dynamic_cast<AliPHOSHit*>((*fHits)[hitCounter]) ;
190 if(curHit->GetPrimary() != primary) break ;
191 // We add hits with the same primary, while GEANT treats primaries succesively
192 if( *curHit == *newHit ) {
199 new((*fHits)[fNhits]) AliPHOSHit(*newHit) ;
200 // get the block Id number
202 geom->AbsToRelNumbering(Id, relid) ;
203 // and fill the relevant QA checkable (only if in PbW04)
204 if ( relid[1] == 0 ) {
205 fQAHitsMul->Update(1) ;
206 (static_cast<AliPHOSQAIntCheckable*>((*fQAHitsMulB)[relid[0]-1]))->Update(1) ;
214 //____________________________________________________________________________
215 void AliPHOSv1::FinishPrimary()
217 // called at the end of each track (primary) by AliRun
218 // hits are reset for each new track
219 // accumulate the total hit-multiplicity
221 // fQAHitsMul->Update( fHits->GetEntriesFast() ) ;
225 //____________________________________________________________________________
226 void AliPHOSv1::FinishEvent()
228 // called at the end of each event by AliRun
229 // accumulate the hit-multiplicity and total energy per block
230 // if the values have been updated check it
233 if ( fQATotEner->HasChanged() ) {
234 fQATotEner->CheckMe() ;
235 fQATotEner->Reset() ;
240 if ( fQAHitsMulB && fQATotEnerB ) {
241 for (i = 0 ; i < GetGeometry()->GetNModules() ; i++) {
242 AliPHOSQAIntCheckable * ci = static_cast<AliPHOSQAIntCheckable*>((*fQAHitsMulB)[i]) ;
243 AliPHOSQAFloatCheckable* cf = static_cast<AliPHOSQAFloatCheckable*>((*fQATotEnerB)[i]) ;
244 if ( ci->HasChanged() ) {
248 if ( cf->HasChanged() ) {
255 // check the total multiplicity
258 if ( fQAHitsMul->HasChanged() ) {
259 fQAHitsMul->CheckMe() ;
260 fQAHitsMul->Reset() ;
264 //____________________________________________________________________________
265 void AliPHOSv1::StepManager(void)
267 // Accumulates hits as long as the track stays in a single crystal or CPV gas Cell
269 Int_t relid[4] ; // (box, layer, row, column) indices
270 Int_t absid ; // absolute cell ID number
271 Float_t xyze[5]={-1000,-1000,-1000,0,0} ; // position wrt MRS, time and energy deposited
272 TLorentzVector pos ; // Lorentz vector of the track current position
275 Int_t tracknumber = gAlice->CurrentTrack() ;
276 Int_t primary = gAlice->GetPrimary( gAlice->CurrentTrack() );
277 TString name = GetGeometry()->GetName() ;
281 if( gMC->CurrentVolID(copy) == gMC->VolId("PCPQ") &&
282 (gMC->IsTrackEntering() ) &&
283 gMC->TrackCharge() != 0) {
285 gMC -> TrackPosition(pos);
287 Float_t xyzm[3], xyzd[3] ;
289 for (i=0; i<3; i++) xyzm[i] = pos[i];
290 gMC -> Gmtod (xyzm, xyzd, 1); // transform coordinate from master to daughter system
292 Float_t xyd[3]={0,0,0} ; //local posiiton of the entering
297 // Current momentum of the hit's track in the local ref. system
298 TLorentzVector pmom ; //momentum of the particle initiated hit
299 gMC -> TrackMomentum(pmom);
300 Float_t pm[3], pd[3];
304 gMC -> Gmtod (pm, pd, 2); // transform 3-momentum from master to daughter system
309 // Digitize the current CPV hit:
311 // 1. find pad response and
312 gMC->CurrentVolOffID(3,moduleNumber);
315 TClonesArray *cpvDigits = new TClonesArray("AliPHOSCPVDigit",0); // array of digits for current hit
316 CPVDigitize(pmom,xyd,moduleNumber,cpvDigits);
321 Int_t idigit,ndigits;
323 // 2. go through the current digit list and sum digits in pads
325 ndigits = cpvDigits->GetEntriesFast();
326 for (idigit=0; idigit<ndigits-1; idigit++) {
327 AliPHOSCPVDigit *cpvDigit1 = dynamic_cast<AliPHOSCPVDigit*>(cpvDigits->UncheckedAt(idigit));
328 Float_t x1 = cpvDigit1->GetXpad() ;
329 Float_t z1 = cpvDigit1->GetYpad() ;
330 for (Int_t jdigit=idigit+1; jdigit<ndigits; jdigit++) {
331 AliPHOSCPVDigit *cpvDigit2 = dynamic_cast<AliPHOSCPVDigit*>(cpvDigits->UncheckedAt(jdigit));
332 Float_t x2 = cpvDigit2->GetXpad() ;
333 Float_t z2 = cpvDigit2->GetYpad() ;
334 if (x1==x2 && z1==z2) {
335 Float_t qsum = cpvDigit1->GetQpad() + cpvDigit2->GetQpad() ;
336 cpvDigit2->SetQpad(qsum) ;
337 cpvDigits->RemoveAt(idigit) ;
341 cpvDigits->Compress() ;
343 // 3. add digits to temporary hit list fTmpHits
345 ndigits = cpvDigits->GetEntriesFast();
346 for (idigit=0; idigit<ndigits; idigit++) {
347 AliPHOSCPVDigit *cpvDigit = dynamic_cast<AliPHOSCPVDigit*>(cpvDigits->UncheckedAt(idigit));
348 relid[0] = moduleNumber + 1 ; // CPV (or PHOS) module number
349 relid[1] =-1 ; // means CPV
350 relid[2] = cpvDigit->GetXpad() ; // column number of a pad
351 relid[3] = cpvDigit->GetYpad() ; // row number of a pad
353 // get the absolute Id number
354 GetGeometry()->RelToAbsNumbering(relid, absid) ;
356 // add current digit to the temporary hit list
358 xyze[3] = gMC->TrackTime() ;
359 xyze[4] = cpvDigit->GetQpad() ; // amplitude in a pad
360 primary = -1; // No need in primary for CPV
361 AddHit(fIshunt, primary, tracknumber, absid, xyze);
363 if (cpvDigit->GetQpad() > 0.02) {
364 xmean += cpvDigit->GetQpad() * (cpvDigit->GetXpad() + 0.5);
365 zmean += cpvDigit->GetQpad() * (cpvDigit->GetYpad() + 0.5);
366 qsum += cpvDigit->GetQpad();
378 if(gMC->CurrentVolID(copy) == gMC->VolId("PXTL") ) { // We are inside a PBWO crystal
380 gMC->TrackPosition(pos) ;
384 Float_t global[3], local[3] ;
388 Float_t lostenergy = gMC->Edep();
390 if ( lostenergy != 0 ) { // Track is inside the crystal and deposits some energy
392 xyze[3] = gMC->TrackTime() ;
394 gMC->CurrentVolOffID(10, moduleNumber) ; // get the PHOS module number ;
397 gMC->CurrentVolOffID(3, strip);
399 gMC->CurrentVolOffID(2, cell);
401 Int_t row = 1 + GetGeometry()->GetNZ() - strip % GetGeometry()->GetNZ() ;
402 Int_t col = (Int_t) TMath::Ceil((Double_t) strip/GetGeometry()->GetNZ()) -1 ;
404 absid = (moduleNumber-1)*GetGeometry()->GetNCristalsInModule() +
405 row + (col*GetGeometry()->GetEMCAGeometry()->GetNCellsInStrip() + cell-1)*GetGeometry()->GetNZ() ;
407 gMC->Gmtod(global, local, 1) ;
409 //Calculates the light yield, the number of photns produced in the
411 Float_t lightYield = gRandom->Poisson(fLightFactor * lostenergy *
412 exp(-fLightYieldAttenuation *
413 (local[1]+GetGeometry()->GetCrystalSize(1)/2.0 ))
415 //Calculates de energy deposited in the crystal
416 xyze[4] = fAPDFactor * lightYield ;
418 // add current hit to the hit list
419 AddHit(fIshunt, primary,tracknumber, absid, xyze);
421 // fill the relevant QA Checkables
422 fQATotEner->Update( xyze[4] ) ; // total energy in PHOS
423 (static_cast<AliPHOSQAFloatCheckable*>((*fQATotEnerB)[moduleNumber-1]))->Update( xyze[4] ) ; // energy in this block
425 } // there is deposited energy
426 } // we are inside a PHOS Xtal
430 //____________________________________________________________________________
431 void AliPHOSv1::CPVDigitize (TLorentzVector p, Float_t *zxhit, Int_t moduleNumber, TClonesArray *cpvDigits)
433 // ------------------------------------------------------------------------
434 // Digitize one CPV hit:
435 // On input take exact 4-momentum p and position zxhit of the hit,
436 // find the pad response around this hit and
437 // put the amplitudes in the pads into array digits
439 // Author: Yuri Kharlov (after Serguei Sadovsky)
441 // ------------------------------------------------------------------------
443 const Float_t kCelWr = GetGeometry()->GetPadSizePhi()/2; // Distance between wires (2 wires above 1 pad)
444 const Float_t kDetR = 0.1; // Relative energy fluctuation in track for 100 e-
445 const Float_t kdEdx = 4.0; // Average energy loss in CPV;
446 const Int_t kNgamz = 5; // Ionization size in Z
447 const Int_t kNgamx = 9; // Ionization size in Phi
448 const Float_t kNoise = 0.03; // charge noise in one pad
452 // Just a reminder on axes notation in the CPV module:
453 // axis Z goes along the beam
454 // axis X goes across the beam in the module plane
455 // axis Y is a normal to the module plane showing from the IP
457 Float_t hitX = zxhit[0];
458 Float_t hitZ =-zxhit[1];
461 Float_t pNorm = p.Py();
462 Float_t eloss = kdEdx;
464 // cout << "CPVDigitize: YVK : "<<hitX<<" "<<hitZ<<" | "<<pX<<" "<<pZ<<" "<<pNorm<<endl;
466 Float_t dZY = pZ/pNorm * GetGeometry()->GetCPVGasThickness();
467 Float_t dXY = pX/pNorm * GetGeometry()->GetCPVGasThickness();
468 gRandom->Rannor(rnor1,rnor2);
469 eloss *= (1 + kDetR*rnor1) *
470 TMath::Sqrt((1 + ( pow(dZY,2) + pow(dXY,2) ) / pow(GetGeometry()->GetCPVGasThickness(),2)));
471 Float_t zhit1 = hitZ + GetGeometry()->GetCPVActiveSize(1)/2 - dZY/2;
472 Float_t xhit1 = hitX + GetGeometry()->GetCPVActiveSize(0)/2 - dXY/2;
473 Float_t zhit2 = zhit1 + dZY;
474 Float_t xhit2 = xhit1 + dXY;
476 Int_t iwht1 = (Int_t) (xhit1 / kCelWr); // wire (x) coordinate "in"
477 Int_t iwht2 = (Int_t) (xhit2 / kCelWr); // wire (x) coordinate "out"
481 if (iwht1==iwht2) { // incline 1-wire hit
483 zxe[0][0] = (zhit1 + zhit2 - dZY*0.57735) / 2;
484 zxe[1][0] = (iwht1 + 0.5) * kCelWr;
486 zxe[0][1] = (zhit1 + zhit2 + dZY*0.57735) / 2;
487 zxe[1][1] = (iwht1 + 0.5) * kCelWr;
490 else if (TMath::Abs(iwht1-iwht2) != 1) { // incline 3-wire hit
492 Int_t iwht3 = (iwht1 + iwht2) / 2;
493 Float_t xwht1 = (iwht1 + 0.5) * kCelWr; // wire 1
494 Float_t xwht2 = (iwht2 + 0.5) * kCelWr; // wire 2
495 Float_t xwht3 = (iwht3 + 0.5) * kCelWr; // wire 3
496 Float_t xwr13 = (xwht1 + xwht3) / 2; // center 13
497 Float_t xwr23 = (xwht2 + xwht3) / 2; // center 23
498 Float_t dxw1 = xhit1 - xwr13;
499 Float_t dxw2 = xhit2 - xwr23;
500 Float_t egm1 = TMath::Abs(dxw1) / ( TMath::Abs(dxw1) + TMath::Abs(dxw2) + kCelWr );
501 Float_t egm2 = TMath::Abs(dxw2) / ( TMath::Abs(dxw1) + TMath::Abs(dxw2) + kCelWr );
502 Float_t egm3 = kCelWr / ( TMath::Abs(dxw1) + TMath::Abs(dxw2) + kCelWr );
503 zxe[0][0] = (dXY*(xwr13-xwht1)/dXY + zhit1 + zhit1) / 2;
505 zxe[2][0] = eloss * egm1;
506 zxe[0][1] = (dXY*(xwr23-xwht1)/dXY + zhit1 + zhit2) / 2;
508 zxe[2][1] = eloss * egm2;
509 zxe[0][2] = dXY*(xwht3-xwht1)/dXY + zhit1;
511 zxe[2][2] = eloss * egm3;
513 else { // incline 2-wire hit
515 Float_t xwht1 = (iwht1 + 0.5) * kCelWr;
516 Float_t xwht2 = (iwht2 + 0.5) * kCelWr;
517 Float_t xwr12 = (xwht1 + xwht2) / 2;
518 Float_t dxw1 = xhit1 - xwr12;
519 Float_t dxw2 = xhit2 - xwr12;
520 Float_t egm1 = TMath::Abs(dxw1) / ( TMath::Abs(dxw1) + TMath::Abs(dxw2) );
521 Float_t egm2 = TMath::Abs(dxw2) / ( TMath::Abs(dxw1) + TMath::Abs(dxw2) );
522 zxe[0][0] = (zhit1 + zhit2 - dZY*egm1) / 2;
524 zxe[2][0] = eloss * egm1;
525 zxe[0][1] = (zhit1 + zhit2 + dZY*egm2) / 2;
527 zxe[2][1] = eloss * egm2;
530 // Finite size of ionization region
532 Int_t nCellZ = GetGeometry()->GetNumberOfCPVPadsZ();
533 Int_t nCellX = GetGeometry()->GetNumberOfCPVPadsPhi();
534 Int_t nz3 = (kNgamz+1)/2;
535 Int_t nx3 = (kNgamx+1)/2;
536 cpvDigits->Expand(nIter*kNgamx*kNgamz);
537 TClonesArray &ldigits = *(static_cast<TClonesArray *>(cpvDigits));
539 for (Int_t iter=0; iter<nIter; iter++) {
541 Float_t zhit = zxe[0][iter];
542 Float_t xhit = zxe[1][iter];
543 Float_t qhit = zxe[2][iter];
544 Float_t zcell = zhit / GetGeometry()->GetPadSizeZ();
545 Float_t xcell = xhit / GetGeometry()->GetPadSizePhi();
546 if ( zcell<=0 || xcell<=0 ||
547 zcell>=nCellZ || xcell>=nCellX) return;
548 Int_t izcell = (Int_t) zcell;
549 Int_t ixcell = (Int_t) xcell;
550 Float_t zc = zcell - izcell - 0.5;
551 Float_t xc = xcell - ixcell - 0.5;
552 for (Int_t iz=1; iz<=kNgamz; iz++) {
553 Int_t kzg = izcell + iz - nz3;
554 if (kzg<=0 || kzg>nCellZ) continue;
555 Float_t zg = (Float_t)(iz-nz3) - zc;
556 for (Int_t ix=1; ix<=kNgamx; ix++) {
557 Int_t kxg = ixcell + ix - nx3;
558 if (kxg<=0 || kxg>nCellX) continue;
559 Float_t xg = (Float_t)(ix-nx3) - xc;
561 // Now calculate pad response
562 Float_t qpad = CPVPadResponseFunction(qhit,zg,xg);
563 qpad += kNoise*rnor2;
564 if (qpad<0) continue;
566 // Fill the array with pad response ID and amplitude
567 new(ldigits[cpvDigits->GetEntriesFast()]) AliPHOSCPVDigit(kxg,kzg,qpad);
573 //____________________________________________________________________________
574 Float_t AliPHOSv1::CPVPadResponseFunction(Float_t qhit, Float_t zhit, Float_t xhit) {
575 // ------------------------------------------------------------------------
576 // Calculate the amplitude in one CPV pad using the
577 // cumulative pad response function
578 // Author: Yuri Kharlov (after Serguei Sadovski)
580 // ------------------------------------------------------------------------
582 Double_t dz = GetGeometry()->GetPadSizeZ() / 2;
583 Double_t dx = GetGeometry()->GetPadSizePhi() / 2;
584 Double_t z = zhit * GetGeometry()->GetPadSizeZ();
585 Double_t x = xhit * GetGeometry()->GetPadSizePhi();
586 Double_t amplitude = qhit *
587 (CPVCumulPadResponse(z+dz,x+dx) - CPVCumulPadResponse(z+dz,x-dx) -
588 CPVCumulPadResponse(z-dz,x+dx) + CPVCumulPadResponse(z-dz,x-dx));
589 return (Float_t)amplitude;
592 //____________________________________________________________________________
593 Double_t AliPHOSv1::CPVCumulPadResponse(Double_t x, Double_t y) {
594 // ------------------------------------------------------------------------
595 // Cumulative pad response function
596 // It includes several terms from the CF decomposition in electrostatics
597 // Note: this cumulative function is wrong since omits some terms
598 // but the cell amplitude obtained with it is correct because
599 // these omitting terms cancel
600 // Author: Yuri Kharlov (after Serguei Sadovski)
602 // ------------------------------------------------------------------------
604 const Double_t kA=1.0;
605 const Double_t kB=0.7;
607 Double_t r2 = x*x + y*y;
609 Double_t cumulPRF = 0;
610 for (Int_t i=0; i<=4; i++) {
611 Double_t b1 = (2*i + 1) * kB;
612 cumulPRF += TMath::Power(-1,i) * TMath::ATan( xy / (b1*TMath::Sqrt(b1*b1 + r2)) );
614 cumulPRF *= kA/(2*TMath::Pi());