A QA task to analyze hit and MC point occupancy distributions in different tracking stations. More...

#include <CbmCaInputQaSetup.h>

Inheritance diagram for cbm::ca::InputQaSetup:

Collaboration diagram for cbm::ca::InputQaSetup:

Public Types
enum class	EStoringMode { kSAMEDIR , kSUBDIR }

using	ObjList_t = std::vector<std::pair<TObject*, TString>>

Public Member Functions
	InputQaSetup (int verbose, bool isMCUsed)
	Constructor from parameters.

void	Check () override
	Checks results of the QA and returns a success flag.

void	CreateSummary () override
	Creates summary cavases, tables etc.

void	ExecQa () override
	Fills histograms.

InitStatus	InitQa () override
	Initializes QA-task.

bool	CompareQaObjects ()
	Process ROOT objects comparison.

void	DisableEventMode ()
	Disables event-by-event execution.

const std::map< std::string, CheckFlags > &	GetCheckList () const
	Gets check-list.

const TString &	GetDefaultTag () const
	Gets default tag.

const std::string &	GetSetupName () const
	Gets name of the setup.

const TString &	GetVersionTag () const
	Gets version tag.

bool	IsMCUsed () const
	Returns flag, whether MC information is used or not in the task.

void	ReadCheckListFromConfig ()
	Reads check-list from the configuration file.

void	SetCheckFile (const std::shared_ptr< TFile > &pCheckFile)
	Sets check-file.

void	SetCompareOutput (const std::shared_ptr< TFile > &pCompareOutput)
	Sets compare output file.

void	SetVersionTag (const TString &tag)
	Sets version tag.

void	SetDefaultTag (const TString &tag)
	Sets default tag.

void	SetRecoMode (ECbmRecoMode recoMode)
	Sets data processing (reconstruction) mode.

void	SetSetupName (const char *setup)
	Sets name of the setup.

const char *	GetConfigName () const
	Gets config name.

template<typename T, typename... Args>
T *	MakeQaObject (TString sName, TString sTitle, Args... args)

void	MakeQaDirectory (TString sName)

void	SetConfigName (const char *path)
	Creates a ROOT object.

void	SetRootFolderName (const TString &path)
	Sets a common root path to the objects in the output file.

void	SetStoringMode (EStoringMode mode)
	Set storing mode.

Protected Member Functions
virtual void	DeInit ()
	De-initialize the task.

void	Exec (Option_t *) override final
	FairTask: Defines action of the task in the event/TS.

void	Finish () override final
	FairTask: Defines action of the task in the end of run.

InitStatus	Init () override final
	FairTask: Task initialization in the beginning of the run.

InitStatus	ReInit () override final
	FairTask: Task reinitialization.

int	GetEventNumber () const
	Get current event number.

template<typename T>
bool	CheckRange (std::string_view name, T var, T lo, T hi) const
	Checks range of variable.

template<typename T>
bool	CheckRange (std::string_view name, T var, T varErr, T lo, T hi) const
	Checks range of variable.

bool	CheckRange (TH1 *h, double meanMax, double rmsMin, double rmsMax)
	Checks ranges for mean and standard deviation.

void	PutSetupNameOnPad (double xMin, double yMin, double xMax, double yMax)
	Puts setup title on the canvas.

CbmEvent *	GetCurrentEvent ()
	Gets pointer to current event.

void	StoreCheckResult (const std::string &tag, bool result, const std::string &msg="")
	Stores check flag to the check-list.

template<typename T>
void	CheckProperty (T &&property, const char *name) const
	Function to check, if a property is defined.

template<class Config>
std::optional< Config >	ReadSpecificConfig () const
	Reads the specific configuration structure from the YAML node.

virtual void	SetTH1Properties (TH1 *pHist) const
	Applies properties on the histogram created with the MakeQaObject function.

virtual void	SetTH2Properties (TH2 *pHist) const
	Applies properties on the histogram created with the MakeQaObject function.

virtual void	SetTProfile2DProperties (TProfile2D *pHist) const
	Applies properties on the profile 2D created with the MakeQaObject function.

virtual void	SetCanvasProperties (TCanvas *pCanv) const
	Applies properties on the canvas created with the MakeQaObject funciton.

void	WriteToFile (TFile *pOutFile) const
	Writes objects into file.

Protected Attributes
TString	fsRootFolderName = ""
	Name of root folder.

TString	fsConfigName = ""
	Name of configuration file.

TString	fsPrefix = ""
	Unique prefix for all writeable root.

EStoringMode	fStoringMode = EStoringMode::kSUBDIR
	Objects storing mode.

std::shared_ptr< ObjList_t >	fpvObjList = nullptr
	List of registered ROOT objects.

YAML::Node	fConfigNode {}
	Configuration node.

Private Member Functions
void	CheckoutDetectors ()
	Check out initialized detectors.

void	CheckInit () const
	Checks branches initialization.

template<ca::EDetectorID DetID>
void	FillHistogramsDet ()
	Fill histograms for a given detector type.

void	DeInitBase ()
	De-initializes this task.

template<class Obj>
bool	CompareTwoObjects (const TObject pObjL, const TObject pObjR, const TString &objName, const ObjectComparisonConfig &cfg)
	Process object comparison.

	ClassDefOverride (CbmQaTask, 0)

template<typename T, typename... Args>
T *	ConstructAndRegisterQaObject (TString name, Args... args)
	Creates and registers a ROOT object.

Private Attributes
DetIdArr_t< bool >	fvbUseDet = {{false}}
	Detector subsystem usage flag.

DetIdArr_t< TClonesArray * >	fvpBrHits = {{nullptr}}
	Input branch for hits.

