Detailed Description

Database entry for each run of an INDRA experiment.

Information available:

all infos from runlists/runsheets (scalers, i.e. gene direct/TM/MRQ, faraday), length of run,
size of run file, tape number (!), multiplicity trigger, etc.

Cross-section for a given run can be calculated with GetEventCrossSection()

Total measured cross-section for all events in run can be calculated with GetTotalCrossSection()

Definition at line 30 of file KVINDRADBRun.h.

#include <KVINDRADBRun.h>

Inheritance diagram for KVINDRADBRun:

[legend]

Public Member Functions
	KVINDRADBRun ()
	default ctor

	KVINDRADBRun (Int_t number, const Char_t *title="INDRA Run")
	ctor for a given run number

virtual	~KVINDRADBRun ()
	dtor

const Char_t *	GetCahier () const

Double_t	GetDeadTime () const

KVDatime &	GetEndDatime ()

Double_t	GetEventCrossSection (Double_t Q_apres_cible, Double_t Coul_par_top=1.e-10) const

virtual Double_t	GetGeneDirectTime (Double_t average_gene_dir_frequency=185.0) const

const Char_t *	GetLogbook () const

Double_t	GetNIncidentIons (Double_t Q_apres_cible, Double_t Coul_par_top=1.e-10) const

KVDatime &	GetStartDatime ()

KVDBTape *	GetTape () const

Int_t	GetTapeNumber () const

Double_t	GetTempsMort () const

Double_t	GetTMpercent () const

Double_t	GetTotalCrossSection (Double_t Q_apres_cible, Double_t Coul_par_top=1.e-10) const

void	SetCahier (const Char_t *log)

void	SetLogbook (const Char_t *log)

void	SetTMpercent (Float_t tmp)

virtual void	UnsetSystem ()

Public Member Functions inherited from KVDBRun
	KVDBRun ()
	default ctor

	KVDBRun (Int_t number, const Char_t *title)
	ctor for a given run number

virtual	~KVDBRun ()
	dtor

void	BlockSignals (Bool_t yes=kTRUE)

Double_t	Get (const Char_t *param) const
	Get numerical (non-scaler) characteristic of run.

const Char_t *	GetComments () const

const Char_t *	GetDate () const

const TDatime &	GetDatime () const

const Char_t *	GetDatimeString ()

const Char_t *	GetEndDate () const

ULong64_t	GetEvents () const

const Char_t *	GetKVVersion () const

virtual Int_t	GetScaler (const Char_t *name) const
	Get value of scaler with the given name for this run.

virtual ULong64_t	GetScaler64 (const Char_t *name) const
	Get value of 64-bit scaler with the given name for this run.

Double_t	GetSize () const

const Char_t *	GetStartDate () const

const Char_t *	GetString (const Char_t *param) const
	Get characteristic of run.

KVDBSystem *	GetSystem () const

const Char_t *	GetSystemName () const

KVTarget *	GetTarget () const
	Return target used for this run (actually target of KVDBSystem associated to run)

Double_t	GetTime () const

Int_t	GetTrigger () const

const Char_t *	GetTriggerString () const

const Char_t *	GetUserName () const

Bool_t	Has (const Char_t *param, Bool_t check_whitespace=kTRUE) const

void	Modified ()

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

virtual void	ReadRunListLine (const KVString &)

void	Set (const Char_t *param, const KVString &val)
	Set characteristic of run.

void	Set (const Char_t *param, Double_t val)
	Set numerical (non-scaler) characteristic of run.

void	SetComments (const KVString &comments)

void	SetDate (const KVString &d)

void	SetDatime (TDatime &dat)

void	SetEndDate (const KVString &d)

void	SetEvents (ULong64_t evt_number)

void	SetKVVersion (const Char_t *V)

void	SetNumber (Int_t n)

virtual void	SetScaler (const Char_t *name, Int_t val)
	Set value for the scaler with the given name for this run.

virtual void	SetScaler64 (const Char_t *name, ULong64_t val)
	Set value for 64-bit scaler with the given name for this run.

void	SetSize (Double_t s)

void	SetStartDate (const KVString &date)

