Detailed Description

Handles TTree with mean pulser data for every run.

Create and fill tree with pulser data. We look for the following two directories:

 $KVROOT/KVFiles/name_of_dataset/gene_detecteurs
 $KVROOT/KVFiles/name_of_dataset/gene_pins

If not found, we look for the following compressed archives:

 $KVROOT/KVFiles/name_of_dataset/gene_detecteurs.tgz
 $KVROOT/KVFiles/name_of_dataset/gene_pins.tgz

and if found, uncompress them ('tar -zxf').
The default names of these directories are defined in .kvrootrc by:

 KVINDRAPulserDataTree.GeneDetDir:   gene_detecteurs
 KVINDRAPulserDataTree.GenePinDir:   gene_pins

Dataset-dependent alternatives can be defined using:

 dataset_name.KVINDRAPulserDataTree.GeneDetDir:   dataset_specific_value

The first directory (gene_detecteurs) must contain 1 file per run with names like:

   run8820.gene

These files are generated using example analysis class GetGeneMean (see Examples). They contain the mean value of every acquisition parameter associated with a detector in the run:

   CI_0201_GG     3095.28
   CI_0201_PG     275.626
   CI_0203_GG     2863.66
   CI_0203_PG     263.308
   CI_0205_GG     3042.83
   etc.

i.e. 'name of acquisition parameter' 'mean value for run'
The second directory (gene_pins) must contain 1 file per run with names like:

   run8820.genepin
 OR   run8820.laserpin
 OR   run8820.genelaserpin

These files are generated using example analysis class GetGeneMeanPin (see Examples). They contain the mean values of the acquisition parameters associated with pin diodes in the run:

   PILA_01_PG_gene     792.616
   PILA_01_PG_laser     1747.18
   PILA_01_GG_gene     0
   etc.

We create a TTree with 1 branch for each detector acquisition parameter. For PILA and SI_PIN parameters, we create a 'gene' and a 'laser' branch for each.

Definition at line 88 of file KVINDRAPulserDataTree.h.

#include <KVINDRAPulserDataTree.h>

Inheritance diagram for KVINDRAPulserDataTree:

[legend]

Public Member Functions
	KVINDRAPulserDataTree ()
	Default constructor.

virtual	~KVINDRAPulserDataTree ()
	Destructor.

virtual void	Build ()

Int_t	GetIndex (const Char_t *branchname) const

Float_t	GetMean (const Char_t *, Int_t)

TTree *	GetTree () const

void	ReadTree (TFile *)
	Read pulser data tree from file.

void	SetRunList (KVSeqCollection *runs)

void	WriteTree (TFile *)

Public Member Functions inherited from KVBase
	KVBase ()
	Default constructor.

	KVBase (const Char_t name, const Char_t title="")
	Ctor for object with given name and type.

	KVBase (const KVBase &)
	copy ctor

virtual	~KVBase ()

virtual void	Clear (Option_t *opt="")
	Clear object properties : name, type/title, number, label.

virtual void	Copy (TObject &) const
	Make a copy of this object.

const Char_t *	GetLabel () const

UInt_t	GetNumber () const

UInt_t	GetNumberOfObjects () const

virtual TObject *	GetObject () const

virtual const Char_t *	GetType () const

Bool_t	HasLabel () const

virtual Bool_t	IsCalled (const Char_t *name) const

Bool_t	IsLabelled (const Char_t *l) const

virtual Bool_t	IsType (const Char_t *typ) const

virtual void	List ()

KVBase &	operator= (const KVBase &)
	copy assignment operator

virtual void	Print (Option_t *option="") const

Double_t	ProtectedGetX (const TF1 *func, Double_t val, int &status, Double_t xmin=0.0, Double_t xmax=0.0) const

void	SetLabel (const Char_t *lab)

virtual void	SetNumber (UInt_t num)

virtual void	SetType (const Char_t *str)

