Inheritance diagram for PXDOccupancyInfoChecker:

Public Member Functions
	__init__ (self, name, tfile, rundir="")

	define_graphs (self)

	get_db_content (self)

	get_graph_value (self, sensor_db_content)

	draw_plots (self, canvas=None, **kwargs)

	objType (self)

	run (self)

	exp (self)

	beginRun (self)

	define_hists (self, name=None, title=None, ztitle=None, **kwargs)

	get_graph_value_from_hist (self, h2=None)

	set_hist_content (self, h2, sensor_db_content)

	fill_plots (self)

	save_canvas (self, canvas, cname, logy=False)

Public Attributes
	name = name
	DBObj name.

	dbObj = Belle2.PyDBObj(self.name, self.objType.Class())
	DBObjPtr for the condition.

	eventMetaData = Belle2.PyStoreObj("EventMetaData")
	pointer to the event metadata

	tfile = tfile
	TFile for saving plots.

	rundir = rundir
	Directory for writing histograms of each run.

dict	graphs = {}
	Dictionary of plots (TGraph) summarizing variables vs run.

dict	hists = {}
	Dictionary of plots (TH1) to be saved for each run.

str	hist_title_suffix = ""
	Hist title suffix.

int	runstart = 999999
	The 1st run.

int	runend = -1
	The last run.

int	expstart = 999999
	The 1st exp.

	use_hist = use_hist
	Flag to get TGraph values from a histogram (TH2F)

Protected Attributes
	_objType = objType
	DBObj type.

Detailed Description

Checker for PXDOccupancyInfoPar

Definition at line 277 of file condition_checker.py.

Constructor & Destructor Documentation

◆ init()

__init__	(	self,
		name,
		tfile,
		rundir = "" )

Definition at line 282 of file condition_checker.py.

    def __init__(self, name, tfile, rundir=""):
        """
        """
        super().__init__(name, Belle2.PXDOccupancyInfoPar, tfile, "")
 

Member Function Documentation

◆ beginRun()

beginRun ( self )

inherited

Call functions at beginning of a run

Definition at line 109 of file condition_checker.py.

    def beginRun(self):
        """
        Call functions at beginning of a run
        """
        self.define_hists()
        self.fill_plots()
 

◆ define_graphs()

define_graphs ( self )

Method to define TGraph

Reimplemented from ConditionCheckerBase.

Definition at line 287 of file condition_checker.py.

    def define_graphs(self):
        """
        Method to define TGraph
        """
        super().define_graphs(ytitle="Occupancy (With Mask) [%]")
 

◆ define_hists()

define_hists	(		self,
			name = None,
			title = None,
			ztitle = None,
		**	kwargs )

inherited

Method to define TH2
Parameters:
  name (str): name for TH2, to which sensor name will be attached
  title (str): title for TH2
  ztitle (str): title for z-axis (color bar)
  kwargs: additional arguments

Reimplemented in PXDDeadPixelsChecker, PXDGainMapChecker, and PXDMaskedPixelsChecker.

Definition at line 125 of file condition_checker.py.

    def define_hists(self, name=None, title=None, ztitle=None, **kwargs):
        """
        Method to define TH2
        Parameters:
          name (str): name for TH2, to which sensor name will be attached
          title (str): title for TH2
          ztitle (str): title for z-axis (color bar)
          kwargs: additional arguments
        """
        if self.rundir:
            self.tfile.cd(self.rundir)
            # \cond false positive doxygen warning
            self.hists.update(get_sensor_maps(name, title, ztitle, self.run, **kwargs))
            # \endcond
 

◆ draw_plots()

draw_plots	(		self,
			canvas = None,
		**	kwargs )

Method to draw plots on a TCanvas

Reimplemented from ConditionCheckerBase.

Definition at line 306 of file condition_checker.py.

    def draw_plots(self, canvas=None, **kwargs):
        """
        Method to draw plots on a TCanvas
        """
        # We don't use raw occupanncy. They will be corrected after takig out dead pixels
        pass
        # super().draw_plots(canvas=canvas, cname="OccupancyWithMask", ymin=0., ymax=plot_type_dict["occ_masked"]["max"])
 
 

◆ exp()

exp ( self )

inherited

Experiment number

Definition at line 103 of file condition_checker.py.

    def exp(self):
        """
        Experiment number
        """
        return self.eventMetaData.getExperiment()
 

