/************************************************************************** * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. * * * * Author: The ALICE Off-line Project. * * Contributors are mentioned in the code where appropriate. * * * * Permission to use, copy, modify and distribute this software and its * * documentation strictly for non-commercial purposes is hereby granted * * without fee, provided that the above copyright notice appears in all * * copies and that both the copyright notice and this permission notice * * appear in the supporting documentation. The authors make no claims * * about the suitability of this software for any purpose. It is * * provided "as is" without express or implied warranty. * **************************************************************************/ // $Id$ //----------------------------------------------------------------------------- /// \class AliMUONPadStatusMaker /// /// Make a 2DStore of pad statuses, using different sources of information, /// like pedestal values, gain values, and HV values. /// /// \author Laurent Aphecetche //----------------------------------------------------------------------------- #include "AliMUONPadStatusMaker.h" #include "AliMUON2DMap.h" #include "AliMUON2DStoreValidator.h" #include "AliMUONCalibParamNI.h" #include "AliMUONCalibrationData.h" #include "AliMUONLogger.h" #include "AliMUONRecoParam.h" #include "AliMUONStringIntMap.h" #include "AliMUONTrackerData.h" #include "AliMUONVCalibParam.h" #include "AliMpArea.h" #include "AliMpArrayI.h" #include "AliMpCDB.h" #include "AliMpConstants.h" #include "AliMpDDLStore.h" #include "AliMpDEManager.h" #include "AliMpDetElement.h" #include "AliMpDCSNamer.h" #include "AliMpManuIterator.h" #include "AliMpManuUID.h" #include "AliCDBEntry.h" #include "AliCDBManager.h" #include "AliCodeTimer.h" #include "AliDCSValue.h" #include "AliLog.h" #include #include #include #include #include #include #include #include #include /// \cond CLASSIMP ClassImp(AliMUONPadStatusMaker) /// \endcond //_____________________________________________________________________________ AliMUONPadStatusMaker::AliMUONPadStatusMaker(const AliMUONCalibrationData& calibData) : fkCalibrationData(calibData), fGainA1Limits(0,1E30), fGainA2Limits(-1E-30,1E30), fGainThresLimits(0,4095), fHVSt12Limits(0,5000), fHVSt345Limits(0,5000), fPedMeanLimits(0,4095), fPedSigmaLimits(0,4095), fManuOccupancyLimits(0,1.0), fBuspatchOccupancyLimits(0,1.0), fDEOccupancyLimits(0,1.0), fStatus(new AliMUON2DMap(true)), fHV(0x0), fPedestals(calibData.Pedestals()), fGains(calibData.Gains()), fTrackerData(0x0) { /// ctor if ( calibData.OccupancyMap() ) { /// create a tracker data from the occupancy map fTrackerData = new AliMUONTrackerData("OCC","OCC",*(calibData.OccupancyMap())); } if ( calibData.HV() ) { /// Only create the fHV internal store if there are some HV values available fHV = new TExMap; } } //_____________________________________________________________________________ AliMUONPadStatusMaker::~AliMUONPadStatusMaker() { /// dtor. delete fStatus; delete fHV; delete fTrackerData; } //_____________________________________________________________________________ TString AliMUONPadStatusMaker::AsString(Int_t status) { /// return a human readable version of the integer status if ( status == 0 ) { return "Brave New World"; } Int_t pedStatus; Int_t gainStatus; Int_t hvStatus; Int_t occStatus; DecodeStatus(status,pedStatus,hvStatus,gainStatus,occStatus); TString s; if ( pedStatus & kPedMeanZero ) s += "& Ped Mean is Zero "; if ( pedStatus & kPedMeanTooLow ) s += "& Ped Mean Too Low "; if ( pedStatus & kPedMeanTooHigh ) s += "& Ped Mean Too High "; if ( pedStatus & kPedSigmaTooLow ) s += "& Ped Sigma Too Low "; if ( pedStatus & kPedSigmaTooHigh ) s += "& Ped Sigma Too High "; if ( pedStatus & kPedMissing ) s += "& Ped is missing "; if ( gainStatus & kGainA1TooLow ) s+="& Gain A1 is Too Low "; if ( gainStatus & kGainA1TooHigh ) s+="& Gain A1 is Too High "; if ( gainStatus & kGainA2TooLow ) s+="& Gain A2 is Too Low "; if ( gainStatus & kGainA2TooHigh ) s+="& Gain A2 is Too High "; if ( gainStatus & kGainThresTooLow ) s+="& Gain Thres is Too Low "; if ( gainStatus & kGainThresTooHigh ) s+="& Gain Thres is Too High "; if ( gainStatus & kGainMissing ) s+="& Gain is missing "; if ( hvStatus & kHVError ) s+="& HV is on error "; if ( hvStatus & kHVTooLow ) s+="& HV is Too Low "; if ( hvStatus & kHVTooHigh ) s+="& HV is Too High "; if ( hvStatus & kHVChannelOFF ) s+="& HV has channel OFF "; if ( hvStatus & kHVSwitchOFF ) s+="& HV has switch OFF "; if ( hvStatus & kHVMissing ) s+="& HV is missing "; if ( occStatus & kManuOccupancyTooHigh ) s+="& manu occupancy too high "; if ( occStatus & kManuOccupancyTooLow ) s+="& manu occupancy too low "; if ( occStatus & kBusPatchOccupancyTooHigh ) s+="& bus patch occupancy too high "; if ( occStatus & kBusPatchOccupancyTooLow ) s+="& bus patch occupancy too low "; if ( occStatus & kDEOccupancyTooHigh ) s+="& DE occupancy too high "; if ( occStatus & kDEOccupancyTooLow ) s+="& DE occupancy too low "; if ( s[0] == '&' ) s[0] = ' '; return s; } //_____________________________________________________________________________ TString AliMUONPadStatusMaker::AsCondition(Int_t mask) { /// return a human readable version of the mask's equivalent condition TString s(AsString(mask)); s.ReplaceAll("&","|"); return s; } //_____________________________________________________________________________ Int_t AliMUONPadStatusMaker::BuildStatus(Int_t pedStatus, Int_t hvStatus, Int_t gainStatus, Int_t occStatus) { /// Build a complete status from specific parts (ped,hv,gain) return ( hvStatus & 0xFF ) | ( ( pedStatus & 0xFF ) << 8 ) | ( ( gainStatus & 0xFF ) << 16 ) | ( ( occStatus & 0xFF ) << 24 ) ; } //_____________________________________________________________________________ void AliMUONPadStatusMaker::DecodeStatus(Int_t status, Int_t& pedStatus, Int_t& hvStatus, Int_t& gainStatus, Int_t& occStatus) { /// Decode complete status into specific parts (ped,hv,gain) occStatus = ( status & 0xFF000000 ) >> 24; gainStatus = ( status & 0xFF0000 ) >> 16; pedStatus = ( status & 0xFF00 ) >> 8; hvStatus = (status & 0xFF); } //_____________________________________________________________________________ Bool_t AliMUONPadStatusMaker::HVSt12Status(Int_t detElemId, Int_t sector, Bool_t& hvChannelTooLow, Bool_t& hvChannelTooHigh, Bool_t& hvChannelON) const { /// Get HV status for one HV sector of St12 /// For a given PCB in a given DE, get the HV status (both the channel /// and the switch). /// Returns false if hv switch changed during the run. AliCodeTimerAuto("",0) if (!fHV) return kFALSE; Bool_t error = kFALSE; hvChannelTooLow = kFALSE; hvChannelTooHigh = kFALSE; hvChannelON = kTRUE; AliMpDCSNamer hvNamer("TRACKER"); TString hvChannel(hvNamer.DCSChannelName(detElemId,sector)); TMap* hvMap = fkCalibrationData.HV(); TPair* hvPair = static_cast(hvMap->FindObject(hvChannel.Data())); if (!hvPair) { AliError(Form("Did not find expected alias (%s) for DE %d", hvChannel.Data(),detElemId)); error = kTRUE; } else { TObjArray* values = static_cast(hvPair->Value()); if (!values) { AliError(Form("Could not get values for alias %s",hvChannel.Data())); error = kTRUE; } else { // find out min and max value, and makes a cut Float_t hvMin(1E9); Float_t hvMax(0); TIter next(values); AliDCSValue* val; while ( ( val = static_cast(next()) ) ) { Float_t hv = val->GetFloat(); hvMin = TMath::Min(hv,hvMin); hvMax = TMath::Max(hv,hvMax); } float lowThreshold = fHVSt12Limits.X(); float highThreshold = fHVSt12Limits.Y(); if ( hvMin < lowThreshold ) hvChannelTooLow = kTRUE; if ( hvMax > highThreshold ) hvChannelTooHigh = kTRUE; if ( hvMin < 1 ) hvChannelON = kFALSE; } } return error; } //_____________________________________________________________________________ Float_t AliMUONPadStatusMaker::SwitchValue(const TObjArray& dcsArray) { /// Loop over the dcs value for a single switch to decide whether /// we should consider it on or off // we'll count the number of ON/OFF for this pad, to insure // consistency (i.e. if status changed during the run, we should // at least notify this fact ;-) and hope it's not the norm) Int_t nTrue(0); Int_t nFalse(0); TIter next(&dcsArray); AliDCSValue* val; while ( ( val = static_cast(next()) ) ) { if ( val->GetBool() ) { ++nTrue; } else { ++nFalse; } } if ( (nTrue>0 && nFalse>0) ) { // change of state during the run, consider it off return 0.0; } if ( nFalse ) { /// switch = FALSE means the HV was flowding up to the PCB. /// i.e. switch = FALSE = ON return 1.0; } return 0.0; } //_____________________________________________________________________________ Bool_t AliMUONPadStatusMaker::HVSt345Status(Int_t detElemId, Int_t pcbIndex, Bool_t& hvChannelTooLow, Bool_t& hvChannelTooHigh, Bool_t& hvChannelON, Bool_t& hvSwitchON) const { /// For a given PCB in a given DE, get the HV status (both the channel /// and the switch). /// Returns false if something goes wrong (in particular if /// hv switch changed during the run). AliCodeTimerAuto("",0) if (!fHV) return kFALSE; Bool_t error = kFALSE; hvChannelTooLow = kFALSE; hvChannelTooHigh = kFALSE; hvSwitchON = kTRUE; hvChannelON = kTRUE; AliMpDCSNamer hvNamer("TRACKER"); TString hvChannel(hvNamer.DCSChannelName(detElemId)); TMap* hvMap = fkCalibrationData.HV(); TPair* hvPair = static_cast(hvMap->FindObject(hvChannel.Data())); if (!hvPair) { AliError(Form("Did not find expected alias (%s) for DE %d", hvChannel.Data(),detElemId)); error = kTRUE; } else { TObjArray* values = static_cast(hvPair->Value()); if (!values) { AliError(Form("Could not get values for alias %s",hvChannel.Data())); error = kTRUE; } else { // find out min and max value, and makes a cut Float_t hvMin(1E9); Float_t hvMax(0); TIter next(values); AliDCSValue* val; while ( ( val = static_cast(next()) ) ) { Float_t hv = val->GetFloat(); hvMin = TMath::Min(hv,hvMin); hvMax = TMath::Max(hv,hvMax); } float lowThreshold = fHVSt345Limits.X(); float highThreshold = fHVSt345Limits.Y(); if ( hvMin < lowThreshold ) hvChannelTooLow = kTRUE; else if ( hvMax > highThreshold ) hvChannelTooHigh = kTRUE; if ( hvMin < 1 ) hvChannelON = kFALSE; } } TString hvSwitch(hvNamer.DCSSwitchName(detElemId,pcbIndex)); TPair* switchPair = static_cast(hvMap->FindObject(hvSwitch.Data())); if (!switchPair) { AliError(Form("Did not find expected alias (%s) for DE %d PCB %d", hvSwitch.Data(),detElemId,pcbIndex)); error = kTRUE; } else { TObjArray* values = static_cast(switchPair->Value()); if (!values) { AliError(Form("Could not get values for alias %s",hvSwitch.Data())); error = kTRUE; } else { Float_t sv = SwitchValue(*values); if ( sv < 0.99 ) hvSwitchON = kFALSE; } } return error; } //_____________________________________________________________________________ Int_t AliMUONPadStatusMaker::HVStatus(Int_t detElemId, Int_t manuId) const { /// Get HV status of one manu AliCodeTimerAuto("",0) if ( !fHV ) return kMissing; Long_t lint = fHV->GetValue(AliMpManuUID::BuildUniqueID(detElemId,manuId)); if ( lint ) { return (Int_t)(lint - 1); } Int_t status(0); AliMpDCSNamer hvNamer("TRACKER"); switch ( AliMpDEManager::GetStationType(detElemId) ) { case AliMp::kStation12: { int sector = hvNamer.ManuId2Sector(detElemId,manuId); if ( sector >= 0 ) { Bool_t hvChannelTooLow, hvChannelTooHigh, hvChannelON; Bool_t error = HVSt12Status(detElemId,sector, hvChannelTooLow, hvChannelTooHigh, hvChannelON); if ( error ) status |= kHVError; if ( hvChannelTooLow ) status |= kHVTooLow; if ( hvChannelTooHigh ) status |= kHVTooHigh; if ( !hvChannelON ) status |= kHVChannelOFF; // assign this status to all the other manus handled by the same HV channel SetHVStatus(detElemId,sector,status); } } break; case AliMp::kStation345: { int pcbIndex = hvNamer.ManuId2PCBIndex(detElemId,manuId); if ( pcbIndex >= 0 ) { Bool_t hvChannelTooLow, hvChannelTooHigh, hvChannelON,hvSwitchON; Bool_t error = HVSt345Status(detElemId,pcbIndex, hvChannelTooLow,hvChannelTooHigh, hvChannelON,hvSwitchON); if ( error ) status |= kHVError; if ( hvChannelTooLow ) status |= kHVTooLow; if ( hvChannelTooHigh ) status |= kHVTooHigh; if ( !hvSwitchON ) status |= kHVSwitchOFF; if ( !hvChannelON) status |= kHVChannelOFF; // assign this status to all the other manus handled by the same HV channel SetHVStatus(detElemId,pcbIndex,status); } } break; default: break; } return status; } //_____________________________________________________________________________ AliMUONVCalibParam* AliMUONPadStatusMaker::Neighbours(Int_t detElemId, Int_t manuId) const { /// Get the neighbours parameters for a given manu AliMUONVStore* neighbourStore = fkCalibrationData.Neighbours(); return static_cast(neighbourStore->FindObject(detElemId,manuId)); } //_____________________________________________________________________________ AliMUONVStore* AliMUONPadStatusMaker::NeighboursStore() const { /// Return the store containing all the neighbours return fkCalibrationData.Neighbours(); } //_____________________________________________________________________________ AliMUONVCalibParam* AliMUONPadStatusMaker::ComputeStatus(Int_t detElemId, Int_t manuId) const { /// Compute the status of a given manu, using all available information, /// i.e. pedestals, gains, and HV AliMUONVCalibParam* param = new AliMUONCalibParamNI(1,AliMpConstants::ManuNofChannels(),detElemId,manuId,-1); fStatus->Add(param); AliMUONVCalibParam* pedestals = static_cast(fPedestals->FindObject(detElemId,manuId)); AliMUONVCalibParam* gains = static_cast(fGains->FindObject(detElemId,manuId)); Int_t hvStatus = HVStatus(detElemId,manuId); Int_t occStatus = OccupancyStatus(detElemId,manuId); for ( Int_t manuChannel = 0; manuChannel < param->Size(); ++manuChannel ) { Int_t pedStatus(0); if (pedestals) { Float_t pedMean = pedestals->ValueAsFloatFast(manuChannel,0); Float_t pedSigma = pedestals->ValueAsFloatFast(manuChannel,1); if ( pedMean < fPedMeanLimits.X() ) pedStatus |= kPedMeanTooLow; else if ( pedMean > fPedMeanLimits.Y() ) pedStatus |= kPedMeanTooHigh; if ( pedSigma < fPedSigmaLimits.X() ) pedStatus |= kPedSigmaTooLow; else if ( pedSigma > fPedSigmaLimits.Y() ) pedStatus |= kPedSigmaTooHigh; if ( pedMean == 0 ) pedStatus |= kPedMeanZero; } else { pedStatus = kPedMissing; } Int_t gainStatus(0); if ( gains ) { Float_t a0 = gains->ValueAsFloatFast(manuChannel,0); Float_t a1 = gains->ValueAsFloatFast(manuChannel,1); Float_t thres = gains->ValueAsFloatFast(manuChannel,2); if ( a0 < fGainA1Limits.X() ) gainStatus |= kGainA1TooLow; else if ( a0 > fGainA1Limits.Y() ) gainStatus |= kGainA1TooHigh; if ( a1 < fGainA2Limits.X() ) gainStatus |= kGainA2TooLow; else if ( a1 > fGainA2Limits.Y() ) gainStatus |= kGainA2TooHigh; if ( thres < fGainThresLimits.X() ) gainStatus |= kGainThresTooLow; else if ( thres > fGainThresLimits.Y() ) gainStatus |= kGainThresTooHigh; } else { gainStatus = kGainMissing; } Int_t status = BuildStatus(pedStatus,hvStatus,gainStatus,occStatus); param->SetValueAsIntFast(manuChannel,0,status); } return param; } //_____________________________________________________________________________ Int_t AliMUONPadStatusMaker::OccupancyStatus(Int_t detElemId, Int_t manuId) const { /// Get the "other" status for a given manu Int_t rv(0); if ( fTrackerData ) { const Int_t occIndex = 2; Double_t occ = fTrackerData->DetectionElement(detElemId,occIndex); if ( occ <= fDEOccupancyLimits.X() ) { rv |= kDEOccupancyTooLow; } else if ( occ > fDEOccupancyLimits.Y() ) { rv |= kDEOccupancyTooHigh; } Int_t busPatchId = AliMpDDLStore::Instance()->GetBusPatchId(detElemId,manuId); occ = fTrackerData->BusPatch(busPatchId,occIndex); if ( occ <= fBuspatchOccupancyLimits.X() ) { rv |= kBusPatchOccupancyTooLow; } else if ( occ > fBuspatchOccupancyLimits.Y() ) { rv |= kBusPatchOccupancyTooHigh; } occ = fTrackerData->Manu(detElemId,manuId,occIndex); if ( occ <= fManuOccupancyLimits.X() ) { rv |= kManuOccupancyTooLow; } else if ( occ > fManuOccupancyLimits.Y() ) { rv |= kManuOccupancyTooHigh; } } return rv; } //_____________________________________________________________________________ AliMUONVCalibParam* AliMUONPadStatusMaker::PadStatus(Int_t detElemId, Int_t manuId) const { /// Get the status container for a given manu AliMUONVCalibParam* param = static_cast(fStatus->FindObject(detElemId,manuId)); if (!param) { // not already there, so compute it now AliCodeTimerAuto("ComputeStatus",0); param = ComputeStatus(detElemId,manuId); } return param; } //_____________________________________________________________________________ Int_t AliMUONPadStatusMaker::PadStatus(Int_t detElemId, Int_t manuId, Int_t manuChannel) const { /// Get the status for a given channel AliMUONVCalibParam* param = static_cast(fStatus->FindObject(detElemId,manuId)); if (!param) { // not already there, so compute it now param = ComputeStatus(detElemId,manuId); } return param->ValueAsInt(manuChannel,0); } //_____________________________________________________________________________ void AliMUONPadStatusMaker::SetHVStatus(Int_t detElemId, Int_t index, Int_t status) const { /// Assign status to all manus in a given HV "zone" (defined by index, meaning /// is different thing from St12 and St345) AliCodeTimerAuto("",0) AliMpDetElement* de = AliMpDDLStore::Instance()->GetDetElement(detElemId); const AliMpArrayI* manus = de->ManusForHV(index); for ( Int_t i = 0; i < manus->GetSize(); ++ i ) { Int_t manuId = manus->GetValue(i); fHV->Add(AliMpManuUID::BuildUniqueID(detElemId,manuId),status + 1); } } //_____________________________________________________________________________ void AliMUONPadStatusMaker::SetLimits(const AliMUONRecoParam& recoParams) { /// Set the limits from the recoparam SetHVSt12Limits(recoParams.HVSt12LowLimit(),recoParams.HVSt12HighLimit()); SetHVSt345Limits(recoParams.HVSt345LowLimit(),recoParams.HVSt345HighLimit()); SetPedMeanLimits(recoParams.PedMeanLowLimit(),recoParams.PedMeanHighLimit()); SetPedSigmaLimits(recoParams.PedSigmaLowLimit(),recoParams.PedSigmaHighLimit()); SetGainA1Limits(recoParams.GainA1LowLimit(),recoParams.GainA1HighLimit()); SetGainA2Limits(recoParams.GainA2LowLimit(),recoParams.GainA2HighLimit()); SetGainThresLimits(recoParams.GainThresLowLimit(),recoParams.GainThresHighLimit()); SetManuOccupancyLimits(recoParams.ManuOccupancyLowLimit(),recoParams.ManuOccupancyHighLimit()); SetBuspatchOccupancyLimits(recoParams.BuspatchOccupancyLowLimit(),recoParams.BuspatchOccupancyHighLimit()); SetDEOccupancyLimits(recoParams.DEOccupancyLowLimit(),recoParams.DEOccupancyHighLimit()); } //_____________________________________________________________________________ void AliMUONPadStatusMaker::Report(UInt_t mask) { /// Report the number of bad pads, according to the mask, /// and the various reasons why they are bad (with occurence rates) AliInfo(""); AliCodeTimerAuto("",0); AliMUONLogger log(1064008); Int_t nBadPads(0); Int_t nPads(0); AliMpManuIterator it; Int_t detElemId, manuId; while ( it.Next(detElemId,manuId) ) { AliMpDetElement* de = AliMpDDLStore::Instance()->GetDetElement(detElemId); for ( Int_t i = 0; i < AliMpConstants::ManuNofChannels(); ++i ) { if ( de->IsConnectedChannel(manuId,i) ) { ++nPads; Int_t status = PadStatus(detElemId,manuId,i); if ( mask && ( status & mask) ) // note that if mask == 0, all pads are good... { ++nBadPads; log.Log(AsString(status)); } } } } TString msg; Int_t ntimes; cout << Form("According to mask %x (human readable form below) %6d pads are bad (over a total of %6d, i.e. %7.2f %%)", mask,nBadPads,nPads,nPads ? nBadPads*100.0/nPads : 0.0) << endl; cout << AliMUONPadStatusMaker::AsCondition(mask) << endl; cout << "--------" << endl; while ( log.Next(msg,ntimes) ) { cout << Form("The message (%120s) occured %15d times (%7.4f %%)",msg.Data(),ntimes,ntimes*100.0/nPads) << endl; } }