MassPointingVertexFitKFit is a derived class from KFitBase It performs a kinematical fit with three constraints: the invariant mass is constrained to its PDG value, the tracks are forced to a common vertex, and the momentum vector is forced to point to an externally provided space point. More...

#include <MassPointingVertexFitKFit.h>

Inheritance diagram for MassPointingVertexFitKFit:

[legend]

Collaboration diagram for MassPointingVertexFitKFit:

[legend]

Public Member Functions
	MassPointingVertexFitKFit (void)
	Construct an object with no argument.

	~MassPointingVertexFitKFit (void)
	Destruct the object.

enum KFitError::ECode	setInitialVertex (const HepPoint3D &v)
	Set an initial vertex point for the mass-vertex-pointing constraint fit. More...

enum KFitError::ECode	setInvariantMass (const double m)
	Set an invariant mass for the mass-vertex-pointing constraint fit. More...

enum KFitError::ECode	setProductionVertex (const HepPoint3D &v)
	Set the production vertex of the particle. More...

enum KFitError::ECode	fixMass (void)
	Tell the object to fix the last added track property at the invariant mass. More...

enum KFitError::ECode	unfixMass (void)
	Tell the object to unfix the last added track property at the invariant mass. More...

enum KFitError::ECode	setCorrelation (const CLHEP::HepMatrix &m) override
	Set a correlation matrix. More...

enum KFitError::ECode	setZeroCorrelation (void) override
	Indicate no correlation between tracks. More...

const HepPoint3D	getVertex (const int flag=KFitConst::kAfterFit) const
	Get a vertex position. More...

const CLHEP::HepSymMatrix	getVertexError (void) const
	Get a fitted vertex error matrix. More...

double	getInvariantMass (void) const
	Get an invariant mass. More...

double	getCHIsq (void) const override
	Get a chi-square of the fit. More...

const CLHEP::HepMatrix	getTrackVertexError (const int id) const
	Get a vertex error matrix of the track. More...

double	getTrackCHIsq (const int id) const override
	Get a chi-square of the track. More...

const CLHEP::HepMatrix	getCorrelation (const int id1, const int id2, const int flag=KFitConst::kAfterFit) const override
	Get a correlation matrix between two tracks. More...

enum KFitError::ECode	doFit (void)
	Perform a mass-vertex-pointing constraint fit. More...

enum KFitError::ECode	updateMother (Particle *mother)
	Update mother particle. More...

enum KFitError::ECode	addTrack (const KFitTrack &kp)
	Add a track to the fitter object. More...

enum KFitError::ECode	addTrack (const CLHEP::HepLorentzVector &p, const HepPoint3D &x, const CLHEP::HepSymMatrix &e, const double q)
	Add a track to the fitter object with specifying its momentum, position, error matrix, and charge. More...

enum KFitError::ECode	addParticle (const Particle *particle)
	Add a particle to the fitter. More...

enum KFitError::ECode	setMagneticField (const double mf)
	Change a magnetic field from the default value KFitConst::kDefaultMagneticField. More...

enum KFitError::ECode	getErrorCode (void) const
	Get a code of the last error. More...

int	getTrackCount (void) const
	Get the number of added tracks. More...

virtual int	getNDF (void) const
	Get an NDF of the fit. More...

double	getMagneticField (void) const
	Get a magnetic field. More...

const CLHEP::HepLorentzVector	getTrackMomentum (const int id) const
	Get a Lorentz vector of the track. More...

const HepPoint3D	getTrackPosition (const int id) const
	Get a position of the track. More...

const CLHEP::HepSymMatrix	getTrackError (const int id) const
	Get an error matrix of the track. More...

const KFitTrack	getTrack (const int id) const
	Get a specified track object. More...

bool	isFitted (void) const
	Return false if fit is not performed yet or performed fit is failed; otherwise true. More...

Protected Member Functions
const CLHEP::HepSymMatrix	makeError1 (const CLHEP::HepLorentzVector &p, const CLHEP::HepMatrix &e) const
	Rebuild an error matrix from a Lorentz vector and an error matrix. More...

const CLHEP::HepMatrix	makeError1 (const CLHEP::HepLorentzVector &p1, const CLHEP::HepLorentzVector &p2, const CLHEP::HepMatrix &e) const
	Rebuild an error matrix from a pair of Lorentz vectors and an error matrix. More...

