Class that bundles various TrackFitResults. More...

#include <Track.h>

Inheritance diagram for Track:

Public Types
enum	StatusBit { c_isFlippedAndRefitted = 1 << 0 }
	status enumerator More...

typedef std::pair< Const::ChargedStable, TrackFitResult * >	ChargedStableTrackFitResultPair
	Pair to hold the particle hypothesis used for the fit as first entry and the result of the track fit as second.

Public Member Functions
	Track (float qualityIndicator=0.)
	Constructor of Track without any attached TrackFitResults.

const TrackFitResult *	getTrackFitResultByName (const Const::ChargedStable &chargedStable, const std::string trackFitResultsName) const
	Access to TrackFitResults with a specified Name.

const TrackFitResult *	getTrackFitResult (const Const::ChargedStable &chargedStable) const
	Default Access to TrackFitResults.

const TrackFitResult *	getTrackFitResultWithClosestMassByName (const Const::ChargedStable &requestedType, const std::string trackFitResultsName) const
	Return the track fit (from TrackFitResult with specified name) for a fit hypothesis with the closest mass.

const TrackFitResult *	getTrackFitResultWithClosestMass (const Const::ChargedStable &requestedType) const
	Return the track fit for a fit hypothesis with the closest mass.

std::vector< ChargedStableTrackFitResultPair >	getTrackFitResultsByName (const std::string trackFitResultsName) const
	Access to all track fit results at the same time (from TrackFitResult with specified name)

std::vector< ChargedStableTrackFitResultPair >	getTrackFitResults () const
	Deafult Access to all track fit results at the same time.

void	addStatusBits (unsigned short int bitmask)
	Add Track Refining Status Bit.

void	setFlippedAndRefitted ()
	Set the Track status bit when the track has been flipped and refitted in the refining step.

bool	getStatusBit (unsigned short int bitmask) const
	Get Track Status after Refining.

bool	isFlippedAndRefitted () const
	Check the Track status after the Refining step.

bool	wasRefined ()
	Check whether Track was modified in the Refining step.

void	setTrackFitResultIndex (const Const::ChargedStable &chargedStable, short index)
	Set an index (for positive values) or unavailability-code (index = -1) for a specific mass hypothesis.

unsigned int	getNumberOfFittedHypotheses () const
	Returns the number of fitted hypothesis which are stored in this track.

float	getQualityIndicator () const
	Getter for quality indicator for classification of fake vs.

void	setTrackTime (float track_time)
	Set track time computed as the difference between the outgoing/ingoing arm time (computed with SVD hits) and the SVD EventT0.

float	getTrackTime () const
	Returns track time computed as the difference between the average of SVD clusters time and the SVD EventT0.

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

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.

virtual std::string	getName () const
	Return a short name that describes this object, e.g.

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.

int	getArrayIndex () const
	Returns this object's array index (in StoreArray), or -1 if not found.

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

Private Member Functions
std::vector< short int >	getValidIndices () const
	Returns a vector of all fit hypothesis indices in m_trackFitIndices which have been set (meaning are not -1)

	ClassDefOverride (Track, 6)
	Class that bundles various TrackFitResults.

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

Private Attributes
unsigned short int	m_statusBitmap = 0
	Bitmap of the track status, contains informations on the refining stage.

short int	m_trackFitIndices [Const::ChargedStable::c_SetSize]
	Index list of the TrackFitResults associated with this Track.

float const	m_qualityIndicator
	Quality indicator for classification of fake vs.

float	m_trackTime = std::numeric_limits<float>::quiet_NaN()
	Track time, computed as the difference between outgoing/ingoing arm time and the SVDEvent T0.

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	FixMergedObjectsModule

class	PostMergeUpdaterModule

Detailed Description

Class that bundles various TrackFitResults.

As the RecoTrack has a lot of information that is only necessary during the fit, this is a much stripped down version containing only indices of TrackFitResults (which is what remains of the various TrackReps, that Genfit might use during the fit).

Definition at line 25 of file Track.h.

Member Typedef Documentation

◆ ChargedStableTrackFitResultPair

typedef std::pair< Const::ChargedStable, TrackFitResult*> ChargedStableTrackFitResultPair

Pair to hold the particle hypothesis used for the fit as first entry and the result of the track fit as second.

Definition at line 39 of file Track.h.