◆ fill_plots()

fill_plots ( self )

inherited

Method to fill plot objects

Definition at line 172 of file condition_checker.py.

    def fill_plots(self):
        """
        Method to fill plot objects
        """
        if self.exp < self.expstart:
            self.expstart = self.exp
        if self.run < self.runstart:
            self.runstart = self.run
        if self.run > self.runend:
            self.runend = self.run
 
        db_content = self.get_db_content()
        values_dict = {}
        pre_values_dict = {}
        for sensorID in sensorID_list:
            sensor_db_content = db_content[sensorID.getID()]
            if self.graphs:
                if not self.use_hist:
                    values_dict[sensorID.getID()] = self.get_graph_value(sensor_db_content)
                gr = self.graphs[sensorID.getID()]
                pre_values_dict[sensorID.getID()] = gr.GetPointY(gr.GetN() - 1)
            # Saving graph points only for different values (sensor-wise)
                # value = self.get_graph_value(sensor_db_content)
                # pre_value = gr.GetPointY(gr.GetN()-1)
                # if value != pre_value:
                #     gr.SetPoint(gr.GetN(), self.run, value)
            # Saving masked map
            if self.rundir != "" and self.hists:
                h2 = self.hists[sensorID.getID()]
                self.set_hist_content(h2, sensor_db_content)
                # Update title with total count
                h2.SetTitle(h2.GetTitle() + self.hist_title_suffix)
                self.tfile.cd(self.rundir)
                h2.Write()
                if self.use_hist:
                    values_dict[sensorID.getID()] = self.get_graph_value_from_hist(h2)
        # Saving graph points only for different conditions
        if values_dict != pre_values_dict:
            for sensorID in sensorID_list:
                gr = self.graphs[sensorID.getID()]
                # \cond false positive doxygen warning
                gr.SetPoint(gr.GetN(), self.run, values_dict[sensorID.getID()])
                # \endcond
 

◆ get_db_content()

get_db_content ( self )

Abstract method to get content of a payload
Should return a Dictionary with sensorID.getID() as key and relaated calibration results as value

Reimplemented from ConditionCheckerBase.

Definition at line 293 of file condition_checker.py.

    def get_db_content(self):
        content_dic = {}
        for sensorID in sensorID_list:
            numID = sensorID.getID()
            raw_occ = self.dbObj.getOccupancy(numID)
            # The default value is -1. It seems 0 will not be updated into the payload.
            content_dic[numID] = raw_occ if raw_occ >= 0 else 0
 
        return content_dic
 

◆ get_graph_value()

get_graph_value	(		self,
			sensor_db_content )

Abstract method to get a value for each TGraph
Parameters:
  sensor_db_content (Any): Calibration results of a module

Reimplemented from ConditionCheckerBase.

Definition at line 303 of file condition_checker.py.

    def get_graph_value(self, sensor_db_content):
        return sensor_db_content * 100
 

◆ get_graph_value_from_hist()

get_graph_value_from_hist	(		self,
			h2 = None )

inherited

Method to get a value for each TGraph
Parameters:
  h2 (TH2): If not none, get value from h2

Reimplemented in PXDDeadPixelsChecker.

Definition at line 155 of file condition_checker.py.

    def get_graph_value_from_hist(self, h2=None):
        """
        Method to get a value for each TGraph
        Parameters:
          h2 (TH2): If not none, get value from h2
        """
        return None
 

◆ objType()

objType ( self )

inherited

DBObj type (read only)

Definition at line 89 of file condition_checker.py.

    def objType(self):
        """
        DBObj type (read only)
        """
        return self._objType
 

◆ run()

run ( self )

inherited

Run number

Definition at line 96 of file condition_checker.py.

    def run(self):
        """
        Run number
        """
        return self.eventMetaData.getRun()
 

◆ save_canvas()

save_canvas	(	self,
		canvas,
		cname,
		logy = False )

inherited

Save TCanvas to png/pdf format and do not write it to the ROOT file by default
Parameters:
  canvas (TCanvas): ROOT TCanvas for plotting
  canme (str): Name of the canvas
  logy (bool): Flag to use log scale for y-axis