const CLHEP::HepMatrix	makeError2 (const CLHEP::HepLorentzVector &p, const CLHEP::HepMatrix &e) const
	Rebuild an error matrix from a Lorentz vector and an error matrix. More...

const CLHEP::HepSymMatrix	makeError3 (const CLHEP::HepLorentzVector &p, const CLHEP::HepMatrix &e, const bool is_fix_mass) const
	Rebuild an error matrix from a Lorentz vector and an error matrix. More...

const CLHEP::HepMatrix	makeError3 (const CLHEP::HepLorentzVector &p1, const CLHEP::HepLorentzVector &p2, const CLHEP::HepMatrix &e, const bool is_fix_mass1, const bool is_fix_mass2) const
	Rebuild an error matrix from a pair of Lorentz vectors and an error matrix. More...

const CLHEP::HepMatrix	makeError4 (const CLHEP::HepLorentzVector &p, const CLHEP::HepMatrix &e) const
	Rebuild an error matrix from a Lorentz vector and an error matrix. More...

enum KFitError::ECode	doFit1 (void)
	Perform a fit (used in MassFitKFit::doFit()). More...

enum KFitError::ECode	doFit2 (void)
	Perform a fit (used in VertexFitKFit::doFit() and MassVertexFitKFit::doFit()). More...

bool	isTrackIDInRange (const int id) const
	Check if the id is in the range. More...

bool	isNonZeroEnergy (const CLHEP::HepLorentzVector &p) const
	Check if the energy is non-zero. More...

Protected Attributes
enum KFitError::ECode	m_ErrorCode
	Error code.

bool	m_FlagFitted
	Flag to indicate if the fit is performed and succeeded.

std::vector< KFitTrack >	m_Tracks
	Container of input tracks.

std::vector< CLHEP::HepMatrix >	m_BeforeCorrelation
	Container of input correlation matrices.

CLHEP::HepSymMatrix	m_V_al_0
	See J.Tanaka Ph.D (2001) p137 for definition.

CLHEP::HepMatrix	m_al_0
	See J.Tanaka Ph.D (2001) p136 for definition.

CLHEP::HepMatrix	m_al_1
	See J.Tanaka Ph.D (2001) p136 for definition.

CLHEP::HepMatrix	m_al_a
	See J.Tanaka Ph.D (2001) p137 for definition.

CLHEP::HepMatrix	m_property
	Container of charges and masses.

CLHEP::HepMatrix	m_D
	See J.Tanaka Ph.D (2001) p137 for definition.

CLHEP::HepMatrix	m_d
	See J.Tanaka Ph.D (2001) p137 for definition.

CLHEP::HepMatrix	m_V_D
	See J.Tanaka Ph.D (2001) p138 for definition.

CLHEP::HepMatrix	m_V_al_1
	See J.Tanaka Ph.D (2001) p138 for definition.

CLHEP::HepMatrix	m_lam
	See J.Tanaka Ph.D (2001) p137 for definition.

CLHEP::HepMatrix	m_E
	See J.Tanaka Ph.D (2001) p137 for definition.

CLHEP::HepMatrix	m_V_E
	See J.Tanaka Ph.D (2001) p138 for definition.

CLHEP::HepMatrix	m_lam0
	See J.Tanaka Ph.D (2001) p138 for definition.

CLHEP::HepMatrix	m_v
	See J.Tanaka Ph.D (2001) p137 for definition.

CLHEP::HepMatrix	m_v_a
	See J.Tanaka Ph.D (2001) p137 for definition.

CLHEP::HepMatrix	m_V_Dt
	See J.Tanaka Ph.D (2001) p138 for definition.

CLHEP::HepMatrix	m_Cov_v_al_1
	See J.Tanaka Ph.D (2001) p137 for definition.

int	m_NDF
	NDF of the fit.

double	m_CHIsq
	chi-square of the fit.

int	m_TrackCount
	Number of tracks.

int	m_NecessaryTrackCount
	Number needed tracks to perform fit.

bool	m_FlagCorrelation
	Flag whether a correlation among tracks exists.

bool	m_FlagOverIteration
	Flag whether the iteration count exceeds the limit.

