GFTrack Class Reference

Track object for genfit. genfit algorithms work on these objects. More...

#include <GFTrack.h>

Inheritance diagram for GFTrack:

Public Member Functions
	GFTrack ()
	Default constructor – needed for compatibility with ROOT. More...
	GFTrack (const GFTrack &)
	Copy constructor. More...
GFTrack &	operator= (const GFTrack &)
	assignement operator More...
	GFTrack (GFAbsTrackRep *, bool smooth=false)
	Initializing constructor. More...
virtual	~GFTrack ()
void	reset ()
	Resets the GFTrack – deletes RecoHits! More...
int	getFailedHits (int repId=-1)
	return the number of failed Hits in track fit repId == -1 will use cardinal rep More...
std::vector< GFAbsRecoHit * >	getHits ()
const GFTrackCand &	getCand () const
GFAbsRecoHit *	getHit (int id) const
unsigned int	getNumHits () const
void	mergeHits (GFTrack *trk)
	Merge two GFTracks. Only hits will be merged. More...
void	releaseHits ()
	Clear hit vector. Note that hits will not be deleted! More...
void	releaseTrackReps ()
	Clear TrackRep vector. Note that the Reps will not be deleted! More...
unsigned int	getNextHitToFit () const
	Accessor for fNextHitToFit. More...
void	setNextHitToFit (unsigned int i)
	Set next hit to be used in a fit. More...
GFAbsTrackRep *	getTrackRep (int id) const
	Accessor for track representations. More...
unsigned int	getNumReps () const
	Get number of track represenatations. More...
GFAbsTrackRep *	getCardinalRep () const
	Get cardinal track representation. More...
TVector3	getMom () const
	Get momentum at the present position. More...
TVector3	getMom (const GFDetPlane &pl) const
	Get momentum at GFDetPlane. More...
TVector3	getPos () const
	Get present position. More...
TVector3	getPos (const GFDetPlane &pl) const
	Get position at GFDetPlane. More...
void	getPosMomCov (TVector3 &pos, TVector3 &mom, TMatrixT< double > &cov)
	Get position, momentum, and 6x6 covariance at current position. More...
void	getPosMomCov (const GFDetPlane &pl, TVector3 &pos, TVector3 &mom, TMatrixT< double > &cov)
	Get position, momentum, and 6x6 covariance at GFDetPlane. More...
double	getChiSqu () const
	Get chi2. More...
unsigned int	getNDF () const
	Get NDF. More...
double	getRedChiSqu () const
	Get chi2/NDF. More...
double	getCharge () const
	Get charge from fit. More...
void	fillGeoTrack (TVirtualGeoTrack *tr) const
	Fill TVirtualGeoTrack object Cardinal representation is used. More...
void	fillGeoTrack (TVirtualGeoTrack *tr, unsigned int repid) const
	Fill TVirtualGeoTrack object with data from specified track rep. More...
void	addFailedHit (unsigned int irep, unsigned int id)
void	addHit (GFAbsRecoHit *theHit)
	deprecated! More...
void	addHit (GFAbsRecoHit *theHit, unsigned int detId, unsigned int hitId, double rho=0., unsigned int planeId=0)
	Add single hit. Updates the GFTrackCand. More...
void	addHitVector (std::vector< GFAbsRecoHit *> hits)
	Add collection of hits. More...
void	addTrackRep (GFAbsTrackRep *theTrackRep)
	Add track represenation. More...
GFBookkeeping *	getBK (int index=-1)
	get GFBookKeeping object for particular track rep (default is cardinal rep) More...
void	setCandidate (const GFTrackCand &cand, bool doreset=false)
	set track candidate More...
void	setCardinalRep (unsigned int r)
	Choose cardinal track represenatation. More...
void	getResiduals (unsigned int detId, unsigned int dim, unsigned int rep, std::vector< double > &result)
	Get residuals. More...
void	setRepAtHit (unsigned int irep, int ihit)
	set the hit index at which plane,state&cov of rep irep is defined More...
