KalmanVertexFitter Class Reference

#include <KalmanVertexFitter.h>

Inheritance diagram for KalmanVertexFitter:

Public Types
typedef CachingVertex< 5 >::RefCountedVertexTrack	RefCountedVertexTrack

Public Member Functions
KalmanVertexFitter *	clone () const override
	KalmanVertexFitter (bool useSmoothing=false)
	KalmanVertexFitter (const edm::ParameterSet &pSet, bool useSmoothing=false)
	KalmanVertexFitter (const KalmanVertexFitter &other)
CachingVertex< 5 >	vertex (const std::vector< reco::TransientTrack > &tracks) const override
CachingVertex< 5 >	vertex (const std::vector< RefCountedVertexTrack > &tracks) const override
CachingVertex< 5 >	vertex (const std::vector< RefCountedVertexTrack > &tracks, const reco::BeamSpot &spot) const override
CachingVertex< 5 >	vertex (const std::vector< reco::TransientTrack > &tracks, const GlobalPoint &linPoint) const override
CachingVertex< 5 >	vertex (const std::vector< reco::TransientTrack > &tracks, const GlobalPoint &priorPos, const GlobalError &priorError) const override
CachingVertex< 5 >	vertex (const std::vector< reco::TransientTrack > &tracks, const reco::BeamSpot &beamSpot) const override
CachingVertex< 5 >	vertex (const std::vector< RefCountedVertexTrack > &tracks, const GlobalPoint &priorPos, const GlobalError &priorError) const override
	~KalmanVertexFitter () override
Public Member Functions inherited from VertexFitter< 5 >
virtual CachingVertex< N >	vertex (const std::vector< typename CachingVertex< N >::RefCountedVertexTrack > &tracks) const =0
virtual CachingVertex< N >	vertex (const std::vector< typename CachingVertex< N >::RefCountedVertexTrack > &tracks, const reco::BeamSpot &spot) const =0
virtual CachingVertex< N >	vertex (const std::vector< typename CachingVertex< N >::RefCountedVertexTrack > &tracks, const GlobalPoint &priorPos, const GlobalError &priorError) const =0
	VertexFitter ()
virtual	~VertexFitter ()

Private Member Functions
edm::ParameterSet	defaultParameters () const
void	setup (const edm::ParameterSet &pSet, bool useSmoothing)

Private Attributes
const SequentialVertexFitter< 5 > *	theSequentialFitter

Detailed Description

Least-squares vertex fitter implemented in the Kalman Filter formalism Fits vertex position and, if smoothing is requested at construction, constrains track parameters at the vertex. A beam spot constraint can also be specified in form of a 3D point and a 3D matrix describing a Gaussian beam spread.

References:

`Vertex fitting with the Kalman filter formalism', T.speer, K.Prokofiev, R.Fruehwirth, CMS IN 2003/008
T.Speer, K.Prokofiev, R.Fruhwirth, W.Waltenberger, P.Vanlaer, "Vertex Fitting in the CMS Tracker", CMS Note 2006/032
P.Billoir, S.Qian, "Fast vertex fitting...", NIM A311 (1992) 139.
R.Fruhwirth, R.Kubinec, W.Mitaroff, M.Regler, Comp. Physics Comm. 96, 189 (1996)
P.Avery, lectures on track and vertex fitting"

Definition at line 22 of file KalmanVertexFitter.h.

Member Typedef Documentation

typedef CachingVertex<5>::RefCountedVertexTrack KalmanVertexFitter::RefCountedVertexTrack

Definition at line 54 of file KalmanVertexFitter.h.

Constructor & Destructor Documentation

KalmanVertexFitter::KalmanVertexFitter

(

bool

useSmoothing = false

)

The constructor, setting everything up to have a VertexFitter using the Kalman algorithm.

Parameters

useSmoothing

Specifies whether the tracks should be refit or not.

Definition at line 11 of file KalmanVertexFitter.cc.

References defaultParameters(), and setup().

Referenced by clone().

{
  edm::ParameterSet pSet = defaultParameters();
  setup(pSet, useSmoothing);
}

KalmanVertexFitter::KalmanVertexFitter	(	const edm::ParameterSet &	pSet,
		bool	useSmoothing = false
	)

Same as above, using a ParameterSet to set the convergence criteria

Definition at line 17 of file KalmanVertexFitter.cc.

References setup().

{
  setup(pSet, useSmoothing);
}

KalmanVertexFitter::KalmanVertexFitter ( const KalmanVertexFitter &  other )

inline

Definition at line 39 of file KalmanVertexFitter.h.

                                                        :
    theSequentialFitter ( other.theSequentialFitter->clone() ) {}

KalmanVertexFitter::~KalmanVertexFitter ( )

inlineoverride

Definition at line 42 of file KalmanVertexFitter.h.

References theSequentialFitter.

  {
    delete theSequentialFitter;
  }

Member Function Documentation

KalmanVertexFitter* KalmanVertexFitter::clone ( void  ) const

inlineoverridevirtual

Fit vertex out of a VertexSeed

Implements VertexFitter< 5 >.

Definition at line 47 of file KalmanVertexFitter.h.

References KalmanVertexFitter().

  {
    return new KalmanVertexFitter(* this);
  }

edm::ParameterSet KalmanVertexFitter::defaultParameters ( ) const

private

Definition at line 44 of file KalmanVertexFitter.cc.

References edm::ParameterSet::addParameter().

Referenced by KalmanVertexFitter(), and vertex().

{
  edm::ParameterSet pSet;
  pSet.addParameter<double>("maxDistance", 0.01);
  pSet.addParameter<int>("maxNbrOfIterations", 10); //10
  return pSet;
}

void KalmanVertexFitter::setup ( const edm::ParameterSet &  pSet, bool  useSmoothing  )

private

Default convergence criteria

Definition at line 22 of file KalmanVertexFitter.cc.

References theSequentialFitter.

Referenced by KalmanVertexFitter(), and vertex().

{
  if (useSmoothing) {
    KalmanVertexTrackUpdator<5> vtu;
    KalmanSmoothedVertexChi2Estimator<5> vse;
    KalmanTrackToTrackCovCalculator<5> covCalc;
    SequentialVertexSmoother<5> smoother(vtu, vse, covCalc);
    theSequentialFitter 
      = new SequentialVertexFitter<5>(pSet, FsmwLinearizationPointFinder(20, -2., 0.4, 10.), 
                   KalmanVertexUpdator<5>(), 
                   smoother, LinearizedTrackStateFactory());
  }
  else {
    DummyVertexSmoother<5> smoother;
    theSequentialFitter 
      = new SequentialVertexFitter<5>(pSet, FsmwLinearizationPointFinder(20, -2., 0.4, 10.), 
                   KalmanVertexUpdator<5>(), 
                   smoother, LinearizedTrackStateFactory());
  }
}

CachingVertex<5> KalmanVertexFitter::vertex ( const std::vector< reco::TransientTrack > &  tracks ) const

inlineoverridevirtual

Fit vertex out of a set of RecTracks

Implements VertexFitter< 5 >.

Definition at line 59 of file KalmanVertexFitter.h.

References theSequentialFitter, and SequentialVertexFitter< N >::vertex().

Referenced by KVFTest::analyze(), KineExample::analyze(), BPHMonitor::analyze(), MultiVertexFitter::createSeed(), PFRecoTauDiscriminationByFlight::discriminate(), Tau.Tau::dxy(), V0Fitter::fitAll(), HIPTwoBodyDecayAnalyzer::fitDimuonVertex(), BPHDecayVertex::fitVertex(), PFDisplacedVertexFinder::fitVertexFromSeed(), HLTmmkkFilter::hltFilter(), HLTmmkFilter::hltFilter(), HLTDisplacedmumumuVtxProducer::produce(), HLTDisplacedmumuVtxProducer::produce(), HLTDisplacedtktkVtxProducer::produce(), HLTmumutktkVtxProducer::produce(), Onia2MuMuPAT::produce(), HLTmumutkVtxProducer::produce(), PFTauSecondaryVertexProducer::produce(), HPSPFRecoTauAlgorithm::refitThreeProng(), ConversionVertexFinder::run(), PFRecoTauDiscriminationByFlightPathSignificance::threeProngFlightPathSig(), and MultiVertexFitter::updateSeeds().

  {
    return theSequentialFitter->vertex(tracks);
  }

CachingVertex<5> KalmanVertexFitter::vertex ( const std::vector< RefCountedVertexTrack > &  tracks ) const

inlineoverride

Fit vertex out of a set of VertexTracks

Definition at line 67 of file KalmanVertexFitter.h.

References theSequentialFitter, and SequentialVertexFitter< N >::vertex().

Referenced by Tau.Tau::dxy().

  {
    return theSequentialFitter->vertex(tracks);
  }

CachingVertex<5> KalmanVertexFitter::vertex ( const std::vector< RefCountedVertexTrack > &  tracks, const reco::BeamSpot &  spot  ) const

inlineoverride

Definition at line 73 of file KalmanVertexFitter.h.

References theSequentialFitter, and SequentialVertexFitter< N >::vertex().

Referenced by Tau.Tau::dxy().

  {
    return theSequentialFitter->vertex(tracks, spot );
  }

CachingVertex<5> KalmanVertexFitter::vertex ( const std::vector< reco::TransientTrack > &  tracks, const GlobalPoint &  linPoint  ) const

inlineoverridevirtual

Fit vertex out of a set of RecTracks. Uses the specified linearization point.

Implements VertexFitter< 5 >.

Definition at line 84 of file KalmanVertexFitter.h.

References theSequentialFitter, and SequentialVertexFitter< N >::vertex().

Referenced by Tau.Tau::dxy().

  {
    return theSequentialFitter->vertex(tracks, linPoint);
  }

CachingVertex<5> KalmanVertexFitter::vertex ( const std::vector< reco::TransientTrack > &  tracks, const GlobalPoint &  priorPos, const GlobalError &  priorError  ) const

inlineoverridevirtual

Fit vertex out of a set of RecTracks. Uses the specified point as both the linearization point AND as prior estimate of the vertex position. The error is used for the weight of the prior estimate.

Implements VertexFitter< 5 >.

Definition at line 96 of file KalmanVertexFitter.h.

References theSequentialFitter, and SequentialVertexFitter< N >::vertex().

Referenced by Tau.Tau::dxy().

  {
    return theSequentialFitter->vertex(tracks, priorPos, priorError);
  }

CachingVertex<5> KalmanVertexFitter::vertex ( const std::vector< reco::TransientTrack > &  tracks, const reco::BeamSpot &  beamSpot  ) const

inlineoverridevirtual

Fit vertex out of a set of TransientTracks. The specified BeamSpot will be used as priot, but NOT for the linearization. The specified LinearizationPointFinder will be used to find the linearization point.

Implements VertexFitter< 5 >.

Definition at line 108 of file KalmanVertexFitter.h.

References theSequentialFitter, and SequentialVertexFitter< N >::vertex().

Referenced by Tau.Tau::dxy().

  {
    return theSequentialFitter->vertex(tracks, beamSpot);
  }

CachingVertex<5> KalmanVertexFitter::vertex ( const std::vector< RefCountedVertexTrack > &  tracks, const GlobalPoint &  priorPos, const GlobalError &  priorError  ) const

inlineoverride

Fit vertex out of a set of VertexTracks. Uses the specified point and error as the prior estimate of the vertex. This position is not used to relinearize the tracks.

Definition at line 120 of file KalmanVertexFitter.h.

References defaultParameters(), setup(), theSequentialFitter, and SequentialVertexFitter< N >::vertex().

Referenced by Tau.Tau::dxy().

  {
    return theSequentialFitter->vertex(tracks, priorPos, priorError);
  }

Member Data Documentation

const SequentialVertexFitter<5>* KalmanVertexFitter::theSequentialFitter

private

Definition at line 137 of file KalmanVertexFitter.h.

Referenced by setup(), vertex(), and ~KalmanVertexFitter().