Describe an experimental set-up coupling two or more different detector arrays.

KVExpSetUp combines two or more existing KVMultiDetArray objects to describe the geometry, detectors, etc. of an experiment coupling several different arrays. Each KVMultiDetArray can have its own dedicated calibration database (KVExpDB and KVUpdater class) used to store and set calibration parameters.

Note: All detector & structure names in individual arrays must be unique! The group numbering has to be modified (in Build()) to make them unique.

Definition at line 24 of file KVExpSetUp.h.

Public Member Functions
	KVExpSetUp ()
	Default constructor. More...

virtual	~KVExpSetUp ()
	Destructor. More...

virtual void	AcceptAllECodes ()

virtual void	AcceptAllIDCodes ()

virtual void	AcceptParticleForAnalysis (KVReconstructedNucleus *) const

virtual void	Build (Int_t run=-1)

void	CheckStatusOfDetectors (KVDBRun *r, const TString &="")

void	Clear (Option_t *opt="")

void	FillDetectorList (KVReconstructedNucleus rnuc, KVHashList DetList, const KVString &DetNames)

virtual KVMultiDetArray *	GetArray (const Char_t *name) const

void	GetArrayMultiplicities (KVReconstructedEvent , KVNameValueList &, Option_t ="")

void	GetDetectorEvent (KVDetectorEvent detev, const TSeqCollection fired_params=nullptr)

KVGroupReconstructor *	GetReconstructorForGroup (const KVGroup *g) const

Bool_t	HandleRawDataEvent (KVRawDataReader *)

void	InitialiseRawDataReading (KVRawDataReader *R)

virtual void	InitializeIDTelescopes ()

void	MakeCalibrationTables (KVExpDB *db)

void	SetCalibratorParameters (KVDBRun *r, const TString &="")

void	SetRawDataFromReconEvent (KVNameValueList &l)

virtual void	SetSimMode (Bool_t on=kTRUE)

virtual void	SetTarget (KVTarget *target)

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

	KVMultiDetArray (const Char_t name, const Char_t type="")
	Constructor with name and optional type. More...

virtual	~KVMultiDetArray ()
	destroy (delete) the MDA and all the associated structure, detectors etc. More...

void	AcceptECodes (const KVNumberList &codelist)

void	AcceptIDCodes (const KVNumberList &codelist)

virtual void	AnalyseGroupAndReconstructEvent (KVReconstructedEvent recev, KVGroup grp)

void	CalculateDetectorSegmentationIndex ()

void	CalculateIdentificationGrids ()
	For each IDtelescope in array, calculate an identification grid. More...

Bool_t	CalParamsSet ()

void	CheckROOTGeometry ()

void	CreateGeoManager (Double_t dx=500, Double_t dy=500, Double_t dz=500)

virtual void	CreateIDTelescopesInGroups ()

virtual void	DetectEvent (KVEvent event, KVReconstructedEvent rec_event, const Char_t *detection_frame="")

virtual KVNameValueList *	DetectParticle (KVNucleus *part)

KVNameValueList *	DetectParticle_TGEO (KVNucleus *part)

void	DetectParticleIn (const Char_t detname, KVNucleus kvp)

void	Draw (Option_t *option="")

virtual TGraph *	DrawPunchThroughEnergyVsZ (const Char_t *detector, Int_t massform=KVNucleus::kBetaMass)

virtual TGraph *	DrawPunchThroughEsurAVsZ (const Char_t *detector, Int_t massform=KVNucleus::kBetaMass)

virtual TGraph *	DrawPunchThroughZVsVpar (const Char_t *detector, Int_t massform=KVNucleus::kBetaMass)

void	FillHistogramsForAllIDTelescopes (KVSeqCollection *list)
	Fill TH2F histograms for all IDTelescopes of the array. More...

void	FillListOfIDTelescopes (KVIDGraph *gr) const

virtual Int_t	FilteredEventCoherencyAnalysis (Int_t round, KVReconstructedEvent *rec_event)

const KVNumberList &	GetAcceptedECodes () const

const KVNumberList &	GetAcceptedIDCodes () const