int	getRepAtHit (unsigned int irep)
	get the hit index at which plane,state&cov of rep irep is defined More...
void	clearRepAtHit ()
	clear the hit indices at which plane,state&cov of reps are defined More...
void	printBookkeeping ()
	print bookkeeping More...
void	Print ()
void	clearBookkeeping ()
void	clearFailedHits ()
void	getHitsByPlane (std::vector< std::vector< int > *> &retVal)
void	setSmoothing (bool smooth=true)
	Switch smoothing on or off for this track. More...
bool	getSmoothing ()
	Read back if smoothing is/was turned on or off for this track. More...
void	blowUpCovs (double blowUpFactor)
	this is needed to blow up the covariance matrix before a fitting pass drops off-diagonal elements and blows up diagonal by blowUpFactor More...

Detailed Description

Track object for genfit. genfit algorithms work on these objects.

Author

Christian Höppner (Technische Universität München, original author)

Sebastian Neubert (Technische Universität München, original author)

Can be used as transient (only in memory) or persistent (written to ROOT-file) object.

A GFTrack contains a collection of RecoHits plus a collection of track representations. The GFTrackCand member is a helper object to store the indices of the hits in the GFTrack.

For a GFTrack one so called "cardinal representation" can be defined. It is that track representation that is used to access the fit results. Usually one will after the fit choose the best fitting representation to be the cardinal rep.

The GFTRack takes ownership over the GFAbsRecoHit pointers it holds.

Definition at line 71 of file GFTrack.h.

Constructor & Destructor Documentation

GFTrack() [1/3]

GFTrack::GFTrack

(

)

Default constructor – needed for compatibility with ROOT.

GFTrack() [2/3]

GFTrack::GFTrack

(

const GFTrack &

)

Copy constructor.

GFTrack() [3/3]

GFTrack::GFTrack	(	GFAbsTrackRep *	,
		bool	smooth = false
	)

Initializing constructor.

A track needs at least one track representation to be useable. The given track representation has to contain starting values for the fit!

~GFTrack()

virtual GFTrack::~GFTrack ( )

virtual

Member Function Documentation

addFailedHit()

void GFTrack::addFailedHit ( unsigned int  irep, unsigned int  id  )

inline

Definition at line 286 of file GFTrack.h.

  {
    assert(irep < fBookkeeping.size());
    fBookkeeping.at(irep)->addFailedHit(id);
  }

addHit() [1/2]

void GFTrack::addHit ( GFAbsRecoHit *  theHit )

inline

deprecated!

Definition at line 294 of file GFTrack.h.

{ fHits.push_back(theHit); }

addHit() [2/2]

void GFTrack::addHit ( GFAbsRecoHit *  theHit, unsigned int  detId, unsigned int  hitId, double  rho = 0., unsigned int  planeId = 0  )

inline

Add single hit. Updates the GFTrackCand.

Definition at line 298 of file GFTrack.h.

References GFTrackCand::addHit().

  {
    fHits.push_back(theHit);
    fCand.addHit(detId, hitId, rho, planeId);
  }

addHitVector()

void GFTrack::addHitVector ( std::vector< GFAbsRecoHit *>  hits )

inline

Add collection of hits.

This is the standard way to fill the track with hit data

Definition at line 308 of file GFTrack.h.

{ fHits = hits; }

addTrackRep()

void GFTrack::addTrackRep ( GFAbsTrackRep *  theTrackRep )

inline

Add track represenation.

The given track representation has to contain starting values for fit!

Definition at line 314 of file GFTrack.h.

  {
    if (fTrackReps == nullptr)
      fTrackReps = new TObjArray(fDefNumTrackReps);
    fTrackReps->Add(theTrackRep);
    fBookkeeping.push_back(new GFBookkeeping());
    fRepAtHit.push_back(-1);
  }

blowUpCovs()

void GFTrack::blowUpCovs

(

double

blowUpFactor

)

this is needed to blow up the covariance matrix before a fitting pass drops off-diagonal elements and blows up diagonal by blowUpFactor