double	m_MagneticField
	Magnetic field.

Private Member Functions
enum KFitError::ECode	prepareInputMatrix (void) override
	Build grand matrices for minimum search from input-track properties. More...

enum KFitError::ECode	prepareInputSubMatrix (void) override
	Build sub-matrices for minimum search from input-track properties. More...

enum KFitError::ECode	prepareCorrelation (void) override
	Build a grand correlation matrix from input-track properties. More...

enum KFitError::ECode	prepareOutputMatrix (void) override
	Build an output error matrix. More...

enum KFitError::ECode	makeCoreMatrix (void) override
	Build matrices using the kinematical constraint. More...

enum KFitError::ECode	calculateNDF (void) override
	Calculate an NDF of the fit. More...

Private Attributes
HepPoint3D	m_BeforeVertex
	Vertex position before the fit.

HepPoint3D	m_AfterVertex
	Vertex position after the fit.

CLHEP::HepSymMatrix	m_AfterVertexError
	Vertex error matrix after the fit.

std::vector< CLHEP::HepMatrix >	m_AfterTrackVertexError
	array of vertex error matrices after the fit.

HepPoint3D	m_ProductionVertex
	Production vertex position.

double	m_InvariantMass
	Invariant mass.

std::vector< int >	m_IsFixMass
	Array of flags whether the track property is fixed at the mass.

Detailed Description

MassPointingVertexFitKFit is a derived class from KFitBase It performs a kinematical fit with three constraints: the invariant mass is constrained to its PDG value, the tracks are forced to a common vertex, and the momentum vector is forced to point to an externally provided space point.

Definition at line 30 of file MassPointingVertexFitKFit.h.

Member Function Documentation

◆ addParticle()

enum KFitError::ECode addParticle ( const Particle * particle )

inherited

Add a particle to the fitter.

The function gets track parameters from the Particle dataobject and calls addTrack().

Parameters

[in] particle Particle.

Returns: error code (zero if success)

Definition at line 34 of file KFitBase.cc.

◆ addTrack() [1/2]

enum KFitError::ECode addTrack	(	const CLHEP::HepLorentzVector &	p,
		const HepPoint3D &	x,
		const CLHEP::HepSymMatrix &	e,
		const double	q
	)

inherited

Add a track to the fitter object with specifying its momentum, position, error matrix, and charge.

This function internally calls addTrack(const KFitTrack &kp).

Parameters

p	Lorentz vector of the track
x	position of the track
e	(7x7) error matrix of the track
q	charge of the track

Returns: error code (zero if success)

◆ addTrack() [2/2]

enum KFitError::ECode addTrack ( const KFitTrack & kp )

inherited

Add a track to the fitter object.

Parameters

kp	object of the track

Returns: error code (zero if success)

Definition at line 34 of file KFitBase.cc.

◆ calculateNDF()

enum KFitError::ECode calculateNDF ( void )

overrideprivatevirtual

Calculate an NDF of the fit.

Returns: error code (zero if success)

Implements KFitBase.

Definition at line 175 of file MassPointingVertexFitKFit.cc.

                                         {
   m_NDF = 2 * m_TrackCount - 3 + 3;
  
   return m_ErrorCode = KFitError::kNoError;
 }

◆ doFit()

enum KFitError::ECode doFit ( void )

Perform a mass-vertex-pointing constraint fit.

Returns: error code (zero if success)

Definition at line 175 of file MassPointingVertexFitKFit.cc.

◆ doFit1()

enum KFitError::ECode doFit1 ( void )

protectedinherited

Perform a fit (used in MassFitKFit::doFit()).

Returns: error code (zero if success)

Definition at line 438 of file KFitBase.cc.

◆ doFit2()

enum KFitError::ECode doFit2 ( void )

protectedinherited

Perform a fit (used in VertexFitKFit::doFit() and MassVertexFitKFit::doFit()).

Returns: error code (zero if success)

Definition at line 438 of file KFitBase.cc.

◆ fixMass()

enum KFitError::ECode fixMass ( void )

Tell the object to fix the last added track property at the invariant mass.

Not intended for end user's use.

Returns: error code (zero if success)

Definition at line 35 of file MassPointingVertexFitKFit.cc.

◆ getCHIsq()