TList *	GetCalibrationStatusOfDetectors ()

UInt_t	GetCurrentRunNumber () const

TString	GetDataSet () const

virtual TString	GetECodeMeaning (Int_t) const

const KVSeqCollection *	GetExtraRawDataSignals () const

const KVSeqCollection *	GetFiredDetectors () const

const KVSeqCollection *	GetFiredSignals () const

TGeoManager *	GetGeometry () const
	Return pointer to the (ROOT) geometry of the array. More...

virtual KVGroup *	GetGroup (const Char_t *) const
	Return pointer to group with name. More...

virtual KVGroup *	GetGroupWithAngles (Float_t, Float_t)

virtual KVGroup *	GetGroupWithDetector (const Char_t *)

virtual Int_t	GetIDCodeForParticlesStoppingInFirstStageOfTelescopes () const

virtual TString	GetIDCodeMeaning (Int_t) const

KVIDTelescope *	GetIDTelescope (const Char_t *name) const
	Return pointer to DeltaE-E ID Telescope with "name". More...

KVSeqCollection *	GetIDTelescopesWithType (const Char_t *type)

KVUniqueNameList *	GetIDTelescopeTypes ()

KVSeqCollection *	GetListOfIDTelescopes () const

KVGeoNavigator *	GetNavigator () const

Int_t	GetNumberOfGroups () const

virtual const Char_t *	GetPartSeedCond () const

virtual Double_t	GetPunchThroughEnergy (const Char_t *detector, Int_t Z, Int_t A)

KVNameValueList &	GetReconParameters ()

const KVNameValueList &	GetReconParameters () const

TList *	GetStatusOfIDTelescopes ()

KVTarget *	GetTarget ()

virtual Double_t	GetTargetEnergyLossCorrection (KVReconstructedNucleus *)

virtual KVTelescope *	GetTelescope (const Char_t *name) const
	Return pointer to telescope in array with name given by "name". More...

virtual Double_t	GetTotalSolidAngle (void) const

const TSeqCollection *	GetTrajectories () const

KVUpDater *	GetUpDater ()

Bool_t	HandledRawData () const

Bool_t	HandleRawDataBuffer (MFMBufferReader &)

Bool_t	IDParamsSet ()

void	init ()

Bool_t	IsBeingDeleted ()

virtual Bool_t	IsBuilt () const

Bool_t	IsRemoving ()

Bool_t	IsROOTGeometry () const

Bool_t	IsSimMode () const

void	MakeHistogramsForAllIDTelescopes (KVSeqCollection *list, Int_t dimension=100)

Bool_t	ParamsSet ()

void	prepare_to_handle_new_raw_data ()
	reset acquisition parameters etc. before reading new raw data event More...

void	PrintCalibStatusOfDetectors ()

void	PrintStatusOfIDTelescopes ()

Bool_t	ReadGridsFromAsciiFile (const Char_t *) const

virtual void	ReconstructEvent (KVReconstructedEvent , KVDetectorEvent )

void	RecursiveTrajectoryClustering (KVGeoDetectorNode *N, KVUniqueNameList &tried_trajectories, KVUniqueNameList &multitraj_nodes, KVUniqueNameList &detectors_of_group)

void	RemoveGroup (const Char_t *)

void	RemoveGroup (KVGroup *)

void	ReplaceDetector (const Char_t name, KVDetector new_kvd)

void	SetCurrentRunNumber (UInt_t r)

void	SetDetectorThicknesses ()

void	SetDetectorTransparency (Char_t)
	Modify the transparency of detector volumes in OpenGL view. More...

void	SetFilterType (Int_t t)

void	SetGeometry (TGeoManager *)

void	SetGridsInTelescopes (UInt_t run)

virtual void	SetIdentifications ()

virtual void	SetMinimumOKMultiplicity (KVEvent *) const

void	SetNavigator (KVGeoNavigator *geo)

virtual void	SetParameters (UInt_t n, Bool_t physics_parameters_only=kFALSE)

virtual void	SetPartSeedCond (const Char_t *cond)

virtual void	SetReconParametersInEvent (KVReconstructedEvent *) const
	Copy any parameters in fReconParameters in to the reconstructed event parameter list. More...

