Single entry point to access MUON calibration data. More...

#include <AliMUONCalibrationData.h>

Inheritance diagram for AliMUONCalibrationData:

Public Member Functions
	AliMUONCalibrationData (Int_t runNumber=-1, Bool_t deferredInitialization=kTRUE)

virtual	~AliMUONCalibrationData ()

AliMUONVStore *	Capacitances () const

AliMUONVStore *	Gains () const
	Get all the gains. More...

AliMUONGlobalCrateConfig *	GlobalTriggerCrateConfig () const
	Get the configuration for the global trigger board. More...

AliMUONVCalibParam *	Gains (Int_t detElemId, Int_t manuId) const
	Get the Gain calibration object for channels within (detElemId,manuId). More...

TMap *	HV (Bool_t patched=kTRUE) const
	Get the HV values. Use patched=kFALSE to get unprocessed (i.e. "raw") values as they are in the OCDB. More...

TMap *	TriggerDCS () const
	Get the Trigger HV and current values. More...

Bool_t	IsValid () const
	Whether this object is valid or not (might be invalid if fetching from CDB failed). More...

AliMUONVCalibParam *	LocalTriggerBoardMasks (Int_t localBoardNumber) const
	Get the mask for a given local trigger board. More...

AliMUONVStore *	Neighbours () const
	Get the neighbours store. More...

AliMUONVStore *	Pedestals () const
	Get the pedestal store. More...

AliMUONVStore *	Config () const
	Get the config store. More...

AliMUONVStore *	OccupancyMap () const
	Get the occupancy map store. More...

AliMUONRejectList *	RejectList () const
	Get the reject list store. More...

AliMUONVCalibParam *	Pedestals (Int_t detElemId, Int_t manuId) const
	Get the Pedestal calibration object for channels within (detElemId,manuId). More...

virtual void	Print (Option_t *opt="") const
	Dump to screen. More...

AliMUONRegionalTriggerConfig *	RegionalTriggerConfig () const
	Get the config for regional trigger. More...

Int_t	RunNumber () const
	The runnumber used by this object. More...

AliMUONTriggerLut *	TriggerLut () const
	Get the trigger Look Up Table. More...

AliMUONTriggerEfficiencyCells *	TriggerEfficiency () const
	Get the trigger efficiency map. More...

void	Reset ()

Static Public Member Functions
static AliMUONVStore *	CreateCapacitances (Int_t runNumber, Int_t *startOfValidity=0)
	Create a capa store (which must be deleted) from OCDB for the given run. More...

static AliMUONVStore *	CreateGains (Int_t runNumber, Int_t *startOfValidity=0)
	Create a gain store (which must be deleted) from OCDB for the given run. More...

static AliMUONGlobalCrateConfig *	CreateGlobalTriggerCrateConfig (Int_t runNumber, Int_t *startOfValidity=0)
	Create a global trigger mask (which must be deleted) from OCDB for the given run. More...

static TMap *	CreateHV (Int_t runNumber, Int_t startOfValidity=0, Bool_t patched=kTRUE, TList messages=0x0, Bool_t dryRun=kFALSE)
	Create a hv map (which must be deleted) from OCDB for the given run. More...

static TMap *	CreateTriggerDCS (Int_t runNumber, Int_t *startOfValidity=0)
	Create a Trigger HV and current map (which must be deleted) from OCDB for the given run. More...

static AliMUONVStore *	CreateNeighbours (Int_t runNumber, Int_t *startOfValidity=0)
	Create a neighbours store (which must be deleted) from OCDB for the given run. More...

static AliMUONVStore *	CreateLocalTriggerBoardMasks (Int_t runNumber, Int_t *startOfValidity=0)
	Create a local trigger mask store (which must be deleted) for a given run. More...

static AliMUONVStore *	CreateOccupancyMap (Int_t runNumber, Int_t *startOfValidity=0)
	Create an occupancy map store (which must be deleted) from OCDB for the given run. More...

static AliMUONRejectList *	CreateRejectList (Int_t runNumber, Int_t *startOfValidity=0)
	Create a rejectlist store (which must be deleted) from OCDB for the given run. More...

