Detailed Description

Identification grids for ChIo-Si telescopes of INDRA.

Z-only identification grids for INDRA Ionisation chamber-Silicon telescopes. To identify a particle with this grid, do:

if( grid->IsIdentifiable(x,y) ){
       grid->Identify(x,y,nuc);
}

After attempting identification with method Identify(), GetQualityCode() method returns one of the following status codes:

KVIDZAGrid::kICODE0,                   OK
KVIDZAGrid::kICODE1,                   slight ambiguity of Z, which could be larger
KVIDZAGrid::kICODE2,                   slight ambiguity of Z, which could be smaller
KVIDZAGrid::kICODE3,                   slight ambiguity of Z, which could be larger or smaller
KVIDZAGrid::kICODE4,                   point is in between two lines of different Z, too far from either to be considered well-identified
KVIDZAGrid::kICODE5,                   point is in between two lines of different Z, too far from either to be considered well-identified
KVIDZAGrid::kICODE6,                   (x,y) is below first line in grid
KVIDZAGrid::kICODE7,                   (x,y) is above last line in grid
KVIDZAGrid::kICODE8,                   no identification: (x,y) out of range covered by grid
KVIDGChIoSi::k_BelowPunchThrough   "warning: point below punch-through line",
KVIDGChIoSi::k_BelowSeuilSi      "point to identify left of Si threshold line (bruit/arret ChIo?)",
KVIDGChIoSi::k_LeftOfBragg       "point to identify below Bragg curve. Z given is a Zmin",
KVIDGChIoSi::k_RightOfEmaxSi         "point to identify has E_Si > Emax_Si i.e. codeur is saturated. Unidentifiable",

Correctly-identified particles with no ambiguity have quality codes < KVIDZAGrid::kICODE4.

Particles with quality code KVIDGChIoSi::k_BelowPunchThrough are also in principle correctly identified, but we give a warning that the point is below the line 'Punch_through' delimiting the region in which the identification lines can be mixed with particles punching through the silicon if no additional condition is placed on e.g. the CsI detector behind the silicon not firing.

Particles with quality code KVIDGChIoSi::k_LeftOfBragg are below the Bragg curve and the Z attributed is a minimum value.

Particles with code KVIDZAGrid::kICODE7 are (far) above the last line of the grid, their Z is also a minimum.

Definition at line 62 of file KVIDGChIoSi.h.

#include <KVIDGChIoSi.h>

Inheritance diagram for KVIDGChIoSi:

[legend]

Public Types
enum	{ k_BelowPunchThrough = KVIDZAGrid::kICODE10 + 1 , k_BelowSeuilSi , k_LeftOfBragg , k_RightOfEmaxSi }

Public Types inherited from KVIDZAGrid
enum	{ kICODE0 , kICODE1 , kICODE2 , kICODE3 , kICODE4 , kICODE5 , kICODE6 , kICODE7 , kICODE8 , kICODE9 , kICODE10 }

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

	KVIDGChIoSi (TString pattern)
	constructor with a pattern More...

virtual	~ KVIDGChIoSi ()

KVIDLine *	GetBraggLine ()

KVIDLine *	GetEmaxSiLine ()

KVIDLine *	GetPunchThroughLine ()

KVIDLine *	GetSeuilSiLine ()

virtual void	Identify (Double_t x, Double_t y, KVIdentificationResult *) const

virtual void	Initialize ()

virtual Bool_t	IsIdentifiable (Double_t x, Double_t y, TString *rejected_by=nullptr) const

Public Member Functions inherited from KVIDZAGrid
	KVIDZAGrid ()
	default ctor. More...

	KVIDZAGrid (const KVIDZAGrid &)
	Copy constructor. More...

virtual	~ KVIDZAGrid ()

virtual void	CalculateLineWidths ()

virtual void	Copy (TObject &) const
	Copy this to 'obj'. More...

virtual TClass *	DefaultIDLineClass ()