Definition at line 250 of file condition_checker.py.

    def save_canvas(self, canvas, cname, logy=False):
        """
        Save TCanvas to png/pdf format and do not write it to the ROOT file by default
        Parameters:
          canvas (TCanvas): ROOT TCanvas for plotting
          canme (str): Name of the canvas
          logy (bool): Flag to use log scale for y-axis
        """
        if cname:
            canvas.SetName(cname)
        exp_run = f"e{self.expstart:05}_r{self.runstart:04}-{self.runend:04}"
        # Draw Belle II label
        latex_r.DrawLatex(0.95, 0.92, "Belle II Experiment: " + exp_run.replace("_", " "))
        # Print and write TCanvas
        if logy:
            canvas.SetLogy(1)
            canvas.Update()
            canvas.Modified()
            canvas.Print(f"{exp_run}_{cname}_vs_run_logy.png")
            canvas.Print(f"{exp_run}_{cname}_vs_run_logy.pdf")
        else:
            canvas.SetLogy(0)
            canvas.Print(f"{exp_run}_{cname}_vs_run.png")
            canvas.Print(f"{exp_run}_{cname}_vs_run.pdf")
        self.tfile.cd()
 
 

◆ set_hist_content()

set_hist_content	(	self,
		h2,
		sensor_db_content )

inherited

Method to set TH2 bins
Parameters:
  h2 (TH2): TH2F object for handling values of a pixel matrix
  sensor_db_content (Any): Calibration results of a module

Reimplemented in PXDDeadPixelsChecker, PXDGainMapChecker, and PXDMaskedPixelsChecker.

Definition at line 163 of file condition_checker.py.

    def set_hist_content(self, h2, sensor_db_content):
        """
        Method to set TH2 bins
        Parameters:
          h2 (TH2): TH2F object for handling values of a pixel matrix
          sensor_db_content (Any): Calibration results of a module
        """
        pass
 

Member Data Documentation

◆ _objType

_objType = objType

protectedinherited

DBObj type.

Definition at line 59 of file condition_checker.py.

◆ dbObj

dbObj = Belle2.PyDBObj(self.name, self.objType.Class())

inherited

DBObjPtr for the condition.

Definition at line 61 of file condition_checker.py.

◆ eventMetaData

eventMetaData = Belle2.PyStoreObj("EventMetaData")

inherited

pointer to the event metadata

Definition at line 63 of file condition_checker.py.

◆ expstart

int expstart = 999999

inherited

The 1st exp.

Definition at line 82 of file condition_checker.py.

◆ graphs

dict graphs = {}

inherited

Dictionary of plots (TGraph) summarizing variables vs run.

Definition at line 72 of file condition_checker.py.

◆ hist_title_suffix

hist_title_suffix = ""

inherited

Hist title suffix.

Definition at line 76 of file condition_checker.py.

◆ hists

dict hists = {}

inherited

Dictionary of plots (TH1) to be saved for each run.

Definition at line 74 of file condition_checker.py.

◆ name

name = name

inherited

DBObj name.

Definition at line 57 of file condition_checker.py.

◆ rundir

rundir = rundir

inherited

Directory for writing histograms of each run.

Definition at line 67 of file condition_checker.py.

◆ runend

int runend = -1

inherited

The last run.

Definition at line 80 of file condition_checker.py.

◆ runstart

int runstart = 999999

inherited

The 1st run.

Definition at line 78 of file condition_checker.py.

◆ tfile

tfile = tfile

inherited

TFile for saving plots.

Definition at line 65 of file condition_checker.py.

◆ use_hist

use_hist = use_hist

inherited

Flag to get TGraph values from a histogram (TH2F)

Definition at line 84 of file condition_checker.py.

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

pxd/scripts/pxd/calibration/condition_checker.py

Public Member Functions

Public Attributes

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __init__()

Member Function Documentation

◆ beginRun()

◆ define_graphs()

◆ define_hists()

◆ draw_plots()

◆ exp()

◆ fill_plots()

◆ get_db_content()

◆ get_graph_value()

◆ get_graph_value_from_hist()

◆ objType()

◆ run()

◆ save_canvas()

◆ set_hist_content()

Member Data Documentation

◆ _objType

◆ dbObj

◆ eventMetaData

◆ expstart

◆ graphs

◆ hist_title_suffix

◆ hists

◆ name

◆ rundir

◆ runend

◆ runstart

◆ tfile

◆ use_hist

◆ init()