Class to represent Particle data in graph. More...

#include <MCParticleGraph.h>

Inheritance diagram for MCParticleGraph::GraphParticle:

[legend]

Collaboration diagram for MCParticleGraph::GraphParticle:

[legend]

Public Types
enum	StatusBit { c_PrimaryParticle = 1 << 0 , c_StableInGenerator = 1 << 1 , c_LeftDetector = 1 << 2 , c_StoppedInDetector = 1 << 3 , c_IsVirtual = 1 << 4 , c_Initial = 1 << 5 , c_IsISRPhoton = 1 << 6 , c_IsFSRPhoton = 1 << 7 , c_IsPHOTOSPhoton = 1 << 8 , c_IsRadiativePhoton = c_IsISRPhoton \| c_IsFSRPhoton \| c_IsPHOTOSPhoton }
	Exception is thrown if the requested index for the last child is out of range. More...

Public Member Functions
GraphParticle &	operator= (const MCParticle &particle)
	Assign the values of an existing MCParticle to this GraphParticle.

void	decaysInto (GraphParticle &daughter)
	Tells the graph that this particle decays into daughter.

void	comesFrom (GraphParticle &mother)
	Tells the graph that this particle is a decay product of mother.

void	setFirstDaughter (int daughter)
	Set the 1-based index of the first daughter, 0 means no daughters.

void	setLastDaughter (int daughter)
	Set the 1-based index of the last daughter, 0 means no daughters.

void	setIgnore (bool ignore=true)
	Set or remove the ignore flag.

bool	getIgnore () const
	Get the ignore flag.

void	setTrackID (int trackID)
	Set the track ID for the particle.

int	getTrackID () const
	Returns the track ID assigned to this MCParticle.

int	getPDG () const
	Return PDG code of particle.

unsigned int	getStatus (unsigned short int bitmask=USHRT_MAX) const
	Return status code of particle.

bool	hasStatus (unsigned short int bitmask) const
	Return if specific status bit is set.

float	getMass () const
	Return the particle mass in GeV.

float	getCharge () const
	Return the particle charge defined in TDatabasePDG.

float	getEnergy () const
	Return particle energy in GeV.

bool	hasValidVertex () const
	Indication whether vertex and time information is useful or just default.

float	getProductionTime () const
	Return production time in ns.

float	getDecayTime () const
	Return the decay time in ns.

float	getLifetime () const
	Return the lifetime in ns.

ROOT::Math::XYZVector	getVertex () const
	Return production vertex position, shorthand for getProductionVertex().

ROOT::Math::XYZVector	getProductionVertex () const
	Return production vertex position.

ROOT::Math::XYZVector	getMomentum () const
	Return momentum.

ROOT::Math::PxPyPzEVector	get4Vector () const
	Return 4Vector of particle.

ROOT::Math::XYZVector	getDecayVertex () const
	Return decay vertex.

int	getIndex () const
	Get 1-based index of the particle in the corresponding MCParticle list.

int	getArrayIndex () const
	Get 0-based index of the particle in the corresponding MCParticle list.

int	getFirstDaughter () const
	Get 1-based index of first daughter, 0 if no daughters.

int	getLastDaughter () const
	Get 1-based index of last daughter, 0 if no daughters.

std::vector< Belle2::MCParticle * >	getDaughters () const
	Get vector of all daughter particles, empty vector if none.

const MCParticle *	getDaughter (int i) const
	Return i-th daughter.

int	getNDaughters () const
	Return number of daughter MCParticles.

MCParticle *	getMother () const
	Returns a pointer to the mother particle.

int	getSecondaryPhysicsProcess () const
	Returns the physics process type of a secondary particle.

Const::DetectorSet	getSeenInDetector () const
	Return the seen-in flags of the entire Belle II subdetectors for an MC particle.

bool	hasSeenInDetector (Const::DetectorSet set) const
	Return if the seen-in flag for a specific subdetector is set or not.

bool	isVirtual () const
	Check if particle is virtual.

bool	isInitial () const
	Check if particle is an initial particle such as ISR.

bool	isPrimaryParticle () const
	Check if particle is a primary particle which was created by the generator (and not, for example material interaction)

void	setPDG (int pdg)
	Set PDG code of the particle.

void	setMassFromPDG ()
	Sets the mass for the particle from the particle's PDG code.

void	setStatus (unsigned short int status)
	Set Status code for the particle.

void	addStatus (unsigned short int bitmask)
	Add bitmask to current status.

void	removeStatus (unsigned short int bitmask)
	Remove bitmask from current status.

void	setMass (float mass)
	Set particle mass.

void	setEnergy (float energy)
	Set energy.

void	setValidVertex (bool valid)
	Set indication wether vertex and time information is valid or just default.

void	setProductionTime (float time)
	Set production time.

void	setDecayTime (float time)
	Set decay time.

void	setProductionVertex (const ROOT::Math::XYZVector &vertex)
	Set production vertex position.

void	setProductionVertex (float x, float y, float z)
	Set production vertex position.

void	setMomentum (const ROOT::Math::XYZVector &momentum)
	Set particle momentum.

void	setMomentum (float px, float py, float pz)
	Set particle momentum.

void	set4Vector (const ROOT::Math::PxPyPzEVector &p4)
	Sets the 4Vector of particle.

void	setDecayVertex (const ROOT::Math::XYZVector &vertex)
	Set decay vertex.

void	setDecayVertex (float x, float y, float z)
	Set decay vertex.

void	setSecondaryPhysicsProcess (int physicsProcess)
	Sets the physics process type of a secondary particle.

void	setSeenInDetector (Const::DetectorSet set)
	Set the seen-in flags for the entire Belle II subdetectors for an Monte Carlo particle.

void	addSeenInDetector (Const::DetectorSet set)
	Flag/Add a bit if the MC particle is seen in a specific subdetector.

void	removeSeenInDetector (Const::DetectorSet set)
	Unflag/Remove the bit if the MC particle is not seen in a specific subdetector.

void	fixParticleList () const
	Search the DataStore for the corresponding MCParticle array.

void	setVirtual ()
	Set particle to virtual.

void	setInitial ()
	Set particle to initial.

virtual std::string	getName () const override
	Return name of this particle.

virtual std::string	getInfoHTML () const override
	Return a short summary of this object's contents in HTML format.

const MCParticle *	getParticleFromGeneralizedIndexString (const std::string &generalizedIndex) const
	Explores the decay tree of the MC particle and returns the (grand^n)daughter identified by a generalized index.

void	addRelationTo (const RelationsInterface< BASE > *object, float weight=1.0, const std::string &namedRelation="") const
	Add a relation from this object to another object (with caching).

void	addRelationTo (const TObject *object, float weight=1.0, const std::string &namedRelation="") const
	Add a relation from this object to another object (no caching, can be quite slow).

void	copyRelations (const RelationsInterface< BASE > *sourceObj)
	Copies all relations of sourceObj (pointing from or to sourceObj) to this object (including weights).

template<class TO >
RelationVector< TO >	getRelationsTo (const std::string &name="", const std::string &namedRelation="") const
	Get the relations that point from this object to another store array.

template<class FROM >
RelationVector< FROM >	getRelationsFrom (const std::string &name="", const std::string &namedRelation="") const
	Get the relations that point from another store array to this object.

template<class T >
RelationVector< T >	getRelationsWith (const std::string &name="", const std::string &namedRelation="") const
	Get the relations between this object and another store array.

template<class TO >
TO *	getRelatedTo (const std::string &name="", const std::string &namedRelation="") const
	Get the object to which this object has a relation.