double getCHIsq ( void ) const

overridevirtual

Get a chi-square of the fit.

Returns: chi-square of the fit

Reimplemented from KFitBase.

Definition at line 124 of file MassPointingVertexFitKFit.cc.

◆ getCorrelation()

const HepMatrix getCorrelation	(	const int	id1,
		const int	id2,
		const int	flag = `KFitConst::kAfterFit`
	)		const

overridevirtual

Get a correlation matrix between two tracks.

Parameters

id1	first track id
id2	second track id
flag	KFitConst::kBeforeFit or KFitConst::kAfterFit

Returns: (7x7) correlation matrix

Reimplemented from KFitBase.

Definition at line 175 of file MassPointingVertexFitKFit.cc.

◆ getErrorCode()

enum KFitError::ECode getErrorCode ( void ) const

inherited

Get a code of the last error.

Returns: the last error code

Definition at line 34 of file KFitBase.cc.

◆ getInvariantMass()

double getInvariantMass ( void ) const

Get an invariant mass.

Returns: invariant mass

Definition at line 117 of file MassPointingVertexFitKFit.cc.

◆ getMagneticField()

double getMagneticField ( void ) const

inherited

Get a magnetic field.

Returns: magnetic field

Definition at line 128 of file KFitBase.cc.

◆ getNDF()

int getNDF ( void ) const

virtualinherited

Get an NDF of the fit.

Returns: NDF of the fit

Definition at line 114 of file KFitBase.cc.

◆ getTrack()

const KFitTrack getTrack ( const int id ) const

inherited

Get a specified track object.

Parameters

id track id

Returns: specified track object

Definition at line 175 of file KFitBase.cc.

◆ getTrackCHIsq()

double getTrackCHIsq ( const int id ) const

overridevirtual

Get a chi-square of the track.

Parameters

id track id

Returns: chi-square of the track

Reimplemented from KFitBase.

Definition at line 140 of file MassPointingVertexFitKFit.cc.

◆ getTrackCount()

int getTrackCount ( void ) const

inherited

Get the number of added tracks.

Returns: the number of added tracks

Definition at line 107 of file KFitBase.cc.

◆ getTrackError()

const HepSymMatrix getTrackError ( const int id ) const

inherited

Get an error matrix of the track.

Parameters

id track id

Returns: error matrix of the track

Definition at line 168 of file KFitBase.cc.

◆ getTrackMomentum()

const HepLorentzVector getTrackMomentum ( const int id ) const

inherited

Get a Lorentz vector of the track.

Parameters

id track id

Returns: Lorentz vector of the track

Definition at line 154 of file KFitBase.cc.

◆ getTrackPosition()

const HepPoint3D getTrackPosition ( const int id ) const

inherited

Get a position of the track.

Parameters

id track id

Returns: position of the track

Definition at line 161 of file KFitBase.cc.

◆ getTrackVertexError()

const HepMatrix getTrackVertexError ( const int id ) const

Get a vertex error matrix of the track.

Parameters

id	track id
flag	KFitConst::kBeforeFit or KFitConst::kAfterFit

Returns: vertex error matrix

Definition at line 131 of file MassPointingVertexFitKFit.cc.

◆ getVertex()

const HepPoint3D getVertex ( const int flag = KFitConst::kAfterFit ) const

Get a vertex position.

Parameters

flag	KFitConst::kBeforeFit or KFitConst::kAfterFit

Returns: vertex position

Definition at line 91 of file MassPointingVertexFitKFit.cc.

◆ getVertexError()

const HepSymMatrix getVertexError ( void ) const

Get a fitted vertex error matrix.

Returns: vertex error matrix

Definition at line 110 of file MassPointingVertexFitKFit.cc.

◆ isFitted()

bool isFitted ( void ) const

inherited

Return false if fit is not performed yet or performed fit is failed; otherwise true.

Returns: see description

Definition at line 727 of file KFitBase.cc.

◆ isNonZeroEnergy()

bool isNonZeroEnergy ( const CLHEP::HepLorentzVector & p ) const

protectedinherited

Check if the energy is non-zero.

Parameters

p	Lorentz vector

Returns: true for non-zero energy, false for otherwise

Definition at line 749 of file KFitBase.cc.

◆ isTrackIDInRange()