virtual void	SetSystem (KVDBSystem *system)
	Set system for run. Any previous system is unassociated (run will be removed from system's list)

void	SetTime (Double_t time)

void	SetTrigger (Int_t trig)

void	SetUserName (const Char_t *U)

virtual void	WriteRunListHeader (std::ostream &, Char_t delim='\|') const
	Write the version flag.

virtual void	WriteRunListLine (std::ostream &, Char_t delim='\|') const

Public Member Functions inherited from KVDBRecord
	KVDBRecord ()

	KVDBRecord (const Char_t name, const Char_t title="")

virtual	~KVDBRecord ()

virtual KVDBKey *	AddKey (const Char_t name, const Char_t title, Bool_t check=kTRUE)

virtual Bool_t	AddKey (KVDBKey *key, Bool_t check=kTRUE)

virtual Bool_t	AddLink (const Char_t key_name, KVDBRecord rec, Bool_t linkback=kTRUE)

virtual Int_t	Compare (const TObject *obj) const

virtual KVDBKey *	GetKey (const Char_t *key) const

virtual TList *	GetKeys () const

virtual KVDBRecord *	GetLink (const Char_t key, const Char_t link) const
	Returns the record named "link" in the table named "key".

virtual KVRList *	GetLinks (const Char_t *key) const
	Returns the list of records linked to this record in table "key".

virtual Int_t	GetNumber () const

virtual KVDBTable *	GetTable () const

virtual void	ls (Option_t option="") const

virtual void	RemoveAllLinks (const Char_t *key)
	Remove all links between this record and the records in the DB table"key_name".

virtual void	RemoveLink (const Char_t key_name, KVDBRecord rec, Bool_t linkback=kTRUE)
	Remove the link between this record and the record "rec" in the DB table"key_name".

virtual void	SetTable (const KVDBTable *table)

Public Member Functions inherited from TFolder
	TFolder ()

	TFolder (const char name, const char title)

virtual	~TFolder ()

virtual void	Add (TObject *obj)

TFolder *	AddFolder (const char name, const char title, TCollection *collection=nullptr)

void	Browse (TBrowser *b) override

void	Clear (Option_t *option="") override

void	Copy (TObject &) const override

virtual const char *	FindFullPathName (const char *name) const

virtual const char *	FindFullPathName (const TObject *obj) const

TObject *	FindObject (const char *name) const override

TObject *	FindObject (const TObject *obj) const override

virtual TObject *	FindObjectAny (const char *name) const

TCollection *	GetListOfFolders () const

TClass *	IsA () const override

Bool_t	IsFolder () const override

Bool_t	IsOwner () const

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

virtual Int_t	Occurence (const TObject *obj) const

void	RecursiveRemove (TObject *obj) override

virtual void	Remove (TObject *obj)

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

virtual void	SetOwner (Bool_t owner=kTRUE)

void	Streamer (TBuffer &) override

void	StreamerNVirtual (TBuffer &ClassDef_StreamerNVirtual_b)

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="")

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

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)

void	ResetBit (UInt_t f)

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 Attributes
KVDatime	fStartEndDate
	used by GetStartDatime and GetEndDatime methods

Additional Inherited Members
Public Types inherited from TObject
enum	EDeprecatedStatusBits

enum	EStatusBits

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

static const char *	Class_Name ()

static constexpr Version_t	Class_Version ()

static const char *	DeclFileName ()

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 TFolder
TCollection *	fFolders

Bool_t	fIsOwner

Protected Attributes inherited from TNamed
TString	fName

TString	fTitle

Protected Attributes inherited from TObject
	kOnlyPrepStep

Constructor & Destructor Documentation

◆ KVINDRADBRun() [1/2]

KVINDRADBRun::KVINDRADBRun ( )

default ctor

Definition at line 18 of file KVINDRADBRun.cpp.

◆ KVINDRADBRun() [2/2]

KVINDRADBRun::KVINDRADBRun	(	Int_t	number,
		const Char_t *	title = `"INDRA Run"`
	)

ctor for a given run number

Definition at line 28 of file KVINDRADBRun.cpp.

◆ ~KVINDRADBRun()

KVINDRADBRun::~KVINDRADBRun ( )

virtual

dtor

Definition at line 39 of file KVINDRADBRun.cpp.

Member Function Documentation

◆ GetCahier()

const Char_t * KVINDRADBRun::GetCahier ( ) const

inline

Definition at line 46 of file KVINDRADBRun.h.

◆ GetDeadTime()

Double_t KVINDRADBRun::GetDeadTime ( ) const

inline

Definition at line 75 of file KVINDRADBRun.h.

◆ GetEndDatime()

KVDatime & KVINDRADBRun::GetEndDatime ( )

inline

Returns KVDatime with end date/time of run, i.e. string returned by GetEndDate(). For INDRA runs, this string is assumed to be in GANIL acquisition format.

Definition at line 103 of file KVINDRADBRun.h.

◆ GetEventCrossSection()

Double_t KVINDRADBRun::GetEventCrossSection	(	Double_t	Q_apres_cible,
		Double_t	Coul_par_top = `1.e-10`
	)		const

Calculation of cross-section (in millibarn) per event of this run from the measured integrated beam current and correcting for dead time. Based on sect_effic.f by M.F. Rivet

For meaning of arguments, see GetNIncidentIons()

Definition at line 53 of file KVINDRADBRun.cpp.

◆ GetGeneDirectTime()

virtual Double_t KVINDRADBRun::GetGeneDirectTime ( Double_t average_gene_dir_frequency = 185.0 ) const

inlinevirtual