DetIdArr_t< CbmMCDataArray * >	fvpBrPoints = {{nullptr}}
	Input branch for MC points.

CbmMCDataObject *	fpMCEventHeader = nullptr
	Pointer to MC event header.

CbmMCEventList *	fpMCEventList = nullptr
	Pointer to MC event list.

std::shared_ptr< const ca::Parameters< double > >	fpParameters = nullptr
	Pointer to CA parameters object.

std::string	fsParametersFilename = ""
	Filename for the tracking parameters.

DetIdArr_t< std::vector< double > >	fvXmin

DetIdArr_t< std::vector< double > >	fvXmax

DetIdArr_t< std::vector< double > >	fvYmin

DetIdArr_t< std::vector< double > >	fvYmax

DetIdArr_t< std::vector< double > >	fvZmin

DetIdArr_t< std::vector< double > >	fvZmax

std::vector< TH2F * >	fph_hit_xy = {}
	Hit occupancy in x-y plane vs. station.

std::vector< TH2F * >	fph_hit_xz = {}
	Hit occupancy in x-z plane vs. station.

std::vector< TH2F * >	fph_hit_yz = {}
	Hit occupancy in y-z plane vs. station.

std::vector< TH2F * >	fph_point_xy = {}
	MC point occupancy in x-z plane vs. station.

std::vector< TH2F * >	fph_point_xz = {}
	MC point occupancy in x-z plane vs. station.

std::vector< TH2F * >	fph_point_yz = {}
	MC point occupancy in y-z plane vs. station.

bool	fbUseMC = false
	Flag, if MC is used.

ECbmRecoMode	fRecoMode = ECbmRecoMode::Timeslice
	Reconstruction mode.

std::map< std::string, CheckFlags >	fmCheckList
	A QA check-list map.

TClonesArray *	fpBrEvents = nullptr
	Pointer to CbmEvent branch.

CbmEvent *	fpCurrentEvent = nullptr
	Pointer to the current event.

std::string	fsSetupName = ""
	Name of the setup (to draw on the canvases)

TParameter< int >	fNofEvents {"nEvents", 0}
	Number of processed events.

TString	fsVersionTag = ""
	Version tag (git SHA etc.)

TString	fsDefaultTag = ""
	Default tag (git SHA etc.)

std::shared_ptr< TFile >	fpBenchmarkInput = nullptr
	A file with default ROOT objects used for the cross-check.

std::shared_ptr< TFile >	fpBenchmarkOutput = nullptr
	An output file for histograms cross-check.

Detailed Description

A QA task to analyze hit and MC point occupancy distributions in different tracking stations.

Definition at line 37 of file CbmCaInputQaSetup.h.

Member Typedef Documentation

◆ ObjList_t

using CbmQaIO::ObjList_t = std::vector<std::pair<TObject*, TString>>

inherited

Examples: /tmp/builds/computing/cbmroot/core/qa/CbmQaIO.h.

Definition at line 45 of file CbmQaIO.h.

Member Enumeration Documentation

◆ EStoringMode

enum class CbmQaIO::EStoringMode

stronginherited

Enumerator
kSAMEDIR	Objects of different type will be stored to root directory.
kSUBDIR	Objects of different type will be stored in different subdirectories like histograms/ canvases/.

Examples: /tmp/builds/computing/cbmroot/core/qa/CbmQaIO.h.

Definition at line 47 of file CbmQaIO.h.

Constructor & Destructor Documentation

◆ InputQaSetup()

InputQaSetup::InputQaSetup	(	int	verbose,
		bool	isMCUsed )

Constructor from parameters.

Parameters

verbose	Verbosity level
isMCUsed	Flag, if MC information is available for this task

Definition at line 29 of file CbmCaInputQaSetup.cxx.

References CbmQaTask::CbmQaTask().

Member Function Documentation

◆ Check()

void InputQaSetup::Check ( )

overridevirtual

Checks results of the QA and returns a success flag.

Implements CbmQaTask.

Definition at line 33 of file CbmCaInputQaSetup.cxx.

◆ CheckInit()

void InputQaSetup::CheckInit ( ) const

private

Checks branches initialization.

Definition at line 38 of file CbmCaInputQaSetup.cxx.

References cbm::algo::ca::END, fpMCEventHeader, fvbUseDet, fvpBrHits, fvpBrPoints, CbmQaTask::IsMCUsed(), and cbm::ca::kDetName.

Referenced by InitQa().

◆ CheckoutDetectors()

void InputQaSetup::CheckoutDetectors ( )

private

Check out initialized detectors.

Definition at line 57 of file CbmCaInputQaSetup.cxx.

References fvbUseDet, CbmSetup::Instance(), cbm::algo::ca::kMuch, cbm::algo::ca::kMvd, cbm::algo::ca::kSts, cbm::algo::ca::kTof, cbm::algo::ca::kTrd, and L_.

Referenced by InitQa().

◆ CheckProperty()

template<typename T>

void CbmQaIO::CheckProperty	(	T &&	property,
		const char *	name ) const

protectedinherited

Function to check, if a property is defined.

Parameters

property	A property to be tested
name	A name of property (used for logging)

Note: Throws an exception, if property is undefined

Examples: /tmp/builds/computing/cbmroot/core/qa/CbmQaIO.h.

Definition at line 177 of file CbmQaIO.h.

Referenced by MakeQaObject().

◆ CheckRange() [1/3]

template<typename T>

bool CbmQaTask::CheckRange	(	std::string_view	name,
		T	var,
		T	lo,
		T	hi ) const

protectedinherited

Checks range of variable.

