2 /**************************************************************************
3 * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
5 * Author: The ALICE Off-line Project. *
6 * Contributors are mentioned in the code where appropriate. *
8 * Permission to use, copy, modify and distribute this software and its *
9 * documentation strictly for non-commercial purposes is hereby granted *
10 * without fee, provided that the above copyright notice appears in all *
11 * copies and that both the copyright notice and this permission notice *
12 * appear in the supporting documentation. The authors make no claims *
13 * about the suitability of this software for any purpose. It is *
14 * provided "as is" without express or implied warranty. *
15 **************************************************************************/
20 //_________________________________________________________________________
21 // Utility Class for handling Raw data
22 // Does all transitions from Digits to Raw and vice versa,
23 // for simu and reconstruction
25 // Note: the current version is still simplified. Only
26 // one raw signal per digit is generated; either high-gain or low-gain
27 // Need to add concurrent high and low-gain info in the future
28 // No pedestal is added to the raw signal.
29 //*-- Author: Marco van Leeuwen (LBL)
30 //*-- Major refactoring by Per Thomas Hille
32 #include "AliEMCALRawUtils.h"
34 #include "AliRunLoader.h"
35 #include "AliAltroBuffer.h"
36 #include "AliRawReader.h"
37 #include "AliCaloRawStreamV3.h"
39 #include "AliEMCALRecParam.h"
40 #include "AliEMCALLoader.h"
41 #include "AliEMCALGeometry.h"
42 #include "AliEMCALDigit.h"
43 #include "AliEMCALRawDigit.h"
45 #include "AliCaloCalibPedestal.h"
46 #include "AliCaloBunchInfo.h"
47 #include "AliCaloFitResults.h"
48 #include "AliEMCALTriggerRawDigitMaker.h"
49 #include "AliEMCALTriggerSTURawStream.h"
50 #include "AliEMCALTriggerData.h"
51 #include "AliCaloConstants.h"
52 #include "AliCaloRawAnalyzer.h"
53 #include "AliCaloRawAnalyzerFactory.h"
54 #include "AliEMCALRawResponse.h"
57 using namespace EMCAL;
59 ClassImp(AliEMCALRawUtils)
62 AliEMCALRawUtils::AliEMCALRawUtils( Algo::fitAlgorithm fitAlgo) : fNoiseThreshold(3),
66 fRemoveBadChannels(kFALSE),
67 fFittingAlgorithm(fitAlgo),
72 fTriggerRawDigitMaker(0x0)
74 SetFittingAlgorithm(fitAlgo);
75 const TObjArray* maps = AliEMCALRecParam::GetMappings();
76 if(!maps) AliFatal("Cannot retrieve ALTRO mappings!!");
77 for(Int_t i = 0; i < 4; i++)
79 fMapping[i] = (AliAltroMapping*)maps->At(i);
82 AliRunLoader *rl = AliRunLoader::Instance();
83 if (rl && rl->GetAliRun())
85 AliEMCAL * emcal = dynamic_cast<AliEMCAL*>(rl->GetAliRun()->GetDetector("EMCAL"));
88 fGeom = emcal->GetGeometry();
92 AliDebug(1, Form("Using default geometry in raw reco"));
93 fGeom = AliEMCALGeometry::GetInstance(AliEMCALGeometry::GetDefaultGeometryName());
98 AliDebug(1, Form("Using default geometry in raw reco"));
99 fGeom = AliEMCALGeometry::GetInstance(AliEMCALGeometry::GetDefaultGeometryName());
102 if(!fGeom) AliFatal(Form("Could not get geometry!"));
103 fTriggerRawDigitMaker = new AliEMCALTriggerRawDigitMaker();
107 AliEMCALRawUtils::~AliEMCALRawUtils()
113 void AliEMCALRawUtils::Digits2Raw()
115 // convert digits of the current event to raw data
116 AliRunLoader *rl = AliRunLoader::Instance();
117 AliEMCALLoader *loader = dynamic_cast<AliEMCALLoader*>(rl->GetDetectorLoader("EMCAL"));
118 loader->LoadDigits("EMCAL");
120 TClonesArray* digits = loader->Digits() ;
123 Warning("Digits2Raw", "no digits found !");
127 static const Int_t nDDL = 12*2; // 12 SM hardcoded for now. Buffers allocated dynamically, when needed, so just need an upper limit here
128 AliAltroBuffer* buffers[nDDL];
129 for (Int_t i=0; i < nDDL; i++)
132 TArrayI adcValuesLow( TIMEBINS );
133 TArrayI adcValuesHigh( TIMEBINS );
135 // loop over digits (assume ordered digits)
136 for (Int_t iDigit = 0; iDigit < digits->GetEntries(); iDigit++)
138 AliEMCALDigit* digit = dynamic_cast<AliEMCALDigit *>(digits->At(iDigit)) ;
141 AliFatal("NULL Digit");
145 if (digit->GetAmplitude() < AliEMCALRawResponse::GetRawFormatThreshold() )
156 fGeom->GetCellIndex(digit->GetId(), nSM, nModule, nIphi, nIeta);
157 fGeom->GetCellPhiEtaIndexInSModule(nSM, nModule, nIphi, nIeta,iphi, ieta) ;
159 //Check which is the RCU, 0 or 1, of the cell.
161 if (0<=iphi&&iphi<8) iRCU=0; // first cable row
162 else if (8<=iphi&&iphi<16 && 0<=ieta&&ieta<24) iRCU=0; // first half;
163 else if(8<=iphi&&iphi<16 && 24<=ieta&&ieta<48) iRCU=1; // second half;
165 else if(16<=iphi&&iphi<24) iRCU=1; // third cable row
167 if (nSM%2==1) iRCU = 1 - iRCU; // swap for odd=C side, to allow us to cable both sides the same
170 Fatal("Digits2Raw()","Non-existent RCU number: %d", iRCU);
173 Int_t iDDL = NRCUSPERMODULE*nSM + iRCU;
174 if (iDDL < 0 || iDDL >= nDDL){
175 Fatal("Digits2Raw()","Non-existent DDL board number: %d", iDDL);
178 if (buffers[iDDL] == 0)
180 // open new file and write dummy header
181 TString fileName = AliDAQ::DdlFileName("EMCAL",iDDL);
182 //Select mapping file RCU0A, RCU0C, RCU1A, RCU1C
183 Int_t iRCUside=iRCU+(nSM%2)*2;
184 //iRCU=0 and even (0) SM -> RCU0A.data 0
185 //iRCU=1 and even (0) SM -> RCU1A.data 1
186 //iRCU=0 and odd (1) SM -> RCU0C.data 2
187 //iRCU=1 and odd (1) SM -> RCU1C.data 3
188 buffers[iDDL] = new AliAltroBuffer(fileName.Data(),fMapping[iRCUside]);
189 buffers[iDDL]->WriteDataHeader(kTRUE, kFALSE); //Dummy;
192 // out of time range signal (?)
193 if (digit->GetTimeR() > TIMEBINMAX ) {
194 AliInfo("Signal is out of time range.\n");
195 buffers[iDDL]->FillBuffer((Int_t)digit->GetAmplitude());
196 buffers[iDDL]->FillBuffer( TIMEBINS ); // time bin
197 buffers[iDDL]->FillBuffer(3); // bunch length
198 buffers[iDDL]->WriteTrailer(3, ieta, iphi, nSM); // trailer
199 // calculate the time response function
201 Bool_t lowgain = AliEMCALRawResponse::RawSampledResponse(digit->GetTimeR(), digit->GetAmplitude(),
202 adcValuesHigh.GetArray(), adcValuesLow.GetArray()) ;
205 buffers[iDDL]->WriteChannel(ieta, iphi, 0, TIMEBINS, adcValuesLow.GetArray(), AliEMCALRawResponse::GetRawFormatThreshold() );
207 buffers[iDDL]->WriteChannel(ieta,iphi, 1, TIMEBINS, adcValuesHigh.GetArray(), AliEMCALRawResponse::GetRawFormatThreshold() );
209 }// iDDL under the limits
213 // write headers and close files
214 for (Int_t i=0; i < nDDL; i++) {
217 buffers[i]->WriteDataHeader(kFALSE, kFALSE);
222 loader->UnloadDigits();
227 void AliEMCALRawUtils::AddDigit(TClonesArray *digitsArr, Int_t id, Int_t lowGain, Float_t amp, Float_t time, Float_t chi2, Int_t ndf)
230 AliEMCALDigit *digit = 0, *tmpdigit = 0;
231 TIter nextdigit(digitsArr);
233 while (digit == 0 && (tmpdigit = (AliEMCALDigit*) nextdigit()))
235 if (tmpdigit->GetId() == id) digit = tmpdigit;
238 if (!digit) { // no digit existed for this tower; create one
239 Int_t type = AliEMCALDigit::kHG; // use enum in AliEMCALDigit
243 type = AliEMCALDigit::kLGnoHG;
246 Int_t idigit = digitsArr->GetEntries();
247 new((*digitsArr)[idigit]) AliEMCALDigit( -1, -1, id, amp, time, type, idigit, chi2, ndf);
248 AliDebug(2,Form("Add digit Id %d for the first time, type %d", id, type));
249 }//digit added first time
251 { // a digit already exists, check range
252 // (use high gain if signal < cut value, otherwise low gain)
254 { // new digit is low gain
255 if (digit->GetAmplitude() > OVERFLOWCUT )
256 { // use if previously stored (HG) digit is out of range
257 digit->SetAmplitude( HGLGFACTOR * amp);
258 digit->SetTime(time);
259 digit->SetType(AliEMCALDigit::kLG);
260 AliDebug(2,Form("Add LG digit ID %d for the second time, type %d", digit->GetId(), digit->GetType()));
262 }//new low gain digit
263 else { // new digit is high gain
265 if (amp < OVERFLOWCUT )
266 { // new digit is high gain; use if not out of range
267 digit->SetAmplitude(amp);
268 digit->SetTime(time);
269 digit->SetType(AliEMCALDigit::kHG);
270 AliDebug(2,Form("Add HG digit ID %d for the second time, type %d", digit->GetId(), digit->GetType()));
273 { // HG out of range, just change flag value to show that HG did exist
274 digit->SetType(AliEMCALDigit::kLG);
275 AliDebug(2,Form("Change LG digit to HG, ID %d, type %d", digit->GetId(), digit->GetType()));
277 }//new high gain digit
278 }//digit existed replace it
282 void AliEMCALRawUtils::Raw2Digits(AliRawReader* reader,TClonesArray *digitsArr, const AliCaloCalibPedestal* pedbadmap, TClonesArray *digitsTRG, AliEMCALTriggerData* trgData)
284 //conversion of raw data to digits
285 if(digitsArr) digitsArr->Clear("C");
286 if (!digitsArr) { Error("Raw2Digits", "no digits found !");return;}
287 if (!reader) {Error("Raw2Digits", "no raw reader found !");return;}
288 AliEMCALTriggerSTURawStream inSTU(reader);
289 AliCaloRawStreamV3 in(reader,"EMCAL",fMapping);
290 reader->Select("EMCAL",0,43); // 43 = AliEMCALGeoParams::fgkLastAltroDDL
291 fTriggerRawDigitMaker->Reset();
292 fTriggerRawDigitMaker->SetIO(reader, in, inSTU, digitsTRG, trgData);
293 fRawAnalyzer->SetIsZeroSuppressed(true); // TMP - should use stream->IsZeroSuppressed(), or altro cfg registers later
296 Int_t caloFlag = 0; // low, high gain, or TRU, or LED ref.
300 while (in.NextChannel())
302 caloFlag = in.GetCaloFlag();
303 if (caloFlag > 2) continue; // Work with ALTRO and FALTRO
304 if(caloFlag < 2 && fRemoveBadChannels && pedbadmap->IsBadChannel(in.GetModule(),in.GetColumn(),in.GetRow()))
308 vector<AliCaloBunchInfo> bunchlist;
309 while (in.NextBunch())
311 bunchlist.push_back( AliCaloBunchInfo(in.GetStartTimeBin(), in.GetBunchLength(), in.GetSignals() ) );
313 if (bunchlist.size() == 0) continue;
316 Int_t id = fGeom->GetAbsCellIdFromCellIndexes(in.GetModule(), in.GetRow(), in.GetColumn()) ;
317 lowGain = in.IsLowGain();
318 fRawAnalyzer->SetL1Phase( in.GetL1Phase() );
319 AliCaloFitResults res = fRawAnalyzer->Evaluate( bunchlist, in.GetAltroCFG1(), in.GetAltroCFG2());
320 if(res.GetAmp() >= fNoiseThreshold )
322 AddDigit(digitsArr, id, lowGain, res.GetAmp(), res.GetTime(), res.GetChi2(), res.GetNdf() );
327 fTriggerRawDigitMaker->Add( bunchlist );
329 } // end while over channel
330 } //end while over DDL's, of input stream
331 fTriggerRawDigitMaker->PostProcess();
332 TrimDigits(digitsArr);
336 void AliEMCALRawUtils::TrimDigits(TClonesArray *digitsArr)
338 AliEMCALDigit *digit = 0;
340 Int_t nDigits = digitsArr->GetEntriesFast();
341 TIter nextdigit(digitsArr);
342 while ((digit = (AliEMCALDigit*) nextdigit())) {
343 if (digit->GetType() == AliEMCALDigit::kLGnoHG) {
344 AliDebug(1,Form("Remove digit with id %d, LGnoHG",digit->GetId()));
345 digitsArr->Remove(digit);
347 else if(fTimeMin > digit->GetTime() || fTimeMax < digit->GetTime()) {
348 digitsArr->Remove(digit);
349 AliDebug(1,Form("Remove digit with id %d, Bad Time %e",digit->GetId(), digit->GetTime()));
351 else if (0 > digit->GetChi2()) {
352 digitsArr->Remove(digit);
353 AliDebug(1,Form("Remove digit with id %d, Bad Chi2 %e",digit->GetId(), digit->GetChi2()));
356 digit->SetIndexInList(n);
361 digitsArr->Compress();
362 AliDebug(1,Form("N Digits before trimming : %d; after array compression %d",nDigits,digitsArr->GetEntriesFast()));
366 void AliEMCALRawUtils::SetFittingAlgorithm(Int_t fitAlgo)
368 fRawAnalyzer = AliCaloRawAnalyzerFactory::CreateAnalyzer( fitAlgo );
369 fRawAnalyzer->SetNsampleCut(5); // requirement for fits to be done, for the new methods
370 fRawAnalyzer->SetOverflowCut ( OVERFLOWCUT );
371 fRawAnalyzer->SetAmpCut(fNoiseThreshold);
372 fRawAnalyzer->SetFitArrayCut(fNoiseThreshold);