template<class FROM >
FROM *	getRelatedFrom (const std::string &name="", const std::string &namedRelation="") const
	Get the object from which this object has a relation.

template<class T >
T *	getRelated (const std::string &name="", const std::string &namedRelation="") const
	Get the object to or from which this object has a relation.

template<class TO >
std::pair< TO *, float >	getRelatedToWithWeight (const std::string &name="", const std::string &namedRelation="") const
	Get first related object & weight of relation pointing to an array.

template<class FROM >
std::pair< FROM *, float >	getRelatedFromWithWeight (const std::string &name="", const std::string &namedRelation="") const
	Get first related object & weight of relation pointing from an array.

template<class T >
std::pair< T *, float >	getRelatedWithWeight (const std::string &name="", const std::string &namedRelation="") const
	Get first related object & weight of relation pointing from/to an array.

std::string	getInfo () const
	Return a short summary of this object's contents in raw text format.

std::string	getArrayName () const
	Get name of array this object is stored in, or "" if not found.

Protected Member Functions
	ClassDefOverride (MCParticle, 5)
	A Class to store the Monte Carlo particle information.

TClonesArray *	getArrayPointer () const
	Returns the pointer to the raw DataStore array holding this object (protected since these arrays are easy to misuse).

Protected Attributes
TClonesArray *	m_plist
	Internal pointer to DataStore Array containing particles belonging to this collection.

int	m_index
	transient pointer to particle list

unsigned short int	m_status
	transient 1-based index of particle

int	m_pdg
	PDG-Code of the particle.

float	m_mass
	mass of the particle

float	m_energy
	energy of the particle

float	m_momentum_x
	momentum of particle, x component

float	m_momentum_y
	momentum of particle, y component

float	m_momentum_z
	momentum of particle, z component

bool	m_validVertex
	indication wether vertex and time information is useful or just default

float	m_productionTime
	production time

float	m_productionVertex_x
	production vertex of particle, x component

float	m_productionVertex_y
	production vertex of particle, y component

float	m_productionVertex_z
	production vertex of particle, z component

float	m_decayTime
	decay time

float	m_decayVertex_x
	decay vertex of particle, x component

float	m_decayVertex_y
	decay vertex of particle, y component

float	m_decayVertex_z
	decay vertex of particle, z component

int	m_mother
	1-based index of the mother particle

int	m_firstDaughter
	1-based index of first daughter particle in collection, 0 if no daughters

int	m_lastDaughter
	1-based index of last daughter particle in collection, 0 if no daughters

int	m_secondaryPhysicsProcess
	physics process type of a secondary particle

Const::DetectorSet	m_seenIn
	Each bit is a seen-in flag for the corresoponding subdetector of Belle II.

Static Protected Attributes
static const double	c_epsilon = 10e-7
	limit of precision for two doubles to be the same.

Private Member Functions
	GraphParticle ()=delete
	No default constructor.

	GraphParticle (const GraphParticle &)=delete
	No copy constructor.

	GraphParticle (TClonesArray *, const MCParticle &)
	Hide MCParticle "almost copy" constructor.

	GraphParticle (MCParticleGraph *graph, unsigned int vertexId)
	Internally used constructor.

void	setIndex (int index)
	Set the 1-based index of the particle.

	ClassDef (RelationsInterface, 0)
	defines interface for accessing relations of objects in StoreArray.

Private Attributes
MCParticleGraph *	m_graph {0}
	internal pointer to the graph this particle belongs to

unsigned int	m_vertexId {0}
	vertex id in the graph

bool	m_ignore {false}
	ignore particle when writing MCParticle list ?

bool	m_primary {true}
	Is this a primary particle ?

int	m_trackID {0}
	The track ID from geant4 that created this particle.

DataStore::StoreEntry *	m_cacheDataStoreEntry
	Cache of the data store entry to which this object belongs.

int	m_cacheArrayIndex
	Cache of the index in the TClonesArray to which this object belongs.

Friends
class	MCParticleGraph

class	ParticleSorter

Detailed Description

Class to represent Particle data in graph.

This is an extended version of the MCParticle class, allowing to set index and daughter indices as well as adding decay information. Use MCParticleGraph::addParticle() to add a new particle to the graph.

Definition at line 75 of file MCParticleGraph.h.

Member Enumeration Documentation

◆ StatusBit

enum StatusBit

inherited

Exception is thrown if the requested index for the last child is out of range.

Exception is thrown if no pointer to the particle list was set. Exception is thrown if the pdg value of the MCParticle is not known to the internal database (TDatabasePDG). The status information for the MCParticle.

Enumerator
c_PrimaryParticle	bit 0: Particle is primary particle. For example, All the particles from the generator.
c_StableInGenerator	bit 1: Particle is stable, i.e., not decaying in the generator.
c_LeftDetector	bit 2: Particle left the detector (the simulation volume).
c_StoppedInDetector	bit 3: Particle was stopped in the detector (the simulation volume).
c_IsVirtual	bit 4: Particle is virtual and not going to Geant4. Exchange boson, off-shell, unknown to Geant4, etc.
c_Initial	bit 5: Particle is initial such as e+ or e- and not going to Geant4
c_IsISRPhoton	bit 6: Particle is from initial state radiation
c_IsFSRPhoton	bit 7: Particle is from finial state radiation
c_IsPHOTOSPhoton	bit 8: Particle is an radiative photon from PHOTOS
c_IsRadiativePhoton	combined flag to test whether the particle is radiative

Definition at line 45 of file MCParticle.h.

                   {
      c_PrimaryParticle   = 1 << 0,
      c_StableInGenerator = 1 << 1,
      c_LeftDetector      = 1 << 2,
      c_StoppedInDetector = 1 << 3,
      c_IsVirtual         = 1 << 4,
      c_Initial           = 1 << 5,
      c_IsISRPhoton       = 1 << 6,
      c_IsFSRPhoton       = 1 << 7,
      c_IsPHOTOSPhoton    = 1 << 8,
      c_IsRadiativePhoton = c_IsISRPhoton | c_IsFSRPhoton | c_IsPHOTOSPhoton,
    };

Constructor & Destructor Documentation

◆ GraphParticle() [1/3]

GraphParticle ( )

privatedelete

No default constructor.

This class gets instantiated by MCParticleGraph::addParticle()

◆ GraphParticle() [2/3]

GraphParticle	(	TClonesArray *	,
		const MCParticle &
	)

inlineprivate

Hide MCParticle "almost copy" constructor.

Definition at line 172 of file MCParticleGraph.h.

172{}

◆ GraphParticle() [3/3]

GraphParticle	(	MCParticleGraph *	graph,
		unsigned int	vertexId
	)

inlineprivate

Internally used constructor.

Create a new Particle with given index and a pointer to the containing graph.

Parameters

graph	Pointer to the graph the particle is part of.
vertexId	The vertex id of the particle in the graph.

Definition at line 180 of file MCParticleGraph.h.

                                                                  : MCParticle(),
        m_graph(graph), m_vertexId(vertexId)
      {
        //The pointer to the TClonesArray the MCParticle is stored in makes no
        //sense inside the Graph so we set it to some invalid value to avoid
        //the MCParticle::fixParticleList() to complain
        m_plist = (TClonesArray*) - 1;
      }

Member Function Documentation

◆ addRelationTo() [1/2]