virtual void	SetROOTGeometry (Bool_t on=kTRUE)

virtual void	SetRunCalibrationParameters (UShort_t n)

virtual void	SetRunIdentificationParameters (UShort_t n)

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

	KVGeoStrucElement (const Char_t name, const Char_t type="")
	Create a geometry structure element with given name and type. More...

virtual	~KVGeoStrucElement ()
	Destructor. More...

virtual void	Add (KVBase *)

void	Clear (Option_t *opt="")
	Empty lists of detectors, daughter structures, and parent structures. More...

void	ClearDetectors (const Char_t *type="")

void	ClearStructures (const Char_t *type="")

virtual Bool_t	Contains (KVBase *name) const

virtual Bool_t	Fired (Option_t *opt="any") const

KVDetector *	GetDetector (const Char_t *name) const
	Return detector in this structure with given name. More...

KVDetector *	GetDetectorAny (const Char_t *name)

KVDetector *	GetDetectorByType (const Char_t *type) const
	Return detector in this structure with given type. More...

KVSeqCollection *	GetDetectors ()

const KVSeqCollection *	GetDetectors () const

KVSeqCollection *	GetDetectorTypeList (const Char_t *type) const

const KVSeqCollection *	GetParents () const

KVGeoStrucElement *	GetParentStructure (const Char_t type, const Char_t name="") const

KVGeoStrucElement *	GetStructure (const Char_t *name) const

KVGeoStrucElement *	GetStructure (const Char_t type, const Char_t name) const
	Get structure with type and name. More...

KVGeoStrucElement *	GetStructure (const Char_t *type, Int_t num) const
	Get structure with type and number. More...

const KVSeqCollection *	GetStructures () const

KVSeqCollection *	GetStructureTypeList (const Char_t *type) const

bool	OwnsDaughters () const

bool	OwnsDetectors () const

void	Print (Option_t *option="") const

virtual void	Remove (KVBase *)

void	SetOwnsDaughters (Bool_t yes=kTRUE)

void	SetOwnsDetectors (Bool_t yes=kTRUE)

void	Sort (Bool_t order=kSortAscending)

void	SortDetectors (Bool_t order=kSortAscending)

void	SortStructures (Bool_t order=kSortAscending)

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

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

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

virtual Int_t	Compare (const TObject *obj) const

virtual void	FillBuffer (char *&buffer)

virtual const char *	GetName () const

virtual const char *	GetTitle () const

virtual ULong_t	Hash () const

virtual Bool_t	IsSortable () const

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

TNamed &	operator= (const TNamed &rhs)

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

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

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

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)

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

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=0, Int_t option=0, Int_t bufsize=0)

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

Protected Member Functions
void	copy_fired_parameters_to_recon_param_list ()

Bool_t	handle_raw_data_event_mfmframe (const MFMCommonFrame &mfmframe)

void	init ()

virtual void	SetExpectedDetectorSignalNames ()

Protected Member Functions inherited from KVMultiDetArray
void	add_and_set_detector_signal (KVDetector *det, KVString detname, Double_t sig_data, KVString sig_type)

void	AddTrajectory (KVGeoDNTrajectory *d)

void	AssociateTrajectoriesAndNodes ()

virtual void	BuildGeometry ()

void	CalculateReconstructionTrajectories ()

void	DeduceGroupsFromTrajectories ()

virtual void	DeduceIdentificationTelescopesFromGeometry ()

virtual void	GetAlignedIDTelescopesForDetector (KVDetector det, TCollection list)

virtual UShort_t	GetBadIDCode ()

virtual UShort_t	GetCoherencyIDCode ()

TString	GetFileName (KVExpDB , const Char_t meth, const Char_t *keyw)

virtual Int_t	GetIDTelescopes (KVDetector , KVDetector , TCollection *list)

virtual void	GetIDTelescopesForGroup (KVGroup grp, TCollection tel_list)

std::unique_ptr< KVFileReader >	GetKVFileReader (KVExpDB db, const Char_t meth, const Char_t *keyw)