Member Enumeration Documentation

◆ StatusBit

enum StatusBit

status enumerator

Definition at line 29 of file Track.h.

                   {
 
      c_isFlippedAndRefitted = 1 << 0
 
    };

Constructor & Destructor Documentation

◆ Track()

Track ( float qualityIndicator = 0. )

inlineexplicit

Constructor of Track without any attached TrackFitResults.

Corresponding TrackFitResults should be added using the corresponding setter function. The array with the indices for the TrackFitResults is initialized with -1, which is an invalid index.

Parameters

qualityIndicator Initialises m_qualityIndicator with 0, a value associated typically with fake tracks.

Definition at line 48 of file Track.h.

                                                : m_qualityIndicator(qualityIndicator)
    {
      std::fill(m_trackFitIndices, m_trackFitIndices + Const::chargedStableSet.size(), -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);
    }

◆ addStatusBits()

void addStatusBits ( unsigned short int bitmask )

inline

Add Track Refining Status Bit.

Parameters

bitmask to be added to the m_statusBitmap

Definition at line 144 of file Track.h.

144{ m_statusBitmap |= bitmask; }

Belle2::Track::m_statusBitmap

unsigned short int m_statusBitmap

Bitmap of the track status, contains informations on the refining stage.

Definition: Track.h:227

◆ 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));
      }
    }

◆ getArrayIndex()

int getArrayIndex ( ) const

inlineinherited

Returns this object's array index (in StoreArray), or -1 if not found.

Definition at line 385 of file RelationsObject.h.

    {
      DataStore::Instance().findStoreEntry(this, m_cacheDataStoreEntry, m_cacheArrayIndex);
      return m_cacheArrayIndex;
    }

◆ 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();
    }

◆ 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

overridevirtual

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

Reimplemented from RelationsInterface< BASE >.

Definition at line 109 of file Track.cc.

{
  std::stringstream out;
  out << "<b>Number of Fitted Hypothesis</b>: " << getNumberOfFittedHypotheses() << "<br>";
 
  // just output all the TrackFitResult infos.
  size_t count = 1;
  for (auto fitResults : getTrackFitResults()) {
    out << "<p>";
    out << "<br><b>-- Hypothesis " << count << " --</b><br>";
    out << fitResults.second->getInfoHTML();
    out << "</p>";
    count++;
  }
  return out.str();
}

◆ getName()

virtual std::string getName ( ) const

inlinevirtualinherited

Return a short name that describes this object, e.g.

pi+ for an MCParticle.

Reimplemented in Particle, MCParticle, and SpacePoint.

Definition at line 344 of file RelationsObject.h.

344{ return ""; }

◆ getNumberOfFittedHypotheses()

unsigned int getNumberOfFittedHypotheses ( ) const

Returns the number of fitted hypothesis which are stored in this track.

Definition at line 36 of file Track.cc.

{
  return getValidIndices().size();
}

◆ getQualityIndicator()

float getQualityIndicator ( ) const

inline

Getter for quality indicator for classification of fake vs.

MC-matched Tracks.

During reconstruction, the probability (given a certain sample composition) of a track to originate from a charged particle rather than e.g. a random combination of hits from different charged particles and background contributions is estimated. This estimate includes information, that isn't used for the calculation of the p-value of the fit, e.g. energy-deposition, timing, and cluster-shape information. We consider it unlikely, that we will make such an estimate for each hypothesis. Therfore, the Track rather than the TrackFitResult is the place to store this information. We don't want to provide a default cut, because charged-particle-vetos and recombination of different kind of resonances potentially can profit from different working points on the efficiency-purity curve, and we expect some MC-data discrepancy due to imperfect calibration of the local reconstruction inputs. The meaning of the value may strongly depend on the presence of VXD or CDC measurements, but this information is available at mdst level as well.

Definition at line 198 of file Track.h.

    {
      return m_qualityIndicator;
    }

◆ 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));
    }

◆ getStatusBit()

bool getStatusBit ( unsigned short int bitmask ) const

inline

Get Track Status after Refining.

Parameters

bitmask

Returns: status (1 or 0) corresponding to the bitmask

Definition at line 155 of file Track.h.

155{ return (m_statusBitmap & bitmask) == bitmask; }

◆ getTrackFitResult()