bool isTrackIDInRange ( const int id ) const

protectedinherited

Check if the id is in the range.

Parameters

id track id

Returns: true if the id is in the range, false otherwise

Definition at line 738 of file KFitBase.cc.

◆ makeCoreMatrix()

enum KFitError::ECode makeCoreMatrix ( void )

overrideprivatevirtual

Build matrices using the kinematical constraint.

Returns: error code (zero if success)

Implements KFitBase.

Definition at line 175 of file MassPointingVertexFitKFit.cc.

◆ makeError1() [1/2]

const CLHEP::HepSymMatrix makeError1	(	const CLHEP::HepLorentzVector &	p,
		const CLHEP::HepMatrix &	e
	)		const

protectedinherited

Rebuild an error matrix from a Lorentz vector and an error matrix.

Parameters

p	Lorentz vector
e	(6x6) error matrix

Returns: (7x7) error matrix

◆ makeError1() [2/2]

const CLHEP::HepMatrix makeError1	(	const CLHEP::HepLorentzVector &	p1,
		const CLHEP::HepLorentzVector &	p2,
		const CLHEP::HepMatrix &	e
	)		const

protectedinherited

Rebuild an error matrix from a pair of Lorentz vectors and an error matrix.

Parameters

p1	first Lorentz vector
p2	second Lorentz vector
e	(6x6) error matrix

Returns: (7x7) error matrix

◆ makeError2()

const HepMatrix makeError2	(	const CLHEP::HepLorentzVector &	p,
		const CLHEP::HepMatrix &	e
	)		const

protectedinherited

Rebuild an error matrix from a Lorentz vector and an error matrix.

Parameters

p	Lorentz vector
e	(3x6) error matrix

Returns: (3x7) error matrix

Definition at line 296 of file KFitBase.cc.

◆ makeError3() [1/2]

const CLHEP::HepSymMatrix makeError3	(	const CLHEP::HepLorentzVector &	p,
		const CLHEP::HepMatrix &	e,
		const bool	is_fix_mass
	)		const

protectedinherited

Rebuild an error matrix from a Lorentz vector and an error matrix.

Parameters

p	Lorentz vector
e	(7x7) error matrix
is_fix_mass	true to recalculate energy term from other parameters, false to do nothing

Returns: (7x7) error matrix

◆ makeError3() [2/2]

const CLHEP::HepMatrix makeError3	(	const CLHEP::HepLorentzVector &	p1,
		const CLHEP::HepLorentzVector &	p2,
		const CLHEP::HepMatrix &	e,
		const bool	is_fix_mass1,
		const bool	is_fix_mass2
	)		const

protectedinherited

Rebuild an error matrix from a pair of Lorentz vectors and an error matrix.

Parameters

p1	first Lorentz vector
p2	second Lorentz vector
e	(7x7) error matrix
is_fix_mass1	true to recalculate energy term from other parameters, false to do nothing
is_fix_mass2	true to recalculate energy term from other parameters, false to do nothing

Returns: (7x7) error matrix

◆ makeError4()

const HepMatrix makeError4	(	const CLHEP::HepLorentzVector &	p,
		const CLHEP::HepMatrix &	e
	)		const

protectedinherited

Rebuild an error matrix from a Lorentz vector and an error matrix.

Parameters

p	Lorentz vector
e	(3x7) error matrix

Returns: (7x7) error matrix

Definition at line 438 of file KFitBase.cc.

◆ prepareCorrelation()

enum KFitError::ECode prepareCorrelation ( void )

overrideprivatevirtual

Build a grand correlation matrix from input-track properties.

Returns: error code (zero if success)

Reimplemented from KFitBase.

Definition at line 175 of file MassPointingVertexFitKFit.cc.

◆ prepareInputMatrix()

enum KFitError::ECode prepareInputMatrix ( void )

overrideprivatevirtual

Build grand matrices for minimum search from input-track properties.

Returns: error code (zero if success)

Implements KFitBase.

Definition at line 175 of file MassPointingVertexFitKFit.cc.

◆ prepareInputSubMatrix()

enum KFitError::ECode prepareInputSubMatrix ( void )

overrideprivatevirtual

Build sub-matrices for minimum search from input-track properties.

Returns: error code (zero if success)