virtual UShort_t	GetMultiHitFirstStageIDCode ()

virtual UChar_t	GetNormalCalibrationCode ()

UShort_t	GetZminCode ()

virtual Bool_t	handle_raw_data_event_ebyedat (KVGANILDataReader &)
	General method for reading raw data in old GANIL ebyedat format. More...

virtual Bool_t	handle_raw_data_event_mfmfile (MFMBufferReader &)

virtual Bool_t	handle_raw_data_event_mfmframe_ebyedat (const MFMEbyedatFrame &)
	Read a raw data event from a EBYEDAT MFM Frame. More...

virtual Bool_t	handle_raw_data_event_mfmmergeframe (const MFMMergeFrameManager &)

virtual Bool_t	handle_raw_data_event_protobuf (KVProtobufDataReader &)

virtual void	MakeListOfDetectors ()

virtual void	PerformClosedROOTGeometryOperations ()

virtual void	PrepareModifGroup (KVGroup grp, KVDetector dd)

void	ReadCalibFile (const Char_t filename, KVExpDB db, KVDBTable *calib_table)

void	ReadCalibrationFiles (KVExpDB *db)

void	ReadOoODetectors (KVExpDB *db)

virtual void	RenumberGroups ()

void	set_detector_thicknesses (const TString &)

virtual void	set_up_single_stage_telescope (KVDetector det, KVIDTelescope idt, TCollection *l)
	Set up detector in single-stage identification telescope and add to fIDTelescopes and to l. More...

virtual void	set_up_telescope (KVDetector de, KVDetector e, KVIDTelescope idt, TCollection l)
	Set up detectors in de-e identification telescope and add to fIDTelescopes and to l. More...

virtual void	SetDetecting (KVDetector *det, Bool_t detecting=kTRUE)

virtual void	SetIDCodeForIDTelescope (KVIDTelescope *) const

virtual void	SetPresent (KVDetector *det, Bool_t present=kTRUE)

bool	try_a_doubleIDtelescope (TString uri, KVDetector de, KVDetector e, TCollection *l)

bool	try_a_singleIDtelescope (TString uri, KVDetector d, TCollection l)

int	try_all_doubleID_telescopes (KVDetector de, KVDetector e, TCollection *l)

int	try_all_singleID_telescopes (KVDetector d, TCollection l)

bool	try_upper_and_lower_doubleIDtelescope (TString uri, KVDetector de, KVDetector e, TCollection *l)

bool	try_upper_and_lower_singleIDtelescope (TString uri, KVDetector d, TCollection l)

Protected Member Functions inherited from KVGeoStrucElement
void	AddParentStructure (KVGeoStrucElement *)

void	RemoveParentStructure (KVGeoStrucElement *)

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
KVList	fMDAList
	list of multidetarrays More...

KVString	lmultidetarrayclasses

Protected Attributes inherited from KVMultiDetArray
KVNumberList	fAcceptECodes
	list of acceptable calibration codes for reconstructed nuclei More...

KVNumberList	fAcceptIDCodes
	list of acceptable identification codes for reconstructed nuclei More...

TList *	fCalibStatusDets
	used by GetStatusIDTelescopes More...

UInt_t	fCurrentRun
	Number of the current run used to call SetParameters. More...

TString	fDataSet
	name of associated dataset, used with MakeMultiDetector() More...

KVUniqueNameList	fExtraRawDataSignals
	any signals read from raw data not associated with a detector More...

Int_t	fFilterType
	type of filtering (used by DetectEvent) More...

KVUniqueNameList	fFiredDetectors
	list of fired detectors after reading raw data event More...

KVUnownedList	fFiredSignals
	list of fired signals after reading raw data event More...

Bool_t	fHandledRawData
	set to true if multidetector handles data in last call to HandleRawData More...

KVDetectorEvent *	fHitGroups
	list of hit groups in simulation More...

KVSeqCollection *	fIDTelescopes
	deltaE-E telescopes in groups More...

KVRangeTableGeoNavigator *	fNavigator
	for propagating particles through array geometry More...

TString	fPartSeedCond
	condition for seeding new reconstructed particles More...