const TrackFitResult * getTrackFitResult ( const Const::ChargedStable & chargedStable ) const

Default Access to TrackFitResults.

This tries to return the TrackFitResult for the requested track hypothesis. If the requested track hypothesis is not available, we return a nullptr.

TODO: Do something special if we did not even try to fit!

Parameters

chargedStable Determines the particle for which you want to get the best available fit hypothesis.

Returns: TrackFitResult for fit with particle hypothesis given by ParticleCode or a nullptr, if no result is available.

See also: TrackFitResult

Definition at line 30 of file Track.cc.

{
  return getTrackFitResultByName(chargedStable, "");
}

◆ getTrackFitResultByName()

const TrackFitResult * getTrackFitResultByName	(	const Const::ChargedStable &	chargedStable,
		const std::string	trackFitResultsName
	)		const

Access to TrackFitResults with a specified Name.

This tries to return the TrackFitResult for the requested track hypothesis. If the requested track hypothesis is not available, we return a nullptr.

TODO: Do something special if we did not even try to fit!

Parameters

chargedStable	Determines the particle for which you want to get the best available fit hypothesis.
trackFitResultsName	The name of the storeArray to get the TrackFitResults from

Returns: TrackFitResult for fit with particle hypothesis given by ParticleCode or a nullptr, if no result is available.

See also: TrackFitResult

Definition at line 17 of file Track.cc.

{
  const auto trackFitResultArrayIndex = m_trackFitIndices[chargedStable.getIndex()];
  if (trackFitResultArrayIndex < 0) {
    B2DEBUG(20, "TrackFitResult for the requested hypothesis is not set. Returning a nullptr instead.");
    return nullptr;
  }
 
  StoreArray<TrackFitResult> trackFitResults(trackFitResultsName);
  return trackFitResults[trackFitResultArrayIndex];
}

◆ getTrackFitResults()

std::vector< Track::ChargedStableTrackFitResultPair > getTrackFitResults ( ) const

Deafult Access to all track fit results at the same time.

Returns a vector of pair of all track fit results which have been set and the respective particle hypothesis they have been fitted with.

Definition at line 60 of file Track.cc.

{
  return getTrackFitResultsByName("");
}

◆ getTrackFitResultsByName()

std::vector< Track::ChargedStableTrackFitResultPair > getTrackFitResultsByName ( const std::string trackFitResultsName ) const

Access to all track fit results at the same time (from TrackFitResult with specified name)

Parameters

trackFitResultsName The name of the storeArray to get the TrackFitResults from Returns a vector of pair of all track fit results which have been set and the respective particle hypothesis they have been fitted with.

Definition at line 42 of file Track.cc.

{
  StoreArray<TrackFitResult> trackFitResults(trackFitResultsName);
  std::vector<Track::ChargedStableTrackFitResultPair> result;
 
  const auto validParticleIndices = getValidIndices();
 
  // extract the particle class and trackfitresult pointer for each
  // stored hypothesis
  for (auto  particleIndex : validParticleIndices) {
    const auto indexInStoreArray = m_trackFitIndices[particleIndex];
    result.emplace_back(std::make_pair(Const::ChargedStable(Const::chargedStableSet.at(particleIndex)),
                                       trackFitResults[indexInStoreArray]));
  }
 
  return result;
}

◆ getTrackFitResultWithClosestMass()

const TrackFitResult * getTrackFitResultWithClosestMass ( const Const::ChargedStable & requestedType ) const

Return the track fit for a fit hypothesis with the closest mass.

Multiple particle hypothesis are used for fitting during the reconstruction and stored with this Track class. Not all hypothesis are available for all tracks because either a specific hypothesis was not fitted or because the fit failed. This method returns the track fit result of a successful fit with the hypothesis of a mass closest to the requested particle type. If the requested type's hypothesis is available it will be returned otherwise the next closest hypothesis in terms of the absolute mass difference will be returned.

For example, if a pion is requested (mass 140 MeV) and only a muon fit (mass 106 MeV) and an electron fit (mass 511 kEV) is available, the muon fit result will be returned. So this method is guaranteed to always return a TrackFitResult (opposite to getTrackFitResult() which can return nullptr if the requested Particle type was not fitted).

Parameters

requestedType The particle type for which the fit result should be returned.

Returns: a pointer to the TrackFitResult object. Use TrackFitResult::getParticleType() to check which fitting hypothesis was actually used for this result.

