Detailed Description

Interface to Range dE/dx and range library.

This is a modified version of the Range package developed by Ricardo Yanez. See here for details.

Modifications concern:

corrected calculation of Northcliffe-Schilling ranges
modified stopping extrapolation for gases in Hubert-Bimbot-Gauvin table

Definition at line 26 of file KVRangeYanez.h.

#include <KVRangeYanez.h>

Inheritance diagram for KVRangeYanez:

[legend]

Public Member Functions
	KVRangeYanez ()

	KVRangeYanez (const KVRangeYanez &)

virtual	~KVRangeYanez ()

virtual KVIonRangeTableMaterial *	AddCompoundMaterial (const Char_t name, const Char_t symbol, Int_t nelem, Int_t z, Int_t a, Int_t *natoms, Double_t density=-1.0) const

virtual KVIonRangeTableMaterial *	AddElementalMaterial (Int_t z, Int_t a=0) const

virtual KVIonRangeTableMaterial *	AddMixedMaterial (const Char_t name, const Char_t symbol, Int_t nelem, Int_t z, Int_t a, Int_t natoms, Double_t weight, Double_t density=-1.0) const

Bool_t	CheckIon (Int_t, Int_t) const

void	Copy (TObject &) const

TObjArray *	GetListOfMaterials ()

KVIonRangeTableMaterial *	MakeNaturallyOccuringElementMixture (Int_t z, Int_t &a) const

void	Print (Option_t *="") const

Bool_t	ReadMaterials (const Char_t *filename) const
	Read materials from file whose name is given. More...

Public Member Functions inherited from KVIonRangeTable
	KVIonRangeTable (const Char_t name="", const Char_t title="")
	Default constructor. More...

virtual	~KVIonRangeTable ()
	Destructor. More...

virtual Double_t	GetAtomicMass (const Char_t *)
	Returns atomic mass of a material in the range tables. More...

virtual Double_t	GetDeltaEFromEResOfIon (const Char_t *mat, Int_t Z, Int_t A, Double_t ERes, Double_t e, Double_t isoAmat=0., Double_t T=-1., Double_t P=-1.)

virtual Double_t	GetDeltaEOfIon (const Char_t *mat, Int_t Z, Int_t A, Double_t E, Double_t r, Double_t Amat=0., Double_t T=-1., Double_t P=-1.)

virtual Double_t	GetDensity (const Char_t *)
	Returns density (g/cm**3) of a material in the range tables. More...

virtual Double_t	GetEIncFromDeltaEOfIon (const Char_t *mat, Int_t Z, Int_t A, Double_t DeltaE, Double_t e, enum SolType type=kEmax, Double_t isoAmat=0., Double_t T=-1., Double_t P=-1.)

virtual Double_t	GetEIncFromEResOfIon (const Char_t *mat, Int_t Z, Int_t A, Double_t Eres, Double_t e, Double_t isoAmat=0., Double_t T=-1., Double_t P=-1.)

virtual Double_t	GetEIncOfMaxDeltaEOfIon (const Char_t *mat, Int_t Z, Int_t A, Double_t e, Double_t isoAmat=0., Double_t T=-1., Double_t P=-1.)

virtual Double_t	GetEmaxValid (const Char_t *material, Int_t Z, Int_t A)

virtual Double_t	GetEResOfIon (const Char_t *mat, Int_t Z, Int_t A, Double_t E, Double_t r, Double_t Amat=0., Double_t T=-1., Double_t P=-1.)

virtual Double_t	GetLinearDeltaEFromEResOfIon (const Char_t *mat, Int_t Z, Int_t A, Double_t ERes, Double_t e, Double_t isoAmat=0., Double_t T=-1., Double_t P=-1.)

virtual Double_t	GetLinearDeltaEOfIon (const Char_t *mat, Int_t Z, Int_t A, Double_t E, Double_t d, Double_t Amat=0., Double_t T=-1., Double_t P=-1.)