static AliMUONVStore *	CreatePedestals (Int_t runNumber, Int_t *startOfValidity=0)
	Create a pedestal store (which must be deleted) from OCDB for the given run. More...

static AliMUONVStore *	CreateConfig (Int_t runNumber, Int_t *startOfValidity=0)
	Create a configuration store (which must be deleted) from OCDB for the given run. More...

static AliMUONRegionalTriggerConfig *	CreateRegionalTriggerConfig (Int_t runNumber, Int_t *startOfValidity=0)
	Create a regional trigger mask store (which must be deleted) for a given run. More...

static AliMUONTriggerLut *	CreateTriggerLut (Int_t runNumber, Int_t *startOfValidity=0)
	Create a trigger Look Up Table (which must be deleted) for a given run. More...

static AliMUONTriggerEfficiencyCells *	CreateTriggerEfficiency (Int_t runNumber, Int_t *startOfValidity=0)
	Create a trigger efficiency map (which must be deleted) for a given run. More...

static TObject *	CreateObject (Int_t runNumber, const char path, Int_t startOfValidity=0x0)

static void	Check (Int_t runNumber)

static void	BypassStores (AliMUONVStore ped, AliMUONVStore gain)

Protected Member Functions
	AliMUONCalibrationData (const AliMUONCalibrationData &other)
	Not implemented. More...

AliMUONCalibrationData &	operator= (const AliMUONCalibrationData &other)
	Not implemented. More...

Static Protected Member Functions
static Bool_t	PatchHVValues (TObjArray &values, TString *msg=0x0, Bool_t dryRun=kFALSE)

static Bool_t	CheckHVGroup (TObjArray &values, Int_t first, Int_t last, Double_t &value, Int_t &slope, TString *msg)

static void	PatchSt1DCSAliases (TMap &hvMap)

static void	AddToMap (const TMap &sourceMap, TMap &destMap, const TString &key, const char source, const char dest)

Private Attributes
Bool_t	fIsValid
	Whether we were able to correctly initialize. More...

Int_t	fRunNumber
	The run number for which we hold calibrations. More...

AliMUONVStore *	fGains
	! Gains More...

AliMUONVStore *	fPedestals
	! Pedestals More...

TMap *	fHV
	! HV More...

TMap *	fTriggerDCS
	! Trigger HV and Currents More...

AliMUONVStore *	fLocalTriggerBoardMasks
	! Local trigger board maska More...

AliMUONRegionalTriggerConfig *	fRegionalTriggerConfig
	! Regional trigger config More...

AliMUONGlobalCrateConfig *	fGlobalTriggerCrateConfig
	! Global trigger crate config More...

AliMUONTriggerLut *	fTriggerLut
	! TRigger LUTs More...

AliMUONTriggerEfficiencyCells *	fTriggerEfficiency
	! Trigger efficiency cells More...

AliMUONVStore *	fCapacitances
	! Manu capacitances More...

AliMUONVStore *	fNeighbours
	! list of neighbours for all channels More...

AliMUONVStore *	fOccupancyMap
	! occupancy map More...

AliMUONRejectList *	fRejectList
	! reject list More...

AliMUONVStore *	fConfig
	! configuration of the tracker More...

Static Private Attributes
static AliMUONVStore *	fgBypassPedestals

static AliMUONVStore *	fgBypassGains

static UInt_t	fgkDCSSt1Flag
	! flag to indicate that the DCS alias naming is not messed up in St1 More...

Detailed Description

Single entry point to access MUON calibration data.

For the moment, this class stores pedestals, gains, hv (for tracker) and lut, masks and efficiencies (for trigger) that are fetched from the CDB.

This class is to be considered as a convenience class. Its aim is to ease retrieval of calibration data from the condition database.

It acts as a "facade" to a bunch of underlying containers/calibration classes.

Author: Laurent Aphecetche

Definition at line 30 of file AliMUONCalibrationData.h.

Constructor & Destructor Documentation

AliMUONCalibrationData::AliMUONCalibrationData	(	Int_t	runNumber = `-1`,
		Bool_t	deferredInitialization = `kTRUE`
	)