Referenced by getSmoothing().

clearBookkeeping()

void GFTrack::clearBookkeeping ( )

inline

Definition at line 388 of file GFTrack.h.

References getNumReps(), and i.

  {
    for (unsigned int i = 0; i < getNumReps(); ++i) {
      fBookkeeping.at(i)->clearAll();
    }
  }

clearFailedHits()

void GFTrack::clearFailedHits ( )

inline

Definition at line 395 of file GFTrack.h.

References getHitsByPlane(), getNumReps(), and i.

  {
    for (unsigned int i = 0; i < getNumReps(); ++i) {
      fBookkeeping.at(i)->clearFailedHits();
    }
  }

clearRepAtHit()

void GFTrack::clearRepAtHit ( )

inline

clear the hit indices at which plane,state&cov of reps are defined

Definition at line 375 of file GFTrack.h.

References getNumReps(), i, Print(), and printBookkeeping().

  {
    for (unsigned int i = 0; i < getNumReps(); ++i) {
      fRepAtHit.at(i) = -1;
    }
  }

fillGeoTrack() [1/2]

void GFTrack::fillGeoTrack ( TVirtualGeoTrack *  tr ) const

inline

Fill TVirtualGeoTrack object Cardinal representation is used.

Definition at line 276 of file GFTrack.h.

References fillGeoTrack().

Referenced by fillGeoTrack().

{ fillGeoTrack(tr, fCardinal_rep); }

fillGeoTrack() [2/2]

void GFTrack::fillGeoTrack	(	TVirtualGeoTrack *	tr,
		unsigned int	repid
	)		const

Fill TVirtualGeoTrack object with data from specified track rep.

getBK()

GFBookkeeping* GFTrack::getBK ( int  index = -1 )

inline

get GFBookKeeping object for particular track rep (default is cardinal rep)

Definition at line 324 of file GFTrack.h.

References getNumReps(), and setCandidate().

  {
    if (index == -1)
      return fBookkeeping.at(fCardinal_rep);
    assert((unsigned int)index < getNumReps());
    return fBookkeeping.at(index);
  }

getCand()

const GFTrackCand& GFTrack::getCand ( ) const

inline

Definition at line 153 of file GFTrack.h.

{ return fCand; }

getCardinalRep()

GFAbsTrackRep* GFTrack::getCardinalRep ( ) const

inline

Get cardinal track representation.

The user has to choose which track rep should be considered the best one after the fit. Usually the track representation giving the smallest chi2 is choosen. By default the first in the list is returned.

Definition at line 209 of file GFTrack.h.

Referenced by getCharge(), getChiSqu(), getMom(), getNDF(), getPos(), getPosMomCov(), and getRedChiSqu().

{ return ((GFAbsTrackRep *)fTrackReps->At(fCardinal_rep)); }

getCharge()

double GFTrack::getCharge ( ) const

inline

Get charge from fit.

Cardinal representation is used.

Definition at line 272 of file GFTrack.h.

References getCardinalRep(), and GFAbsTrackRep::getCharge().

{ return getCardinalRep()->getCharge(); }

getChiSqu()

double GFTrack::getChiSqu ( ) const

inline

Get chi2.

Cardinal representation is used.

Definition at line 254 of file GFTrack.h.

References getCardinalRep(), and GFAbsTrackRep::getChiSqu().

{ return getCardinalRep()->getChiSqu(); }

getFailedHits()

int GFTrack::getFailedHits ( int  repId = -1 )

inline

return the number of failed Hits in track fit repId == -1 will use cardinal rep

Definition at line 141 of file GFTrack.h.

  {
    int theRep;
    if (repId == -1)
      theRep = fCardinal_rep;
    else
      theRep = repId;
    return fBookkeeping.at(theRep)->getNumFailed();
  }

getHit()

GFAbsRecoHit* GFTrack::getHit ( int  id ) const

inline

Definition at line 155 of file GFTrack.h.

{ return fHits.at(id); }

getHits()

std::vector<GFAbsRecoHit *> GFTrack::getHits ( )