Definition at line 104 of file Track.cc.

{
  return getTrackFitResultWithClosestMassByName(requestedType, "");
}

◆ getTrackFitResultWithClosestMassByName()

const TrackFitResult * getTrackFitResultWithClosestMassByName	(	const Const::ChargedStable &	requestedType,
		const std::string	trackFitResultsName
	)		const

Return the track fit (from TrackFitResult with specified name) for a fit hypothesis with the closest mass.

Multiple particle hypothesis are used for fitting during the reconstruction and stored with this Track class. Not all hypothesis are available for all tracks because either a specific hypothesis was not fitted or because the fit failed. This method returns the track fit result of a successful fit with the hypothesis of a mass closest to the requested particle type. If the requested type's hypothesis is available it will be returned otherwise the next closest hypothesis in terms of the absolute mass difference will be returned.

For example, if a pion is requested (mass 140 MeV) and only a muon fit (mass 106 MeV) and an electron fit (mass 511 kEV) is available, the muon fit result will be returned. So this method is guaranteed to always return a TrackFitResult (opposite to getTrackFitResult() which can return nullptr if the requested Particle type was not fitted).

Parameters

requestedType	The particle type for which the fit result should be returned.
trackFitResultsName	The name of the storeArray to get the TrackFitResults from

Returns: a pointer to the TrackFitResult object. Use TrackFitResult::getParticleType() to check which fitting hypothesis was actually used for this result.

Definition at line 80 of file Track.cc.

{
  // make sure at least one hypothesis exist. No B2 Track should exist which does not have at least
  // one hypothesis
  B2ASSERT("Belle2::Track must always have at least one successfully fitted hypothesis.", getNumberOfFittedHypotheses() > 0);
 
  // find fitted hypothesis which is closest to the mass of our requested particle type
  auto allFitRes = getTrackFitResultsByName(trackFitResultsName);
 
  // sort so the closest mass hypothesis fit in the first entry of the vector
  auto bestMassFit = std::min_element(allFitRes.begin(), allFitRes.end(), [requestedType](auto & a, auto & b) {
    const auto massDiffA = std::abs(a.first.getMass() - requestedType.getMass());
    const auto massDiffB = std::abs(b.first.getMass() - requestedType.getMass());
 
    return massDiffA < massDiffB;
  });
 
  if (std::isnan(bestMassFit->second->getPValue())) {
    return nullptr;
  }
  return bestMassFit->second;
}

◆ getTrackTime()

float getTrackTime ( ) const

inline

Returns track time computed as the difference between the average of SVD clusters time and the SVD EventT0.

Definition at line 215 of file Track.h.

    {
      return m_trackTime;
    }

◆ getValidIndices()

std::vector< short int > getValidIndices ( ) const

private

Returns a vector of all fit hypothesis indices in m_trackFitIndices which have been set (meaning are not -1)

Definition at line 65 of file Track.cc.

{
  std::vector <short int> resultParticleIndex;
 
  short int i = 0;
  for (const auto& hyp : m_trackFitIndices) {
    if (hyp != -1) {
      resultParticleIndex.push_back(i);
    }
    i++;
  }
 
  return resultParticleIndex;
}

◆ isFlippedAndRefitted()

bool isFlippedAndRefitted ( ) const

inline

Check the Track status after the Refining step.

Returns: true if the track was flipped and refitted in the refining step

Definition at line 160 of file Track.h.

160{ return getStatusBit(c_isFlippedAndRefitted); }

Belle2::Track::getStatusBit

bool getStatusBit(unsigned short int bitmask) const

Get Track Status after Refining.

Definition: Track.h:155

◆ setFlippedAndRefitted()

void setFlippedAndRefitted ( )

inline

Set the Track status bit when the track has been flipped and refitted in the refining step.

Definition at line 149 of file Track.h.

149{ addStatusBits(c_isFlippedAndRefitted); }

Belle2::Track::addStatusBits

void addStatusBits(unsigned short int bitmask)

Add Track Refining Status Bit.

Definition: Track.h:144

◆ setTrackFitResultIndex()

void setTrackFitResultIndex	(	const Const::ChargedStable &	chargedStable,
		short	index
	)

inline

Set an index (for positive values) or unavailability-code (index = -1) for a specific mass hypothesis.