Constructor.

Parameters

runNumber	is used as a key to the CDB
deferredInitialization	if kFALSE, all the calibrations are fetched regardless of whether you'll use them or not.

Default ctor.

Definition at line 80 of file AliMUONCalibrationData.cxx.

AliMUONCalibrationData::~AliMUONCalibrationData ( )

virtual

Destructor. Note that we're the owner of our pointers if the OCDB cache is not set. Otherwise the cache is supposed to take care of them...

Definition at line 128 of file AliMUONCalibrationData.cxx.

AliMUONCalibrationData::AliMUONCalibrationData ( const AliMUONCalibrationData & other )

protected

Not implemented.

Member Function Documentation

void AliMUONCalibrationData::AddToMap	(	const TMap &	sourceMap,
		TMap &	destMap,
		const TString &	key,
		const char *	source,
		const char *	dest
	)

staticprotected

Remap

Definition at line 621 of file AliMUONCalibrationData.cxx.

Referenced by PatchSt1DCSAliases().

void AliMUONCalibrationData::BypassStores	(	AliMUONVStore *	ped,
		AliMUONVStore *	gain
	)

static

Force the use of those pedestals and gains

Definition at line 1068 of file AliMUONCalibrationData.cxx.

AliMUONVStore * AliMUONCalibrationData::Capacitances ( ) const

Create (if needed) and return the internal store for capacitances.

Definition at line 137 of file AliMUONCalibrationData.cxx.

Referenced by AliMUONCalibrationData(), AliMUONDigitCalibrator::Ctor(), and AliMUONTrackerDataMaker::Ctor().

void AliMUONCalibrationData::Check ( Int_t runNumber )

static

Self-check to see if we can read all data for a given run from the current OCDB...

Definition at line 1219 of file AliMUONCalibrationData.cxx.

Bool_t AliMUONCalibrationData::CheckHVGroup	(	TObjArray &	values,
		Int_t	first,
		Int_t	last,
		Double_t &	value,
		Int_t &	slope,
		TString *	msg
	)

staticprotected

Definition at line 176 of file AliMUONCalibrationData.cxx.

Referenced by PatchHVValues().

AliMUONVStore * AliMUONCalibrationData::Config ( ) const

Get the config store.

Return config

Definition at line 1093 of file AliMUONCalibrationData.cxx.

Referenced by AliMUONCalibrationData(), and AliMUONTrackerQADataMakerRec::InitCommon().

AliMUONVStore * AliMUONCalibrationData::CreateCapacitances	(	Int_t	runNumber,
		Int_t *	startOfValidity = `0`
	)

static

Create a capa store (which must be deleted) from OCDB for the given run.

Create capa store from OCDB for a given run

Definition at line 150 of file AliMUONCalibrationData.cxx.

Referenced by Capacitances(), Check(), and AliMUONTrackerConditionDataMaker::CreateStore().

AliMUONVStore * AliMUONCalibrationData::CreateConfig	(	Int_t	runNumber,
		Int_t *	startOfValidity = `0`
	)

static

Create a configuration store (which must be deleted) from OCDB for the given run.

Create a new config store from the OCDB for a given run

Definition at line 901 of file AliMUONCalibrationData.cxx.

Referenced by Check(), Config(), and AliMUONTrackerConditionDataMaker::CreateStore().

AliMUONVStore * AliMUONCalibrationData::CreateGains	(	Int_t	runNumber,
		Int_t *	startOfValidity = `0`
	)

static

Create a gain store (which must be deleted) from OCDB for the given run.

Create a new gain store from the OCDB for a given run

Definition at line 159 of file AliMUONCalibrationData.cxx.

Referenced by Check(), AliMUONTrackerConditionDataMaker::CreateStore(), and Gains().

AliMUONGlobalCrateConfig * AliMUONCalibrationData::CreateGlobalTriggerCrateConfig	(	Int_t	runNumber,
		Int_t *	startOfValidity = `0`
	)

static

Create a global trigger mask (which must be deleted) from OCDB for the given run.

Create the internal store for GlobalTriggerCrateConfig from OCDB