KVRawDataReader *	fRawDataReader
	last raw data reader object used in call to HandleRawData More...

KVNameValueList	fReconParameters
	general purpose list of parameters for storing information on data reconstruction More...

Bool_t	fROOTGeometry
	=kTRUE use ROOT geometry More...

Bool_t	fSimMode
	=kTRUE in "simulation mode" (use for calculating response to simulated events) More...

TList *	fStatusIDTelescopes
	used by GetStatusIDTelescopes More...

KVTarget *	fTarget
	target used in experiment More...

KVUniqueNameList	fTrajectories
	list of all possible trajectories through detectors of array More...

KVUpDater *	fUpDater
	used to set parameters for multidetector More...

Protected Attributes inherited from KVGeoStrucElement
KVUniqueNameList	fDetectors
	detectors in this structure element More...

KVUniqueNameList	fParentStrucList
	parent structures More...

KVUniqueNameList	fStructures
	daughter structures More...

Protected Attributes inherited from KVBase
TString	fLabel
	label for the object More...

Protected Attributes inherited from TNamed
TString	fName

TString	fTitle

Protected Attributes inherited from TObject
	kOnlyPrepStep

Private Member Functions
void	for_each_array (const std::function< void(KVMultiDetArray )> &f, const std::function< bool(KVMultiDetArray )> &break_cond=[](KVMultiDetArray *) { return false;}) const

Additional Inherited Members
Public Types inherited from KVMultiDetArray
enum	EFilterType { kFilterType_Geo , kFilterType_GeoThresh , kFilterType_Full }
	filter types. values of fFilterType More...

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 KVMultiDetArray
static TGeoHMatrix *	GetVolumePositioningMatrix (Double_t distance, Double_t theta, Double_t phi, TGeoTranslation *postTrans=nullptr)

static KVMultiDetArray *	MakeMultiDetector (const Char_t *dataset_name, Int_t run=-1, TString classname="KVMultiDetArray")

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

Static Public Member Functions inherited from TObject
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 Types inherited from KVMultiDetArray
enum	{ kIsRemoving = BIT(14) , kParamsSet = BIT(15) , kIsBuilt = BIT(16) , kIsBeingDeleted = BIT(17) , kIDParamsSet = BIT(18) , kCalParamsSet = BIT(19) }

Static Protected Attributes inherited from KVMultiDetArray
static Bool_t	fBuildTarget = kFALSE

static Bool_t	fCloseGeometryNow = kTRUE

static Bool_t	fMakeMultiDetectorSetParameters = kTRUE

#include <KVExpSetUp.h>

Inheritance diagram for KVExpSetUp:

[legend]

Constructor & Destructor Documentation

◆ KVExpSetUp()

KVExpSetUp::KVExpSetUp ( )

Default constructor.

Definition at line 37 of file KVExpSetUp.cpp.

◆ ~KVExpSetUp()

KVExpSetUp::~KVExpSetUp ( )

virtual

Destructor.

Definition at line 48 of file KVExpSetUp.cpp.

Member Function Documentation

◆ AcceptAllECodes()

virtual void KVExpSetUp::AcceptAllECodes ( )

inlinevirtual

Calling this method disables any selection of "OK" reconstructed particles according to their calibration code status, for all arrays in the setup.

Reimplemented from KVMultiDetArray.

Definition at line 199 of file KVExpSetUp.h.

◆ AcceptAllIDCodes()

virtual void KVExpSetUp::AcceptAllIDCodes ( )

inlinevirtual

Calling this method disables any selection of "OK" reconstructed particles according to their identification code status, for all arrays in the setup.

Reimplemented from KVMultiDetArray.

Definition at line 189 of file KVExpSetUp.h.

◆ AcceptParticleForAnalysis()

void KVExpSetUp::AcceptParticleForAnalysis ( KVReconstructedNucleus * NUC ) const

virtual

Overrides KVMultiDetArray method We use the "ARRAY" parameter of the reconstructed particle (if set) to know which array of the setup detected it.

Reimplemented from KVMultiDetArray.

Definition at line 148 of file KVExpSetUp.cpp.

◆ Build()