Implements KFitBase.

Definition at line 175 of file MassPointingVertexFitKFit.cc.

◆ prepareOutputMatrix()

enum KFitError::ECode prepareOutputMatrix ( void )

overrideprivatevirtual

Build an output error matrix.

Returns: error code (zero if success)

Implements KFitBase.

Definition at line 175 of file MassPointingVertexFitKFit.cc.

◆ setCorrelation()

enum KFitError::ECode setCorrelation ( const CLHEP::HepMatrix & c )

overridevirtual

Set a correlation matrix.

Not intended for end user's use.

Parameters

c	(7x7) correlation matrix

Returns: error code (zero if success)

Reimplemented from KFitBase.

Definition at line 35 of file MassPointingVertexFitKFit.cc.

◆ setInitialVertex()

enum KFitError::ECode setInitialVertex ( const HepPoint3D & v )

Set an initial vertex point for the mass-vertex-pointing constraint fit.

Parameters

v	initial vertex point

Returns: error code (zero if success)

Definition at line 35 of file MassPointingVertexFitKFit.cc.

◆ setInvariantMass()

enum KFitError::ECode setInvariantMass ( const double m )

Set an invariant mass for the mass-vertex-pointing constraint fit.

Parameters

m	invariant mass

Returns: error code (zero if success)

Definition at line 35 of file MassPointingVertexFitKFit.cc.

◆ setMagneticField()

enum KFitError::ECode setMagneticField ( const double mf )

inherited

Change a magnetic field from the default value KFitConst::kDefaultMagneticField.

Parameters

mf	magnetic field to set

Returns: error code (zero if success)

Definition at line 34 of file KFitBase.cc.

◆ setProductionVertex()

enum KFitError::ECode setProductionVertex ( const HepPoint3D & v )

Set the production vertex of the particle.

Parameters

v	production vertex

Returns: error code (zero if success)

Definition at line 35 of file MassPointingVertexFitKFit.cc.

◆ setZeroCorrelation()

enum KFitError::ECode setZeroCorrelation ( void )

overridevirtual

Indicate no correlation between tracks.

Not intended for end user's use.

Returns: error code (zero if success)

Reimplemented from KFitBase.

Definition at line 35 of file MassPointingVertexFitKFit.cc.

◆ unfixMass()

enum KFitError::ECode unfixMass ( void )

Tell the object to unfix the last added track property at the invariant mass.

Not intended for end user's use.

Returns: error code (zero if success)

Definition at line 35 of file MassPointingVertexFitKFit.cc.

◆ updateMother()

enum KFitError::ECode updateMother ( Particle * mother )

Update mother particle.

Parameters

mother particle

Definition at line 175 of file MassPointingVertexFitKFit.cc.

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

analysis/VertexFitting/KFit/include/MassPointingVertexFitKFit.h
analysis/VertexFitting/KFit/src/MassPointingVertexFitKFit.cc

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Member Function Documentation

◆ addParticle()

◆ addTrack() [1/2]

◆ addTrack() [2/2]

◆ calculateNDF()

◆ doFit()

◆ doFit1()

◆ doFit2()

◆ fixMass()

◆ getCHIsq()

◆ getCorrelation()

◆ getErrorCode()

◆ getInvariantMass()

◆ getMagneticField()

◆ getNDF()

◆ getTrack()

◆ getTrackCHIsq()

◆ getTrackCount()

◆ getTrackError()

◆ getTrackMomentum()

◆ getTrackPosition()

◆ getTrackVertexError()

◆ getVertex()

◆ getVertexError()

◆ isFitted()

◆ isNonZeroEnergy()

◆ isTrackIDInRange()

◆ makeCoreMatrix()

◆ makeError1() [1/2]

◆ makeError1() [2/2]

◆ makeError2()

◆ makeError3() [1/2]

◆ makeError3() [2/2]

◆ makeError4()

◆ prepareCorrelation()

◆ prepareInputMatrix()

◆ prepareInputSubMatrix()

◆ prepareOutputMatrix()

◆ setCorrelation()

◆ setInitialVertex()

◆ setInvariantMass()

◆ setMagneticField()

◆ setProductionVertex()

◆ setZeroCorrelation()

◆ unfixMass()

◆ updateMother()