Parameters

name	Name of the variable
var	Variable to check
lo	Lower limit of the variable
hi	Upper limit of the variable

Returns: False, if variable exits the range

Definition at line 275 of file CbmQaTask.h.

References CheckRange().

Referenced by CheckRange(), and CheckRange().

◆ CheckRange() [2/3]

template<typename T>

bool CbmQaTask::CheckRange	(	std::string_view	name,
		T	var,
		T	varErr,
		T	lo,
		T	hi ) const

protectedinherited

Checks range of variable.

Parameters

name	Name of the variable
var	Variable to check
varErr	Standard Error of the variable
lo	Lower limit of the variable
hi	Upper limit of the variable

Returns: False, if variable exits the range

Definition at line 283 of file CbmQaTask.h.

◆ CheckRange() [3/3]

bool CbmQaTask::CheckRange	(	TH1 *	h,
		double	meanMax,
		double	rmsMin,
		double	rmsMax )

protectedinherited

Checks ranges for mean and standard deviation.

Returns: False, if variable exits the range

Definition at line 141 of file CbmQaTask.cxx.

References CheckRange().

◆ ClassDefOverride()

CbmQaTask::ClassDefOverride	(	CbmQaTask	,
		0	)

privateinherited

References CbmQaTask().

◆ CompareQaObjects()

bool CbmQaTask::CompareQaObjects ( )

inherited

Process ROOT objects comparison.

Returns: true All the object are consistent; false Some of the objects are inconsistent

Definition at line 162 of file CbmQaTask.cxx.

References CbmQaIO::fConfigNode.

◆ CompareTwoObjects()

template<class Obj>

bool CbmQaTask::CompareTwoObjects	(	const TObject *	pObjL,
		const TObject *	pObjR,
		const TString &	objName,
		const ObjectComparisonConfig &	cfg )

privateinherited

Process object comparison.

Template Parameters

Obj	Class of the ROOT object

Parameters

pObjL	First object (this)
pObjR	Second object (default)
objName	Name of the object (contains full path to the object)
cfg	Comparison configuration entry

Returns: true Histograms are equal within selected method; false Histograms differ within one of the comparison methods

Definition at line 306 of file CbmQaTask.h.

References CbmQaTask::ObjectComparisonConfig::fCanvOpt, CbmQaTask::ObjectComparisonConfig::fChi2NdfMax, fpBenchmarkOutput, CbmQaTask::ObjectComparisonConfig::fPoint, CbmQaTask::ObjectComparisonConfig::fRatio, CbmQaTask::ObjectComparisonConfig::fRatioMax, CbmQaTask::ObjectComparisonConfig::fRatioMin, fsDefaultTag, CbmQaTask::ObjectComparisonConfig::fStat, CbmQaTask::ObjectComparisonConfig::fStatOpt, and fsVersionTag.

◆ ConstructAndRegisterQaObject()

template<typename T, typename... Args>

T * CbmQaIO::ConstructAndRegisterQaObject	(	TString	name,
		Args...	args )

privateinherited

Creates and registers a ROOT object.

Parameters

name	A name of the ROOT object, which can contain a sub-directory
args	Other arguments, passed to the ROOT object constructor

Examples: /tmp/builds/computing/cbmroot/core/qa/CbmQaIO.h.

Definition at line 197 of file CbmQaIO.h.

References fpvObjList, fsRootFolderName, fStoringMode, kSUBDIR, SetCanvasProperties(), SetTH1Properties(), SetTH2Properties(), and SetTProfile2DProperties().

Referenced by MakeQaObject().

◆ CreateSummary()

void InputQaSetup::CreateSummary ( )

overridevirtual

Creates summary cavases, tables etc.

Reimplemented from CbmQaTask.

Definition at line 74 of file CbmCaInputQaSetup.cxx.

References cbm::algo::RecoSetup::ForEachUnit(), fph_hit_xz, fph_hit_yz, fpParameters, fvbUseDet, fvXmax, fvXmin, fvYmax, fvYmin, fvZmax, fvZmin, cbm::RecoSetupManager::GetSetup(), cbm::RecoSetupManager::Instance(), CbmQaIO::MakeQaObject(), CbmQaTask::PutSetupNameOnPad(), and cbm::algo::ca::ToCaDetectorID().

◆ DeInit()

virtual void CbmQaTask::DeInit ( )

inlineprotectedvirtualinherited

De-initialize the task.

Reimplemented in cbm::ca::OutputQa, CbmCaInputQaBase< DetID >, CbmCaInputQaBase< cbm::algo::ca::EDetectorID::kMuch >, CbmCaInputQaBase< cbm::algo::ca::EDetectorID::kMvd >, CbmCaInputQaBase< cbm::algo::ca::EDetectorID::kSts >, CbmCaInputQaBase< cbm::algo::ca::EDetectorID::kTof >, CbmCaInputQaBase< cbm::algo::ca::EDetectorID::kTrd >, CbmCaInputQaMuch, CbmCaInputQaMvd, CbmCaInputQaSts, CbmCaInputQaTof, CbmCaInputQaTrd, and OutputQa.

Definition at line 159 of file CbmQaTask.h.

Referenced by DeInitBase().

◆ DeInitBase()

void CbmQaTask::DeInitBase ( )

privateinherited

De-initializes this task.

Definition at line 129 of file CbmQaTask.cxx.

References DeInit().

Referenced by Init().

◆ DisableEventMode()

void CbmQaTask::DisableEventMode ( )

inherited

Disables event-by-event execution.

By default, if the branch

◆ Exec()

void CbmQaTask::Exec ( Option_t * )

