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 #include "AliMpDCSNamer.h"
20 #include "AliCodeTimer.h"
22 #include "AliMpArea.h"
23 #include "AliMpDEIterator.h"
24 #include "AliMpDEManager.h"
25 #include "AliMpHelper.h"
26 #include "AliMpMotifMap.h"
27 #include "AliMpMotifPosition.h"
28 #include "AliMpSector.h"
29 #include "AliMpSegmentation.h"
30 #include "AliMpSlat.h"
31 #include "AliMpConstants.h"
32 #include <Riostream.h>
34 #include <TObjArray.h>
35 #include <TObjString.h>
39 //-----------------------------------------------------------------------------
40 /// \class AliMpDCSNamer
42 /// A utility class to manage DCS aliases names, in particular the
43 /// two conventions used to number the detection elements within a detector.
45 /// \author: Laurent Aphecetche and Diego Stocco, Subatech
46 //-----------------------------------------------------------------------------
49 ClassImp(AliMpDCSNamer)
52 const char* AliMpDCSNamer::fgkDCSChannelSt345Pattern[] =
53 { "MchHvLvLeft/Chamber%02dLeft/Slat%02d.actual.vMon",
54 "MchHvLvRight/Chamber%02dRight/Slat%02d.actual.vMon"
57 const char* AliMpDCSNamer::fgkDCSChannelSt12Pattern[] =
59 "MchHvLvLeft/Chamber%02dLeft/Quad%dSect%d.actual.vMon",
60 "MchHvLvRight/Chamber%02dRight/Quad%dSect%d.actual.vMon",
63 const char* AliMpDCSNamer::fgkDCSSideTrackerName[] = { "Left", "Right" };
66 const char* AliMpDCSNamer::fgkDCSSwitchSt345Pattern = "MchDE%04dsw%d.inValue";
68 const char* AliMpDCSNamer::fgkDCSChannelTriggerPattern[] = {"MTR_%3sSIDE_MT%2i_RPC%i_HV.%s", "MTR_%2sSIDE_MT%2i_RPC%i_HV.%s"};
69 const char* AliMpDCSNamer::fgkDCSSideTriggerName[] = { "OUT", "IN" };
70 const char* AliMpDCSNamer::fgkDCSMeasureName[] = { "vEff", "actual.iMon" };
72 const char* AliMpDCSNamer::fgkDetectorName[] = { "TRACKER", "TRIGGER" };
74 //_____________________________________________________________________________
75 AliMpDCSNamer::AliMpDCSNamer():
78 SetDetector("TRACKER");
82 //_____________________________________________________________________________
83 AliMpDCSNamer::AliMpDCSNamer(const char* detName):
86 /// ctor taking the detector name as argument (either trigger or tracker)
90 //_____________________________________________________________________________
91 AliMpDCSNamer::~AliMpDCSNamer()
96 //_____________________________________________________________________________
97 Bool_t AliMpDCSNamer::SetDetector(const char* detName)
99 /// Set the detector type
100 /// \param detName = tracker, trigger
102 TString sDetName(detName);
105 if(sDetName.Contains(fgkDetectorName[kTrackerDet]))
106 fDetector = kTrackerDet;
107 else if(sDetName.Contains(fgkDetectorName[kTriggerDet]))
108 fDetector = kTriggerDet;
110 AliWarning("Detector name must be either tracker or trigger. Default tracker selected");
117 //_____________________________________________________________________________
119 AliMpDCSNamer::AliasesAsLdif(const char* ldiffile) const
121 /// Export the aliases in LDIF format
123 ofstream out(ldiffile);
125 TObjArray* a = CompactAliases();
130 // Some header. host name and port probably not up to date.
131 TString detName = (fDetector == kTriggerDet) ? "MTR" : "MCH";
133 out << "#" << detName.Data() << " config" << endl
134 << "dn: det=" << detName.Data() <<",o=alice,dc=cern,dc=ch" << endl
135 << "objectClass: AliShuttleDetector" << endl
136 << "det: " << detName.Data() << endl
137 << "StrictRunOrder: 1" << endl
138 << "responsible: aphecetc@in2p3.fr" << endl
139 << "DCSHost: aldcs053.cern.ch" << endl
140 << "DCSPort: 4242" <<endl;
142 while ( ( s = (TObjString*)(next()) ) )
144 out << "DCSalias: " << s->String().Data() << endl;
152 //_____________________________________________________________________________
154 AliMpDCSNamer::CompactAliases() const
156 /// Generate a compact list of aliases, for Shuttle test
157 /// This one is completely hand-made, in contrast with GenerateAliases()
160 TObjArray* a = new TObjArray;
165 // St 12 (DCS Channels)
166 a->Add(new TObjString("MchHvLvRight/Chamber[00..03]Right/Quad0Sect[0..2].actual.vMon"));
167 a->Add(new TObjString("MchHvLvLeft/Chamber[00..03]Left/Quad1Sect[0..2].actual.vMon"));
168 a->Add(new TObjString("MchHvLvLeft/Chamber[00..03]Left/Quad2Sect[0..2].actual.vMon"));
169 a->Add(new TObjString("MchHvLvRight/Chamber[00..03]Right/Quad3Sect[0..2].actual.vMon"));
171 // St345 (DCS Channels)
173 a->Add(new TObjString("MchHvLvRight/Chamber[04..09]Right/Slat[00..08].actual.vMon"));
174 a->Add(new TObjString("MchHvLvLeft/Chamber[04..09]Left/Slat[00..08].actual.vMon"));
176 a->Add(new TObjString("MchHvLvRight/Chamber[06..09]Right/Slat[09..12].actual.vMon"));
177 a->Add(new TObjString("MchHvLvLeft/Chamber[06..09]Left/Slat[09..12].actual.vMon"));
181 a->Add(new TObjString("MTR_OUTSIDE_MT[11..12]Right/RPC[1..9]_HV.imon"));
182 a->Add(new TObjString("MTR_OUTSIDE_MT[21..22]Right/RPC[1..9]_HV.imon"));
183 a->Add(new TObjString("MTR_INSIDE_MT[11..12]Right/RPC[1..9]_HV.imon"));
184 a->Add(new TObjString("MTR_INSIDE_MT[21..22]Right/RPC[1..9]_HV.imon"));
186 a->Add(new TObjString("MTR_OUTSIDE_MT[11..12]Right/RPC[1..9]_HV.vmon"));
187 a->Add(new TObjString("MTR_OUTSIDE_MT[21..22]Right/RPC[1..9]_HV.vmon"));
188 a->Add(new TObjString("MTR_INSIDE_MT[11..12]Right/RPC[1..9]_HV.vmon"));
189 a->Add(new TObjString("MTR_INSIDE_MT[21..22]Right/RPC[1..9]_HV.vmon"));
193 if(fDetector == kTrackerDet){
194 // St345 (DCS Switches)
201 Int_t detElemId = it.CurrentDEId();
202 if ( AliMpDEManager::GetStationType(detElemId) == AliMp::kStation345 )
204 a->Add(new TObjString(Form("MchDE%04dsw[0..%d].inValue",detElemId,NumberOfPCBs(detElemId)-1)));
213 //_____________________________________________________________________________
215 AliMpDCSNamer::DCS2DE(Int_t chId, Int_t side, Int_t dcsNumber) const
217 /// Convert DCS Tracker "slat number" (old convention) to DE (new) convention.
219 /// \param chamberId : chamber number (starting at 0)
220 /// \param side : 0 for Left, 1 for Right
221 /// \param dcsNumber : slat number in DCS convention
223 /// note that dcsNumber should be >=0 and < number of DEs/2 in chamber
226 Int_t chamberId = chId;
228 if(fDetector == kTrackerDet){ // Tracker
230 Int_t nofDE = AliMpDEManager::GetNofDEInChamber(chamberId);
232 Int_t half = nofDE/2;
234 dcsNumber = half - dcsNumber;
236 Int_t quarter = nofDE/4;
237 Int_t threeQuarter = half + quarter;
239 if ( side == 0 ) // left
241 de = threeQuarter + 1 - dcsNumber;
243 else if ( side == 1 ) // right
245 if ( dcsNumber <= quarter )
247 de = dcsNumber + threeQuarter;
251 de = dcsNumber - quarter - 1;
257 if ( chId < 19 ) chamberId = chId - 1;
258 else chamberId = chId - 9;
260 Int_t nofDE = AliMpDEManager::GetNofDEInChamber(chamberId);
262 if ( side == 0 ) // left -> Outside
266 else if ( side == 1 ) // right -> Inside
268 de = (13 + dcsNumber) % nofDE;
272 return (chamberId+1)*100 + de;
276 //_____________________________________________________________________________
278 AliMpDCSNamer::DetElemId2DCS(Int_t detElemId, Int_t& side, Int_t &chId) const
280 /// Convert DE to DCS "slat number"
283 CheckConsistency(detElemId);
285 Int_t chamberId = AliMpDEManager::GetChamberId(detElemId);
288 AliDebug(1,Form("DetElemId %d invalid",detElemId));
291 Int_t dcsNumber = (detElemId-(chamberId+1)*100);
293 switch ( AliMpDEManager::GetStationType(detElemId) )
295 case AliMp::kStation12:
311 case AliMp::kStation345:
313 Int_t nofDE = AliMpDEManager::GetNofDEInChamber(chamberId);
315 Int_t quarter = nofDE/4;
317 Int_t half = nofDE/2;
319 Int_t threeQuarter = half + quarter;
323 if ( dcsNumber <= quarter )
325 dcsNumber += quarter + 1 ;
328 else if ( dcsNumber <= threeQuarter )
330 dcsNumber = ( threeQuarter - dcsNumber + 1 );
333 else if ( dcsNumber > threeQuarter )
335 dcsNumber = dcsNumber - threeQuarter;
342 // dcs convention change : numbering from top, not from bottom
343 dcsNumber = half-dcsNumber;
346 case AliMp::kStationTrigger:
348 if (chamberId < AliMpConstants::NofChambers()-2)
349 chId = chamberId + 1;
350 else chId = 23 + chamberId - AliMpConstants::NofChambers();
352 Int_t nofDE = AliMpDEManager::GetNofDEInChamber(chamberId);
354 if ( dcsNumber >=5 && dcsNumber <= 13 ) {
356 dcsNumber = 14 - dcsNumber;
360 dcsNumber = (5 + dcsNumber) % nofDE;
362 AliDebug(10, Form("detElemId %i -> MT%i_side%i_L%i", detElemId, chId, side, dcsNumber));
373 //_____________________________________________________________________________
375 AliMpDCSNamer::DCSChannelName(Int_t detElemId, Int_t sector, Int_t dcsMeasure) const
377 /// Return the alias name of the DCS Channel for a given DCS area
379 /// \param sector = 0,1 or 2 for St12, and is unused for st345 and trigger
380 /// \param dcsMeasure = kDCSHV, kDCSI and is unused for tracker
382 Int_t chamberId = AliMpDEManager::GetChamberId(detElemId);
383 if ( chamberId < 0 ) return 0x0;
385 Int_t side(-1), chId(-1);
386 Int_t dcsNumber = DetElemId2DCS(detElemId,side,chId);
388 switch (AliMpDEManager::GetStationType(detElemId))
390 case AliMp::kStation12:
391 return Form(fgkDCSChannelSt12Pattern[side],chamberId,dcsNumber,sector);
393 case AliMp::kStation345:
394 return Form(fgkDCSChannelSt345Pattern[side],chamberId,dcsNumber);
396 case AliMp::kStationTrigger:
397 return Form(fgkDCSChannelTriggerPattern[side],fgkDCSSideTriggerName[side],chId,dcsNumber,fgkDCSMeasureName[dcsMeasure]);
405 //_____________________________________________________________________________
407 AliMpDCSNamer::DCSSwitchName(Int_t detElemId, Int_t pcbNumber) const
409 /// Return the alias name of the DCS Switch for a given PCB
410 /// within a slat of St345
412 if (AliMpDEManager::GetStationType(detElemId) == AliMp::kStation345)
414 return Form(fgkDCSSwitchSt345Pattern,detElemId,pcbNumber);
419 //_____________________________________________________________________________
421 AliMpDCSNamer::DCSIndexFromDCSAlias(const char* dcsAlias) const
423 /// Converts the dcs alias to a hv index
425 /// dcsAlias has one of the following 3 forms :
427 /// MchHvLv[Left|Right]/Chamber##[Left|Right]/Chamber##[Left|Right]Slat##.actual.vMon
429 /// MchHvLv[Left|Right]/Chamber##[Left|Right]/Chamber##[Left|Right]Quad#Sect#.actual.vMon
431 /// MchDE####dsw#.inValue
433 TString sDcsAlias(dcsAlias);
439 if ( sDcsAlias.Contains("Left") )
443 else if ( sDcsAlias.Contains("Right") )
450 sscanf(sDcsAlias.Data(),fgkDCSSwitchSt345Pattern,&de,&sw);
458 if ( sDcsAlias.Contains("Quad") )
460 sscanf(sDcsAlias.Data(),fgkDCSChannelSt12Pattern[side],&n1,&n3,&n4);
467 //_____________________________________________________________________________
469 AliMpDCSNamer::DetElemIdFromDCSAlias(const char* dcsAlias) const
471 /// Converts the dcs alias to a detection element identifier
473 /// dcsAlias has one of the following forms :
475 /// MchHvLv[Left|Right]/Chamber##[Left|Right]/Chamber##[Left|Right]Slat##.actual.vMon
477 /// MchHvLv[Left|Right]/Chamber##[Left|Right]/Chamber##[Left|Right]Quad#Sect#.actual.vMon
479 /// MTR_Side[OUTSIDE|INSIDE]_MTChamber##_RPC#_HV.Type[actual.iMon|vEff]
481 AliDebug(1,Form("dcsAlias=%s",dcsAlias));
483 TString sDcsAlias(dcsAlias);
487 const char** sideName = (fDetector == kTriggerDet) ? fgkDCSSideTriggerName : fgkDCSSideTrackerName;
489 for(Int_t iside=0; iside<2; iside++){
490 if ( sDcsAlias.Contains(sideName[iside]) ) {
495 if(side<0) return -2;
504 if ( sDcsAlias.Contains("Slat") )
506 sscanf(sDcsAlias.Data(),fgkDCSChannelSt345Pattern[side],&n1,&n3);
507 detElemId = DCS2DE(n1,side,n3);
508 AliDebug(1,Form("Slat side=%d n1=%d n3=%d de=%d",side,n1,n3,detElemId));
510 else if ( sDcsAlias.Contains("Quad") )
512 sscanf(sDcsAlias.Data(),fgkDCSChannelSt12Pattern[side],&n1,&n3,&n4);
513 detElemId = 100*(n1+1) + n3;
514 AliDebug(1,Form("Quad side=%d n1=%d n3=%d n4=%d de=%d",side,n1,n3,n4,detElemId));
516 else if ( sDcsAlias.Contains("MT") )
518 sscanf(sDcsAlias.Data(),fgkDCSChannelTriggerPattern[side],cside,&n1,&n3,type);
519 detElemId = DCS2DE(n1,side,n3);
520 AliDebug(1,Form("Slat side=%d n1=%d n3=%d de=%d",side,n1,n3,detElemId));
527 if ( !AliMpDEManager::IsValidDetElemId(detElemId) )
529 AliError(Form("Invalid aliasName %s",dcsAlias));
536 //_____________________________________________________________________________
537 Int_t AliMpDCSNamer::DCSvariableFromDCSAlias(const char* dcsAlias) const
539 /// Get DCS variable from an alias (trigger)
541 TString sDcsAlias(dcsAlias);
543 Int_t dcsMeasurement = -1;
545 for(Int_t iMeas=0; iMeas<kNDCSMeas; iMeas++){
546 if ( sDcsAlias.Contains(fgkDCSMeasureName[iMeas]) ) {
547 dcsMeasurement = iMeas;
552 return dcsMeasurement;
556 //_____________________________________________________________________________
558 AliMpDCSNamer::GenerateAliases() const
560 /// Generate DCS alias names, for MUON Tracker High Voltage system.
561 /// or for MUON Trigger HV and current system.
563 /// We first generate aliases of DCS channels :
565 /// St 1 ch 1 : 12 channels
566 /// ch 2 : 12 channels
567 /// St 2 ch 3 : 12 channels
568 /// ch 4 : 12 channels
569 /// St 3 ch 5 : 18 channels
570 /// ch 6 : 18 channels
571 /// St 4 ch 7 : 26 channels
572 /// ch 8 : 26 channels
573 /// St 5 ch 9 : 26 channels
574 /// ch 10 : 26 channels
576 /// then aliases of DCS switches (only for St345) : 1 switch per PCB.
578 /// Returns a TObjArray of TObjString(=alias name)
580 TObjArray* aliases = new TObjArray;
581 aliases->SetOwner(kTRUE);
583 Int_t nMeasures = (fDetector == kTriggerDet) ? kNDCSMeas : 1;
585 for(Int_t iMeas=0; iMeas<nMeasures; iMeas++){
593 Int_t detElemId = it.CurrentDEId();
597 switch ( AliMpDEManager::GetStationType(detElemId) )
599 case AliMp::kStation12:
600 for ( int sector = 0; sector < 3; ++sector)
602 aliases->Add(new TObjString(DCSChannelName(detElemId,sector)));
605 case AliMp::kStation345:
606 aliases->Add(new TObjString(DCSChannelName(detElemId)));
607 for ( Int_t i = 0; i < NumberOfPCBs(detElemId); ++i )
609 aliases->Add(new TObjString(DCSSwitchName(detElemId,i)));
619 switch ( AliMpDEManager::GetStationType(detElemId) )
621 case AliMp::kStationTrigger:
622 AliDebug(10,Form("Current DetElemId %i",detElemId));
623 aliases->Add(new TObjString(DCSChannelName(detElemId,0,iMeas)));
632 } // loop on detElemId
633 } // Loop on measurement type
638 //_____________________________________________________________________________
640 AliMpDCSNamer::ManuId2Index(Int_t detElemId, Int_t manuId) const
642 /// Convert (de,manu) to hv index, depending on the station
644 AliMp::StationType stationType = AliMpDEManager::GetStationType(detElemId);
645 if ( stationType == AliMp::kStation345 )
647 return ManuId2PCBIndex(detElemId,manuId);
649 else if ( stationType == AliMp::kStation12 )
651 return ManuId2Sector(detElemId,manuId);
656 //_____________________________________________________________________________
658 AliMpDCSNamer::ManuId2PCBIndex(Int_t detElemId, Int_t manuId) const
660 /// Returns the index of PCB (within a St345 slat) for a given manu number.
661 /// Returns -1 if (detElemId,manuId) is incorrect
665 const AliMpSlat* slat
666 = AliMpSegmentation::Instance()->GetSlatByElectronics(detElemId, manuId);
667 if ( ! slat ) return -1;
669 return slat->FindPCBIndexByMotifPositionID(manuId);
672 //_____________________________________________________________________________
674 AliMpDCSNamer::ManuId2Sector(Int_t detElemId, Int_t manuId) const
676 /// Return the DCS-sector number (within a St12 quadrant) for a given manu number.
680 const AliMpSector* sector
681 = AliMpSegmentation::Instance()->GetSectorByElectronics(detElemId, manuId);
682 if ( ! sector ) return -1;
684 const AliMpMotifMap* motifMap = sector->GetMotifMap();
685 const AliMpMotifPosition* motifPos = motifMap->FindMotifPosition(manuId);
688 = motifPos->GetPositionX()-motifPos->GetDimensionX();
690 Double_t x = lowerLeftX*10.0; // cm -> mm
693 AliMq::Station12Type stationType = AliMpDEManager::GetStation12Type(detElemId);
695 if ( stationType == AliMq::kStation1 )
697 if ( x < -10 ) AliFatal("");
699 if ( x < 291.65 ) isector = 0;
700 else if ( x < 585.65 ) isector = 1;
701 else if ( x < 879.65 ) isector = 2;
705 if ( x < -140 ) AliFatal("");
707 if ( x < 283.75 ) isector = 0;
708 else if ( x < 603.75 ) isector = 1;
709 else if ( x < 1158.75 ) isector = 2;
715 //_____________________________________________________________________________
717 AliMpDCSNamer::NumberOfPCBs(Int_t detElemId) const
719 /// Returns the number of PCB in a given detection element
720 /// Only works for St345
722 AliMp::StationType stationType = AliMpDEManager::GetStationType(detElemId);
723 if ( stationType != AliMp::kStation345 )
729 const AliMpSlat* slat
730 = AliMpSegmentation::Instance()->GetSlat(detElemId, AliMp::kCath0);
731 return slat->GetSize();
735 //_____________________________________________________________________________
736 Bool_t AliMpDCSNamer::CheckConsistency(Int_t detElemId) const
739 /// Check that the required detElemId either belongs to tracker or trigger
740 /// consistently with the initial definition of the namer
743 Bool_t isConsistent(kFALSE);
745 switch(AliMpDEManager::GetStationType(detElemId))
747 case AliMp::kStation12:
748 case AliMp::kStation345:
749 if (fDetector == kTrackerDet) isConsistent = kTRUE;
750 requestInfo = "TRACKER";
752 case AliMp::kStationTrigger:
753 if (fDetector == kTriggerDet) isConsistent = kTRUE;
754 requestInfo = "TRIGGER";
760 if(!isConsistent) AliWarning(Form("Requesting information for %s station but class initialized for %s",requestInfo.Data(), fgkDetectorName[fDetector]));