Definition at line 167 of file AliMUONCalibrationData.cxx.

Referenced by Check(), and GlobalTriggerCrateConfig().

TMap * AliMUONCalibrationData::CreateHV	(	Int_t	runNumber,
		Int_t *	startOfValidity = `0`,
		Bool_t	patched = `kTRUE`,
		TList *	messages = `0x0`,
		Bool_t	dryRun = `kFALSE`
	)

static

Create a hv map (which must be deleted) from OCDB for the given run.

Create a new HV map from the OCDB for a given run

dryRun is only usefull with patched=kTRUE and non-empty messages) : it allow to get the list of messages without altering the values at all (A patch without a patch, so to speak...)

Definition at line 708 of file AliMUONCalibrationData.cxx.

Referenced by Check(), AliMUONCDB::CheckHV(), AliMUONTrackerConditionDataMaker::CreateStore(), HV(), AliMUONTrackerHV::Plot(), AliMUONTrackerHV::Print(), and AliMUONTrackerHV::ReportTrips().

AliMUONVStore * AliMUONCalibrationData::CreateLocalTriggerBoardMasks	(	Int_t	runNumber,
		Int_t *	startOfValidity = `0`
	)

static

Create a local trigger mask store (which must be deleted) for a given run.

Get the internal store for LocalTriggerBoardMasks from OCDB

Definition at line 817 of file AliMUONCalibrationData.cxx.

Referenced by Check(), and LocalTriggerBoardMasks().

AliMUONVStore * AliMUONCalibrationData::CreateNeighbours	(	Int_t	runNumber,
		Int_t *	startOfValidity = `0`
	)

static

Create a neighbours store (which must be deleted) from OCDB for the given run.

Create a neighbour store from the OCDB for a given run

Definition at line 826 of file AliMUONCalibrationData.cxx.

Referenced by Check(), and Neighbours().

TObject * AliMUONCalibrationData::CreateObject	(	Int_t	runNumber,
		const char *	path,
		Int_t *	startOfValidity = `0x0`
	)

static

Access the CDB for a given path (e.g. MUON/Calib/Pedestals), and return the corresponding TObject.

Definition at line 834 of file AliMUONCalibrationData.cxx.

Referenced by CreateCapacitances(), CreateConfig(), CreateGains(), CreateGlobalTriggerCrateConfig(), CreateHV(), CreateLocalTriggerBoardMasks(), CreateNeighbours(), CreateOccupancyMap(), CreatePedestals(), CreateRegionalTriggerConfig(), CreateRejectList(), CreateTriggerDCS(), CreateTriggerEfficiency(), and CreateTriggerLut().

AliMUONVStore * AliMUONCalibrationData::CreateOccupancyMap	(	Int_t	runNumber,
		Int_t *	startOfValidity = `0`
	)

static

Create an occupancy map store (which must be deleted) from OCDB for the given run.

Create a new occupancy map store from the OCDB for a given run

Definition at line 877 of file AliMUONCalibrationData.cxx.

Referenced by AliMUONTrackerConditionDataMaker::CreateStore(), and OccupancyMap().

AliMUONVStore * AliMUONCalibrationData::CreatePedestals	(	Int_t	runNumber,
		Int_t *	startOfValidity = `0`
	)

static

Create a pedestal store (which must be deleted) from OCDB for the given run.

Create a new pedestal store from the OCDB for a given run

Definition at line 893 of file AliMUONCalibrationData.cxx.

Referenced by Check(), AliMUONTrackerConditionDataMaker::CreateStore(), and Pedestals().

AliMUONRegionalTriggerConfig * AliMUONCalibrationData::CreateRegionalTriggerConfig	(	Int_t	runNumber,
		Int_t *	startOfValidity = `0`
	)

static

Create a regional trigger mask store (which must be deleted) for a given run.

Create the internal store for RegionalTriggerConfig from OCDB

Definition at line 910 of file AliMUONCalibrationData.cxx.

Referenced by Check(), and RegionalTriggerConfig().

AliMUONRejectList * AliMUONCalibrationData::CreateRejectList	(	Int_t	runNumber,
		Int_t *	startOfValidity = `0`
	)