finaloverrideprotectedinherited

FairTask: Defines action of the task in the event/TS.

Definition at line 44 of file CbmQaTask.cxx.

References ExecQa(), fNofEvents, fpBrEvents, and fpCurrentEvent.

◆ ExecQa()

void InputQaSetup::ExecQa ( )

overridevirtual

Fills histograms.

Reimplemented from CbmQaTask.

Definition at line 256 of file CbmCaInputQaSetup.cxx.

References FillHistogramsDet(), fvbUseDet, cbm::algo::ca::kMuch, cbm::algo::ca::kMvd, cbm::algo::ca::kSts, cbm::algo::ca::kTof, and cbm::algo::ca::kTrd.

◆ FillHistogramsDet()

template<cbm::algo::ca::EDetectorID DetID>

void InputQaSetup::FillHistogramsDet ( )

private

Fill histograms for a given detector type.

Definition at line 159 of file CbmCaInputQaSetup.cxx.

References fph_hit_xy, fph_hit_xz, fph_hit_yz, fph_point_xy, fph_point_xz, fph_point_yz, fpMCEventList, fpParameters, fvpBrHits, fvpBrPoints, fvXmax, fvXmin, fvYmax, fvYmin, fvZmax, fvZmin, cbm::algo::RecoSetup::Get(), cbm::RecoSetupManager::GetSetup(), CbmTofAddress::GetSmType(), cbm::RecoSetupManager::Instance(), CbmQaTask::IsMCUsed(), cbm::ca::kDetName, cbm::algo::ca::kTof, and cbm::algo::ca::ToCbmModuleId().

Referenced by ExecQa().

◆ Finish()

void CbmQaTask::Finish ( )

finaloverrideprotectedinherited

FairTask: Defines action of the task in the end of run.

Definition at line 64 of file CbmQaTask.cxx.

References CreateSummary(), fNofEvents, and CbmQaIO::WriteToFile().

◆ GetCheckList()

const std::map< std::string, CheckFlags > & CbmQaTask::GetCheckList ( ) const

inlineinherited

Gets check-list.

Definition at line 113 of file CbmQaTask.h.

References fmCheckList.

◆ GetConfigName()

const char * CbmQaIO::GetConfigName ( ) const

inlineinherited

Gets config name.

Examples: /tmp/builds/computing/cbmroot/core/qa/CbmQaIO.h.

Definition at line 75 of file CbmQaIO.h.

References fsConfigName.

◆ GetCurrentEvent()

CbmEvent * CbmQaTask::GetCurrentEvent ( )

inlineprotectedinherited

Gets pointer to current event.

Definition at line 216 of file CbmQaTask.h.

References fpCurrentEvent.

Referenced by cbm::ca::OutputQa::ExecQa(), and CbmRichRingRecoQa::ExecQa().

◆ GetDefaultTag()

const TString & CbmQaTask::GetDefaultTag ( ) const

inlineinherited

Gets default tag.

Definition at line 116 of file CbmQaTask.h.

References fsDefaultTag.

◆ GetEventNumber()

int CbmQaTask::GetEventNumber ( ) const

inlineprotectedinherited

Get current event number.

Definition at line 183 of file CbmQaTask.h.

References fNofEvents.

Referenced by cbm::ca::OutputQa::Check(), and cbm::ca::OutputQa::DrawEvent().

◆ GetSetupName()

const std::string & CbmQaTask::GetSetupName ( ) const

inlineinherited

Gets name of the setup.

Definition at line 119 of file CbmQaTask.h.

References fsSetupName.

◆ GetVersionTag()

const TString & CbmQaTask::GetVersionTag ( ) const

inlineinherited

Gets version tag.

Definition at line 122 of file CbmQaTask.h.

References fsVersionTag.

◆ Init()

InitStatus CbmQaTask::Init ( )

finaloverrideprotectedinherited

FairTask: Task initialization in the beginning of the run.

Definition at line 88 of file CbmQaTask.cxx.

References DeInitBase(), EventByEvent, fpBrEvents, fRecoMode, and InitQa().

Referenced by ReInit().

◆ InitQa()

InitStatus InputQaSetup::InitQa ( )

overridevirtual

Initializes QA-task.

TEMPORARY

Reimplemented from CbmQaTask.

Definition at line 278 of file CbmCaInputQaSetup.cxx.

References CheckInit(), CheckoutDetectors(), cbm::algo::ca::END, cbm::algo::RecoSetup::ForEachUnit(), fph_hit_xy, fph_hit_xz, fph_hit_yz, fph_point_xy, fph_point_xz, fph_point_yz, fpMCEventHeader, fpMCEventList, fpParameters, fvbUseDet, fvpBrHits, fvpBrPoints, fvXmax, fvXmin, fvYmax, fvYmin, fvZmax, fvZmin, cbm::ca::ParametersHandler::Get(), cbm::RecoSetupManager::GetSetup(), cbm::ca::ParametersHandler::Instance(), cbm::RecoSetupManager::Instance(), CbmQaTask::IsMCUsed(), cbm::ca::kDetName, cbm::algo::ca::kMuch, cbm::algo::ca::kMvd, cbm::algo::ca::kSts, cbm::algo::ca::kTof, cbm::algo::ca::kTrd, CbmQaIO::MakeQaDirectory(), CbmQaIO::MakeQaObject(), and cbm::algo::ca::ToCaDetectorID().

◆ IsMCUsed()

bool CbmQaTask::IsMCUsed ( ) const

inlineinherited

Returns flag, whether MC information is used or not in the task.

Definition at line 126 of file CbmQaTask.h.

References fbUseMC.