void KVExpSetUp::Build ( Int_t run = -1 )

virtual

Build the combined arrays

The name of the setup will be "[det1]-[det2]-..." default ROOT geometry for all arrays

Reimplemented from KVMultiDetArray.

Definition at line 63 of file KVExpSetUp.cpp.

◆ CheckStatusOfDetectors()

void KVExpSetUp::CheckStatusOfDetectors	(	KVDBRun *	kvrun,
		const TString &	myname = `""`
	)

inlinevirtual

Sets status of detectors (KVDetector::IsPresent() and KVDetector::IsWorking()) for a given run of a dataset.

If 'myname' is given, we look in database table "myname.OoODets"

Check status (present, working) for all detectors for the run

Reimplemented from KVMultiDetArray.

Definition at line 179 of file KVExpSetUp.h.

◆ Clear()

void KVExpSetUp::Clear ( Option_t * opt = "" )

inlinevirtual

Reset all groups (lists of detected particles etc.) and detectors in groups (energy losses, ACQparams etc. etc.) and the target if there is one

call Clear(opt) for each multidetector in the setup

Reimplemented from KVMultiDetArray.

Definition at line 94 of file KVExpSetUp.h.

◆ copy_fired_parameters_to_recon_param_list()

void KVExpSetUp::copy_fired_parameters_to_recon_param_list ( )

inlineprotectedvirtual

values of fired raw data signals (acquisition parameters) from last read raw event are copied to the fReconParameters list of parameters to be stored with the reconstructed event.

the format for each signal is:

ACQPAR.[array].[detector].[signal] ACQPAR.[array].[signal]

in the first case for signals associated with detectors, in the latter case signals which are not associated with a detector

Reimplemented from KVMultiDetArray.

Definition at line 73 of file KVExpSetUp.h.

◆ FillDetectorList()

void KVExpSetUp::FillDetectorList	(	KVReconstructedNucleus *	rnuc,
		KVHashList *	DetList,
		const KVString &	DetNames
	)

inlinevirtual

Called when required to fill KVReconstructedNucleus::fDetList with pointers to the detectors whose names are stored in KVReconstructedNucleus::fDetNames.

Call FillDetectorList for each array in turn, until DetList gets filled This is because some arrays may override the KVMultiDetArray::FillDetectorList method

Reimplemented from KVMultiDetArray.

Definition at line 103 of file KVExpSetUp.h.

◆ for_each_array()

void KVExpSetUp::for_each_array	(	const std::function< void(KVMultiDetArray *)> &	f,
		const std::function< bool(KVMultiDetArray *)> &	break_cond = `[](KVMultiDetArray*) { return false; }`
	)		const

inlineprivate

perform the same function call f for each array in the setup

if break_cond is given, it is tested after each call to f, and if it returns true, we stop the loop

Definition at line 26 of file KVExpSetUp.h.

◆ GetArray()

virtual KVMultiDetArray* KVExpSetUp::GetArray ( const Char_t * name ) const

inlinevirtual

Return pointer to array in set up with given name

Reimplemented from KVMultiDetArray.

Definition at line 117 of file KVExpSetUp.h.

◆ GetArrayMultiplicities()

void KVExpSetUp::GetArrayMultiplicities	(	KVReconstructedEvent *	e,
		KVNameValueList &	m,
		Option_t *	opt = `""`
	)

Calculate multiplicities of particles in each array of the setup. They will appear in the KVNameValueList as parameters with the name of the array. e.g.

"INDRA" = 21 "FAZIA" = 3

Any option given will be used to determine the type of event iterator used - see KVEvent::GetNextParticleIterator(Option_t*).

Definition at line 181 of file KVExpSetUp.cpp.

◆ GetDetectorEvent()

void KVExpSetUp::GetDetectorEvent	(	KVDetectorEvent *	detev,
		const TSeqCollection *	fired_dets = `nullptr`
	)

inlinevirtual

First step in event reconstruction based on current status of detectors in array. Fills the given KVDetectorEvent with the list of all groups which have fired. i.e. loop over all groups of the array and test whether KVGroup::Fired() returns true or false.

