Inheritance diagram for PXDDeadPixelsChecker:

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

	define_graphs (self)

	define_hists (self)

	get_db_content (self)

	get_graph_value (self, sensor_db_content)

	get_graph_value_from_hist (self, h2)

	set_hist_content (self, h2, sensor_db_content)

	draw_plots (self, canvas=None, cname="PXDDeadPixel", ymin=0., ymax=plot_type_dict["dead"]["max"], **kwargs)

	objType (self)

	run (self)

	exp (self)

	beginRun (self)

	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 PXDDeadPixelPar

Definition at line 360 of file condition_checker.py.

Constructor & Destructor Documentation

◆ init()

__init__	(	self,
		name,
		tfile,
		rundir = "maps",
		use_hist = True )

Definition at line 365 of file condition_checker.py.

    def __init__(self, name, tfile, rundir="maps", use_hist=True):
        """
        """
        super().__init__(name, Belle2.PXDDeadPixelPar, tfile, rundir)
 

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 370 of file condition_checker.py.

    def define_graphs(self):
        """
        Method to define TGraph
        """
        super().define_graphs(ytitle="Dead pixels [%]")
 

◆ define_hists()

define_hists ( self )

Method to define TH2

Reimplemented from ConditionCheckerBase.

Definition at line 376 of file condition_checker.py.

    def define_hists(self):
        """
        Method to define TH2
        """
        super().define_hists(name="DeadPixels", title="Dead Pixels", ztitle="isDead")
 

◆ draw_plots()

draw_plots	(		self,
			canvas = None,
			cname = "PXDDeadPixel",
			ymin = 0.,
			ymax = plot_type_dict["dead"]["max"],
		**	kwargs )

Method to draw plots on a TCanvas

Reimplemented from ConditionCheckerBase.

Definition at line 450 of file condition_checker.py.

    def draw_plots(self, canvas=None, cname="PXDDeadPixel", ymin=0., ymax=plot_type_dict["dead"]["max"], **kwargs):
        """
        Method to draw plots on a TCanvas
        """
        super().draw_plots(canvas=canvas, cname=cname, ymin=ymin, ymax=ymax, **kwargs)
 
 

◆ 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 382 of file condition_checker.py.

    def get_db_content(self):
        deadsensormap = self.dbObj.getDeadSensorMap()
        deaddrainmap = self.dbObj.getDeadDrainMap()
        deadrowmap = self.dbObj.getDeadRowMap()
        deadsinglesmap = self.dbObj.getDeadSinglePixelMap()
 
        content_dic = {}
        for sensorID in sensorID_list:
            numID = sensorID.getID()
            content_dic[numID] = {}
            if numID in deadsensormap:
                content_dic[numID]["deadsensor"] = True
            else:
                content_dic[numID]["deadsensor"] = False
                content_dic[numID]["deaddrains"] = deaddrainmap[numID]
                content_dic[numID]["deadrows"] = deadrowmap[numID]
                content_dic[numID]["deadsingles"] = deadsinglesmap[numID]
        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 401 of file condition_checker.py.

    def get_graph_value(self, sensor_db_content):
        deadcount = 0
        if sensor_db_content["deadsensor"]:
            deadcount = nPixels
        else:
            n_deaddrains = len(sensor_db_content["deaddrains"])
            n_deadrows = len(sensor_db_content["deadrows"])
            if n_deaddrains == 0 or n_deadrows == 0:
                # Every dead drain counts for 192 dead pixels
                deadcount = n_deaddrains * 192
                # Every dead row counts for 250 dead pixels
                # This can lead to double counting of dead pixel from dead drains
                # The double counting can be avoided by using TH2.Integral().
                deadcount += n_deadrows * 250
                # Every dead single pixels
                deadcount += len(sensor_db_content["deadsingles"])
            else:  # Using a histogram to avoid double counting
                # Just create a temporary TH2
                h2 = list(get_sensor_maps(sensorID_list=sensorID_list[0:1]).values())[0]
                self.set_hist_content(h2, sensor_db_content)
                deadcount = h2.Integral()
        
        self.hist_title_suffix = f" ({deadcount} pixels)"
        return min(deadcount, nPixels) * 100. / nPixels
 

◆ get_graph_value_from_hist()

get_graph_value_from_hist	(		self,
			h2 )

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

Reimplemented from ConditionCheckerBase.

Definition at line 426 of file condition_checker.py.

    def get_graph_value_from_hist(self, h2):
        return h2.Integral() * 100. / nPixels
 

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

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 from ConditionCheckerBase.

Definition at line 429 of file condition_checker.py.

    def set_hist_content(self, h2, sensor_db_content):
        # loop over all dead pixels
        if sensor_db_content["deadsensor"]:
            ones = np.ones(nPixels)
            h2.SetContent(ones)
        else:
            for drainID in sensor_db_content["deaddrains"]:
                for iGate in range(192):
                    uCell = drainID / 4
                    vCell = drainID % 4 + iGate * 4
                    h2.SetBinContent(int(uCell + 1), int(vCell + 1), 1)
 
            for vCell in sensor_db_content["deadrows"]:
                for uCell in range(nUCells):
                    h2.SetBinContent(int(uCell + 1), int(vCell + 1), 1)
 
            for pixelID in sensor_db_content["deadsingles"]:
                uCell = int(pixelID / nVCells)
                vCell = pixelID % nVCells
                h2.SetBinContent(int(uCell + 1), int(vCell + 1), 1)
 

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