Referenced by cbm::ca::OutputQa::Check(), cbm::mvd::CbmMvdMcQaTask::Check(), CbmCaInputQaBase< DetID >::Check(), CbmRichRingRecoQa::Check(), cbm::ca::InputQaSetup::CheckInit(), cbm::ca::OutputQa::CreateFitQaPointSet(), cbm::ca::OutputQa::CreateSummary(), CbmCaInputQaBase< DetID >::CreateSummary(), cbm::ca::OutputQa::DrawEvent(), cbm::ca::OutputQa::DrawSetOf(), cbm::ca::OutputQa::ExecQa(), cbm::mvd::CbmMvdMcQaTask::ExecQa(), CbmCaInputQaBase< DetID >::ExecQa(), CbmRichRingRecoQa::ExecQa(), cbm::ca::InputQaSetup::FillHistogramsDet(), CbmRichRingRecoQa::InitHistograms(), cbm::ca::InputQaSetup::InitQa(), cbm::ca::OutputQa::InitQa(), cbm::mvd::CbmMvdMcQaTask::InitQa(), CbmCaInputQaBase< DetID >::InitQa(), and CbmRichRingRecoQa::InitQa().

◆ MakeQaDirectory()

void CbmQaIO::MakeQaDirectory ( TString sName )

inherited

Examples: /tmp/builds/computing/cbmroot/core/qa/CbmQaIO.h.

Definition at line 132 of file CbmQaIO.cxx.

References fsRootFolderName.

Referenced by cbm::ca::InputQaSetup::InitQa(), and CbmCaInputQaBase< DetID >::InitQa().

◆ MakeQaObject()

template<typename T, typename... Args>

T * CbmQaIO::MakeQaObject	(	TString	sName,
		TString	sTitle,
		Args...	args )

inherited

◆ PutSetupNameOnPad()

void CbmQaTask::PutSetupNameOnPad	(	double	xMin,
		double	yMin,
		double	xMax,
		double	yMax )

protectedinherited

Puts setup title on the canvas.

Definition at line 248 of file CbmQaTask.cxx.

References fsSetupName.

Referenced by cbm::ca::InputQaSetup::CreateSummary().

◆ ReadCheckListFromConfig()

void CbmQaTask::ReadCheckListFromConfig ( )

inherited

Reads check-list from the configuration file.

Definition at line 263 of file CbmQaTask.cxx.

References CbmQaIO::fConfigNode, and fmCheckList.

◆ ReadSpecificConfig()

template<class Config>

std::optional< Config > CbmQaIO::ReadSpecificConfig ( ) const

inlineprotectedinherited

Reads the specific configuration structure from the YAML node.

Template Parameters

Config Type of the configuration class

The function is to be called in the user-defined class method InitDataBranches

Examples: /tmp/builds/computing/cbmroot/core/qa/CbmQaIO.h.

Definition at line 126 of file CbmQaIO.h.

References fConfigNode, and cbm::util::yaml::Read().

Referenced by CbmCaInputQaBase< DetID >::InitQa().

◆ ReInit()

InitStatus CbmQaTask::ReInit ( )

finaloverrideprotectedinherited

FairTask: Task reinitialization.

Definition at line 122 of file CbmQaTask.cxx.

References Init().

◆ SetCanvasProperties()

void CbmQaIO::SetCanvasProperties ( TCanvas * pCanv ) const

protectedvirtualinherited

Applies properties on the canvas created with the MakeQaObject funciton.

Parameters

pCanv Pointer to the canvas

Examples: /tmp/builds/computing/cbmroot/core/qa/CbmQaIO.h.

Definition at line 84 of file CbmQaIO.cxx.

Referenced by ConstructAndRegisterQaObject().

◆ SetCheckFile()

void CbmQaTask::SetCheckFile ( const std::shared_ptr< TFile > & pCheckFile )

inlineinherited

Sets check-file.

Parameters

pCheckFile Shared pointer to the cross-check file

Definition at line 134 of file CbmQaTask.h.

References fpBenchmarkInput.

◆ SetCompareOutput()

void CbmQaTask::SetCompareOutput ( const std::shared_ptr< TFile > & pCompareOutput )

inlineinherited

Sets compare output file.

Parameters

pCompareOutput Shared pointer to the comparison output file

Definition at line 138 of file CbmQaTask.h.

References fpBenchmarkOutput.

◆ SetConfigName()

void CbmQaIO::SetConfigName ( const char * path )

inherited

Creates a ROOT object.

Sets config name

Parameters

name	A path to the config

Examples: /tmp/builds/computing/cbmroot/core/qa/CbmQaIO.h.

Definition at line 95 of file CbmQaIO.cxx.

References fsConfigName.

◆ SetDefaultTag()

void CbmQaTask::SetDefaultTag ( const TString & tag )

inlineinherited

Sets default tag.

Definition at line 144 of file CbmQaTask.h.

References fsDefaultTag.

◆ SetRecoMode()

void CbmQaTask::SetRecoMode ( ECbmRecoMode recoMode )

inlineinherited

Sets data processing (reconstruction) mode.

The reconstruction mode can be either ECbmRecoMode::Timeslice or ECbmRecoMode::EventByEvent. The first variant implies, that the data are processed within entire time-slice (in the event-by-event simulation within the entire event). For the second variant the data are processed within a loop of CbmEvent objects, if the branch of latter is accessible. By default the ECbmRecoMode::Timeslice is used.

Definition at line 152 of file CbmQaTask.h.

References fRecoMode.

◆ SetRootFolderName()

void CbmQaIO::SetRootFolderName ( const TString & path )

inlineinherited