virtual Double_t	GetLinearEIncFromDeltaEOfIon (const Char_t *mat, Int_t Z, Int_t A, Double_t DeltaE, Double_t e, enum SolType type=kEmax, Double_t isoAmat=0., Double_t T=-1., Double_t P=-1.)

virtual Double_t	GetLinearEIncFromEResOfIon (const Char_t *mat, Int_t Z, Int_t A, Double_t Eres, Double_t e, Double_t isoAmat=0., Double_t T=-1., Double_t P=-1.)

virtual Double_t	GetLinearEIncOfMaxDeltaEOfIon (const Char_t *mat, Int_t Z, Int_t A, Double_t e, Double_t isoAmat=0., Double_t T=-1., Double_t P=-1.)

virtual Double_t	GetLinearEResOfIon (const Char_t *mat, Int_t Z, Int_t A, Double_t E, Double_t d, Double_t Amat=0., Double_t T=-1., Double_t P=-1.)

virtual Double_t	GetLinearMaxDeltaEOfIon (const Char_t *mat, Int_t Z, Int_t A, Double_t e, Double_t isoAmat=0., Double_t T=-1., Double_t P=-1.)

virtual Double_t	GetLinearPunchThroughEnergy (const Char_t *mat, Int_t Z, Int_t A, Double_t e, Double_t isoAmat=0., Double_t T=-1., Double_t P=-1.)

virtual Double_t	GetLinearRangeOfIon (const Char_t *mat, Int_t Z, Int_t A, Double_t E, Double_t Amat=0., Double_t T=-1., Double_t P=-1.)

KVIonRangeTableMaterial *	GetMaterial (const Char_t *material) const
	Returns pointer to material of given name or type. More...

KVIonRangeTableMaterial *	GetMaterial (TGeoMaterial *) const

virtual const Char_t *	GetMaterialName (const Char_t *)
	Return name of material of given type or name if it is in range tables. More...

virtual Double_t	GetMaxDeltaEOfIon (const Char_t *mat, Int_t Z, Int_t A, Double_t e, Double_t isoAmat=0., Double_t T=-1., Double_t P=-1.)

virtual Double_t	GetPunchThroughEnergy (const Char_t *mat, Int_t Z, Int_t A, Double_t e, Double_t isoAmat=0., Double_t T=-1., Double_t P=-1.)

virtual Double_t	GetRangeOfIon (const Char_t *mat, Int_t Z, Int_t A, Double_t E, Double_t Amat=0., Double_t T=-1., Double_t P=-1.)

virtual TGeoMaterial *	GetTGeoMaterial (const Char_t *material)
	Create and return pointer to TGeoMaterial/Mixture corresponding to material. More...

virtual Double_t	GetZ (const Char_t *)
	Returns atomic number of a material in the range tables. More...

virtual Bool_t	IsMaterialGas (const Char_t *)
	Return kTRUE if material is gaseous. More...

virtual Bool_t	IsMaterialKnown (const Char_t *)
	Return kTRUE if material is in range tables. More...

virtual Bool_t	IsMaterialKnown (TGeoMaterial *)
	Returns kTRUE if material corresponding to TGeoMaterial name or type is in range table. More...

virtual void	SetTemperatureAndPressure (const Char_t *, Double_t temperature, Double_t pressure)

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

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)

Private Member Functions
void	CheckMaterialsList () const

KVIonRangeTableMaterial *	GetMaterialWithNameOrType (const Char_t *material) const

void	SaveMaterial (KVIonRangeTableMaterial *mat) const

Private Attributes
Bool_t	fDoNotSaveMaterials

TString	fLocalMaterialsDirectory

Static Private Attributes
static KVHashList *	fMaterials = 0x0
	static list of all currently defined materials More...

Additional Inherited Members
Public Types inherited from KVIonRangeTable
enum	SolType { kEmax , kEmin }

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

Static Public Member Functions inherited from KVIonRangeTable
static KVIonRangeTable *	GetRangeTable (const Char_t *name)
	Generates an instance of the KVIonRangeTable plugin class corresponding to given name. More...

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

