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	ReadParameters (const char *filename)
	Reads defined parameters object from file.

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	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< const CbmTrackingDetectorInterfaceBase * >	fvpDetInterface = {{nullptr}}
	Pointers to the tracking detector interfaces for each subsystem.

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< ca::Parameters< float > >	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 41 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 46 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 48 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 26 of file CbmCaInputQaSetup.cxx.

Member Function Documentation

◆ Check()

void InputQaSetup::Check ( )

overridevirtual

Checks results of the QA and returns a success flag.

Implements CbmQaTask.

Definition at line 30 of file CbmCaInputQaSetup.cxx.

◆ CheckInit()

void InputQaSetup::CheckInit ( ) const

private

Checks branches initialization.

Definition at line 35 of file CbmCaInputQaSetup.cxx.

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

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 178 of file CbmQaIO.h.

Referenced by CbmQaIO::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 CbmQaTask::CheckRange().

Referenced by CbmQaTask::CheckRange(), and CbmQaTask::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 CbmQaTask::CheckRange().

◆ ClassDefOverride()

CbmQaTask::ClassDefOverride	(	CbmQaTask	,
		0	)

privateinherited

◆ 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 CbmQaTask::CompareTwoObjects(), CbmQaTask::ObjectComparisonConfig::fCanvOpt, CbmQaTask::ObjectComparisonConfig::fChi2NdfMax, CbmQaIO::fConfigNode, CbmQaTask::fpBenchmarkInput, CbmQaTask::ObjectComparisonConfig::fPoint, CbmQaIO::fpvObjList, CbmQaTask::ObjectComparisonConfig::fRatio, CbmQaTask::ObjectComparisonConfig::fRatioMax, CbmQaTask::ObjectComparisonConfig::fRatioMin, CbmQaIO::fsRootFolderName, and CbmQaTask::ObjectComparisonConfig::fStat.

◆ 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, CbmQaTask::fpBenchmarkOutput, CbmQaTask::ObjectComparisonConfig::fPoint, CbmQaTask::ObjectComparisonConfig::fRatio, CbmQaTask::ObjectComparisonConfig::fRatioMax, CbmQaTask::ObjectComparisonConfig::fRatioMin, CbmQaTask::fsDefaultTag, CbmQaTask::ObjectComparisonConfig::fStat, CbmQaTask::ObjectComparisonConfig::fStatOpt, and CbmQaTask::fsVersionTag.

Referenced by CbmQaTask::CompareQaObjects().

◆ 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 198 of file CbmQaIO.h.

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

Referenced by CbmQaIO::MakeQaObject().

◆ CreateSummary()

void InputQaSetup::CreateSummary ( )

overridevirtual

Creates summary cavases, tables etc.

Reimplemented from CbmQaTask.

Definition at line 54 of file CbmCaInputQaSetup.cxx.

References fph_hit_xz, fph_hit_yz, fpParameters, fvbUseDet, fvpDetInterface, fvXmax, fvXmin, fvYmax, fvYmin, fvZmax, fvZmin, CbmQaIO::MakeQaObject(), and CbmQaTask::PutSetupNameOnPad().

◆ 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, and CbmCaInputQaTrd.

Definition at line 159 of file CbmQaTask.h.

Referenced by CbmQaTask::DeInitBase().

◆ DeInitBase()

void CbmQaTask::DeInitBase ( )

privateinherited

De-initializes this task.

Definition at line 129 of file CbmQaTask.cxx.

References CbmQaTask::DeInit().

Referenced by CbmQaTask::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 CbmQaTask::ExecQa(), CbmQaTask::fNofEvents, CbmQaTask::fpBrEvents, and CbmQaTask::fpCurrentEvent.

◆ ExecQa()

void InputQaSetup::ExecQa ( )

overridevirtual

Fills histograms.

Reimplemented from CbmQaTask.

Definition at line 230 of file CbmCaInputQaSetup.cxx.

References FillHistogramsDet(), and fvbUseDet.

◆ FillHistogramsDet()

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

void InputQaSetup::FillHistogramsDet ( )

private

Fill histograms for a given detector type.