Sets a common root path to the objects in the output file.

Parameters

path	A path to the object

Examples: /tmp/builds/computing/cbmroot/core/qa/CbmQaIO.h.

Definition at line 108 of file CbmQaIO.h.

References fsRootFolderName.

Referenced by CbmQaTask::CbmQaTask().

◆ SetSetupName()

void CbmQaTask::SetSetupName ( const char * setup )

inlineinherited

Sets name of the setup.

Definition at line 155 of file CbmQaTask.h.

References fsSetupName.

◆ SetStoringMode()

void CbmQaIO::SetStoringMode ( EStoringMode mode )

inlineinherited

Set storing mode.

Examples: /tmp/builds/computing/cbmroot/core/qa/CbmQaIO.h.

Definition at line 111 of file CbmQaIO.h.

References fStoringMode.

Referenced by CbmCaInputQaBase< DetID >::CbmCaInputQaBase().

◆ SetTH1Properties()

void CbmQaIO::SetTH1Properties ( TH1 * pHist ) const

protectedvirtualinherited

Applies properties on the histogram created with the MakeQaObject function.

Parameters

pHist Pointer to the histogram

Reimplemented in cbm::ca::TrackTypeQa, and TrackTypeQa.

Examples: /tmp/builds/computing/cbmroot/core/qa/CbmQaIO.h.

Definition at line 36 of file CbmQaIO.cxx.

References cbm::qa::util::GetHistStats().

Referenced by ConstructAndRegisterQaObject().

◆ SetTH2Properties()

void CbmQaIO::SetTH2Properties ( TH2 * pHist ) const

protectedvirtualinherited

Applies properties on the histogram created with the MakeQaObject function.

Parameters

pHist Pointer to the histogram

Examples: /tmp/builds/computing/cbmroot/core/qa/CbmQaIO.h.

Definition at line 50 of file CbmQaIO.cxx.

Referenced by ConstructAndRegisterQaObject().

◆ SetTProfile2DProperties()

void CbmQaIO::SetTProfile2DProperties ( TProfile2D * pHist ) const

protectedvirtualinherited

Applies properties on the profile 2D created with the MakeQaObject function.

Parameters

pHist Pointer to the profile

Examples: /tmp/builds/computing/cbmroot/core/qa/CbmQaIO.h.

Definition at line 67 of file CbmQaIO.cxx.

Referenced by ConstructAndRegisterQaObject().

◆ SetVersionTag()

void CbmQaTask::SetVersionTag ( const TString & tag )

inlineinherited

Sets version tag.

Definition at line 141 of file CbmQaTask.h.

References fsVersionTag.

◆ StoreCheckResult()

void CbmQaTask::StoreCheckResult	(	const std::string &	tag,
		bool	result,
		const std::string &	msg = "" )

protectedinherited

Stores check flag to the check-list.

Parameters

tag	The flag name
result	Check result
msg	Supporting message (optional)

Definition at line 311 of file CbmQaTask.cxx.

References fmCheckList.

Referenced by CbmRichRingRecoQa::Check().

◆ WriteToFile()

void CbmQaIO::WriteToFile ( TFile * pOutFile ) const

protectedinherited

Writes objects into file.

Parameters

pOutFile Pointer to output ROOT file

Examples: /tmp/builds/computing/cbmroot/core/qa/CbmQaIO.h.

Definition at line 116 of file CbmQaIO.cxx.

References fpvObjList.

Referenced by CbmQaTask::Finish().

Member Data Documentation

◆ fbUseMC

bool CbmQaTask::fbUseMC = false

privateinherited

Flag, if MC is used.

Definition at line 240 of file CbmQaTask.h.

Referenced by CbmQaTask(), and IsMCUsed().

◆ fConfigNode

YAML::Node CbmQaIO::fConfigNode {}

protectedinherited

Configuration node.

Definition at line 163 of file CbmQaIO.h.

Referenced by CbmQaTask::CompareQaObjects(), MakeQaObject(), CbmQaTask::ReadCheckListFromConfig(), and ReadSpecificConfig().

◆ fmCheckList

std::map<std::string, CheckFlags> CbmQaTask::fmCheckList

privateinherited

A QA check-list map.

The check list is updated with new entries with the StoreCheckResult(tag, result) function, which is to be called from the Check() function. The result is stored to CheckFlags::fResult field, while the CheckFlags::fStatus stays uninitialized. Than, when the ReadCheckListFromConfig() function is called, the fStatus is updated according to the check list entries in the qa_tasks_config_mcbm.yaml/qa_tasks_config_cbm.yaml. If the fStatus is false (default), the check is ignored in the final verdict making.

Definition at line 251 of file CbmQaTask.h.

Referenced by GetCheckList(), ReadCheckListFromConfig(), and StoreCheckResult().

◆ fNofEvents

TParameter<int> CbmQaTask::fNofEvents {"nEvents", 0}

privateinherited

Number of processed events.

Definition at line 256 of file CbmQaTask.h.

Referenced by Exec(), Finish(), and GetEventNumber().

◆ fpBenchmarkInput

std::shared_ptr<TFile> CbmQaTask::fpBenchmarkInput = nullptr

privateinherited

A file with default ROOT objects used for the cross-check.

Definition at line 261 of file CbmQaTask.h.

Referenced by SetCheckFile().

◆ fpBenchmarkOutput

std::shared_ptr<TFile> CbmQaTask::fpBenchmarkOutput = nullptr

privateinherited

An output file for histograms cross-check.

Definition at line 262 of file CbmQaTask.h.

Referenced by CompareTwoObjects(), and SetCompareOutput().

◆ fpBrEvents