static

Create a rejectlist store (which must be deleted) from OCDB for the given run.

Create a new rejectlist store from the OCDB for a given run

Definition at line 885 of file AliMUONCalibrationData.cxx.

Referenced by AliMUONTrackerConditionDataMaker::AliMUONTrackerConditionDataMaker(), and RejectList().

TMap * AliMUONCalibrationData::CreateTriggerDCS	(	Int_t	runNumber,
		Int_t *	startOfValidity = `0`
	)

static

Create a Trigger HV and current map (which must be deleted) from OCDB for the given run.

Create a new Trigger HV and curent map from the OCDB for a given run

Definition at line 809 of file AliMUONCalibrationData.cxx.

Referenced by Check(), and TriggerDCS().

AliMUONTriggerEfficiencyCells * AliMUONCalibrationData::CreateTriggerEfficiency	(	Int_t	runNumber,
		Int_t *	startOfValidity = `0`
	)

static

Create a trigger efficiency map (which must be deleted) for a given run.

Create trigger efficiency object from OCBD

Definition at line 919 of file AliMUONCalibrationData.cxx.

Referenced by Check(), and TriggerEfficiency().

AliMUONTriggerLut * AliMUONCalibrationData::CreateTriggerLut	(	Int_t	runNumber,
		Int_t *	startOfValidity = `0`
	)

static

Create a trigger Look Up Table (which must be deleted) for a given run.

Create trigger LUT from OCDB

Definition at line 928 of file AliMUONCalibrationData.cxx.

Referenced by Check(), and TriggerLut().

AliMUONVStore * AliMUONCalibrationData::Gains ( ) const

Get all the gains.

Create (if needed) and return the internal store for gains.

Definition at line 937 of file AliMUONCalibrationData.cxx.

Referenced by AliMUONCalibrationData(), AliMUONDigitizerV3::ApplyResponseToTrackerDigit(), AliMUONDigitCalibrator::Ctor(), AliMUONTrackerDataMaker::Ctor(), AliMUONChamberCalibrationTask::Exec(), Gains(), AliMUONDigitizerV3::Init(), and MUONClusterInfo().

AliMUONVCalibParam * AliMUONCalibrationData::Gains	(	Int_t	detElemId,
		Int_t	manuId
	)		const

Get the Gain calibration object for channels within (detElemId,manuId).

Return the gains for a given (detElemId, manuId) pair Note that, unlike the DeadChannel case, if the result is 0x0, that's an error (meaning that we should get gains for all channels).

Definition at line 951 of file AliMUONCalibrationData.cxx.

AliMUONGlobalCrateConfig * AliMUONCalibrationData::GlobalTriggerCrateConfig ( ) const

Get the configuration for the global trigger board.

Return the config for the global trigger board.

Definition at line 968 of file AliMUONCalibrationData.cxx.

Referenced by AliMUONCalibrationData(), AliMUONTriggerElectronics::LoadMasks(), MUONReCalcGlobalTrigger(), and AliMUONTriggerQADataMakerRec::RawTriggerInGlobal2OutGlobal().

TMap * AliMUONCalibrationData::HV ( Bool_t patched = kTRUE ) const

Get the HV values. Use patched=kFALSE to get unprocessed (i.e. "raw") values as they are in the OCDB.

Return the calibration for a given (detElemId, manuId) pair

Definition at line 982 of file AliMUONCalibrationData.cxx.

Referenced by AliMUONCalibrationData(), AliMUONCDB::CheckHV(), AliMUONTrackerDataMaker::Ctor(), AliMUONPadStatusMaker::HVSt12Status(), and AliMUONPadStatusMaker::HVSt345Status().

Bool_t AliMUONCalibrationData::IsValid ( ) const

inline

Whether this object is valid or not (might be invalid if fetching from CDB failed).

Definition at line 100 of file AliMUONCalibrationData.h.

AliMUONVCalibParam * AliMUONCalibrationData::LocalTriggerBoardMasks ( Int_t localBoardNumber ) const

Get the mask for a given local trigger board.

Return the masks for a given trigger local board.