If the list of fired detectors 'fired_dets' is given, then we use this list to find the associated groups. If not given, or if it is empty, we may use the internal fFiredDetectors list.

Call method detev->Clear() before reading another event in order to reset all of the hit groups (including all detectors etc.) and emptying the list.

Override KVMultiDetArray method Call each array in turn and add fired groups to the KVDetectorEvent

Reimplemented from KVMultiDetArray.

Definition at line 124 of file KVExpSetUp.h.

◆ GetReconstructorForGroup()

KVGroupReconstructor* KVExpSetUp::GetReconstructorForGroup ( const KVGroup * g ) const

inlinevirtual

Create and return pointer to new KVGroupReconstructor for reconstructing particles in the given group. Returns nullptr if group is not part of this array.

Plugins for specific arrays can be defined as plugins using the name of the array: +Plugin.KVGroupReconstructor: my_array my_group_reconstructor my_lib "my_group_reconstructor()"

Override KVMultiDetArray method Call each array in turn to get reconstructor for group

Reimplemented from KVMultiDetArray.

Definition at line 135 of file KVExpSetUp.h.

◆ handle_raw_data_event_mfmframe()

Bool_t KVExpSetUp::handle_raw_data_event_mfmframe ( const MFMCommonFrame & mfmframe )

inlineprotectedvirtual

Method used to treat raw data in MFM format read by KVMFMDataFileReader

Here we dispatch two types of frame - MFMEbyedatFrame & MFMMesytecMDPPFrame - to specific methods - handle_raw_data_event_mfmframe_ebyedat() and handle_raw_data_event_mfmframe_mesytec_mdpp() which need to be implemented in child classes for specific arrays which use these data formats.

Return kTRUE if raw data was treated

Handle single (not merged) MFM frames of raw data. It is assumed that each frame type corresponds to a different detector array. Therefore as soon as one of them treats the data in the frame, we return kTRUE.

Reimplemented from KVMultiDetArray.

Definition at line 52 of file KVExpSetUp.h.

◆ HandleRawDataEvent()

Bool_t KVExpSetUp::HandleRawDataEvent ( KVRawDataReader * rawdata )

virtual

Set fRawDataReader pointer in each sub-array and call prepare_to_handle_new_raw_data() for each sub-array, before treating raw data.

copy fired signals & detectors of sub-arrays to main lists

copy any reconstruction parameters from sub-arrays to main list

Reimplemented from KVMultiDetArray.

Definition at line 209 of file KVExpSetUp.cpp.

◆ init()

void KVExpSetUp::init ( void )

protected

Definition at line 21 of file KVExpSetUp.cpp.

◆ InitialiseRawDataReading()

void KVExpSetUp::InitialiseRawDataReading ( KVRawDataReader * r )

inlinevirtual

Call this method just after opening a raw data file in order to perform any necessary initialisations, depending on the type of data

Calls InitialiseRawDataReading() for each array of the setup in turn

Reimplemented from KVMultiDetArray.

Definition at line 220 of file KVExpSetUp.h.

◆ InitializeIDTelescopes()

virtual void KVExpSetUp::InitializeIDTelescopes ( )

inlinevirtual

Calls Initialize() method of each identification telescope (see KVIDTelescope and derived classes) and sets the general identification code defined for each telescope.

Calling this method is essential before identification of particles is attempted.

Override base method in order to set general identification codes for telescopes in each array

Reimplemented from KVMultiDetArray.

Definition at line 210 of file KVExpSetUp.h.

◆ MakeCalibrationTables()

void KVExpSetUp::MakeCalibrationTables ( KVExpDB * db )

inlinevirtual

We first look for a file with the name given by

[dataset].[name].OoODetectors: [name.OoODetectors.dat]

which should contain the runlists for each malfunctioning detector. If found we add to the experiment database a table '[name].OoO Detectors' where [name] is the name of this array.

Then we look for a file with the name given by

[dataset].[name].CalibrationFiles: [CalibrationFiles.dat]

which should contain the names of files to read with each type of calibration If found we add to the experiment database a table '[name].Calibrations' where [name] is the name of this array, containing all calibrations as KVDBParameterSet objects with the name of the detector concerned.