TClonesArray* CbmQaTask::fpBrEvents = nullptr

privateinherited

Pointer to CbmEvent branch.

Definition at line 253 of file CbmQaTask.h.

Referenced by Exec(), and Init().

◆ fpCurrentEvent

CbmEvent* CbmQaTask::fpCurrentEvent = nullptr

privateinherited

Pointer to the current event.

Definition at line 254 of file CbmQaTask.h.

Referenced by Exec(), and GetCurrentEvent().

◆ fph_hit_xy

std::vector<TH2F*> cbm::ca::InputQaSetup::fph_hit_xy = {}

private

Hit occupancy in x-y plane vs. station.

Definition at line 91 of file CbmCaInputQaSetup.h.

Referenced by FillHistogramsDet(), and InitQa().

◆ fph_hit_xz

std::vector<TH2F*> cbm::ca::InputQaSetup::fph_hit_xz = {}

private

Hit occupancy in x-z plane vs. station.

Definition at line 92 of file CbmCaInputQaSetup.h.

Referenced by CreateSummary(), FillHistogramsDet(), and InitQa().

◆ fph_hit_yz

std::vector<TH2F*> cbm::ca::InputQaSetup::fph_hit_yz = {}

private

Hit occupancy in y-z plane vs. station.

Definition at line 93 of file CbmCaInputQaSetup.h.

Referenced by CreateSummary(), FillHistogramsDet(), and InitQa().

◆ fph_point_xy

std::vector<TH2F*> cbm::ca::InputQaSetup::fph_point_xy = {}

private

MC point occupancy in x-z plane vs. station.

Definition at line 94 of file CbmCaInputQaSetup.h.

Referenced by FillHistogramsDet(), and InitQa().

◆ fph_point_xz

std::vector<TH2F*> cbm::ca::InputQaSetup::fph_point_xz = {}

private

MC point occupancy in x-z plane vs. station.

Definition at line 95 of file CbmCaInputQaSetup.h.

Referenced by FillHistogramsDet(), and InitQa().

◆ fph_point_yz

std::vector<TH2F*> cbm::ca::InputQaSetup::fph_point_yz = {}

private

MC point occupancy in y-z plane vs. station.

Definition at line 96 of file CbmCaInputQaSetup.h.

Referenced by FillHistogramsDet(), and InitQa().

◆ fpMCEventHeader

CbmMCDataObject* cbm::ca::InputQaSetup::fpMCEventHeader = nullptr

private

Pointer to MC event header.

Definition at line 75 of file CbmCaInputQaSetup.h.

Referenced by CheckInit(), and InitQa().

◆ fpMCEventList

CbmMCEventList* cbm::ca::InputQaSetup::fpMCEventList = nullptr

private

Pointer to MC event list.

Definition at line 76 of file CbmCaInputQaSetup.h.

Referenced by FillHistogramsDet(), and InitQa().

◆ fpParameters

std::shared_ptr<const ca::Parameters<double> > cbm::ca::InputQaSetup::fpParameters = nullptr

private

Pointer to CA parameters object.

Definition at line 77 of file CbmCaInputQaSetup.h.

Referenced by CreateSummary(), FillHistogramsDet(), and InitQa().

◆ fpvObjList

std::shared_ptr<ObjList_t> CbmQaIO::fpvObjList = nullptr

protectedinherited

List of registered ROOT objects.

Definition at line 161 of file CbmQaIO.h.

Referenced by CbmQaIO(), ConstructAndRegisterQaObject(), cbm::ca::TrackTypeQa::Init(), cbm::ca::OutputQa::InitQa(), and WriteToFile().

◆ fRecoMode

ECbmRecoMode CbmQaTask::fRecoMode = ECbmRecoMode::Timeslice

privateinherited

Reconstruction mode.

Definition at line 242 of file CbmQaTask.h.

Referenced by CbmQaTask(), Init(), and SetRecoMode().

◆ fsConfigName

TString CbmQaIO::fsConfigName = ""

protectedinherited

Name of configuration file.

Examples: /tmp/builds/computing/cbmroot/core/qa/CbmQaIO.h.

Definition at line 157 of file CbmQaIO.h.

Referenced by GetConfigName(), and SetConfigName().

◆ fsDefaultTag

TString CbmQaTask::fsDefaultTag = ""

privateinherited

Default tag (git SHA etc.)

Definition at line 259 of file CbmQaTask.h.

Referenced by CompareTwoObjects(), GetDefaultTag(), and SetDefaultTag().

◆ fsParametersFilename

std::string cbm::ca::InputQaSetup::fsParametersFilename = ""

private

Filename for the tracking parameters.

Definition at line 78 of file CbmCaInputQaSetup.h.

◆ fsPrefix

TString CbmQaIO::fsPrefix = ""

protectedinherited

Unique prefix for all writeable root.

Definition at line 158 of file CbmQaIO.h.

Referenced by CbmQaIO(), cbm::ca::TrackFitQa::CreatePullPlot(), cbm::ca::TrackTypeQa::Init(), and cbm::ca::OutputQa::InitQa().

◆ fsRootFolderName

TString CbmQaIO::fsRootFolderName = ""

protectedinherited

Name of root folder.

Definition at line 156 of file CbmQaIO.h.

Referenced by ConstructAndRegisterQaObject(), cbm::ca::TrackTypeQa::Init(), cbm::ca::OutputQa::InitQa(), MakeQaDirectory(), and SetRootFolderName().

◆ fsSetupName

std::string CbmQaTask::fsSetupName = ""

privateinherited

Name of the setup (to draw on the canvases)

Definition at line 255 of file CbmQaTask.h.