Public Member Functions inherited from TNamed
	TNamed ()

	TNamed (const char name, const char title)

	TNamed (const TNamed &named)

	TNamed (const TString &name, const TString &title)

virtual	~TNamed ()

void	Clear (Option_t *option="") override

TObject *	Clone (const char *newname="") const override

Int_t	Compare (const TObject *obj) const override

void	Copy (TObject &named) const override

virtual void	FillBuffer (char *&buffer)

const char *	GetName () const override

const char *	GetTitle () const override

ULong_t	Hash () const override

TClass *	IsA () const override

Bool_t	IsSortable () const override

void	ls (Option_t *option="") const override

TNamed &	operator= (const TNamed &rhs)

void	Print (Option_t *option="") const override

virtual void	SetName (const char *name)

virtual void	SetNameTitle (const char name, const char title)

virtual void	SetTitle (const char *title="")

virtual Int_t	Sizeof () const

void	Streamer (TBuffer &) override

void	StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)

Public Member Functions inherited from TObject
	TObject ()

	TObject (const TObject &object)

virtual	~TObject ()

void	AbstractMethod (const char *method) const

virtual void	AppendPad (Option_t *option="")

virtual void	Browse (TBrowser *b)

ULong_t	CheckedHash ()

virtual const char *	ClassName () const

virtual void	Delete (Option_t *option="")

virtual Int_t	DistancetoPrimitive (Int_t px, Int_t py)

virtual void	Draw (Option_t *option="")

virtual void	DrawClass () const

virtual TObject *	DrawClone (Option_t *option="") const

virtual void	Dump () const

virtual void	Error (const char method, const char msgfmt,...) const

virtual void	Execute (const char method, const char params, Int_t *error=nullptr)

virtual void	Execute (TMethod method, TObjArray params, Int_t *error=nullptr)

virtual void	ExecuteEvent (Int_t event, Int_t px, Int_t py)

virtual void	Fatal (const char method, const char msgfmt,...) const

virtual TObject *	FindObject (const char *name) const

virtual TObject *	FindObject (const TObject *obj) const

virtual Option_t *	GetDrawOption () const

virtual const char *	GetIconName () const

virtual char *	GetObjectInfo (Int_t px, Int_t py) const

virtual Option_t *	GetOption () const

virtual UInt_t	GetUniqueID () const

virtual Bool_t	HandleTimer (TTimer *timer)

Bool_t	HasInconsistentHash () const

virtual void	Info (const char method, const char msgfmt,...) const

virtual Bool_t	InheritsFrom (const char *classname) const

virtual Bool_t	InheritsFrom (const TClass *cl) const

virtual void	Inspect () const

void	InvertBit (UInt_t f)

Bool_t	IsDestructed () const

virtual Bool_t	IsEqual (const TObject *obj) const

virtual Bool_t	IsFolder () const

R__ALWAYS_INLINE Bool_t	IsOnHeap () const

R__ALWAYS_INLINE Bool_t	IsZombie () const

void	MayNotUse (const char *method) const

virtual Bool_t	Notify ()

void	Obsolete (const char method, const char asOfVers, const char *removedFromVers) const

void	operator delete (void *ptr)

void	operator delete (void ptr, void vp)

void	operator delete[] (void *ptr)

void	operator delete[] (void ptr, void vp)

void *	operator new (size_t sz)

void *	operator new (size_t sz, void *vp)

void *	operator new[] (size_t sz)

void *	operator new[] (size_t sz, void *vp)

TObject &	operator= (const TObject &rhs)

virtual void	Paint (Option_t *option="")

virtual void	Pop ()

virtual Int_t	Read (const char *name)

virtual void	RecursiveRemove (TObject *obj)

void	ResetBit (UInt_t f)

virtual void	SaveAs (const char filename="", Option_t option="") const

virtual void	SavePrimitive (std::ostream &out, Option_t *option="")

void	SetBit (UInt_t f)

void	SetBit (UInt_t f, Bool_t set)