inline

Definition at line 151 of file GFTrack.h.

{ return fHits; }

getHitsByPlane()

void GFTrack::getHitsByPlane

(

std::vector< std::vector< int > *> &

retVal

)

use planeId information of GFTrackCand and return by ref groups of hit ids which are in the same planes.

Referenced by clearFailedHits().

getMom() [1/2]

TVector3 GFTrack::getMom ( ) const

inline

Get momentum at the present position.

Cardinal representation is used.

Definition at line 215 of file GFTrack.h.

References getCardinalRep(), and GFAbsTrackRep::getMom().

{ return getCardinalRep()->getMom(); }

getMom() [2/2]

TVector3 GFTrack::getMom ( const GFDetPlane &  pl ) const

inline

Get momentum at GFDetPlane.

The track will be extrapolated to GFDetPlane to get the momentum there. The track will not be modified. Cardinal representation is used.

Definition at line 222 of file GFTrack.h.

References getCardinalRep(), and GFAbsTrackRep::getMom().

{ return getCardinalRep()->getMom(pl); }

getNDF()

unsigned int GFTrack::getNDF ( ) const

inline

Get NDF.

Cardinal representation is used.

Definition at line 260 of file GFTrack.h.

References getCardinalRep(), and GFAbsTrackRep::getNDF().

{ return getCardinalRep()->getNDF(); }

getNextHitToFit()

unsigned int GFTrack::getNextHitToFit ( ) const

inline

Accessor for fNextHitToFit.

Definition at line 189 of file GFTrack.h.

{ return fNextHitToFit; }

getNumHits()

unsigned int GFTrack::getNumHits ( ) const

inline

Definition at line 157 of file GFTrack.h.

References mergeHits().

{ return fHits.size(); }

getNumReps()

unsigned int GFTrack::getNumReps ( ) const

inline

Get number of track represenatations.

Definition at line 201 of file GFTrack.h.

Referenced by clearBookkeeping(), clearFailedHits(), clearRepAtHit(), getBK(), getRepAtHit(), and setRepAtHit().

{ return fTrackReps->GetEntriesFast(); }

getPos() [1/2]

TVector3 GFTrack::getPos ( ) const

inline

Get present position.

Cardinal representation is used.

Definition at line 228 of file GFTrack.h.

References getCardinalRep(), and GFAbsTrackRep::getPos().

{ return getCardinalRep()->getPos(); }

getPos() [2/2]

TVector3 GFTrack::getPos ( const GFDetPlane &  pl ) const

inline

Get position at GFDetPlane.

The track will be extrapolated to GFDetPlane to get the position there. The track will not be modified. Cardinal representation is used.

Definition at line 235 of file GFTrack.h.

References getCardinalRep(), and GFAbsTrackRep::getPos().

{ return getCardinalRep()->getPos(pl); }

getPosMomCov() [1/2]

void GFTrack::getPosMomCov ( TVector3 &  pos, TVector3 &  mom, TMatrixT< double > &  cov  )

inline

Get position, momentum, and 6x6 covariance at current position.

Cardinal representation is used.

Definition at line 241 of file GFTrack.h.

References getCardinalRep(), and GFAbsTrackRep::getPosMomCov().

{ getCardinalRep()->getPosMomCov(pos, mom, cov); }

getPosMomCov() [2/2]

void GFTrack::getPosMomCov ( const GFDetPlane &  pl, TVector3 &  pos, TVector3 &  mom, TMatrixT< double > &  cov  )

inline

Get position, momentum, and 6x6 covariance at GFDetPlane.

The track will be extrapolated to GFDetPlane to get everything there. The track will not be modified. Cardinal representation is used.

Definition at line 248 of file GFTrack.h.

References getCardinalRep(), and GFAbsTrackRep::getPosMomCov().

{ getCardinalRep()->getPosMomCov(pl, pos, mom, cov); }

getRedChiSqu()

double GFTrack::getRedChiSqu ( ) const

inline

Get chi2/NDF.

Cardinal representation is used.