Definition at line 134 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, fvpDetInterface, fvXmax, fvXmin, fvYmax, fvYmin, fvZmax, fvZmin, CbmMCEventList::GetEventIdByIndex(), CbmMCEventList::GetFileIdByIndex(), CbmMCEventList::GetNofEvents(), CbmTofAddress::GetSmType(), CbmQaTask::IsMCUsed(), and cbm::ca::kDetName.

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 CbmQaTask::CreateSummary(), CbmQaTask::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 CbmQaTask::fmCheckList.

◆ GetConfigName()

const char * CbmQaIO::GetConfigName ( ) const

inlineinherited

Gets config name.

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

Definition at line 76 of file CbmQaIO.h.

References CbmQaIO::fsConfigName.

◆ GetCurrentEvent()

CbmEvent * CbmQaTask::GetCurrentEvent ( )

inlineprotectedinherited

Gets pointer to current event.

Definition at line 216 of file CbmQaTask.h.

References CbmQaTask::fpCurrentEvent.

Referenced by cbm::ca::OutputQa::ExecQa().

◆ GetDefaultTag()

const TString & CbmQaTask::GetDefaultTag ( ) const

inlineinherited

Gets default tag.

Definition at line 116 of file CbmQaTask.h.

References CbmQaTask::fsDefaultTag.

◆ GetEventNumber()

int CbmQaTask::GetEventNumber ( ) const

inlineprotectedinherited

Get current event number.

Definition at line 183 of file CbmQaTask.h.

References CbmQaTask::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 CbmQaTask::fsSetupName.

◆ GetVersionTag()

const TString & CbmQaTask::GetVersionTag ( ) const

inlineinherited

Gets version tag.

Definition at line 122 of file CbmQaTask.h.

References CbmQaTask::fsVersionTag.

◆ Init()

InitStatus CbmQaTask::Init ( )

finaloverrideprotectedinherited

FairTask: Task initialization in the beginning of the run.

Definition at line 88 of file CbmQaTask.cxx.

References CbmQaTask::DeInitBase(), EventByEvent, CbmQaTask::fNofEvents, CbmQaTask::fpBrEvents, CbmQaTask::fRecoMode, CbmQaTask::InitQa(), and Timeslice.

Referenced by CbmQaTask::ReInit().

◆ InitQa()

InitStatus InputQaSetup::InitQa ( )

overridevirtual

Initializes QA-task.

TEMPORARY

Reimplemented from CbmQaTask.

Definition at line 252 of file CbmCaInputQaSetup.cxx.

References CheckInit(), fph_hit_xy, fph_hit_xz, fph_hit_yz, fph_point_xy, fph_point_xz, fph_point_yz, fpMCEventHeader, fpMCEventList, fpParameters, fsParametersFilename, fvbUseDet, fvpBrHits, fvpBrPoints, fvpDetInterface, fvXmax, fvXmin, fvYmax, fvYmin, fvZmax, fvZmin, cbm::ca::ParametersHandler::Get(), CbmTrackingDetectorInterfaceBase::GetNtrackingStations(), cbm::ca::ParametersHandler::Instance(), CbmMuchTrackingInterface::Instance(), CbmMvdTrackingInterface::Instance(), CbmStsTrackingInterface::Instance(), CbmTofTrackingInterface::Instance(), CbmTrdTrackingInterface::Instance(), CbmQaTask::IsMCUsed(), cbm::ca::kDetName, CbmQaIO::MakeQaDirectory(), and CbmQaIO::MakeQaObject().

◆ 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 CbmQaTask::fbUseMC.

Referenced by cbm::ca::OutputQa::Check(), CbmCaInputQaSts::Check(), CheckInit(), cbm::ca::OutputQa::CreateSummary(), CbmCaInputQaSts::CreateSummary(), cbm::ca::OutputQa::DrawEvent(), cbm::ca::OutputQa::DrawSetOf(), cbm::ca::OutputQa::ExecQa(), CbmCaInputQaTof::ExecQa(), FillHistogramsDet(), CbmCaInputQaSts::FillHistogramsPerHit(), InitQa(), cbm::ca::OutputQa::InitQa(), and CbmCaInputQaSts::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 CbmQaIO::fpvObjList, and CbmQaIO::fsRootFolderName.