◆ KVRangeYanez() [1/2]

KVRangeYanez::KVRangeYanez ( )

Default constructor

Predefined materials are created based on the contents of the file(s) whose names are given as values of the variable RANGE.PredefMaterials

A default file is specified in the main .kvrootrc file.

If you want to add your own definitions, just put in your .kvrootrc file:

+RANGE.PredefMaterials: myfile1.dat

+RANGE.PredefMaterials: myfile2.dat

If you want to override the default definitions:

RANGE.PredefMaterials: myfile1.dat

+RANGE.PredefMaterials: myfile2.dat

Definition at line 41 of file KVRangeYanez.cpp.

◆ KVRangeYanez() [2/2]

KVRangeYanez::KVRangeYanez ( const KVRangeYanez & obj )

Definition at line 93 of file KVRangeYanez.cpp.

◆ ~KVRangeYanez()

virtual KVRangeYanez::~KVRangeYanez ( )

inlinevirtual

Definition at line 39 of file KVRangeYanez.h.

Member Function Documentation

◆ AddCompoundMaterial()

KVIonRangeTableMaterial * KVRangeYanez::AddCompoundMaterial	(	const Char_t *	name,
		const Char_t *	symbol,
		Int_t	nelem,
		Int_t *	z,
		Int_t *	a,
		Int_t *	natoms,
		Double_t	density = `-1.0`
	)		const

virtual

Adds a compound material with a simple formula composed of different elements

Parameters

[in]	name	name for the new compound (no spaces)
[in]	symbol	chemical symbol for compound
[in]	nelem	number of elements in compound
[in]	z[nelem]	atomic numbers of elements
[in]	a[nelem]	mass numbers of elements
[in]	natoms[nelem]	number of atoms of each element
[in]	density	in $g/cm^{3}$, only required if compound is a solid

Reimplemented from KVIonRangeTable.

Definition at line 259 of file KVRangeYanez.cpp.

◆ AddElementalMaterial()

KVIonRangeTableMaterial * KVRangeYanez::AddElementalMaterial	(	Int_t	z,
		Int_t	a = `0`
	)		const

virtual

Adds a material composed of a single chemical element.

Parameters

[in]	z	atomic number $Z$ of element
[in]	a	[optional] mass number $A$ of isotope

If the mass number of the isotope $A$ is not specified, we create a material containing the naturally occuring isotopes of the given element, weighted according to natural abundance.

If the mass is given, the material name will be "Xxx-A" where Xxx is the name of the element

e.g. "Calcium-48", "Tin-124", etc.

Otherwise, we just use the element symbol and name for naturally-occurring mixtures of atomic elements ("Ca", "Calcium", etc.).

Reimplemented from KVIonRangeTable.

Definition at line 203 of file KVRangeYanez.cpp.

◆ AddMixedMaterial()

KVIonRangeTableMaterial * KVRangeYanez::AddMixedMaterial	(	const Char_t *	name,
		const Char_t *	symbol,
		Int_t	nelem,
		Int_t *	z,
		Int_t *	a,
		Int_t *	natoms,
		Double_t *	proportion,
		Double_t	density = `-1.0`
	)		const

virtual

Adds a material which is a mixture of either elements or compounds:

Parameters

[in]	name	name for the new mixture (no spaces)
[in]	symbol	chemical symbol for mixture
[in]	nelem	number of elements in mixture
[in]	z[nelem]	atomic numbers of elements
[in]	a[nelem]	mass numbers of elements
[in]	natoms[nelem]	number of atoms of each element
[in]	proportion[nelem]	proportion by mass in mixture of element
[in]	density	in $g/cm^{3}$, if mixture is a solid

Reimplemented from KVIonRangeTable.

Definition at line 301 of file KVRangeYanez.cpp.

◆ CheckIon()

Bool_t KVRangeYanez::CheckIon	(	Int_t	,
		Int_t
	)		const