void	DrawLinesWithWidth ()

KVIDLine *	GetClosestLine () const

Double_t	GetDistanceClosestLine () const

UChar_t	GetIndexClosest () const

Int_t	GetQualityCode () const

virtual KVIDZALine *	GetZALine (Int_t z, Int_t a, Int_t &) const

virtual KVIDZALine *	GetZLine (Int_t z, Int_t &) const

Int_t	GetZmax () const

KVIDZALine *	GetZmaxLine () const

virtual void	IdentZ (Double_t x, Double_t y, Double_t &Z)

virtual void	IdentZA (Double_t x, Double_t y, Int_t &Z, Double_t &A)

KVIDGraph *	MakeSubsetGraph (Int_t Zmin, Int_t Zmax, const Char_t *="")
	virtual void MakeEDeltaEZGrid(Int_t Zmin, Int_t Zmax, Int_t npoints=20, Double_t gamma = 2);//MENU More...

KVIDGraph *	MakeSubsetGraph (TList , TClass =0)

void	ReCheckQuality (Int_t &Z, Double_t &A)

void	RemoveLine (Int_t Z, Int_t A=-1)
	Remove and destroy identifier. More...

void	RemoveZLines (const Char_t *ZList)
	Remove and destroy identifiers. More...

void	SetManualWidth (Double_t manual_width=.3, Double_t manual_width_scaling=0.05)

void	SetVarXVarY (const char VarX, const char VarY)

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

virtual	~ KVIDGrid ()

virtual TClass *	DefaultOKLineClass ()

KVIDLine *	FindNearestEmbracingIDLine (Double_t x, Double_t y, const Char_t position, const Char_t axis, Int_t &idx, Int_t &idx_min, Int_t &idx_max, Double_t &dist, Double_t &dist_min, Double_t &dist_max) const

KVIDLine *	FindNearestIDLineFast (Double_t x, Double_t y, const Char_t *position, Int_t &idx, Int_t &idx_min, Int_t &idx_max, Double_t &dist, Double_t &dist_min, Double_t &dist_max) const

KVIDLine *	FindNextEmbracingLine (Int_t &index, Int_t inc_index, Double_t x, Double_t y, const Char_t *axis) const

Int_t	GetIDLinesEmbracingPoint (const Char_t *direction, Double_t x, Double_t y) const

KVIDLine *	NewLine (const Char_t *idline_class="")

Public Member Functions inherited from KVIDGraph
	KVIDGraph ()

	KVIDGraph (const KVIDGraph &)
	Copy constructor. More...

virtual	~KVIDGraph ()

virtual Bool_t	AcceptIDForTest (const KVIdentificationResult &idr)

void	Add (TString, KVIDentifier *)

KVIDentifier *	Add (TString, TString)

virtual void	AddCut (KVIDentifier *cut)

virtual void	AddIdentifier (KVIDentifier *id)

void	AddIDTelescope (KVBase *t)

void	AddIDTelescopes (const TList *)
	Associate this graph with all ID telescopes in list. More...

virtual void	AddInfo (KVIDentifier *info)

void	AddParameter (char Name, char Value)

virtual Int_t	CheckVersion (Int_t version)

virtual void	Clear (Option_t *opt="")

void	ClearListOfTelescopes ()

void	ClearPad (TVirtualPad *)

virtual void	Delete (Option_t *option="")

void	Draw (Option_t *opt="")

virtual void	DrawAndAdd (const Char_t type="ID", const Char_t classname="KVIDentifier")

virtual void	DrawClass () const

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

virtual void	DrawPanel ()

virtual void	Dump () const

virtual Bool_t	ExistVersion (Int_t version)

void	ExtendBeginningAllIdentLines (Double_t, Option_t *="")

void	ExtendEndAllIdentLines (Double_t, Option_t *="")

void	FindAxisLimits ()
	Calculate X/Y min/max of all objects in graph. More...