Definition at line 266 of file GFTrack.h.

References getCardinalRep(), and GFAbsTrackRep::getRedChiSqu().

{ return getCardinalRep()->getRedChiSqu(); }

getRepAtHit()

int GFTrack::getRepAtHit ( unsigned int  irep )

inline

get the hit index at which plane,state&cov of rep irep is defined

Definition at line 367 of file GFTrack.h.

References getNumReps().

  {
    assert(irep < getNumReps());
    return fRepAtHit.at(irep);
  }

getResiduals()

void GFTrack::getResiduals	(	unsigned int	detId,
		unsigned int	dim,
		unsigned int	rep,
		std::vector< double > &	result
	)

Get residuals.

Parameters

detId	which detector?
dim	= index of coordinate to choose from resiudal vector
rep	which track representation?
result	results are written to this vector

Referenced by setCardinalRep().

getSmoothing()

bool GFTrack::getSmoothing ( )

inline

Read back if smoothing is/was turned on or off for this track.

Definition at line 412 of file GFTrack.h.

References blowUpCovs().

{ return fSmooth; }

getTrackRep()

GFAbsTrackRep* GFTrack::getTrackRep ( int  id ) const

inline

Accessor for track representations.

Definition at line 197 of file GFTrack.h.

{ return reinterpret_cast<GFAbsTrackRep *>(fTrackReps->At(id)); }

mergeHits()

void GFTrack::mergeHits

(

GFTrack *

trk

)

Merge two GFTracks. Only hits will be merged.

All hits from trk will be merged into this GFTrack. trk will be empty afterwards.

Kalman::continueTrack can be used to include the newly added hits in the fit.

Note that the new hits are inserted at the end of the present track!

Referenced by getNumHits().

operator=()

GFTrack& GFTrack::operator=

(

const GFTrack &

)

assignement operator

Print()

void GFTrack::Print

(

)

Referenced by clearRepAtHit().

printBookkeeping()

void GFTrack::printBookkeeping

(

)

print bookkeeping

Referenced by clearRepAtHit().

releaseHits()

void GFTrack::releaseHits ( )

inline

Clear hit vector. Note that hits will not be deleted!

Be carefull not to create memory leaks here.

Definition at line 175 of file GFTrack.h.

{ fHits.clear(); }

releaseTrackReps()

void GFTrack::releaseTrackReps ( )

inline

Clear TrackRep vector. Note that the Reps will not be deleted!

Be carefull not to create memory leaks here.

Definition at line 181 of file GFTrack.h.

  {
    fTrackReps->SetOwner(kFALSE);
    fTrackReps->Clear();
  }

reset()

void GFTrack::reset

(

)

Resets the GFTrack – deletes RecoHits!

setCandidate()

void GFTrack::setCandidate	(	const GFTrackCand &	cand,
		bool	doreset = false
	)

set track candidate

Referenced by getBK().

setCardinalRep()

void GFTrack::setCardinalRep ( unsigned int  r )

inline

Choose cardinal track represenatation.

See also

getCardinalRep

Definition at line 339 of file GFTrack.h.

References getResiduals().

  {
    if ((int)r < fTrackReps->GetEntriesFast())
      fCardinal_rep = r;
  }

setNextHitToFit()

void GFTrack::setNextHitToFit ( unsigned int  i )

inline

Set next hit to be used in a fit.

Definition at line 193 of file GFTrack.h.

References i.

{ fNextHitToFit = i; }

setRepAtHit()

void GFTrack::setRepAtHit ( unsigned int  irep, int  ihit  )

inline

set the hit index at which plane,state&cov of rep irep is defined

Definition at line 359 of file GFTrack.h.

References getNumReps().

  {
    assert(irep < getNumReps());
    fRepAtHit.at(irep) = ihit;
  }

setSmoothing()

void GFTrack::setSmoothing ( bool  smooth = true )

inline

Switch smoothing on or off for this track.

Definition at line 408 of file GFTrack.h.

{ fSmooth = smooth; }

---

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

• GFTrack.h