virtual void	SetDrawOption (Option_t *option="")

virtual void	SetUniqueID (UInt_t uid)

void	StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)

virtual void	SysError (const char method, const char msgfmt,...) const

R__ALWAYS_INLINE Bool_t	TestBit (UInt_t f) const

Int_t	TestBits (UInt_t f) const

virtual void	UseCurrentStyle ()

virtual void	Warning (const char method, const char msgfmt,...) const

virtual Int_t	Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0)

virtual Int_t	Write (const char *name=nullptr, Int_t option=0, Int_t bufsize=0) const

Private Member Functions
void	CreateTree ()

TString	GetDirectoryName (const Char_t *)

Bool_t	OpenGeneData (Int_t, std::ifstream &)

Bool_t	OpenPinData (Int_t, std::ifstream &)

void	ReadData ()
	Read data for every run in dataset.

UChar_t	ReadData (Int_t)
	Read data for one run, fill tree.

void	ReadFile (std::ifstream &)
	Read data in one file.

Private Attributes
TTree *	fArb
	tree containing pulser data

KVTarArchive *	fGeneDir
	directory/archive containing gene data

THashTable *	fIndex
	associate name of branch to index in fVal

KVTarArchive *	fPinDir
	directory/archive containing pin data

Int_t	fRun
	run number used to build tree

KVSeqCollection *	fRunlist
	list of runs given by database

Int_t	fTab_siz
	size of array

Float_t *	fVal
	array of floats used to fill tree

Additional Inherited Members
Public Types inherited from KVBase
enum	EKaliVedaBits { kIsKaliVedaObject = BIT(23) }

Public Types inherited from TObject
enum	EDeprecatedStatusBits

enum	EStatusBits

Static Public Member Functions inherited from KVBase
static Bool_t	AreEqual (Double_t x, Double_t y, Long64_t maxdif=1)
	Comparison between two 64-bit floating-point values.

static void	BackupFileWithDate (const Char_t *path)

static void	CombineFiles (const Char_t file1, const Char_t file2, const Char_t *newfilename, Bool_t keep=kTRUE)

static void	Deprecated (const char method, const char advice)

static Bool_t	FindClassSourceFiles (const Char_t class_name, KVString &imp_file, KVString &dec_file, const Char_t dir_name=".")

static Bool_t	FindExecutable (TString &exec, const Char_t *path="$(PATH)")

static const Char_t *	FindFile (const Char_t *search, TString &wfil)

static const Char_t *	GetBINDIRFilePath (const Char_t *namefile="")

static const Char_t *	GetDATABASEFilePath ()

static const Char_t *	GetDATADIRFilePath (const Char_t *namefile="")

static Bool_t	GetDataSetEnv (const Char_t dataset, const Char_t type, Bool_t defval)

static const Char_t *	GetDataSetEnv (const Char_t dataset, const Char_t type, const Char_t *defval)

static Double_t	GetDataSetEnv (const Char_t dataset, const Char_t type, Double_t defval)

static const Char_t *	GetETCDIRFilePath (const Char_t *namefile="")

static const Char_t *	GetExampleFilePath (const Char_t library, const Char_t namefile)
	Return full path to example file for given library (="KVMultiDet", "BackTrack", etc.)

static const Char_t *	GetINCDIRFilePath (const Char_t *namefile="")

static const Char_t *	GetKVBuildDate ()
	Returns KaliVeda build date.

static const Char_t *	GetKVBuildDir ()
	Returns top-level directory used for build.

static const Char_t *	GetKVBuildTime ()
	Returns KaliVeda build time.

static const Char_t *	GetKVBuildType ()
	Returns KaliVeda build type (cmake build: Release, Debug, RelWithDebInfo, ...)

static const Char_t *	GetKVBuildUser ()
	Returns username of person who performed build.

static const Char_t *	GetKVSourceDir ()
	Returns top-level directory of source tree used for build.