Referenced by InitQa(), and CbmCaInputQaTof::InitQa().

◆ MakeQaObject()

template<typename T , typename... Args>

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

inherited

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

Definition at line 261 of file CbmQaIO.h.

References CbmQaIO::CheckProperty(), CbmQaIO::ConstructAndRegisterQaObject(), and CbmQaIO::fConfigNode.

Referenced by cbm::ca::OutputQa::Check(), cbm::ca::TrackFitQa::CreatePullPlot(), cbm::ca::TrackFitQa::CreateResidualPlot(), CreateSummary(), cbm::ca::OutputQa::CreateSummary(), CbmCaInputQaSts::CreateSummary(), cbm::ca::OutputQa::DrawEvent(), cbm::ca::TrackFitQa::Init(), cbm::ca::TrackTypeQa::Init(), InitQa(), CbmCaInputQaSts::InitQa(), and CbmCaInputQaTof::InitQa().

◆ 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 CbmQaTask::fsSetupName.

Referenced by 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 CbmQaTask::fmCheckList.

◆ ReadParameters()

void cbm::ca::InputQaSetup::ReadParameters ( const char * filename )

inline

Reads defined parameters object from file.

Parameters

filename Name of parameter file

Note: TEMPORARY FUNCTION, A SEPARATE PARAMETERS INITIALIZATION CLASS IS TO BE USED

Definition at line 51 of file CbmCaInputQaSetup.h.

References fsParametersFilename.

◆ 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 127 of file CbmQaIO.h.

References CbmQaIO::fConfigNode, and cbm::algo::yaml::Read().

◆ ReInit()

InitStatus CbmQaTask::ReInit ( )

finaloverrideprotectedinherited

FairTask: Task reinitialization.

Definition at line 122 of file CbmQaTask.cxx.

References CbmQaTask::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 CbmQaIO::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 CbmQaTask::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 CbmQaTask::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 CbmQaIO::fConfigNode, CbmQaIO::fsConfigName, and CbmQaIO::fsPrefix.

◆ SetDefaultTag()

void CbmQaTask::SetDefaultTag ( const TString & tag )

inlineinherited

Sets default tag.

Definition at line 144 of file CbmQaTask.h.

References CbmQaTask::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 CbmQaTask::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 109 of file CbmQaIO.h.

References CbmQaIO::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 CbmQaTask::fsSetupName.

◆ SetStoringMode()

void CbmQaIO::SetStoringMode ( EStoringMode mode )

inlineinherited

Set storing mode.

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

Definition at line 112 of file CbmQaIO.h.

References CbmQaIO::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.

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

Definition at line 36 of file CbmQaIO.cxx.

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

Referenced by CbmQaIO::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 CbmQaIO::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 CbmQaIO::ConstructAndRegisterQaObject().

◆ SetVersionTag()

void CbmQaTask::SetVersionTag ( const TString & tag )

inlineinherited

Sets version tag.

Definition at line 141 of file CbmQaTask.h.

References CbmQaTask::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 CbmQaTask::fmCheckList.

Referenced by CbmCaInputQaSts::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 CbmQaIO::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::IsMCUsed().

◆ fConfigNode

YAML::Node CbmQaIO::fConfigNode {}

protectedinherited

Configuration node.

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

Definition at line 164 of file CbmQaIO.h.

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

◆ 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 CbmQaTask::GetCheckList(), CbmQaTask::ReadCheckListFromConfig(), and CbmQaTask::StoreCheckResult().

◆ fNofEvents

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

privateinherited

Number of processed events.

Definition at line 256 of file CbmQaTask.h.

Referenced by CbmQaTask::Exec(), CbmQaTask::Finish(), CbmQaTask::GetEventNumber(), and CbmQaTask::Init().

◆ 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 CbmQaTask::CompareQaObjects(), and CbmQaTask::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 CbmQaTask::CompareTwoObjects(), and CbmQaTask::SetCompareOutput().

◆ fpBrEvents

TClonesArray* CbmQaTask::fpBrEvents = nullptr

privateinherited

Pointer to CbmEvent branch.

