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. More...

virtual	~KVINDRAPulserDataTree ()
	Destructor. More...

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. More...

void	SetRunList (KVSeqCollection *runs)

void	WriteTree (TFile *)

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

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

	KVBase (const KVBase &)
	copy ctor More...

virtual	~ KVBase ()

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

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

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 More...

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)

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. More...

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

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

Private Attributes
TTree *	fArb
	tree containing pulser data More...

KVTarArchive *	fGeneDir
	directory/archive containing gene data More...

THashTable *	fIndex
	associate name of branch to index in fVal More...

KVTarArchive *	fPinDir
	directory/archive containing pin data More...

Int_t	fRun
	run number used to build tree More...

KVSeqCollection *	fRunlist
	list of runs given by database More...

Int_t	fTab_siz
	size of array More...

Float_t *	fVal
	array of floats used to fill tree More...

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

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. More...

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.) More...

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

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

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

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

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

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

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

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

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. More...

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

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. More...

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

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