virtual TFitResultPtr	Fit (const char formula, Option_t option="", Option_t *goption="", Axis_t xmin=0, Axis_t xmax=0)

virtual TFitResultPtr	Fit (TF1 f1, Option_t option="", Option_t *goption="", Axis_t xmin=0, Axis_t xmax=0)

virtual void	FitPanel ()
	virtual void SetTitle(const char *title="") {TGraph::SetTitle(title);}; More...

KVIDentifier *	GetCut (const Char_t *name) const

KVList *	GetCuts ()

const KVList *	GetCuts () const

KVIDentifier *	GetIdentifier (const Char_t *name) const

KVIDentifier *	GetIdentifier (Int_t Z, Int_t A) const

KVIDentifier *	GetIdentifierAt (Int_t index) const

KVList *	GetIdentifiers ()

const KVList *	GetIdentifiers () const

const Char_t *	GetIDTelescopeLabel () const

const TList *	GetIDTelescopes () const

KVIDentifier *	GetInfo (const Char_t *name) const

KVList *	GetInfos ()

const KVList *	GetInfos () const

KVIDGraph *	GetLastSavedVersion () const

Int_t	GetMassFormula () const

const Char_t *	GetName () const

const Char_t *	GetNamesOfIDTelescopes () const

Int_t	GetNumberOfCuts () const

Int_t	GetNumberOfIdentifiers () const

Int_t	GetNumberOfInfos () const

TVirtualPad *	GetPad () const

KVNameValueList *	GetParameters ()

const KVNameValueList *	GetParameters () const

TString	GetPattern (void)

const Char_t *	GetRunList () const

const KVNumberList &	GetRuns () const

Axis_t	GetXmax () const

Axis_t	GetXmin () const

Double_t	GetXScaleFactor ()

Axis_t	GetYmax () const

Axis_t	GetYmin () const

Double_t	GetYScaleFactor ()

Bool_t	HandlesIDTelescope (KVBase *t) const

virtual Bool_t	HasMassIDCapability () const

void	Increment (Float_t x)

virtual Int_t	InsertPoint ()

virtual void	Inspect () const

TVirtualPad *	IsDrawn () const

Bool_t	IsSorted () const

void	Modified ()

void	Print (Option_t *opt="") const
	Print out all objects in graph. More...

void	ReadAsciiFile (const Char_t *filename)

virtual void	ReadAsciiFile_WP (Int_t version=-1)
	lecture des grilles avec version suivant un modele de fichier More...

virtual void	ReadFromAsciiFile (std::ifstream &gridfile)

void	RemoveCut (KVIDentifier *)
	Remove and destroy cut. More...

void	RemoveIdentifier (KVIDentifier *)
	Remove and destroy identifier. More...

void	RemoveIDTelescope (KVBase *t)

void	RemoveInfo (KVIDentifier *)
	Remove and destroy cut. More...

virtual Int_t	RemovePoint ()

virtual Int_t	RemovePoint (Int_t i)

void	ResetDraw ()

void	ResetPad ()

void	RevertToLastSavedVersion ()

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

void	Scale (TF1 sx, TF1 sy)

virtual void	SetDrawOption (Option_t *option="")

virtual void	SetEditable (Bool_t editable=kTRUE)

virtual void	SetFillAttributes ()

virtual void	SetInfos (Double_t, Double_t, KVIdentificationResult *) const
	loop over KVIDGraph::fInfoZones to set flags in KVIdentificationResult More...

virtual void	SetLineAttributes ()

void	SetLineColor (Color_t lcolor)

void	SetLineStyle (Style_t lstyle)

void	SetLineWidth (Width_t lwidth)

virtual void	SetMarkerAttributes ()

void	SetMassFormula (Int_t)

virtual void	SetMassIDCapability (Bool_t yes=kTRUE)

virtual void	SetMaximum (Double_t maximum=-1111)

virtual void	SetMinimum (Double_t minimum=-1111)

virtual void	SetName (const char *name)