inlinevirtual

Reimplemented from KVIonRangeTable.

Definition at line 52 of file KVRangeYanez.h.

◆ CheckMaterialsList()

void KVRangeYanez::CheckMaterialsList ( ) const

private

Definition at line 178 of file KVRangeYanez.cpp.

◆ Copy()

void KVRangeYanez::Copy ( TObject & obj ) const

virtual

Reimplemented from KVBase.

Definition at line 103 of file KVRangeYanez.cpp.

◆ GetListOfMaterials()

TObjArray * KVRangeYanez::GetListOfMaterials ( )

virtual

Create and fill a list of all materials for which range tables exist.

Each entry is a TNamed with the name and type (title) of the material.

User's responsibility to delete list after use (it owns its objects).

Implements KVIonRangeTable.

Definition at line 157 of file KVRangeYanez.cpp.

◆ GetMaterialWithNameOrType()

KVIonRangeTableMaterial * KVRangeYanez::GetMaterialWithNameOrType ( const Char_t * material ) const

privatevirtual

Returns pointer to material of given name or type if it has been defined.

Parameters

[in] material name or type of material to retrieve

Implements KVIonRangeTable.

Definition at line 118 of file KVRangeYanez.cpp.

◆ MakeNaturallyOccuringElementMixture()

KVIonRangeTableMaterial * KVRangeYanez::MakeNaturallyOccuringElementMixture	(	Int_t	z,
		Int_t &	a
	)		const

Create a material containing the naturally occuring isotopes of the given element, weighted according to their abundance.

Parameters

[in]	z	atomic number of element
[out]	a	mass number of unique isotope, if 100% abundance

if there is only one naturally occurring isotope of the element we set a to this isotope and don't create any material

Definition at line 342 of file KVRangeYanez.cpp.

◆ Print()

void KVRangeYanez::Print ( Option_t * = "" ) const

virtual

Reimplemented from KVIonRangeTable.

Definition at line 136 of file KVRangeYanez.cpp.

◆ ReadMaterials()

Bool_t KVRangeYanez::ReadMaterials ( const Char_t * filename ) const

virtual

Read materials from file whose name is given.

Implements KVIonRangeTable.

Definition at line 398 of file KVRangeYanez.cpp.

◆ SaveMaterial()

void KVRangeYanez::SaveMaterial ( KVIonRangeTableMaterial * mat ) const

private

Write definition of material in a file in the directory

/RANGE

All files in this directory are read when the table is initialised make directory if needed

Definition at line 500 of file KVRangeYanez.cpp.

Member Data Documentation

◆ fDoNotSaveMaterials

Bool_t KVRangeYanez::fDoNotSaveMaterials

mutableprivate

Definition at line 31 of file KVRangeYanez.h.

◆ fLocalMaterialsDirectory

TString KVRangeYanez::fLocalMaterialsDirectory

private

Definition at line 30 of file KVRangeYanez.h.

◆ fMaterials

KVHashList * KVRangeYanez::fMaterials = 0x0

staticprivate

static list of all currently defined materials

Definition at line 27 of file KVRangeYanez.h.

[in]	z	atomic number \(Z\) of element
[in]	a	[optional] mass number \(A\) of isotope

Detailed Description

Public Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Additional Inherited Members

Constructor & Destructor Documentation

◆ KVRangeYanez() [1/2]

◆ KVRangeYanez() [2/2]

◆ ~KVRangeYanez()

Member Function Documentation

◆ AddCompoundMaterial()

◆ AddElementalMaterial()

◆ AddMixedMaterial()

◆ CheckIon()

◆ CheckMaterialsList()

◆ Copy()

◆ GetListOfMaterials()

◆ GetMaterialWithNameOrType()

◆ MakeNaturallyOccuringElementMixture()

◆ Print()

◆ ReadMaterials()

◆ SaveMaterial()

Member Data Documentation

◆ fDoNotSaveMaterials

◆ fLocalMaterialsDirectory

◆ fMaterials