The TrackFitResult itself should be saved separately in the DataStore.

Parameters

chargedStable	Determines the hypothesis for which you want to store the index or unavailability-code.
index	index of track fit result (for positive values) or unavailability-code (index = -1)

Definition at line 174 of file Track.h.

    {
      m_trackFitIndices[chargedStable.getIndex()] = index;
    }

◆ setTrackTime()

void setTrackTime ( float track_time )

inline

Set track time computed as the difference between the outgoing/ingoing arm time (computed with SVD hits) and the SVD EventT0.

If both outgoing and ingoing arms exist: 1) if the outgoing arm time is smaller than the ingoing arm time, the track time is computed as the difference of the outgoing arm time and the SVD EventT0; 2) otherwise the track time is computed as the difference of the ingoing arm time and the SVD EventT0. If only the outgoing arm exists, the track time is computed as the difference of the outgoing arm time and the SVD EventT0. If only the ingoing arm exists, the track time is computed as the difference of the ingoing arm time and the SVD EventT0.

Definition at line 209 of file Track.h.

    {
      m_trackTime = track_time;
    }

◆ wasRefined()

bool wasRefined ( )

inline

Check whether Track was modified in the Refining step.

Returns: true if the track was modified in the refining step

Definition at line 165 of file Track.h.

165{ return m_statusBitmap > 0; }

Friends And Related Function Documentation

◆ FixMergedObjectsModule

friend class FixMergedObjectsModule

friend

Definition at line 250 of file Track.h.

◆ PostMergeUpdaterModule

friend class PostMergeUpdaterModule

friend

Definition at line 251 of file Track.h.

Member Data Documentation

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

float const m_qualityIndicator

private

Quality indicator for classification of fake vs.

MC-matched Tracks.

Given likely data-MC discrepancies etc orders of magnitude larger than float precision, single precision is enough.

Definition at line 243 of file Track.h.

◆ m_statusBitmap

unsigned short int m_statusBitmap = 0

private

Bitmap of the track status, contains informations on the refining stage.

Definition at line 227 of file Track.h.

◆ m_trackFitIndices

short int m_trackFitIndices[Const::ChargedStable::c_SetSize]

private

Index list of the TrackFitResults associated with this Track.

Definition at line 230 of file Track.h.

◆ m_trackTime

float m_trackTime = std::numeric_limits<float>::quiet_NaN()

private

Track time, computed as the difference between outgoing/ingoing arm time and the SVDEvent T0.

Definition at line 246 of file Track.h.

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

mdst/dataobjects/include/Track.h
mdst/dataobjects/src/Track.cc

Public Types

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ ChargedStableTrackFitResultPair

Member Enumeration Documentation

◆ StatusBit

Constructor & Destructor Documentation

◆ Track()

Member Function Documentation

◆ addRelationTo() [1/2]

◆ addRelationTo() [2/2]

◆ addStatusBits()

◆ copyRelations()

◆ getArrayIndex()

◆ getArrayName()

◆ getArrayPointer()

◆ getInfo()

◆ getInfoHTML()

◆ getName()

◆ getNumberOfFittedHypotheses()

◆ getQualityIndicator()

◆ getRelated()

◆ getRelatedFrom()

◆ getRelatedFromWithWeight()

◆ getRelatedTo()

◆ getRelatedToWithWeight()

◆ getRelatedWithWeight()

◆ getRelationsFrom()

◆ getRelationsTo()

◆ getRelationsWith()

◆ getStatusBit()

◆ getTrackFitResult()

◆ getTrackFitResultByName()

◆ getTrackFitResults()

◆ getTrackFitResultsByName()

◆ getTrackFitResultWithClosestMass()

◆ getTrackFitResultWithClosestMassByName()

◆ getTrackTime()

◆ getValidIndices()

◆ isFlippedAndRefitted()

◆ setFlippedAndRefitted()

◆ setTrackFitResultIndex()

◆ setTrackTime()

◆ wasRefined()

Friends And Related Function Documentation

◆ FixMergedObjectsModule

◆ PostMergeUpdaterModule

Member Data Documentation

◆ m_cacheArrayIndex

◆ m_cacheDataStoreEntry

◆ m_qualityIndicator

◆ m_statusBitmap

◆ m_trackFitIndices

◆ m_trackTime