static const Char_t *	GetKVVersion ()
	Returns KaliVeda version string.

static const Char_t *	GetLIBDIRFilePath (const Char_t *namefile="")

static const Char_t *	GetListOfPlugins (const Char_t *base)

static const Char_t *	GetListOfPluginURIs (const Char_t *base)

static const Char_t *	GetPluginURI (const Char_t base, const Char_t plugin)

static void	GetTempFileName (TString &base)

static const Char_t *	GetTEMPLATEDIRFilePath (const Char_t *namefile="")

static const Char_t *	GetWORKDIRFilePath (const Char_t *namefile="")

static const Char_t *	gitBranch ()
	Returns git branch of sources.

static const Char_t *	gitCommit ()
	Returns last git commit of sources.

static void	InitEnvironment ()

static bool	is_gnuinstall ()

static Bool_t	IsThisAPlugin (const TString &uri, TString &base)

static TPluginHandler *	LoadPlugin (const Char_t base, const Char_t uri="0")

static Bool_t	OpenContextMenu (const char method, TObject obj, const char *alt_method_name="")

static void	OpenTempFile (TString &base, std::ofstream &fp)

static void	PrintSplashScreen ()
	Prints welcome message and infos on version etc.

static Bool_t	SearchAndOpenKVFile (const Char_t name, KVSQLite::database &dbfile, const Char_t kvsubdir="")

static Bool_t	SearchAndOpenKVFile (const Char_t name, std::ifstream &file, const Char_t kvsubdir="", KVLockfile *locks=0)

static Bool_t	SearchAndOpenKVFile (const Char_t name, std::ofstream &file, const Char_t kvsubdir="", KVLockfile *locks=0)

static Bool_t	SearchKVFile (const Char_t name, TString &fullpath, const Char_t kvsubdir="")

static const Char_t *	WorkingDirectory ()

Static Public Member Functions inherited from TNamed
static TClass *	Class ()

static const char *	Class_Name ()

static constexpr Version_t	Class_Version ()

static const char *	DeclFileName ()

Static Public Member Functions inherited from TObject
static TClass *	Class ()

static const char *	Class_Name ()

static constexpr Version_t	Class_Version ()

static const char *	DeclFileName ()

static Longptr_t	GetDtorOnly ()

static Bool_t	GetObjectStat ()

static void	SetDtorOnly (void *obj)

static void	SetObjectStat (Bool_t stat)

Public Attributes inherited from TObject
	kBitMask

	kCanDelete

	kCannotPick

	kHasUUID

	kInconsistent

	kInvalidObject

	kIsOnHeap

	kIsReferenced

	kMustCleanup

	kNoContextMenu

	kNotDeleted

	kObjInCanvas

	kOverwrite

	kSingleKey

	kWriteDelete

	kZombie

Protected Member Functions inherited from TObject
virtual void	DoError (int level, const char location, const char fmt, va_list va) const

void	MakeZombie ()

Protected Attributes inherited from TNamed
TString	fName

TString	fTitle

Protected Attributes inherited from TObject
	kOnlyPrepStep

Constructor & Destructor Documentation

◆ KVINDRAPulserDataTree()

KVINDRAPulserDataTree::KVINDRAPulserDataTree ( )

Default constructor.

Definition at line 26 of file KVINDRAPulserDataTree.cpp.

◆ ~KVINDRAPulserDataTree()

KVINDRAPulserDataTree::~KVINDRAPulserDataTree ( )

virtual

Destructor.

Definition at line 41 of file KVINDRAPulserDataTree.cpp.

Member Function Documentation

◆ Build()

void KVINDRAPulserDataTree::Build ( )

virtual

Create and fill tree with pulser data. We look for the following two directories:

$KVROOT/KVFiles/name_of_dataset/gene_detecteurs $KVROOT/KVFiles/name_of_dataset/gene_pins

If not found, we look for the following compressed archives:

$KVROOT/KVFiles/name_of_dataset/gene_detecteurs.tgz $KVROOT/KVFiles/name_of_dataset/gene_pins.tgz

and if found, uncompress them ('tar -zxf'). [[ N.B. in this case the extracted directories will be deleted after reading, [[ ensuring that if new archives are supplied, [[ we always use the latest versions of files.

The default names of these directories are defined in .kvrootrc by:

KVINDRAPulserDataTree.GeneDetDir: gene_detecteurs KVINDRAPulserDataTree.GenePinDir: gene_pins

Dataset-dependent alternatives can be defined using:

dataset_name.KVINDRAPulserDataTree.GeneDetDir: dataset_specific_value

The first directory (gene_detecteurs) must contain 1 file per run with names like:

run8820.gene

These files are generated using example analysis class GetGeneMean (see Examples). They contain the mean value of every acquisition parameter associated with a detector in the run:

CI_0201_GG 3095.28 CI_0201_PG 275.626 CI_0203_GG 2863.66 CI_0203_PG 263.308 CI_0205_GG 3042.83 etc.

i.e. 'name of acquisition parameter' 'mean value for run'

The second directory (gene_pins) must contain 1 file per run with names like:

run8820.genepin OR run8820.laserpin OR run8820.genelaserpin

These files are generated using example analysis class GetGeneMeanPin (see Examples). They contain the mean values of the acquisition parameters associated with pin diodes in the run:

PILA_01_PG_gene 792.616 PILA_01_PG_laser 1747.18 PILA_01_GG_gene 0 etc.

We create a TTree with 1 branch for each detector acquisition parameter. For PILA and SI_PIN parameters, we create a 'gene' and a 'laser' branch for each.

Definition at line 114 of file KVINDRAPulserDataTree.cpp.

◆ CreateTree()

void KVINDRAPulserDataTree::CreateTree ( )

private

Create new TTree with 1 branch 'Run' with run number 1 branch for each acquisition parameter of every detector (except time markers) 2 branches for each 'PILA_...' or 'SI_PIN...' parameter, suffixed with '_laser' and '_gene'

NB if multidetector has not been built, it will be built by this method

Definition at line 225 of file KVINDRAPulserDataTree.cpp.

◆ GetDirectoryName()

TString KVINDRAPulserDataTree::GetDirectoryName ( const Char_t * dirvar )

private

Returns the name of the directory defined by the .kvrootrc environment variable

KVINDRAPulserDataTree.[dirvar] OR dataset_name.KVINDRAPulserDataTree.[dirvar]:

Definition at line 197 of file KVINDRAPulserDataTree.cpp.

◆ GetIndex()

Int_t KVINDRAPulserDataTree::GetIndex ( const Char_t * branchname ) const

inline

Definition at line 120 of file KVINDRAPulserDataTree.h.

◆ GetMean()

Float_t KVINDRAPulserDataTree::GetMean	(	const Char_t *	param,
		Int_t	run
	)

Return mean value of pulser/laser for given parameter and run. For detectors, param should be name of an acquisition parameter e.g. CI_0201_PG, CSI_1301_L, etc. For pin laser diodes, param should be name of associated acquisition parameter with either '_laser' or '_gene' appended e.g. PILA_05_PG_laser, SI_PIN1_PG_gene

Returns -1.0 if no data available for this parameter/run.

Definition at line 467 of file KVINDRAPulserDataTree.cpp.

◆ GetTree()

TTree * KVINDRAPulserDataTree::GetTree ( ) const

inline

Definition at line 112 of file KVINDRAPulserDataTree.h.

◆ OpenGeneData()

Bool_t KVINDRAPulserDataTree::OpenGeneData	(	Int_t	,
		std::ifstream &
	)

private

Open gene data for one run We look for file 'runXXXX.gene' in the directory given by environment variable KVINDRAPulserDataTree.GeneDetDir.

Definition at line 341 of file KVINDRAPulserDataTree.cpp.

◆ OpenPinData()

Bool_t KVINDRAPulserDataTree::OpenPinData	(	Int_t	,
		std::ifstream &
	)

private

Open pin data for one run We look for one of the following files in the directory given by environment variable KVINDRAPulserDataTree.GenePinDir:

runXXXX.genepin OR runXXXX.laserpin OR runXXXX.genelaserpin

Definition at line 364 of file KVINDRAPulserDataTree.cpp.

◆ ReadData() [1/2]

void KVINDRAPulserDataTree::ReadData ( )

private

Read data for every run in dataset.

Definition at line 392 of file KVINDRAPulserDataTree.cpp.

◆ ReadData() [2/2]

UChar_t KVINDRAPulserDataTree::ReadData ( Int_t run )

private

Read data for one run, fill tree.

Definition at line 314 of file KVINDRAPulserDataTree.cpp.

◆ ReadFile()

void KVINDRAPulserDataTree::ReadFile ( std::ifstream & )

private

Read data in one file.

Definition at line 291 of file KVINDRAPulserDataTree.cpp.

◆ ReadTree()

void KVINDRAPulserDataTree::ReadTree ( TFile * file )

Read pulser data tree from file.

Definition at line 425 of file KVINDRAPulserDataTree.cpp.

◆ SetRunList()

void KVINDRAPulserDataTree::SetRunList ( KVSeqCollection * runs )

inline

Definition at line 128 of file KVINDRAPulserDataTree.h.

◆ WriteTree()

void KVINDRAPulserDataTree::WriteTree ( TFile * file )

Write pulser data tree in file We build and index based on the Run number and store it in the tree.

Definition at line 443 of file KVINDRAPulserDataTree.cpp.

Member Data Documentation

◆ fArb

TTree* KVINDRAPulserDataTree::fArb

private

tree containing pulser data

Definition at line 90 of file KVINDRAPulserDataTree.h.

◆ fGeneDir

KVTarArchive* KVINDRAPulserDataTree::fGeneDir

private

directory/archive containing gene data

Definition at line 91 of file KVINDRAPulserDataTree.h.

◆ fIndex

THashTable* KVINDRAPulserDataTree::fIndex

private

associate name of branch to index in fVal

Definition at line 96 of file KVINDRAPulserDataTree.h.

◆ fPinDir

KVTarArchive* KVINDRAPulserDataTree::fPinDir

private

directory/archive containing pin data

Definition at line 92 of file KVINDRAPulserDataTree.h.

◆ fRun

Int_t KVINDRAPulserDataTree::fRun

private

run number used to build tree

Definition at line 93 of file KVINDRAPulserDataTree.h.

◆ fRunlist

KVSeqCollection* KVINDRAPulserDataTree::fRunlist

private

list of runs given by database

Definition at line 97 of file KVINDRAPulserDataTree.h.

◆ fTab_siz

Int_t KVINDRAPulserDataTree::fTab_siz

private

size of array

Definition at line 95 of file KVINDRAPulserDataTree.h.

◆ fVal

Float_t* KVINDRAPulserDataTree::fVal

private

array of floats used to fill tree

Definition at line 94 of file KVINDRAPulserDataTree.h.

Detailed Description

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Constructor & Destructor Documentation

◆ KVINDRAPulserDataTree()

◆ ~KVINDRAPulserDataTree()

Member Function Documentation

◆ Build()

◆ CreateTree()

◆ GetDirectoryName()

◆ GetIndex()

◆ GetMean()

◆ GetTree()

◆ OpenGeneData()

◆ OpenPinData()

◆ ReadData() [1/2]

◆ ReadData() [2/2]

◆ ReadFile()

◆ ReadTree()

◆ SetRunList()

◆ WriteTree()

Member Data Documentation

◆ fArb

◆ fGeneDir

◆ fIndex

◆ fPinDir

◆ fRun

◆ fRunlist

◆ fTab_siz

◆ fVal