Referenced by GetSetupName(), PutSetupNameOnPad(), and SetSetupName().

◆ fStoringMode

EStoringMode CbmQaIO::fStoringMode = EStoringMode::kSUBDIR

protectedinherited

Objects storing mode.

Definition at line 160 of file CbmQaIO.h.

Referenced by CbmQaTask::CbmQaTask(), ConstructAndRegisterQaObject(), SetStoringMode(), cbm::ca::TrackFitQa::TrackFitQa(), and cbm::ca::TrackTypeQa::TrackTypeQa().

◆ fsVersionTag

TString CbmQaTask::fsVersionTag = ""

privateinherited

Version tag (git SHA etc.)

Definition at line 258 of file CbmQaTask.h.

Referenced by CompareTwoObjects(), GetVersionTag(), and SetVersionTag().

◆ fvbUseDet

DetIdArr_t<bool> cbm::ca::InputQaSetup::fvbUseDet = {{false}}

private

Detector subsystem usage flag.

Definition at line 71 of file CbmCaInputQaSetup.h.

Referenced by CheckInit(), CheckoutDetectors(), CreateSummary(), ExecQa(), and InitQa().

◆ fvpBrHits

DetIdArr_t<TClonesArray*> cbm::ca::InputQaSetup::fvpBrHits = {{nullptr}}

private

Input branch for hits.

Definition at line 72 of file CbmCaInputQaSetup.h.

Referenced by CheckInit(), FillHistogramsDet(), and InitQa().

◆ fvpBrPoints

DetIdArr_t<CbmMCDataArray*> cbm::ca::InputQaSetup::fvpBrPoints = {{nullptr}}

private

Input branch for MC points.

Definition at line 73 of file CbmCaInputQaSetup.h.

Referenced by CheckInit(), FillHistogramsDet(), and InitQa().

◆ fvXmax

DetIdArr_t<std::vector<double> > cbm::ca::InputQaSetup::fvXmax

private

Definition at line 81 of file CbmCaInputQaSetup.h.

Referenced by CreateSummary(), FillHistogramsDet(), and InitQa().

◆ fvXmin

DetIdArr_t<std::vector<double> > cbm::ca::InputQaSetup::fvXmin

private

Definition at line 80 of file CbmCaInputQaSetup.h.

Referenced by CreateSummary(), FillHistogramsDet(), and InitQa().

◆ fvYmax

DetIdArr_t<std::vector<double> > cbm::ca::InputQaSetup::fvYmax

private

Definition at line 83 of file CbmCaInputQaSetup.h.

Referenced by CreateSummary(), FillHistogramsDet(), and InitQa().

◆ fvYmin

DetIdArr_t<std::vector<double> > cbm::ca::InputQaSetup::fvYmin

private

Definition at line 82 of file CbmCaInputQaSetup.h.

Referenced by CreateSummary(), FillHistogramsDet(), and InitQa().

◆ fvZmax

DetIdArr_t<std::vector<double> > cbm::ca::InputQaSetup::fvZmax

private

Definition at line 85 of file CbmCaInputQaSetup.h.

Referenced by CreateSummary(), FillHistogramsDet(), and InitQa().

◆ fvZmin

DetIdArr_t<std::vector<double> > cbm::ca::InputQaSetup::fvZmin

private

Definition at line 84 of file CbmCaInputQaSetup.h.

Referenced by CreateSummary(), FillHistogramsDet(), and InitQa().

The documentation for this class was generated from the following files:

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

◆ ObjList_t

Member Enumeration Documentation

◆ EStoringMode

Constructor & Destructor Documentation

◆ InputQaSetup()

Member Function Documentation

◆ Check()

◆ CheckInit()

◆ CheckoutDetectors()

◆ CheckProperty()

◆ CheckRange() [1/3]

◆ CheckRange() [2/3]

◆ CheckRange() [3/3]

◆ ClassDefOverride()

◆ CompareQaObjects()

◆ CompareTwoObjects()

◆ ConstructAndRegisterQaObject()

◆ CreateSummary()

◆ DeInit()

◆ DeInitBase()

◆ DisableEventMode()

◆ Exec()

◆ ExecQa()

◆ FillHistogramsDet()

◆ Finish()

◆ GetCheckList()

◆ GetConfigName()

◆ GetCurrentEvent()

◆ GetDefaultTag()

◆ GetEventNumber()

◆ GetSetupName()

◆ GetVersionTag()

◆ Init()

◆ InitQa()

◆ IsMCUsed()

◆ MakeQaDirectory()

◆ MakeQaObject()

◆ PutSetupNameOnPad()

◆ ReadCheckListFromConfig()

◆ ReadSpecificConfig()

◆ ReInit()

◆ SetCanvasProperties()

◆ SetCheckFile()

◆ SetCompareOutput()

◆ SetConfigName()

◆ SetDefaultTag()

◆ SetRecoMode()

◆ SetRootFolderName()

◆ SetSetupName()

◆ SetStoringMode()

◆ SetTH1Properties()

◆ SetTH2Properties()

◆ SetTProfile2DProperties()

◆ SetVersionTag()

◆ StoreCheckResult()

◆ WriteToFile()

Member Data Documentation

◆ fbUseMC

◆ fConfigNode

◆ fmCheckList

◆ fNofEvents

◆ fpBenchmarkInput

◆ fpBenchmarkOutput

◆ fpBrEvents

◆ fpCurrentEvent

◆ fph_hit_xy

◆ fph_hit_xz

◆ fph_hit_yz

◆ fph_point_xy

◆ fph_point_xz

◆ fph_point_yz

◆ fpMCEventHeader