void addRelationTo	(	const RelationsInterface< BASE > *	object,
		float	weight = `1.0`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Add a relation from this object to another object (with caching).

Parameters

object	The object to which the relation should point.
weight	The weight of the relation.
namedRelation	Additional name for the relation, or "" for the default naming

Definition at line 142 of file RelationsObject.h.

    {
      if (object)
        DataStore::Instance().addRelation(this, m_cacheDataStoreEntry, m_cacheArrayIndex,
                                          object, object->m_cacheDataStoreEntry, object->m_cacheArrayIndex, weight, namedRelation);
    }

◆ addRelationTo() [2/2]

void addRelationTo	(	const TObject *	object,
		float	weight = `1.0`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Add a relation from this object to another object (no caching, can be quite slow).

Parameters

object	The object to which the relation should point.
weight	The weight of the relation.
namedRelation	Additional name for the relation, or "" for the default naming

Definition at line 155 of file RelationsObject.h.

    {
      StoreEntry* toEntry = nullptr;
      int toIndex = -1;
      DataStore::Instance().addRelation(this, m_cacheDataStoreEntry, m_cacheArrayIndex, object, toEntry, toIndex, weight, namedRelation);
    }

◆ addSeenInDetector()

void addSeenInDetector ( Const::DetectorSet set )

inlineinherited

Flag/Add a bit if the MC particle is seen in a specific subdetector.

Parameters

set	The ID for Belle II subdetector(s), in either Const::DetectorSet or Const::EDetector format

Definition at line 480 of file MCParticle.h.

480{ m_seenIn += set; }

Belle2::MCParticle::m_seenIn

Const::DetectorSet m_seenIn

Each bit is a seen-in flag for the corresoponding subdetector of Belle II.

Definition: MCParticle.h:567

◆ addStatus()

void addStatus ( unsigned short int bitmask )

inlineinherited

Add bitmask to current status.

Parameters

bitmask The status code which should be added to the existing MonteCarlo particle status code.

Definition at line 353 of file MCParticle.h.

353{ m_status |= bitmask; }

Belle2::MCParticle::m_status

unsigned short int m_status

transient 1-based index of particle

Definition: MCParticle.h:540

◆ comesFrom()

void comesFrom ( GraphParticle & mother )

inline

Tells the graph that this particle is a decay product of mother.

Parameters

mother The mother particle of this particle.

Definition at line 105 of file MCParticleGraph.h.

105{ m_graph->addDecay(mother, *this); }

Belle2::MCParticleGraph::addDecay

void addDecay(GraphParticle &mother, GraphParticle &daughter)

Add decay information between two particles.

Definition: MCParticleGraph.h:302

◆ copyRelations()

void copyRelations ( const RelationsInterface< BASE > * sourceObj )

inlineinherited

Copies all relations of sourceObj (pointing from or to sourceObj) to this object (including weights).

Useful if you want to make a complete copy of a StoreArray object to make modifications to it, but retain all information on linked objects.

Note: this only works if sourceObj inherits from the same base (e.g. RelationsObject), and only for related objects that also inherit from the same base.

Definition at line 170 of file RelationsObject.h.

    {
      if (!sourceObj)
        return;
      auto fromRels = sourceObj->getRelationsFrom<RelationsInterface<BASE>>("ALL");
      for (unsigned int iRel = 0; iRel < fromRels.size(); iRel++) {
        fromRels.object(iRel)->addRelationTo(this, fromRels.weight(iRel));
      }
 
      auto toRels = sourceObj->getRelationsTo<RelationsInterface<BASE>>("ALL");
      for (unsigned int iRel = 0; iRel < toRels.size(); iRel++) {
        this->addRelationTo(toRels.object(iRel), toRels.weight(iRel));
      }
    }

◆ decaysInto()

void decaysInto ( GraphParticle & daughter )

inline

Tells the graph that this particle decays into daughter.

Parameters

daughter The daughter particle in which this particle decays.

Definition at line 99 of file MCParticleGraph.h.

99{ m_graph->addDecay(*this, daughter); }

◆ fixParticleList()

void fixParticleList ( ) const

inherited

Search the DataStore for the corresponding MCParticle array.

This function should not be needed by normal users and is called automatically if the pointer to the particle list is not set when needed, e.g. after deserialization.

Definition at line 82 of file MCParticle.cc.

{
  if (m_plist != 0) return;
 
  TClonesArray* plist(0);
 
  //Search default location
  //TODO: this could be replaced with RelationsObject::getArrayIndex()/getArrayName()
  StoreArray<MCParticle> MCParticles;
  if (MCParticles && MCParticles.getPtr()->IndexOf(this) >= 0) {
    plist = MCParticles.getPtr();
  } else {
    //Search all StoreArrays which happen to store MCParticles
    const DataStore::StoreEntryMap& map = DataStore::Instance().getStoreEntryMap(DataStore::c_Event);
    for (DataStore::StoreEntryConstIter iter = map.begin(); iter != map.end(); ++iter) {
      TClonesArray* value = dynamic_cast<TClonesArray*>(iter->second.ptr);
      if (value && value->GetClass() == Class() && value->IndexOf(this) >= 0) {
        plist = value;
        break;
      }
    }
  }
  //Could not find any collection, raise exception
  if (!plist) {
    B2ERROR("Could not determine StoreArray the MCParticle belongs to !");
    throw NoParticleListSetError();
  }
 
  //Set plist pointer and index for whole array
  for (int i = 0; i < plist->GetEntriesFast(); i++) {
    MCParticle& mc = *(static_cast<MCParticle*>(plist->At(i)));
    mc.m_plist = plist;
    mc.m_index = i + 1;
  }
}

◆ get4Vector()

ROOT::Math::PxPyPzEVector get4Vector ( ) const

inlineinherited

Return 4Vector of particle.

Returns: The 4-vector of the MonteCarlo particle.

Definition at line 207 of file MCParticle.h.

    {
      return ROOT::Math::PxPyPzEVector(m_momentum_x, m_momentum_y, m_momentum_z, m_energy);
    }

◆ getArrayIndex()

int getArrayIndex ( ) const

inlineinherited

Get 0-based index of the particle in the corresponding MCParticle list.

This is the function for users who want to use the indices of the TClonesArray. To get the corresponding mother and daughter indices use ->getMother()->getArrayIndex().

Returns: The index of the MonteCarlo particle in the corresponding MCParticle array Careful: These indices do not follow the standard from (Fortran) generators, where the first particle has index 1. In the array the first particle has index 0.

Definition at line 244 of file MCParticle.h.

244{ fixParticleList(); return m_index - 1; }

Belle2::MCParticle::fixParticleList

void fixParticleList() const

Search the DataStore for the corresponding MCParticle array.

Definition: MCParticle.cc:82

Belle2::MCParticle::m_index

int m_index

transient pointer to particle list

Definition: MCParticle.h:538

◆ getArrayName()

std::string getArrayName ( ) const

inlineinherited

Get name of array this object is stored in, or "" if not found.

Definition at line 377 of file RelationsObject.h.

    {
      DataStore::Instance().findStoreEntry(this, m_cacheDataStoreEntry, m_cacheArrayIndex);
      return m_cacheDataStoreEntry ? m_cacheDataStoreEntry->name : "";
    }

◆ getArrayPointer()

TClonesArray * getArrayPointer ( ) const

inlineprotectedinherited

Returns the pointer to the raw DataStore array holding this object (protected since these arrays are easy to misuse).

Definition at line 418 of file RelationsObject.h.

    {
      DataStore::Instance().findStoreEntry(this, m_cacheDataStoreEntry, m_cacheArrayIndex);
      if (!m_cacheDataStoreEntry)
        return nullptr;
      return m_cacheDataStoreEntry->getPtrAsArray();
    }

◆ getCharge()

float getCharge ( ) const

inherited

Return the particle charge defined in TDatabasePDG.

Returns: The charge of the particle in units of q(positron).

Definition at line 36 of file MCParticle.cc.

{
  // Geant4 "optical photon" (m_pdg == 0) is not known to TDatabasePDG::Instance().
  if (m_pdg == 0) {
    return 0.0;
  }
 
  if (TDatabasePDG::Instance()->GetParticle(m_pdg) == nullptr) {
    B2ERROR("PDG=" << m_pdg << " ***code unknown to TDatabasePDG");
    return 0.0;
  }
 
  return TDatabasePDG::Instance()->GetParticle(m_pdg)->Charge() / 3.0;
}

◆ getDaughter()

const MCParticle * getDaughter ( int i ) const

inherited

Return i-th daughter.

Definition at line 67 of file MCParticle.cc.

{
  if (i >= getNDaughters()) {
    return nullptr;
  }
  return getDaughters().at(i);
}

◆ getDaughters()

vector< MCParticle * > getDaughters ( ) const

inherited

Get vector of all daughter particles, empty vector if none.

Throws an exception of type LastChildIndexOutOfRangError if the last daughter is out of the index range.

Returns: A list of all daughter particles. The list is empty if the MonteCarlo particle doesn't have any daughters.

Definition at line 52 of file MCParticle.cc.

{
  vector<MCParticle*> result;
  if (m_firstDaughter > 0) {
    fixParticleList();
    if (m_lastDaughter > m_plist->GetEntriesFast()) throw LastChildIndexOutOfRangError();
    TClonesArray& plist = *m_plist;
    result.reserve(m_lastDaughter - m_firstDaughter + 1);
    for (int i = m_firstDaughter - 1; i < m_lastDaughter; i++) {
      result.push_back(static_cast<MCParticle*>(plist[i]));
    }
  }
  return result;
}

◆ getDecayTime()

float getDecayTime ( ) const

inlineinherited

Return the decay time in ns.

Returns: The timestamp of the decay of the MonteCarlo particle in ns. If the particle is stable the time is set to infinity. If the particle crosses the simulation volume boundary, it is set to the crossing time.

Definition at line 168 of file MCParticle.h.

168{ return m_decayTime; }

Belle2::MCParticle::m_decayTime

float m_decayTime

decay time

Definition: MCParticle.h:555

◆ getDecayVertex()

ROOT::Math::XYZVector getDecayVertex ( ) const

inlineinherited

Return decay vertex.

Returns: The decay vertex of the MonteCarlo particle in cm. If the particle crosses the simulation volume boundary, it is set to the crossing position.

Definition at line 219 of file MCParticle.h.

    {
      return ROOT::Math::XYZVector(m_decayVertex_x, m_decayVertex_y, m_decayVertex_z);
    }

◆ getEnergy()

float getEnergy ( ) const

inlineinherited

Return particle energy in GeV.

Returns: Returns the particle energy in GeV.

Definition at line 147 of file MCParticle.h.

147{ return m_energy; }

◆ getFirstDaughter()

int getFirstDaughter ( ) const

inlineinherited

Get 1-based index of first daughter, 0 if no daughters.

Returns: The index of the first daughter of the MonteCarlo particle. The index is 0 if the MonteCarlo particle doesn't have any daughters.

Definition at line 251 of file MCParticle.h.

251{ return m_firstDaughter; }

◆ getIgnore()

bool getIgnore ( ) const

inline

Get the ignore flag.

Returns: whether the ignore flag is set

Definition at line 139 of file MCParticleGraph.h.

139{ return m_ignore; }

Belle2::MCParticleGraph::GraphParticle::m_ignore

bool m_ignore

ignore particle when writing MCParticle list ?

Definition: MCParticleGraph.h:197

◆ getIndex()

int getIndex ( ) const

inlineinherited

Get 1-based index of the particle in the corresponding MCParticle list.

This is used by the MCParticle Graph.

Returns: The index of the MonteCarlo particle in the corresponding MCParticle list (starts with 1)

Definition at line 230 of file MCParticle.h.

230{ fixParticleList(); return m_index; }

◆ getInfo()

std::string getInfo ( ) const

inlineinherited

Return a short summary of this object's contents in raw text format.

Returns the contents of getInfoHTML() while translating line-breaks etc.

Note: : You don't need to implement this function (it's not virtual), getInfoHTML() is enough.

Definition at line 370 of file RelationsObject.h.

    {
      return _RelationsInterfaceImpl::htmlToPlainText(getInfoHTML());
    }

◆ getInfoHTML()

std::string getInfoHTML ( ) const

overridevirtualinherited

Return a short summary of this object's contents in HTML format.

Reimplemented from RelationsInterface< BASE >.

Definition at line 125 of file MCParticle.cc.

{
  std::stringstream out;
  out << "<b>Charge</b>=" << (int)getCharge();
  out << ", <b>PDG</b>=" << getPDG();
  out << " (" << getName() << ")";
  out << "<br>";
  out << "<b>isPrimaryParticle</b>=" << isPrimaryParticle();
  out << ",<b>isInitial</b>=" << isInitial();
  out << ",<b>isVirtual</b>=" << isVirtual();
  out << "<br>";
 
  out << "<b>pT</b>=" << getMomentum().Rho();
  out << ", <b>pZ</b>=" << m_momentum_z;
  out << "<br>";
  std::string unitType = HTML::chooseUnitOfLength(getProductionVertex());
  int precision = 3;
  out << "<b>V</b>=" << HTML::getStringConvertToUnit(getProductionVertex(), precision, unitType);
 
  const MCParticle* mom = getMother();
  if (mom) {
    out << "<br>";
    out << "<b>Mother</b>: " << mom->getArrayName() << "[" << mom->getArrayIndex() << "] (" << mom->getName() << ")";
  }
  return out.str();
}

◆ getLastDaughter()

int getLastDaughter ( ) const

inlineinherited

Get 1-based index of last daughter, 0 if no daughters.

Returns: The index of the last daughter of the MonteCarlo particle. The index is 0 if the MonteCarlo particle doesn't have any daughters.

Definition at line 259 of file MCParticle.h.

259{ return m_lastDaughter; }

◆ getLifetime()

float getLifetime ( ) const

inlineinherited

Return the lifetime in ns.

A convenient method to get the lifetime of the MonteCarlo particle.

Returns: The lifetime of the MonteCarlo particle in ns. If the particle crosses the simulation volume boundary, it is set to the time spent inside the volume.

Definition at line 177 of file MCParticle.h.

177{ return m_decayTime - m_productionTime; }

Belle2::MCParticle::m_productionTime

float m_productionTime

production time

Definition: MCParticle.h:550

◆ getMass()

float getMass ( ) const

inlineinherited

Return the particle mass in GeV.

Returns: The mass of the particle in GeV.

Definition at line 135 of file MCParticle.h.

135{ return m_mass; }

Belle2::MCParticle::m_mass

float m_mass

mass of the particle

Definition: MCParticle.h:542

◆ getMomentum()

ROOT::Math::XYZVector getMomentum ( ) const

inlineinherited

Return momentum.

Returns: The momentum of the MonteCarlo particle in GeV.

Definition at line 198 of file MCParticle.h.

    {
      return ROOT::Math::XYZVector(m_momentum_x, m_momentum_y, m_momentum_z);
    }

◆ getName()

std::string getName ( ) const

overridevirtualinherited

Return name of this particle.

Reimplemented from RelationsInterface< BASE >.

Definition at line 117 of file MCParticle.cc.

{
  const TParticlePDG* p = TDatabasePDG::Instance()->GetParticle(m_pdg);
  if (p)
    return p->GetName();
  else //handle unknown PDG codes
    return std::to_string(m_pdg);
}

◆ getNDaughters()

int getNDaughters ( ) const

inherited

Return number of daughter MCParticles.

Definition at line 75 of file MCParticle.cc.

{
  if (getFirstDaughter() == 0) //no daughters
    return 0;
  return getLastDaughter() - getFirstDaughter() + 1;
}

◆ getParticleFromGeneralizedIndexString()

const MCParticle * getParticleFromGeneralizedIndexString ( const std::string & generalizedIndex ) const

inherited

Explores the decay tree of the MC particle and returns the (grand^n)daughter identified by a generalized index.

The generalized index consists of a colon-separated list of daughter indexes, starting from the root particle: 0:1:3 identifies the fourth daughter (3) of the second daughter (1) of the first daughter (0) of the mother particle. This method mirrors the method used in the Particle class.

Parameters

generalizedIndex the generalized index of the particle to be returned

Returns: a particle in the decay tree of the root particle.

Definition at line 152 of file MCParticle.cc.

{
  // Split the generalizedIndex string in a vector of strings.
  std::vector<std::string> generalizedIndexes;
  boost::split(generalizedIndexes, generalizedIndex, boost::is_any_of(":"));
 
  if (generalizedIndexes.empty()) {
    B2WARNING("Generalized index of MC daughter particle is empty. Skipping.");
    return nullptr;
  }
 
  // To explore a decay tree of unknown depth, we need a place to store
  // both the root particle and the daughter particle at each iteration
  const MCParticle* dauPart =
    nullptr; // This will be eventually returned
  const MCParticle* currentPart = this; // This is the root particle of the next iteration
 
  // Loop over the generalizedIndexes until you get to the particle you want
  for (auto& indexString : generalizedIndexes) {
    // indexString is a string. First try to convert it into an int
    int dauIndex = 0;
    try {
      dauIndex = Belle2::convertString<int>(indexString);
    } catch (std::invalid_argument&) {
      B2WARNING("Found the string " << indexString << "instead of a daughter index.");
      return nullptr;
    }
 
    // Check that the daughter index is smaller than the number of daughters of the current root particle
    if (dauIndex >= int(currentPart->getNDaughters()) or dauIndex < 0) {
      B2WARNING("Daughter index out of range" << LogVar("daughter index", dauIndex));
      B2WARNING("Trying to access non-existing particle.");
      return nullptr;
    } else {
      dauPart = currentPart->getDaughter(dauIndex); // Pick the particle indicated by the generalizedIndex
      currentPart = dauPart;
    }
  }
  return dauPart;
}

◆ getPDG()

int getPDG ( ) const

inlineinherited

Return PDG code of particle.

Returns: The PDG code of the MonteCarlo particle.

Definition at line 112 of file MCParticle.h.

112{ return m_pdg; }

◆ getProductionTime()

float getProductionTime ( ) const

inlineinherited

Return production time in ns.

Returns: The timestamp of the MonteCarlo particle production in ns.

Definition at line 159 of file MCParticle.h.

159{ return m_productionTime; }

◆ getProductionVertex()

ROOT::Math::XYZVector getProductionVertex ( ) const

inlineinherited

Return production vertex position.

Returns: The production vertex of the MonteCarlo particle in cm.

Definition at line 189 of file MCParticle.h.

    {
      return ROOT::Math::XYZVector(m_productionVertex_x, m_productionVertex_y, m_productionVertex_z);
    }

◆ getRelated()

T * getRelated	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get the object to or from which this object has a relation.

Template Parameters

T	The class of objects to or from which the relation points.

Parameters

name	The name of the store array to or from which the relation points. If empty the default store array name for class T will be used. If the special name "ALL" is given all store arrays containing objects of type T are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: The first related object or a null pointer.

Definition at line 278 of file RelationsObject.h.

    {
      return static_cast<T*>(DataStore::Instance().getRelationWith(DataStore::c_BothSides, this, m_cacheDataStoreEntry, m_cacheArrayIndex,
                             T::Class(), name, namedRelation).object);
    }

◆ getRelatedFrom()

FROM * getRelatedFrom	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get the object from which this object has a relation.

Template Parameters

FROM	The class of objects from which the relation points.

Parameters

name	The name of the store array from which the relation points. If empty the default store array name for class FROM will be used. If the special name "ALL" is given all store arrays containing objects of type FROM are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: The first related object or a null pointer.

Definition at line 263 of file RelationsObject.h.

    {
      return static_cast<FROM*>(DataStore::Instance().getRelationWith(DataStore::c_FromSide, this, m_cacheDataStoreEntry,
                                m_cacheArrayIndex, FROM::Class(), name, namedRelation).object);
    }

◆ getRelatedFromWithWeight()

std::pair< FROM *, float > getRelatedFromWithWeight	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get first related object & weight of relation pointing from an array.

Template Parameters

FROM	The class of objects from which the relation points.

Parameters

name	The name of the store array from which the relation points. If empty the default store array name for class FROM will be used. If the special name "ALL" is given all store arrays containing objects of type FROM are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: Pair of first related object and the relation weight, or (NULL, 1.0) if none found.

Definition at line 314 of file RelationsObject.h.

    {
      RelationEntry entry = DataStore::Instance().getRelationWith(DataStore::c_FromSide, this, m_cacheDataStoreEntry, m_cacheArrayIndex,
                                                                  FROM::Class(), name, namedRelation);
      return std::make_pair(static_cast<FROM*>(entry.object), entry.weight);
    }

◆ getRelatedTo()

TO * getRelatedTo	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get the object to which this object has a relation.

Template Parameters

TO	The class of objects to which the relation points.

Parameters

name	The name of the store array to which the relation points. If empty the default store array name for class TO will be used. If the special name "ALL" is given all store arrays containing objects of type TO are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: The first related object or a null pointer.

Definition at line 248 of file RelationsObject.h.

    {
      return static_cast<TO*>(DataStore::Instance().getRelationWith(DataStore::c_ToSide, this, m_cacheDataStoreEntry, m_cacheArrayIndex,
                              TO::Class(), name, namedRelation).object);
    }

◆ getRelatedToWithWeight()

std::pair< TO *, float > getRelatedToWithWeight	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get first related object & weight of relation pointing to an array.

Template Parameters

TO	The class of objects to which the relation points.

Parameters

name	The name of the store array to which the relation points. If empty the default store array name for class TO will be used. If the special name "ALL" is given all store arrays containing objects of type TO are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: Pair of first related object and the relation weight, or (NULL, 1.0) if none found.

Definition at line 297 of file RelationsObject.h.

    {
      RelationEntry entry = DataStore::Instance().getRelationWith(DataStore::c_ToSide, this, m_cacheDataStoreEntry, m_cacheArrayIndex,
                                                                  TO::Class(), name, namedRelation);
      return std::make_pair(static_cast<TO*>(entry.object), entry.weight);
    }

◆ getRelatedWithWeight()

std::pair< T *, float > getRelatedWithWeight	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get first related object & weight of relation pointing from/to an array.

Template Parameters

T	The class of objects to or from which the relation points.

Parameters

name	The name of the store array to or from which the relation points. If empty the default store array name for class T will be used. If the special name "ALL" is given all store arrays containing objects of type T are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: Pair of first related object and the relation weight, or (NULL, 1.0) if none found.

Definition at line 331 of file RelationsObject.h.

    {
      RelationEntry entry = DataStore::Instance().getRelationWith(DataStore::c_BothSides, this, m_cacheDataStoreEntry, m_cacheArrayIndex,
                                                                  T::Class(), name, namedRelation);
      return std::make_pair(static_cast<T*>(entry.object), entry.weight);
    }

◆ getRelationsFrom()

RelationVector< FROM > getRelationsFrom	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get the relations that point from another store array to this object.

Template Parameters

FROM	The class of objects from which the relations point.

Parameters

name	The name of the store array from which the relations point. If empty the default store array name for class FROM will be used. If the special name "ALL" is given all store arrays containing objects of type FROM are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: A vector of relations.

Definition at line 212 of file RelationsObject.h.

    {
      return RelationVector<FROM>(DataStore::Instance().getRelationsWith(DataStore::c_FromSide, this, m_cacheDataStoreEntry,
                                  m_cacheArrayIndex, FROM::Class(), name, namedRelation));
    }

◆ getRelationsTo()

RelationVector< TO > getRelationsTo	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get the relations that point from this object to another store array.

Template Parameters

TO	The class of objects to which the relations point.

Parameters

name	The name of the store array to which the relations point. If empty the default store array name for class TO will be used. If the special name "ALL" is given all store arrays containing objects of type TO are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: A vector of relations.

Definition at line 197 of file RelationsObject.h.

    {
      return RelationVector<TO>(DataStore::Instance().getRelationsWith(DataStore::c_ToSide, this, m_cacheDataStoreEntry,
                                m_cacheArrayIndex, TO::Class(), name, namedRelation));
    }

◆ getRelationsWith()

RelationVector< T > getRelationsWith	(	const std::string &	name = `""`,
		const std::string &	namedRelation = `""`
	)		const

inlineinherited

Get the relations between this object and another store array.

Relations in both directions are returned.

Template Parameters

T	The class of objects to or from which the relations point.

Parameters

name	The name of the store array to or from which the relations point. If empty the default store array name for class T will be used. If the special name "ALL" is given all store arrays containing objects of type T are considered.
namedRelation	Additional name for the relation, or "" for the default naming

Returns: A vector of relations.

Definition at line 230 of file RelationsObject.h.

    {
      return RelationVector<T>(DataStore::Instance().getRelationsWith(DataStore::c_BothSides, this, m_cacheDataStoreEntry,
                               m_cacheArrayIndex, T::Class(), name, namedRelation));
    }

◆ getSecondaryPhysicsProcess()

int getSecondaryPhysicsProcess ( ) const

inlineinherited

Returns the physics process type of a secondary particle.

Returns: Returns an integer indicating the physics process type of a secondary particle. 0 if the particle is primary. -1 if no information is found. For the details, see the Geant4 package: (*G4Track)->GetCreatorProcess()->GetProcessSubType() processes/electromagnetic/utils/include/G4EmProcessSubType.hh processes/hadronic/management/include/G4HadronicProcessType.hh processes/decay/include/G4DecayProcessType.hh

Definition at line 297 of file MCParticle.h.

297{return m_secondaryPhysicsProcess;}

Belle2::MCParticle::m_secondaryPhysicsProcess

int m_secondaryPhysicsProcess

physics process type of a secondary particle

Definition: MCParticle.h:565

◆ getSeenInDetector()

Const::DetectorSet getSeenInDetector ( ) const

inlineinherited

Return the seen-in flags of the entire Belle II subdetectors for an MC particle.

Returns: Returns the entire seen-in flags

Definition at line 303 of file MCParticle.h.

303{ return m_seenIn; }

◆ getStatus()

unsigned int getStatus ( unsigned short int bitmask = USHRT_MAX ) const

inlineinherited

Return status code of particle.

Parameters

bitmask Takes an optional bitmask that is compared to the status of the particle.

Returns: Returns the status code of the particle. If a bitmask is given and it matches the the status it returns the value of the bitmask and 0 if not.

Definition at line 122 of file MCParticle.h.

122{ return m_status & bitmask; }

◆ getTrackID()

int getTrackID ( ) const

inline

Returns the track ID assigned to this MCParticle.

Returns: The ID of the Geant4 track which created this particle.

Definition at line 154 of file MCParticleGraph.h.

154{ return m_trackID; }

Belle2::MCParticleGraph::GraphParticle::m_trackID

int m_trackID

The track ID from geant4 that created this particle.

Definition: MCParticleGraph.h:199

◆ getVertex()

ROOT::Math::XYZVector getVertex ( ) const

inlineinherited

Return production vertex position, shorthand for getProductionVertex().

Returns: The production vertex of the MonteCarlo particle in cm.

Definition at line 183 of file MCParticle.h.

183{ return getProductionVertex(); }

◆ hasSeenInDetector()

bool hasSeenInDetector ( Const::DetectorSet set ) const

inlineinherited

Return if the seen-in flag for a specific subdetector is set or not.

Parameters

set	The ID for Belle II subdetector(s), in either Const::DetectorSet or Const::EDetector format.

Returns: Returns true if the corresponding bit is set.

Definition at line 310 of file MCParticle.h.

310{ return m_seenIn.contains(set); }

Belle2::Const::DetectorSet::contains

bool contains(const DetectorSet &set) const

Check whether this set contains another set.

Definition: Const.h:235

◆ hasStatus()

bool hasStatus ( unsigned short int bitmask ) const

inlineinherited

Return if specific status bit is set.

Parameters

bitmask The bitmask which is compared to the status of the particle.

Returns: Returns true if the bitmask matches the status code of the particle.

Definition at line 129 of file MCParticle.h.

129{ return (m_status & bitmask) == bitmask; }

◆ hasValidVertex()

bool hasValidVertex ( ) const

inlineinherited

Indication whether vertex and time information is useful or just default.

Returns: Returns True if the vertex and time information is useful.

Definition at line 153 of file MCParticle.h.

153{ return m_validVertex; }

Belle2::MCParticle::m_validVertex

bool m_validVertex

indication wether vertex and time information is useful or just default

Definition: MCParticle.h:548

◆ operator=()

GraphParticle & operator= ( const MCParticle & particle )

inline

Assign the values of an existing MCParticle to this GraphParticle.

This assignment will leave all bookkeeping members of the GraphParticle untouched (decays, ignore status, track id) but will assign all values/flags from the MCParticle.

Parameters

particle Particle which values (momentum, energy, mass, vertex, etc.) shall be assigned

Definition at line 85 of file MCParticleGraph.h.

      {
        MCParticle::operator=(particle);
        //The pointer to the TClonesArray the MCParticle is stored in makes no
        //sense inside the Graph so we set it to some invalid value to avoid
        //the MCParticle::fixParticleList() to complain
        m_plist = (TClonesArray*) - 1;
        return *this;
      }

◆ removeSeenInDetector()

void removeSeenInDetector ( Const::DetectorSet set )

inlineinherited

Unflag/Remove the bit if the MC particle is not seen in a specific subdetector.

Parameters

set	The ID for Belle II subdetector(s), in either Const::DetectorSet or Const::EDetector format

Definition at line 486 of file MCParticle.h.

486{ m_seenIn -= set; }

◆ removeStatus()

void removeStatus ( unsigned short int bitmask )

inlineinherited

Remove bitmask from current status.

Parameters

bitmask The status code which should be removed from the existing MonteCarlo particle status code.

Definition at line 360 of file MCParticle.h.

360{ m_status &= (~bitmask); }

◆ set4Vector()

void set4Vector ( const ROOT::Math::PxPyPzEVector & p4 )

inlineinherited

Sets the 4Vector of particle.

Parameters

p4 4Vector

Definition at line 438 of file MCParticle.h.

    {
      m_momentum_x = p4.px(); m_momentum_y = p4.py(); m_momentum_z = p4.pz(); m_energy = p4.energy();
    }

◆ setDecayTime()

void setDecayTime ( float time )

inlineinherited

Set decay time.

Parameters

time	The timestamp of the decay of the MonteCarlo time.

Definition at line 390 of file MCParticle.h.

390{ m_decayTime = time; }

◆ setDecayVertex() [1/2]

void setDecayVertex ( const ROOT::Math::XYZVector & vertex )

inlineinherited

Set decay vertex.

Parameters

vertex The position of the decay vertex given as XYZVector.

Definition at line 447 of file MCParticle.h.

    {
      m_decayVertex_x = vertex.X(); m_decayVertex_y = vertex.Y(), m_decayVertex_z = vertex.Z();
    }

◆ setDecayVertex() [2/2]

void setDecayVertex	(	float	x,
		float	y,
		float	z
	)

inlineinherited

Set decay vertex.

The position of the decay vertex is given as three float parameters.

Parameters

x	The x position of the decay vertex.
y	The y position of the decay vertex.
z	The z position of the decay vertex.

Definition at line 459 of file MCParticle.h.

    {
      m_decayVertex_x = x; m_decayVertex_y = y; m_decayVertex_z = z;
    }

◆ setEnergy()

void setEnergy ( float energy )

inlineinherited

Set energy.

Parameters

energy The energy of the MonteCarlo particle.

Definition at line 372 of file MCParticle.h.

372{ m_energy = energy; }

◆ setFirstDaughter()

void setFirstDaughter ( int daughter )

inline

Set the 1-based index of the first daughter, 0 means no daughters.

Will be reset when sorting the particle graph and will be set according to the information given with decaysInto() and comesFrom().

Parameters

daughter The index of the first daughter particle. Set to 0 for no daughters.

Definition at line 114 of file MCParticleGraph.h.

114{ m_firstDaughter = daughter; }

◆ setIgnore()

void setIgnore ( bool ignore = true )

inline

Set or remove the ignore flag.

If ignore is set, this particle will not be written to the MCParticle list and all its daughters without ignore flag will be attributed to all parents of this particle.

Parameters

ignore Set to true to ignore this particle when creating the MCParticle list.

Definition at line 132 of file MCParticleGraph.h.

132{ m_ignore = ignore; }

◆ setIndex()

void setIndex ( int index )

inlineprivate

Set the 1-based index of the particle.

Parameters

index The index of the particle.

Definition at line 193 of file MCParticleGraph.h.

193{ m_index = index; }

◆ setInitial()

void setInitial ( )

inlineinherited

Set particle to initial.

(A bit more convinient)

Definition at line 505 of file MCParticle.h.

505{ addStatus(c_Initial); }

Belle2::MCParticle::addStatus

void addStatus(unsigned short int bitmask)

Add bitmask to current status.

Definition: MCParticle.h:353

◆ setLastDaughter()

void setLastDaughter ( int daughter )

inline

Set the 1-based index of the last daughter, 0 means no daughters.

See also: setFirstDaughter()

Parameters

daughter The index of the last daughter particle. Set to 0 for no daughters.

Definition at line 122 of file MCParticleGraph.h.

122{ m_lastDaughter = daughter; }

◆ setMass()

void setMass ( float mass )

inlineinherited

Set particle mass.

Parameters

mass	The MonteCarlo particle mass.

Definition at line 366 of file MCParticle.h.

366{ m_mass = mass; }

◆ setMassFromPDG()

void setMassFromPDG ( )

inherited

Sets the mass for the particle from the particle's PDG code.

Definition at line 28 of file MCParticle.cc.

{
  if (TDatabasePDG::Instance()->GetParticle(m_pdg) == nullptr)
    throw(ParticlePDGNotKnownError() << m_pdg);
  m_mass = TDatabasePDG::Instance()->GetParticle(m_pdg)->Mass();
}

◆ setMomentum() [1/2]

void setMomentum ( const ROOT::Math::XYZVector & momentum )

inlineinherited

Set particle momentum.

Parameters

momentum The momentum of the MonteCarlo particle given as XYZVector.

Definition at line 417 of file MCParticle.h.

    {
      m_momentum_x = momentum.X(); m_momentum_y = momentum.Y(), m_momentum_z = momentum.Z();
    }

◆ setMomentum() [2/2]

void setMomentum	(	float	px,
		float	py,
		float	pz
	)

inlineinherited

Set particle momentum.

The momentum of the MonteCarlo particle is given as three float parameters.

Parameters

px	The x component of the momentum vector.
py	The y component of the momentum vector.
pz	The z component of the momentum vector.

Definition at line 429 of file MCParticle.h.

    {
      m_momentum_x = px, m_momentum_y = py; m_momentum_z = pz;
    }

◆ setPDG()

void setPDG ( int pdg )

inlineinherited

Set PDG code of the particle.

Parameters

pdg	The PDG code of the MonteCarlo particle.

Definition at line 335 of file MCParticle.h.

335{ m_pdg = pdg; }

◆ setProductionTime()

void setProductionTime ( float time )

inlineinherited

Set production time.

Parameters

time	The timestamp of the production of the MonteCarlo particle.

Definition at line 384 of file MCParticle.h.

384{ m_productionTime = time; }

◆ setProductionVertex() [1/2]

void setProductionVertex ( const ROOT::Math::XYZVector & vertex )

inlineinherited

Set production vertex position.

Parameters

vertex The position of the production vertex given as XYZVector.

Definition at line 396 of file MCParticle.h.

    {
      m_productionVertex_x = vertex.X(); m_productionVertex_y = vertex.Y(), m_productionVertex_z = vertex.Z();
    }

◆ setProductionVertex() [2/2]

void setProductionVertex	(	float	x,
		float	y,
		float	z
	)

inlineinherited

Set production vertex position.

The position of the production vertex is given as three float parameters.

Parameters

x	The x position of the production vertex.
y	The y position of the production vertex.
z	The z position of the production vertex.

Definition at line 408 of file MCParticle.h.

    {
      m_productionVertex_x = x; m_productionVertex_y = y; m_productionVertex_z = z;
    }

◆ setSecondaryPhysicsProcess()

void setSecondaryPhysicsProcess ( int physicsProcess )

inlineinherited

Sets the physics process type of a secondary particle.

Parameters

physicsProcess physics process type as an integer number for a secondary particle.

Definition at line 468 of file MCParticle.h.

468{ m_secondaryPhysicsProcess = physicsProcess; }

◆ setSeenInDetector()

void setSeenInDetector ( Const::DetectorSet set )

inlineinherited

Set the seen-in flags for the entire Belle II subdetectors for an Monte Carlo particle.

Parameters

set	The ID for Belle II subdetector(s), in either Const::DetectorSet or Const::EDetector format

Definition at line 474 of file MCParticle.h.

474{ m_seenIn = set; }

◆ setStatus()

void setStatus ( unsigned short int status )

inlineinherited

Set Status code for the particle.

Parameters

status The status code of the MonteCarlo particle.

Definition at line 346 of file MCParticle.h.

346{ m_status = status; }

◆ setTrackID()

void setTrackID ( int trackID )

inline

Set the track ID for the particle.

The track ID is used to build the relationship between MCParticles and created Hits.

Parameters

trackID The ID of the Geant4 track which created this MCParticle.

Definition at line 147 of file MCParticleGraph.h.

147{ m_trackID = trackID; }

◆ setValidVertex()

void setValidVertex ( bool valid )

inlineinherited

Set indication wether vertex and time information is valid or just default.

Parameters

valid Set to true if the vertex is valid.

Definition at line 378 of file MCParticle.h.

378{ m_validVertex = valid; }

◆ setVirtual()

void setVirtual ( )

inlineinherited

Set particle to virtual.

(A bit more convinient)

Definition at line 500 of file MCParticle.h.

500{ addStatus(c_IsVirtual); }

Friends And Related Function Documentation

◆ MCParticleGraph

friend class MCParticleGraph

friend

Definition at line 201 of file MCParticleGraph.h.

◆ ParticleSorter

friend class ParticleSorter

friend

Definition at line 202 of file MCParticleGraph.h.

Member Data Documentation

◆ c_epsilon

const double c_epsilon = 10e-7

staticprotectedinherited

limit of precision for two doubles to be the same.

Definition at line 563 of file MCParticle.h.

◆ m_cacheArrayIndex

int m_cacheArrayIndex

mutableprivateinherited

Cache of the index in the TClonesArray to which this object belongs.

Definition at line 432 of file RelationsObject.h.

◆ m_cacheDataStoreEntry

DataStore::StoreEntry* m_cacheDataStoreEntry

mutableprivateinherited

Cache of the data store entry to which this object belongs.

Definition at line 429 of file RelationsObject.h.

◆ m_decayTime

float m_decayTime

protectedinherited

decay time

Definition at line 555 of file MCParticle.h.

◆ m_decayVertex_x

float m_decayVertex_x

protectedinherited

decay vertex of particle, x component

Definition at line 556 of file MCParticle.h.

◆ m_decayVertex_y

float m_decayVertex_y

protectedinherited

decay vertex of particle, y component

Definition at line 557 of file MCParticle.h.

◆ m_decayVertex_z

float m_decayVertex_z

protectedinherited

decay vertex of particle, z component

Definition at line 558 of file MCParticle.h.

◆ m_energy

float m_energy

protectedinherited

energy of the particle

Definition at line 543 of file MCParticle.h.

◆ m_firstDaughter

int m_firstDaughter

protectedinherited

1-based index of first daughter particle in collection, 0 if no daughters

Definition at line 561 of file MCParticle.h.

◆ m_graph

MCParticleGraph* m_graph {0}

private

internal pointer to the graph this particle belongs to

Definition at line 195 of file MCParticleGraph.h.

◆ m_ignore

bool m_ignore {false}

private

ignore particle when writing MCParticle list ?

Definition at line 197 of file MCParticleGraph.h.

◆ m_index

int m_index

protectedinherited

transient pointer to particle list

1-based index of the particle, will be set automatically after deserialisation if needed.

Definition at line 538 of file MCParticle.h.

◆ m_lastDaughter

int m_lastDaughter

protectedinherited

1-based index of last daughter particle in collection, 0 if no daughters

Definition at line 562 of file MCParticle.h.

◆ m_mass

float m_mass

protectedinherited

mass of the particle

Definition at line 542 of file MCParticle.h.

◆ m_momentum_x

float m_momentum_x

protectedinherited

momentum of particle, x component

Definition at line 544 of file MCParticle.h.

◆ m_momentum_y

float m_momentum_y

protectedinherited

momentum of particle, y component

Definition at line 545 of file MCParticle.h.

◆ m_momentum_z

float m_momentum_z

protectedinherited

momentum of particle, z component

Definition at line 546 of file MCParticle.h.

◆ m_mother

int m_mother

protectedinherited

1-based index of the mother particle

Definition at line 560 of file MCParticle.h.

◆ m_pdg

int m_pdg

protectedinherited

PDG-Code of the particle.

Definition at line 541 of file MCParticle.h.

◆ m_plist

TClonesArray* m_plist

protectedinherited

Internal pointer to DataStore Array containing particles belonging to this collection.

This is a transient member and will not be written to file. The pointer will be set correctly on first access after deserialisation

Definition at line 532 of file MCParticle.h.

◆ m_primary

bool m_primary {true}

private

Is this a primary particle ?

Definition at line 198 of file MCParticleGraph.h.

◆ m_productionTime

float m_productionTime

protectedinherited

production time

Definition at line 550 of file MCParticle.h.

◆ m_productionVertex_x

float m_productionVertex_x

protectedinherited

production vertex of particle, x component

Definition at line 551 of file MCParticle.h.

◆ m_productionVertex_y

float m_productionVertex_y

protectedinherited

production vertex of particle, y component

Definition at line 552 of file MCParticle.h.

◆ m_productionVertex_z

float m_productionVertex_z

protectedinherited

production vertex of particle, z component

Definition at line 553 of file MCParticle.h.

◆ m_secondaryPhysicsProcess

int m_secondaryPhysicsProcess

protectedinherited

physics process type of a secondary particle

Definition at line 565 of file MCParticle.h.

◆ m_seenIn

Const::DetectorSet m_seenIn

protectedinherited

Each bit is a seen-in flag for the corresoponding subdetector of Belle II.

Definition at line 567 of file MCParticle.h.

◆ m_status

unsigned short int m_status

protectedinherited

transient 1-based index of particle

status code

Definition at line 540 of file MCParticle.h.

◆ m_trackID

int m_trackID {0}

private

The track ID from geant4 that created this particle.

Definition at line 199 of file MCParticleGraph.h.

◆ m_validVertex

bool m_validVertex

protectedinherited

indication wether vertex and time information is useful or just default

Definition at line 548 of file MCParticle.h.

◆ m_vertexId

unsigned int m_vertexId {0}

private

vertex id in the graph

Definition at line 196 of file MCParticleGraph.h.

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

mdst/dataobjects/include/MCParticleGraph.h

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Private Attributes

Friends

Detailed Description

Member Enumeration Documentation

◆ StatusBit

Constructor & Destructor Documentation

◆ GraphParticle() [1/3]

◆ GraphParticle() [2/3]

◆ GraphParticle() [3/3]

Member Function Documentation

◆ addRelationTo() [1/2]

◆ addRelationTo() [2/2]

◆ addSeenInDetector()

◆ addStatus()

◆ comesFrom()

◆ copyRelations()

◆ decaysInto()

◆ fixParticleList()

◆ get4Vector()

◆ getArrayIndex()

◆ getArrayName()

◆ getArrayPointer()

◆ getCharge()

◆ getDaughter()

◆ getDaughters()

◆ getDecayTime()

◆ getDecayVertex()

◆ getEnergy()

◆ getFirstDaughter()

◆ getIgnore()

◆ getIndex()

◆ getInfo()

◆ getInfoHTML()

◆ getLastDaughter()

◆ getLifetime()

◆ getMass()

◆ getMomentum()

◆ getName()

◆ getNDaughters()

◆ getParticleFromGeneralizedIndexString()

◆ getPDG()

◆ getProductionTime()

◆ getProductionVertex()

◆ getRelated()

◆ getRelatedFrom()

◆ getRelatedFromWithWeight()

◆ getRelatedTo()

◆ getRelatedToWithWeight()

◆ getRelatedWithWeight()

◆ getRelationsFrom()

◆ getRelationsTo()

◆ getRelationsWith()

◆ getSecondaryPhysicsProcess()

◆ getSeenInDetector()

◆ getStatus()

◆ getTrackID()

◆ getVertex()

◆ hasSeenInDetector()

◆ hasStatus()

◆ hasValidVertex()

◆ operator=()

◆ removeSeenInDetector()

◆ removeStatus()

◆ set4Vector()

◆ setDecayTime()

◆ setDecayVertex() [1/2]

◆ setDecayVertex() [2/2]

◆ setEnergy()

◆ setFirstDaughter()

◆ setIgnore()

◆ setIndex()

◆ setInitial()

◆ setLastDaughter()

◆ setMass()