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 // Authors: David Guez, Ivana Hrivnacova, Marion MacCormick; IPN Orsay
20 // Class AliMUONSt1Response
21 // ----------------------------
22 // Response class for station 1 including electronics and detector response.
23 // Individual pedestals or noise levels can be controlled separately.
24 // The current pulse height responses do not contain any physics
32 #include <MPlaneSegmentation.h>
34 #include <MMotifMap.h>
39 #include <MVRowSegment.h>
40 #include "AliMUONSt1Response.h"
41 #include "AliMUONSt1ResponseParameter.h"
42 #include "AliMUONSt1ResponseRule.h"
43 #include "AliMUONSt1IniReader.h"
44 #include "AliMUONSt1Decoder.h"
45 #include "AliMUONTransientDigit.h"
47 ClassImp(AliMUONSt1Response);
49 const TString AliMUONSt1Response::fgkConfigBaseName = "configChamber";
50 const TString AliMUONSt1Response::fgkStandardIniFileName = "st1StdParameter.ini";
52 const TString AliMUONSt1Response::fgkBaseName ="base";
53 const TString AliMUONSt1Response::fgkIncludeName ="include";
54 const TString AliMUONSt1Response::fgkParameterName ="parameter";
55 const TString AliMUONSt1Response::fgkRegionName ="region";
56 const TString AliMUONSt1Response::fgkRuleName ="rule";
57 const TString AliMUONSt1Response::fgkNameName ="name";
58 const TString AliMUONSt1Response::fgkPedestalName ="pedestal";
59 const TString AliMUONSt1Response::fgkNoiseName ="noise";
60 const TString AliMUONSt1Response::fgkStateName ="state";
61 const TString AliMUONSt1Response::fgkMName ="padM";
62 const TString AliMUONSt1Response::fgkMGName ="padMG";
63 const TString AliMUONSt1Response::fgkMGCName ="padMGC";
64 const TString AliMUONSt1Response::fgkIJName ="padIJ";
65 const TString AliMUONSt1Response::fgkXYName ="padXY";
66 const TString AliMUONSt1Response::fgkZoneName ="zone";
67 const TString AliMUONSt1Response::fgkStickyOnName ="stickyOn";
68 const TString AliMUONSt1Response::fgkStickyOffName ="stickyOff";
69 const TString AliMUONSt1Response::fgkFileName ="file";
70 const TString AliMUONSt1Response::fgkValueName ="value";
71 const TString AliMUONSt1Response::fgkGausName ="gaus";
72 const TString AliMUONSt1Response::fgkNotName ="no";
73 const TString AliMUONSt1Response::fgkNofSigmaName ="nofSigma";
77 //__________________________________________________________________________
78 AliMUONSt1Response::AliMUONSt1Response(Int_t chamber)
80 ,fChamber(chamber),fParams(),fRegions(),fTrashList()
83 // default pedestal value
86 fCountUnknownIndices=0;
92 fPlaneSegmentation[i]=0;
93 for (Int_t j=0;j<fgkNofZones;j++)
95 fDefaultParameters[i][j]=0;
98 fTrashList.SetOwner(kTRUE);
102 //__________________________________________________________________________
103 AliMUONSt1Response::~AliMUONSt1Response()
108 if (fPlaneSegmentation[i]) delete fPlaneSegmentation[i];
109 if (fPlane[i]) delete fPlane[i];
114 //__________________________________________________________________________
115 void AliMUONSt1Response::SetIniFileName(Int_t plane,const TString& fileName)
117 // Set the file to be read for the response parameters
118 if ((plane>=0) && (plane<=1)) fIniFileName[plane] = fileName;
122 //__________________________________________________________________________
123 void AliMUONSt1Response::ReadCouplesOfIntRanges(const string& value,TList* list,AliMUONSt1ElectronicElement::TDescription descr)
125 // Decode couplets of integer ranges (enclosed within parenthesis and
126 // separated by a comma, eg. (12/20,33/60) for ranges 12 to 20 and 33 to 60)
127 // and save these ranges in <list>
128 vector<string> lstCpl = decoder::SplitNtuples(value);
129 for (unsigned int n=0;n<lstCpl.size();n++){ // for each (..,..) couplet
130 vector<string> lst = decoder::SplitList(lstCpl[n],",");
131 // should have 2 elements
132 if (lst.size() != 2) {
133 Warning("ReadIniFile","Bad pad definition");
136 vector<pair <int,int> > lst1 = decoder::DecodeListOfIntRanges(lst[0],";");
137 vector<pair <int,int> > lst2 = decoder::DecodeListOfIntRanges(lst[1],";");
138 for (unsigned int u1=0;u1<lst1.size();u1++){
139 for (unsigned int u2=0;u2<lst2.size();u2++){
140 AliMUONSt1ElectronicElement* elem
141 = new AliMUONSt1ElectronicElement(descr);
142 fTrashList.Add(elem);
143 elem->SetRange(0,lst1[u1].first,lst1[u1].second);
144 elem->SetRange(1,lst2[u2].first,lst2[u2].second);
152 //__________________________________________________________________________
153 void AliMUONSt1Response::ReadCouplesOfFloatRanges(const string& value,TList* list)
155 // Decode couplets of floating point ranges (enclosed within parenthesis and
156 // separated by a comma, eg. (12./20.,33./60.) for ranges 12. to 20. and 33. to 60.)
157 // and save these ranges in <list>
158 vector<string> lstCpl = decoder::SplitNtuples(value);
159 for (unsigned int n=0;n<lstCpl.size();n++){ // for each (..,..) couplets
160 vector<string> lst = decoder::SplitList(lstCpl[n],",");
161 // should have 2 elements
162 if (lst.size() != 2) {
163 Warning("ReadIniFile","Bad pad definition");
166 vector<pair <double,double> > lst1 = decoder::DecodeListOfFloatRanges(lst[0],";");
167 vector<pair <double,double> > lst2 = decoder::DecodeListOfFloatRanges(lst[1],";");
168 for (unsigned int u1=0;u1<lst1.size();u1++){
169 for (unsigned int u2=0;u2<lst2.size();u2++){
170 AliMUONSt1ElectronicElement* elem
171 = new AliMUONSt1ElectronicElement(AliMUONSt1ElectronicElement::kXY);
172 fTrashList.Add(elem);
173 elem->SetRange(0,lst1[u1].first,lst1[u1].second);
174 elem->SetRange(1,lst2[u2].first,lst2[u2].second);
182 //__________________________________________________________________________
183 void AliMUONSt1Response::SetPairToParam(const string& name,const string& value,AliMUONSt1ResponseParameter* param) const
185 // set a (name,value) pair to <param>
186 TString path=getenv("ALICE_ROOT");
188 const char* nm = name.c_str();
189 if (fgkStateName.CompareTo(nm,TString::kIgnoreCase)==0){
190 param->SetState(atoi(value.c_str()));
191 } else if (fgkPedestalName.CompareTo(nm,TString::kIgnoreCase)==0){
192 vector<string> lst = decoder::SplitList(value," ");
193 if ((lst.size()>0) && (fgkNotName.CompareTo(lst[0].c_str(),TString::kIgnoreCase)==0)){
194 param->UnSetPedestal();
195 } else if ((lst.size()>1) && (fgkValueName.CompareTo(lst[0].c_str(),TString::kIgnoreCase)==0)){
196 param->SetPedestal(atof(lst[1].c_str()));
197 } else if ((lst.size()>1) && (fgkFileName.CompareTo(lst[0].c_str(),TString::kIgnoreCase)==0)){
198 param->SetPedestal(path+lst[1].c_str());
199 } else if ((lst.size()>2) && (fgkGausName.CompareTo(lst[0].c_str(),TString::kIgnoreCase)==0)){
200 param->SetPedestal(atof(lst[1].c_str()),atof(lst[2].c_str()));
202 } else if (fgkNoiseName.CompareTo(nm,TString::kIgnoreCase)==0){
203 vector<string> lst = decoder::SplitList(value," ");
204 if ((lst.size()>1) && (fgkValueName.CompareTo(lst[0].c_str(),TString::kIgnoreCase)==0)){
205 param->SetNoise(atof(lst[1].c_str()));
206 } else if ((lst.size()>1) && (fgkFileName.CompareTo(lst[0].c_str(),TString::kIgnoreCase)==0)){
207 param->SetNoise(path+lst[1].c_str());
208 } else if ((lst.size()>2) && (fgkGausName.CompareTo(lst[0].c_str(),TString::kIgnoreCase)==0)){
209 param->SetNoise(atof(lst[1].c_str()),atof(lst[2].c_str()));
211 } else if (fgkNofSigmaName.CompareTo(nm,TString::kIgnoreCase)==0){
212 param->SetNofSigma(atoi(value.c_str()));
213 } else if (fgkStickyOnName.CompareTo(nm,TString::kIgnoreCase)==0){
214 vector< pair<int,int> > lst = decoder::DecodeListOfIntRanges(value);
215 for (unsigned int i=0;i<lst.size();i++){
216 for (int j=lst[i].first;(j<12) && (j<=lst[i].second);j++){
217 param->SetStickyBitOn(j);
220 } else if (fgkStickyOffName.CompareTo(nm,TString::kIgnoreCase)==0){
221 vector< pair<int,int> > lst = decoder::DecodeListOfIntRanges(value);
222 for (unsigned int i=0;i<lst.size();i++){
223 for (int j=lst[i].first;(j<12) && (j<=lst[i].second);j++){
224 param->SetStickyBitOff(j);
231 //__________________________________________________________________________
232 void AliMUONSt1Response::SetPairToListElem(const string& name,const string& value,TList* list)
234 // set a (name,value) pair to <list>
235 const char* nm = name.c_str();
236 if (fgkIJName.CompareTo(nm,TString::kIgnoreCase)==0){
237 ReadCouplesOfIntRanges(value,list,AliMUONSt1ElectronicElement::kIJ);
238 } else if (fgkMGCName.CompareTo(nm,TString::kIgnoreCase)==0){
239 ReadCouplesOfIntRanges(value,list,AliMUONSt1ElectronicElement::kMGC);
240 } else if (fgkMGName.CompareTo(nm,TString::kIgnoreCase)==0){
241 ReadCouplesOfIntRanges(value,list,AliMUONSt1ElectronicElement::kMG);
242 } else if (fgkMName.CompareTo(nm,TString::kIgnoreCase)==0){
243 vector< pair<int,int> > lst = decoder::DecodeListOfIntRanges(value);
244 for (unsigned int i=0;i<lst.size();i++){
245 AliMUONSt1ElectronicElement* elem
246 = new AliMUONSt1ElectronicElement(AliMUONSt1ElectronicElement::kM);
247 fTrashList.Add(elem);
248 elem->SetRange(0,lst[i].first,lst[i].second);
251 } else if (fgkXYName.CompareTo(nm,TString::kIgnoreCase)==0){
252 ReadCouplesOfFloatRanges(value,list);
257 //__________________________________________________________________________
258 void AliMUONSt1Response::ReadIniFile(Int_t plane)
260 //Read the ini file and fill the <plane>th structures
261 TString path=getenv("ALICE_ROOT");
264 if (gSystem->AccessPathName(path+fIniFileName[plane],kReadPermission)){
266 Form("Unable to Read the file %s",fIniFileName[plane].Data()));
271 ReadIniFile(plane,path+fIniFileName[plane],kTRUE,kTRUE,kTRUE);
275 //__________________________________________________________________________
276 void AliMUONSt1Response::ReadIniFile(Int_t plane,const TString& fileName,
277 Bool_t rdParam,Bool_t rdRegion,Bool_t rdRule)
279 //Read the given ini file and fill the <plane>th structures
280 cout<<"Reading parameter file "<<fileName<<endl;
281 AliMUONSt1IniReader iniFile(fileName.Data());
282 AliMUONSt1IniReader::TChapter chap;
283 AliMUONSt1IniReader::TValueList vals;
284 AliMUONSt1IniReader::TValueList::iterator itValue;
285 while (!iniFile.Eof()){
286 chap = iniFile.MakeCurrentChapter();
287 TString chapName = chap.first.c_str();
289 if (fgkBaseName.CompareTo(chapName,TString::kIgnoreCase)==0){
290 for (itValue = vals.begin() ; itValue != vals.end(); ++itValue){
291 string name = (*itValue).first;
292 string value = (*itValue).second;
293 if (fgkIncludeName.CompareTo(name.c_str(),TString::kIgnoreCase)==0){
294 vector<string> lst = decoder::SplitList(value,":");
296 TString inFileName = TString(gSystem->DirName(fileName))+"/" + lst[0].c_str();
297 Bool_t inParam=kFALSE,inRegion=kFALSE,inRule=kFALSE;
299 vector<string> lst2 = decoder::SplitList(lst[1],",");
300 for (unsigned int k=0;k<lst2.size();k++){
301 if (fgkParameterName.CompareTo(lst2[k].c_str(),TString::kIgnoreCase)==0){
303 } else if (fgkRegionName.CompareTo(lst2[k].c_str(),TString::kIgnoreCase)==0){
305 } else if (fgkRuleName.CompareTo(lst2[k].c_str(),TString::kIgnoreCase)==0){
310 inParam=inRegion=inRule=kTRUE;
312 ReadIniFile(plane,inFileName,inParam,inRegion,inRule);
316 } else if (rdParam && fgkParameterName.CompareTo(chapName,TString::kIgnoreCase)==0){
317 AliMUONSt1ResponseParameter* param = new AliMUONSt1ResponseParameter();
318 fTrashList.Add(param);
319 string paramName=Form("Parameter %d",fParams.size()+1);
320 for (itValue = vals.begin() ; itValue != vals.end(); ++itValue){
321 string name = (*itValue).first;
322 string value = (*itValue).second;
323 if (fgkNameName.CompareTo(name.c_str(),TString::kIgnoreCase)==0){
325 } else SetPairToParam(name,value,param);
327 fParams[paramName]=param;
328 } else if (rdRegion && fgkRegionName.CompareTo(chapName,TString::kIgnoreCase)==0){
329 TList* lstElem = new TList;
330 string listName=Form("Region %d",fRegions.size()+1);
331 for (itValue = vals.begin() ; itValue != vals.end(); ++itValue){
332 string name = (*itValue).first;
333 string value = (*itValue).second;
334 if (fgkNameName.CompareTo(name.c_str(),TString::kIgnoreCase)==0){
336 } else SetPairToListElem(name,value,lstElem);
338 fRegions[listName]=lstElem;
342 while (!iniFile.Eof()){
343 chap = iniFile.MakeCurrentChapter();
344 TString chapName = chap.first.c_str();
346 if (rdRule && fgkRuleName.CompareTo(chapName,TString::kIgnoreCase)==0){
348 Bool_t zones[fgkNofZones];
349 for (i=0;i<fgkNofZones;i++) zones[i]=kFALSE;
350 AliMUONSt1ResponseRule* rule=0;
351 for (itValue = vals.begin() ; itValue != vals.end(); ++itValue){
352 string name = (*itValue).first;
353 string value = (*itValue).second;
354 if (fgkZoneName.CompareTo(name.c_str(),TString::kIgnoreCase)==0){
355 vector< pair<int,int> > lst = decoder::DecodeListOfIntRanges(value);
356 for (unsigned int i=0;i<lst.size();i++){
357 for (int j=lst[i].first;(j<=fgkNofZones) && (j<=lst[i].second);j++) {
358 if (j>0) zones[j-1] = kTRUE;
361 } else if (fgkRegionName.CompareTo(name.c_str(),TString::kIgnoreCase)==0){
362 TListMap::iterator it = fRegions.find(value);
363 if (it != fRegions.end()){
365 rule = new AliMUONSt1ResponseRule();
366 fTrashList.Add(rule);
368 TIter next((*it).second);
369 AliMUONSt1ElectronicElement* el;
370 while ((el = static_cast<AliMUONSt1ElectronicElement*>(next()))){
371 rule->AddElement(el);
373 } else Warning("ReadIniFile",Form("Can't find region named %s",value.c_str()));
376 for (itValue = vals.begin() ; itValue != vals.end(); ++itValue){
377 string name = (*itValue).first;
378 string value = (*itValue).second;
379 if (fgkParameterName.CompareTo(name.c_str(),TString::kIgnoreCase)==0){
380 TParamsMap::iterator it = fParams.find(value);
381 if (it != fParams.end()){
382 AliMUONSt1ResponseParameter* param = (*it).second;
383 for (i=0;i<fgkNofZones;i++) if (zones[i]) {
384 fDefaultParameters[plane][i]=param;
386 if (rule) rule->AddParameter(param);
387 } else Warning("ReadIniFile",Form("Can't find parameter named %s",value.c_str()));
390 if (rule) fRulesList[plane].AddFirst(rule);
393 for (TListMap::iterator it = fRegions.begin() ; it != fRegions.end(); ++it) delete (*it).second;
397 //__________________________________________________________________________
398 void AliMUONSt1Response::ReadFiles()
400 // Define the current response rules with respect to the description
401 // given in the "configChamber1.ini" and "configChamber2.ini" files.
403 TString path=getenv("ALICE_ROOT");
406 TString configFileName = path + fgkConfigBaseName + Form("%d.ini",fChamber);
407 if (gSystem->AccessPathName(configFileName,kReadPermission)){
408 // no configChamberI.ini file exists
409 SetIniFileName(0,fgkStandardIniFileName);
410 SetIniFileName(1,fgkStandardIniFileName);
412 cout<<"Reading configuration file "<<configFileName<<endl;
413 AliMUONSt1IniReader iniFile(configFileName.Data());
414 while (!iniFile.Eof()) {
415 iniFile.ReadNextLine();
416 if (iniFile.GetCurrentType() != AliMUONSt1IniReader::kValue) continue;
418 if ((sscanf(iniFile.GetCurrentName().c_str()
419 ,"file%d",&plane)==1) && (plane>=0) && (plane<=1)){
420 SetIniFileName(plane,iniFile.GetCurrentValue().c_str());
424 //book memory and fill them with .ini files
425 fPlane[0]=MPlane::Create(kBendingPlane);
426 fPlane[1]=MPlane::Create(kNonBendingPlane);
428 fPlaneSegmentation[i]= new MPlaneSegmentation(fPlane[i]);
433 //__________________________________________________________________________
434 Float_t AliMUONSt1Response::IntPH(Float_t eloss)
436 // Calculate charge from given ionization energy lost.
438 nel= Int_t(eloss*1.e9/20);
441 for (Int_t i=1;i<=nel;i++) {
443 while(!arg) arg = gRandom->Rndm();
444 charge -= fChargeSlope*TMath::Log(arg);
450 //__________________________________________________________________________
451 MZone* AliMUONSt1Response::FindZone(MSector* sector,Int_t posId)
453 // to be moved to MSector::
454 for (Int_t izone=1;izone<=sector->GetNofZones();izone++){
455 MZone* zone = sector->GetZone(izone);
456 for (Int_t isub=0;isub<zone->GetNofSubZones();isub++){
457 MSubZone* sub=zone->GetSubZone(isub);
458 for (Int_t iseg=0;iseg<sub->GetNofRowSegments();iseg++){
459 if (sub->GetRowSegment(iseg)->HasMotifPosition(posId)) return zone;
467 //__________________________________________________________________________
469 Int_t AliMUONSt1Response::DigitResponse(Int_t digit,AliMUONTransientDigit* where)
471 // returns the electronic response of pad located at <where>, when
472 // a charge <digit> is present
474 //cout<<"electronic of pad "<<where->PadX()<<' '<<where->PadY()
475 // <<" on plane "<<where->Cathode()<<endl;
477 //read the files the first time this function is called
478 if (!fPlane[0]) ReadFiles();
482 MIntPair indices(where->PadX(),where->PadY());
483 MPad pad = fPlaneSegmentation[where->Cathode()]->PadByIndices(indices,kFALSE);
489 MIntPair location = pad.GetLocation();
490 //cout<<location.GetFirst()<<endl;
491 Int_t posId=abs(location.GetFirst());
493 if (fPlane[0]->GetFrontSector()->GetMotifMap()->FindMotifPosition(posId))
494 sector=(MSector*)fPlane[0]->GetFrontSector();
495 else if (fPlane[0]->GetBackSector()->GetMotifMap()->FindMotifPosition(posId))
496 sector=(MSector*)fPlane[0]->GetBackSector();
498 if (sector) zone=FindZone(sector,posId);
500 numZone=zone->GetID()-1;
501 GC=location.GetSecond();
506 fCountUnknownIndices++;
510 cout<<"Probleme electronic of pad "<<where->PadX()<<' '<<where->PadY()
511 <<" on plane "<<where->Cathode()<<endl;
515 TIter next(&fRulesList[where->Cathode()]);
516 AliMUONSt1ResponseRule* rule;
517 while ( (rule = static_cast<AliMUONSt1ResponseRule*>(next())))
518 if (rule->Contains(pad)) listParams.AddAll(rule->GetParameters());
519 if (fDefaultParameters[where->Cathode()][numZone])
520 listParams.Add(fDefaultParameters[where->Cathode()][numZone]);
522 AliMUONSt1ResponseParameter* param;
523 TIter nextParam(&listParams);
524 while ( (param = static_cast<AliMUONSt1ResponseParameter*>(nextParam()))){
525 if (param->GetState()==kFALSE) {
530 while ( (param = static_cast<AliMUONSt1ResponseParameter*>(nextParam()))){
531 if (param->HasPedestal()) {
532 digit = param->ApplyPedestal(digit,GC);
533 break; // Apply pedestals just once --> break the loop once a pedestal
537 if ( digit < 0) digit=0;
538 if (digit > MaxAdc()) digit=MaxAdc();
540 while ( (param = static_cast<AliMUONSt1ResponseParameter*>(nextParam()))){
541 digit = param->ApplyStickyBits(digit);
549 //__________________________________________________________________________
550 void AliMUONSt1Response::PrintStatistics() const
552 // Show the results of the statistics
553 cout<<"The DigitResponse() method was called "<<fCountNofCalls<<" times"<<endl;
554 cout<<" it was unable to find the pad corresponding to the given indices "
555 <<fCountUnknownIndices<<" times ("
556 <<(Double_t)100.*fCountUnknownIndices/fCountNofCalls
558 cout<<" it was unable to find the zone corresponding to the found pad "
559 <<fCountUnknownZone<<" times ("
560 <<(Double_t)100.*fCountUnknownZone/fCountNofCalls