Reimplemented from KVMultiDetArray.

Definition at line 161 of file KVExpSetUp.h.

◆ SetCalibratorParameters()

void KVExpSetUp::SetCalibratorParameters	(	KVDBRun *	r,
		const TString &	myname = `""`
	)

inlinevirtual

Sets up calibrators for all detectors with a defined calibration for run Set parameters for all detectors with links to table "Calibrations" for run If 'myname' is given, we look in "myname.Calibrations" Reset all calibrators of all detectors first

Set calibrators for all detectors for the run

Reimplemented from KVMultiDetArray.

Definition at line 171 of file KVExpSetUp.h.

◆ SetExpectedDetectorSignalNames()

virtual void KVExpSetUp::SetExpectedDetectorSignalNames ( )

inlineprotectedvirtual

Detector signals corresponding to raw data acquisition parameters are typically only created and added to detectors when some raw data has been read including those parameters.

However, when reconstructing data, we may define identification matrices or calibration formulae which use these signals before starting to read data. Therefore we need to know beforehand what detector signals are expected to be available once data has been read.

These are defined, according to detector types, by variables of the form

[dataset].[array].[detector-type].ExpectedDetectorSignals: [comma-separated list of signal names]

type

int type

where [dataset] is optionally used to provide dataset-specific definitions.

Here we add a detector signal of each expected type to each detector of the array

Reimplemented from KVMultiDetArray.

Definition at line 81 of file KVExpSetUp.h.

◆ SetRawDataFromReconEvent()

void KVExpSetUp::SetRawDataFromReconEvent ( KVNameValueList & l )

inlinevirtual

Take values 'ACQPAR.[array_name].[detname].[signal]' or 'ACQPAR.[array_name].[signal]' in the parameter list and use them to set values of raw acquisition parameters.

Any detector signals which don't already exist will be created

Reimplemented from KVMultiDetArray.

Definition at line 151 of file KVExpSetUp.h.

◆ SetSimMode()

virtual void KVExpSetUp::SetSimMode ( Bool_t on = kTRUE )

inlinevirtual

Set simulation mode of each array

Reimplemented from KVMultiDetArray.

Definition at line 230 of file KVExpSetUp.h.

◆ SetTarget()

virtual void KVExpSetUp::SetTarget ( KVTarget * target )

inlinevirtual

Set target both for the overall combined array and each individual array

Reimplemented from KVMultiDetArray.

Definition at line 239 of file KVExpSetUp.h.

Member Data Documentation

◆ fMDAList

KVList KVExpSetUp::fMDAList

protected

list of multidetarrays

Definition at line 46 of file KVExpSetUp.h.

◆ lmultidetarrayclasses

KVString KVExpSetUp::lmultidetarrayclasses

protected

Definition at line 47 of file KVExpSetUp.h.

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

kaliveda.doxygen/KVMultiDet/exp_events/KVExpSetUp.h
kaliveda.doxygen/KVMultiDet/exp_events/KVExpSetUp.cpp

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Additional Inherited Members

Constructor & Destructor Documentation

◆ KVExpSetUp()

◆ ~KVExpSetUp()

Member Function Documentation

◆ AcceptAllECodes()

◆ AcceptAllIDCodes()

◆ AcceptParticleForAnalysis()

◆ Build()

◆ CheckStatusOfDetectors()

◆ Clear()

◆ copy_fired_parameters_to_recon_param_list()

◆ FillDetectorList()

◆ for_each_array()

◆ GetArray()

◆ GetArrayMultiplicities()

◆ GetDetectorEvent()

◆ GetReconstructorForGroup()

◆ handle_raw_data_event_mfmframe()

◆ HandleRawDataEvent()

◆ init()

◆ InitialiseRawDataReading()

◆ InitializeIDTelescopes()

◆ MakeCalibrationTables()

◆ SetCalibratorParameters()

◆ SetExpectedDetectorSignalNames()

◆ SetRawDataFromReconEvent()

◆ SetSimMode()

◆ SetTarget()

Member Data Documentation

◆ fMDAList

◆ lmultidetarrayclasses