virtual void	SetOnlyZId (Bool_t yes=kTRUE)

void	SetPattern (TString pattern)

void	SetRunList (const char *runlist)

void	SetRuns (const KVNumberList &nl)
	Set list of runs for which grid is valid. More...

virtual void	SetVarX (const char *v)

virtual void	SetVarY (const char *v)

void	SetXScaleFactor (Double_t=0)

void	SetXVariable (const char *v)
	void SetIDTelescopes();// MENU={Hierarchy="Set.../ID Telescopes"} More...

void	SetYScaleFactor (Double_t=0)

void	SetYVariable (const char *v)

void	SortIdentifiers ()

virtual void	TestIdentification (TH2F *data, KVHashList &histos, KVNameValueList &histo_names)

void	UnDraw ()

void	UpdateLastSavedVersion ()
	update last saved version. mkae copy of current state of graph. More...

void	WriteAsciiFile (const Char_t *filename)
	Open, write and close ascii file containing this grid. More...

virtual void	WriteAsciiFile_WP (Int_t version=-1)

virtual void	WriteToAsciiFile (std::ofstream &gridfile)

Private Member Functions
void	BackwardsCompatibilityFix ()

void	init ()

Private Attributes
KVIDLine *	fBragg
	bragg line More...

KVIDLine *	fEmaxSi
	saturation codeur silicon More...

KVIDLine *	fPunch
	punch-through line More...

KVIDLine *	fSeuil
	seuil silicium line More...

Additional Inherited Members
Static Public Member Functions inherited from KVIDGraph
static KVIDGraph *	AddGraphs (KVIDGraph g1, Int_t id1_min, Int_t id1_max, KVIDGraph g2, Int_t id2_min, Int_t id2_max)

static Bool_t	GetAutoAdd ()

static KVIDGraph *	MakeIDGraph (const Char_t *)

static void	SetAutoAdd (Bool_t yes=kTRUE)

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Enumerator
k_BelowPunchThrough
k_BelowSeuilSi
k_LeftOfBragg
k_RightOfEmaxSi

Definition at line 76 of file KVIDGChIoSi.h.

Constructor & Destructor Documentation

◆ KVIDGChIoSi() [1/2]

KVIDGChIoSi::KVIDGChIoSi ( )

Default constructor.

Definition at line 24 of file KVIDGChIoSi.cpp.

◆ KVIDGChIoSi() [2/2]

KVIDGChIoSi::KVIDGChIoSi ( TString pattern )

constructor with a pattern

Definition at line 35 of file KVIDGChIoSi.cpp.

◆ ~ KVIDGChIoSi()

virtual KVIDGChIoSi::~ KVIDGChIoSi ( )

virtual

Member Function Documentation

◆ BackwardsCompatibilityFix()

void KVIDGChIoSi::BackwardsCompatibilityFix ( )

privatevirtual

Called after reading a grid from an ascii file. Tries to convert information written by an old version of the class:

PARAMETER> Ring min=... -—> <PARAMETER> IDTelescopes=... PARAMETER> Ring max=... PARAMETER> Mod min=... PARAMETER> Mod max=...

Reimplemented from KVIDGraph.

Definition at line 157 of file KVIDGChIoSi.cpp.

◆ GetBraggLine()

KVIDLine* KVIDGChIoSi::GetBraggLine ( )

inline

Definition at line 92 of file KVIDGChIoSi.h.

◆ GetEmaxSiLine()

KVIDLine* KVIDGChIoSi::GetEmaxSiLine ( )

inline

Definition at line 100 of file KVIDGChIoSi.h.

◆ GetPunchThroughLine()

KVIDLine* KVIDGChIoSi::GetPunchThroughLine ( )

inline

Definition at line 96 of file KVIDGChIoSi.h.

◆ GetSeuilSiLine()

KVIDLine* KVIDGChIoSi::GetSeuilSiLine ( )

inline