The GENE DIRECT of INDRA Selector module is generated from an internal clock with a nominal frequency of 160Hz, but which in reality (as measured by scaler) is approximately 185Hz (it actually appears to fluctuate around this value). Therefore the length of a run can be obtained from the GD simply by dividing by 185 (or another value for the average frequency of the pulser, which may be given as argument). This method returns the result of this division, corresponding to the length of the run (in seconds).

Definition at line 88 of file KVINDRADBRun.h.

◆ GetLogbook()

const Char_t * KVINDRADBRun::GetLogbook ( ) const

inline

Definition at line 50 of file KVINDRADBRun.h.

◆ GetNIncidentIons()

Double_t KVINDRADBRun::GetNIncidentIons	(	Double_t	Q_apres_cible,
		Double_t	Coul_par_top = `1.e-10`
	)		const

Calculate total number of incident beam particles during run, based on measured integrated beam current Arguments: Q_apres_cible = (average) charge state of projectile ions AFTER passage through target Coul_par_top = calibration of Faraday current integrator (default: 1.e-10 Coul/top) Note (from sect_effic.f): /‍*** Etalonnage de l'integrateur en 1993: voir cahier 4 page 87. /‍** Si l'oscillateur interne du trigger est a 169 Hz, on a 10**(-10) Cb/top. /‍** si c'est 160 Hz, on a 1.0610*(10**(-10)).

Definition at line 129 of file KVINDRADBRun.cpp.

◆ GetStartDatime()

KVDatime & KVINDRADBRun::GetStartDatime ( )

inline

Returns KVDatime with start date/time of run, i.e. string returned by GetStartDate(). For INDRA runs, this string is assumed to be in GANIL acquisition format. If date is not set, we return current time & date.

Definition at line 94 of file KVINDRADBRun.h.

◆ GetTape()

KVDBTape * KVINDRADBRun::GetTape ( ) const

Definition at line 166 of file KVINDRADBRun.cpp.

◆ GetTapeNumber()

Int_t KVINDRADBRun::GetTapeNumber ( ) const

Definition at line 178 of file KVINDRADBRun.cpp.

◆ GetTempsMort()

Double_t KVINDRADBRun::GetTempsMort ( ) const

Calculate temps mort for run from values of Gene dir, Gene MRQ and Gene TM, according to: T.M. = Gene TM / (Gene dir - Gene MRQ) If Gene dir = Gene MRQ, temps mort = 0. This can be compared to the value of GetTMpercent() (if present) which is the percentage value filled in the runsheet during the experimental run.

Definition at line 103 of file KVINDRADBRun.cpp.

◆ GetTMpercent()

Double_t KVINDRADBRun::GetTMpercent ( ) const

inline

Definition at line 42 of file KVINDRADBRun.h.

◆ GetTotalCrossSection()

Double_t KVINDRADBRun::GetTotalCrossSection	(	Double_t	Q_apres_cible,
		Double_t	Coul_par_top = `1.e-10`
	)		const

Calculate total cross-section (in millibarn) measured for this run from the calculated cross-section per event (see GetEventCrossSection()) and the total number of measured events

Definition at line 86 of file KVINDRADBRun.cpp.

◆ SetCahier()

void KVINDRADBRun::SetCahier ( const Char_t * log )

inline

Definition at line 60 of file KVINDRADBRun.h.

◆ SetLogbook()

void KVINDRADBRun::SetLogbook ( const Char_t * log )

inline

Definition at line 64 of file KVINDRADBRun.h.

◆ SetTMpercent()

void KVINDRADBRun::SetTMpercent ( Float_t tmp )

inline

Definition at line 55 of file KVINDRADBRun.h.

◆ UnsetSystem()

void KVINDRADBRun::UnsetSystem ( )

virtual

If this run has previously been associated with a system in the database, this will remove the association. The run will also be removed from the system's list of associated runs.

Reimplemented from KVDBRun.

Definition at line 152 of file KVINDRADBRun.cpp.

Member Data Documentation

◆ fStartEndDate

KVDatime KVINDRADBRun::fStartEndDate

private

used by GetStartDatime and GetEndDatime methods

Definition at line 33 of file KVINDRADBRun.h.

Detailed Description

Public Member Functions

Private Attributes

Additional Inherited Members

Constructor & Destructor Documentation

◆ KVINDRADBRun() [1/2]

◆ KVINDRADBRun() [2/2]

◆ ~KVINDRADBRun()

Member Function Documentation

◆ GetCahier()

◆ GetDeadTime()

◆ GetEndDatime()

◆ GetEventCrossSection()

◆ GetGeneDirectTime()

◆ GetLogbook()

◆ GetNIncidentIons()

◆ GetStartDatime()

◆ GetTape()

◆ GetTapeNumber()

◆ GetTempsMort()

◆ GetTMpercent()

◆ GetTotalCrossSection()

◆ SetCahier()

◆ SetLogbook()

◆ SetTMpercent()

◆ UnsetSystem()

Member Data Documentation

◆ fStartEndDate