Definition at line 253 of file CbmQaTask.h.

Referenced by CbmQaTask::Exec(), and CbmQaTask::Init().

◆ fpCurrentEvent

CbmEvent* CbmQaTask::fpCurrentEvent = nullptr

privateinherited

Pointer to the current event.

Definition at line 254 of file CbmQaTask.h.

Referenced by CbmQaTask::Exec(), and CbmQaTask::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 101 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 102 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 103 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 104 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 105 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 106 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 85 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 86 of file CbmCaInputQaSetup.h.

Referenced by FillHistogramsDet(), and InitQa().

◆ fpParameters

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

private

Pointer to CA parameters object.

Definition at line 87 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.

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

Definition at line 162 of file CbmQaIO.h.

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

◆ fRecoMode

ECbmRecoMode CbmQaTask::fRecoMode = ECbmRecoMode::Timeslice

privateinherited

Reconstruction mode.

Definition at line 242 of file CbmQaTask.h.

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

◆ fsConfigName

TString CbmQaIO::fsConfigName = ""

protectedinherited

Name of configuration file.

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

Definition at line 158 of file CbmQaIO.h.

Referenced by CbmQaIO::GetConfigName(), and CbmQaIO::SetConfigName().

◆ fsDefaultTag

TString CbmQaTask::fsDefaultTag = ""

privateinherited

Default tag (git SHA etc.)

Definition at line 259 of file CbmQaTask.h.

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

◆ fsParametersFilename

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

private

Filename for the tracking parameters.

Definition at line 88 of file CbmCaInputQaSetup.h.

Referenced by InitQa(), and ReadParameters().

◆ fsPrefix

TString CbmQaIO::fsPrefix = ""

protectedinherited

Unique prefix for all writeable root.

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

Definition at line 159 of file CbmQaIO.h.

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

◆ fsRootFolderName

TString CbmQaIO::fsRootFolderName = ""

protectedinherited

Name of root folder.

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

Definition at line 157 of file CbmQaIO.h.

Referenced by CbmQaTask::CompareQaObjects(), CbmQaIO::ConstructAndRegisterQaObject(), cbm::ca::TrackTypeQa::Init(), cbm::ca::OutputQa::InitQa(), CbmQaIO::MakeQaDirectory(), and CbmQaIO::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 CbmQaTask::GetSetupName(), CbmQaTask::PutSetupNameOnPad(), and CbmQaTask::SetSetupName().

◆ fStoringMode

EStoringMode CbmQaIO::fStoringMode = EStoringMode::kSUBDIR

protectedinherited

Objects storing mode.

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

Definition at line 161 of file CbmQaIO.h.

Referenced by CbmQaTask::CbmQaTask(), CbmQaIO::ConstructAndRegisterQaObject(), CbmQaIO::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 CbmQaTask::CompareTwoObjects(), CbmQaTask::GetVersionTag(), and CbmQaTask::SetVersionTag().

◆ fvbUseDet

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

private

Detector subsystem usage flag.

Definition at line 81 of file CbmCaInputQaSetup.h.

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

◆ fvpBrHits

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

private

Input branch for hits.

Definition at line 82 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 83 of file CbmCaInputQaSetup.h.

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

◆ fvpDetInterface

DetIdArr_t<const CbmTrackingDetectorInterfaceBase*> cbm::ca::InputQaSetup::fvpDetInterface = {{nullptr}}

private

Pointers to the tracking detector interfaces for each subsystem.

Definition at line 79 of file CbmCaInputQaSetup.h.

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

◆ fvXmax

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

private

Definition at line 91 of file CbmCaInputQaSetup.h.

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

◆ fvXmin

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

private

Definition at line 90 of file CbmCaInputQaSetup.h.

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

◆ fvYmax

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

private

Definition at line 93 of file CbmCaInputQaSetup.h.

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

◆ fvYmin

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

private

Definition at line 92 of file CbmCaInputQaSetup.h.

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

◆ fvZmax

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

private

Definition at line 95 of file CbmCaInputQaSetup.h.

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

◆ fvZmin

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

private

Definition at line 94 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()

◆ 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()

◆ ReadParameters()

◆ 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