Definition at line 1020 of file AliMUONCalibrationData.cxx.

Referenced by AliMUONCalibrationData(), and AliMUONTriggerElectronics::LoadMasks().

AliMUONVStore * AliMUONCalibrationData::Neighbours ( ) const

Get the neighbours store.

Create (if needed) and return the internal store for neighbours.

Definition at line 1008 of file AliMUONCalibrationData.cxx.

Referenced by AliMUONCalibrationData(), AliMUONTrackerDataMaker::Ctor(), AliMUONPadStatusMaker::Neighbours(), and AliMUONPadStatusMaker::NeighboursStore().

AliMUONVStore * AliMUONCalibrationData::OccupancyMap ( ) const

Get the occupancy map store.

Get occupancy map

Definition at line 1044 of file AliMUONCalibrationData.cxx.

Referenced by AliMUONCalibrationData().

AliMUONCalibrationData& AliMUONCalibrationData::operator= ( const AliMUONCalibrationData & other )

protected

Not implemented.

Bool_t AliMUONCalibrationData::PatchHVValues	(	TObjArray &	values,
		TString *	msg = `0x0`,
		Bool_t	dryRun = `kFALSE`
	)

staticprotected

We do here a little bit of massaging of the HV values, if needed.

The main point is to "gather" values that are within a given small amount of time (typically 60 seconds) and infer a slope from those values slope > 0 means it is a ramp-up, slope < 0 that's a ramp-down

This is to avoid both the "ramp-down-before-end-of-run" and the "ramp-up-after-start-of-run" syndroms...

Use dryRun = kTRUE to fill the messages without altering the values

Return kFALSE is the kind of HV (trouble) case we have here has not been identified...

Definition at line 241 of file AliMUONCalibrationData.cxx.

Referenced by CreateHV().

void AliMUONCalibrationData::PatchSt1DCSAliases ( TMap & hvMap )

staticprotected

It was discovered (in sept. 2013) that the DCS aliases for St1 was wrongly assigned (in the hardware), so the correspondence between DCS channels and actual HV channels is wrong for St1 in the DCS (and thus in the DCS archive, and so in the OCDB HV object).

It affects all the OCDB object written in 2010-2013.

This method fixes that.

Definition at line 639 of file AliMUONCalibrationData.cxx.

Referenced by CreateHV().

AliMUONVStore * AliMUONCalibrationData::Pedestals ( ) const

Get the pedestal store.

Return pedestals

Definition at line 1078 of file AliMUONCalibrationData.cxx.

Referenced by AliMUONCalibrationData(), AliMUONDigitizerV3::ApplyResponseToTrackerDigit(), AliMUONDigitCalibrator::Ctor(), AliMUONTrackerDataMaker::Ctor(), AliMUONChamberCalibrationTask::Exec(), AliMUONDigitizerV3::GenerateNoisyDigitsForOneCathode(), AliMUONDigitizerV3::Init(), MUONClusterInfo(), and Pedestals().

AliMUONVCalibParam * AliMUONCalibrationData::Pedestals	(	Int_t	detElemId,
		Int_t	manuId
	)		const

Get the Pedestal calibration object for channels within (detElemId,manuId).

Return the pedestals for a given (detElemId, manuId) pair. A return value of 0x0 is considered an error, meaning we should get pedestals for all channels.

Definition at line 1106 of file AliMUONCalibrationData.cxx.

void AliMUONCalibrationData::Print ( Option_t * opt = "" ) const

virtual

Dump to screen.

A very basic dump of our guts.

Definition at line 1123 of file AliMUONCalibrationData.cxx.

AliMUONRegionalTriggerConfig * AliMUONCalibrationData::RegionalTriggerConfig ( ) const

Get the config for regional trigger.

Return the config for the regional trigger board.

Definition at line 1143 of file AliMUONCalibrationData.cxx.

Referenced by AliMUONCalibrationData(), AliMUONTriggerElectronics::LoadMasks(), MUONReCalcGlobalTrigger(), and AliMUONTriggerCrateStore::ReadFromFile().

AliMUONRejectList * AliMUONCalibrationData::RejectList ( ) const