Definition at line 88 of file KVIDGChIoSi.h.

◆ Identify()

void KVIDGChIoSi::Identify	(	Double_t	x,
		Double_t	y,
		KVIdentificationResult *	idr
	)		const

virtual

After identification of the particle, we adjust the quality code (if the particle was well-identified by KVIDZAGrid::Identify, i.e. with fICode<KVIDZAGrid::kICODE4) if: the particle is below the 'Bragg_line' => quality code KVIDGChIoSi::k_LeftOfBragg in this case the Z given is a minimum value the particle is below the 'Punch_through' line => quality code KVIDGChIoSi::k_BelowPunchThrough, but the particle is in principle well identified, if a condition has been applied to make sure that the detector behind the silicon (i.e. CsI) did not fire.

Reimplemented from KVIDZAGrid.

Definition at line 218 of file KVIDGChIoSi.cpp.

◆ init()

void KVIDGChIoSi::init ( void )

private

default initialisations SetOnlyZId(kTRUE) is called

Definition at line 48 of file KVIDGChIoSi.cpp.

◆ Initialize()

void KVIDGChIoSi::Initialize ( void )

virtual

General initialisation method for identification grid. This method MUST be called once before using the grid for identifications. The ID lines are sorted. The natural line widths of all ID lines are calculated. The line with the largest Z (Zmax line) is found. Pointers to different 'OK lines' are initialised

Reimplemented from KVIDZAGrid.

Definition at line 129 of file KVIDGChIoSi.cpp.

◆ IsIdentifiable()

Bool_t KVIDGChIoSi::IsIdentifiable	(	Double_t	x,
		Double_t	y,
		TString *	rejected_by = `nullptr`
	)		const

virtual

Sets fStatus for particle depending on its position in the grid.

Returns kTRUE if the particle corresponding to point (x=esi,y=echio) in the ChIo-Si map is identifiable i.e. if it is contained within the region delimited by

the line indicating the limit of particles stopping in the ChIo (KVIDCutLine:"Seuil_Si", accpeted:"right")
the line indicating the maximum canal/energy Silicium before saturation (KVIDCutLine:"Emax_Si", accepted:"left") Particles which do not satisfy one of the following cuts:
the line indicating the lower limit of Z identification, or Bragg curve (KVIDCutLine:"Bragg_line", accepted:"right")
the line indicating the limit of particles punching through to the CsI (KVIDCutLine:"Punch_through", accepted:"above") are identified with a quality code warning.

Reimplemented from KVIDGraph.

Definition at line 83 of file KVIDGChIoSi.cpp.

Member Data Documentation

◆ fBragg

KVIDLine* KVIDGChIoSi::fBragg

private

bragg line

Definition at line 66 of file KVIDGChIoSi.h.

◆ fEmaxSi

KVIDLine* KVIDGChIoSi::fEmaxSi

private

saturation codeur silicon

Definition at line 69 of file KVIDGChIoSi.h.

◆ fPunch

KVIDLine* KVIDGChIoSi::fPunch

private

punch-through line

Definition at line 67 of file KVIDGChIoSi.h.

◆ fSeuil

KVIDLine* KVIDGChIoSi::fSeuil

private

seuil silicium line

Definition at line 68 of file KVIDGChIoSi.h.

Detailed Description

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Member Enumeration Documentation

◆ anonymous enum

Constructor & Destructor Documentation

◆ KVIDGChIoSi() [1/2]

◆ KVIDGChIoSi() [2/2]

◆ ~ KVIDGChIoSi()

Member Function Documentation

◆ BackwardsCompatibilityFix()

◆ GetBraggLine()

◆ GetEmaxSiLine()

◆ GetPunchThroughLine()

◆ GetSeuilSiLine()

◆ Identify()

◆ init()

◆ Initialize()

◆ IsIdentifiable()

Member Data Documentation

◆ fBragg

◆ fEmaxSi

◆ fPunch

◆ fSeuil