[u/mrichter/AliRoot.git] / STEER / AliVertexerTracks.h

#ifndef ALIVERTEXERTRACKS_H
#define ALIVERTEXERTRACKS_H
/* Copyright(c) 1998-2003, ALICE Experiment at CERN, All rights reserved. *
 * See cxx source for full Copyright notice                               */


//-------------------------------------------------------
// Class for vertex determination with tracks
//
//   Origin: AliITSVertexerTracks  
//           A.Dainese, Padova, andrea.dainese@pd.infn.it
//           M.Masera,  Torino, massimo.masera@to.infn.it 
//   Moved to STEER and adapted to ESD tracks: 
//           F.Prino, Torino, prino@to.infn.it 
//-------------------------------------------------------

/*****************************************************************************
 *                                                                           *
 * This class determines the vertex of a set of tracks.                      *
 * Different algorithms are implemented, see data member fAlgo.              *
 *                                                                           *
 *****************************************************************************/

#include <TObjArray.h>
#include <TMatrixD.h>

#include "AliLog.h"
#include "AliESDVertex.h"


class AliExternalTrackParam;
class AliVEvent;
class AliStrLine;

class AliVertexerTracks : public TObject {
  
 public:
  AliVertexerTracks(); 
  AliVertexerTracks(Double_t fieldkG); 
  virtual ~AliVertexerTracks();

  AliESDVertex* FindPrimaryVertex(const AliVEvent *vEvent);
  AliESDVertex* FindPrimaryVertex(const TObjArray *trkArrayOrig,UShort_t *idOrig);
  AliESDVertex* VertexForSelectedTracks(const TObjArray *trkArray,UShort_t *id,
					Bool_t optUseFitter=kTRUE,
					Bool_t optPropagate=kTRUE,
					Bool_t optUseDiamondConstraint=kFALSE);
  AliESDVertex* VertexForSelectedESDTracks(TObjArray *trkArray,
					Bool_t optUseFitter=kTRUE,
					Bool_t optPropagate=kTRUE,
					Bool_t optUseDiamondConstraint=kFALSE);
  AliESDVertex* RemoveTracksFromVertex(AliESDVertex *inVtx,
				       const TObjArray *trkArray,UShort_t *id,
				       const Float_t *diamondxy) const; 
  AliESDVertex* RemoveConstraintFromVertex(AliESDVertex *inVtx,
					   Float_t *diamondxyz,
					   Float_t *diamondcov) const;
  void  SetITSMode(Double_t dcacut=0.1,
		   Double_t dcacutIter0=0.1,
		   Double_t maxd0z0=0.5,
		   Int_t minCls=5,
		   Int_t mintrks=1,
		   Double_t nsigma=3.,
		   Double_t mindetfitter=100.,
		   Double_t maxtgl=1000.,
		   Double_t fidR=3.,
		   Double_t fidZ=30.,
		   Int_t finderAlgo=1,
		   Int_t finderAlgoIter0=4); 
  void  SetTPCMode(Double_t dcacut=0.1,
		   Double_t dcacutIter0=1.0,
		   Double_t maxd0z0=5.0,
		   Int_t minCls=10,
		   Int_t mintrks=1,
		   Double_t nsigma=3.,
		   Double_t mindetfitter=0.1,
		   Double_t maxtgl=1.5, 
		   Double_t fidR=3.,
		   Double_t fidZ=30.,
		   Int_t finderAlgo=1,
		   Int_t finderAlgoIter0=4); 
  void  SetCuts(Double_t *cuts);
  void  SetConstraintOff() { fConstraint=kFALSE; SetVtxStart(); SetVtxStartSigma(); return; }
  void  SetConstraintOn() { fConstraint=kTRUE; return; }
  void  SetDCAcut(Double_t maxdca) { fDCAcut=maxdca; return; }
  void  SetDCAcutIter0(Double_t maxdca) { fDCAcutIter0=maxdca; return; }
  void  SetFinderAlgorithm(Int_t opt=1) { fAlgo=opt; return; }
  void  SetITSrefitRequired() { fITSrefit=kTRUE; return; }
  void  SetITSpureSA() { fITSpureSA=kTRUE; return; }
  Bool_t GetITSrefitRequired() const { return fITSrefit; }
  void  SetITSrefitNotRequired() { fITSrefit=kFALSE; return; }
  void  SetFiducialRZ(Double_t r=3,Double_t z=30) { fFiducialR=r; fFiducialZ=z; return; }
  void  SetMaxd0z0(Double_t maxd0z0=0.5) { fMaxd0z0=maxd0z0; return; }
  void  SetMinClusters(Int_t n=5) { fMinClusters=n; return; }
  Int_t GetMinClusters() const { return fMinClusters; }
  void  SetMinTracks(Int_t n=1) { fMinTracks=n; return; }
  void  SetNSigmad0(Double_t n=3) { fNSigma=n; return; }
  Double_t GetNSigmad0() const { return fNSigma; }
  void  SetMinDetFitter(Double_t mindet=100.) { fMinDetFitter=mindet; return; }
  void  SetMaxTgl(Double_t maxtgl=1.) { fMaxTgl=maxtgl; return; }
  void  SetOnlyFitter() { if(!fConstraint) AliFatal("Set constraint first!"); 
     fOnlyFitter=kTRUE; return; }
  void  SetSkipTracks(Int_t n,const Int_t *skipped);
  void  SetVtxStart(Double_t x=0,Double_t y=0,Double_t z=0) 
    { fNominalPos[0]=x; fNominalPos[1]=y; fNominalPos[2]=z; return; }
  void  SetVtxStartSigma(Double_t sx=3.,Double_t sy=3.,Double_t sz=15.) 
    { fNominalCov[0]=sx*sx; fNominalCov[2]=sy*sy; fNominalCov[5]=sz*sz;
      fNominalCov[1]=0.; fNominalCov[3]=0.; fNominalCov[4]=0.; return; }
  void  SetVtxStart(AliESDVertex *vtx);
  static Double_t GetStrLinMinDist(const Double_t *p0,const Double_t *p1,const Double_t *x0);
  static Double_t GetDeterminant3X3(Double_t matr[][3]);
  static void GetStrLinDerivMatrix(const Double_t *p0,const Double_t *p1,Double_t (*m)[3],Double_t *d);
  static void GetStrLinDerivMatrix(const Double_t *p0,const Double_t *p1,const Double_t *sigmasq,Double_t (*m)[3],Double_t *d);
  static AliESDVertex TrackletVertexFinder(const TClonesArray *lines, Int_t optUseWeights=0);
  static AliESDVertex TrackletVertexFinder(AliStrLine **lines, const Int_t knacc, Int_t optUseWeights=0);
  void     SetFieldkG(Double_t field=-999.) { fFieldkG=field; return; }
  Double_t GetFieldkG() const { 
    if(fFieldkG<-99.) AliFatal("Field value not set");
    return fFieldkG; } 
  void SetNSigmaForUi00(Double_t n=1.5) { fnSigmaForUi00=n; return; }
  Double_t GetNSigmaForUi00() const { return fnSigmaForUi00; }

 protected:
  void     HelixVertexFinder();
  void     OneTrackVertFinder();
  Int_t    PrepareTracks(const TObjArray &trkArrayOrig,const UShort_t *idOrig,
			 Int_t optImpParCut);
  Bool_t   PropagateTrackTo(AliExternalTrackParam *track,
			    Double_t xToGo);
  Bool_t   TrackToPoint(AliExternalTrackParam *t,
		        TMatrixD &ri,TMatrixD &wWi,
			Bool_t uUi3by3=kFALSE) const;     
  void     VertexFinder(Int_t optUseWeights=0);
  void     VertexFitter();
  void     StrLinVertexFinderMinDist(Int_t optUseWeights=0);
  void     TooFewTracks();

  AliESDVertex fVert;         // vertex after vertex finder
  AliESDVertex *fCurrentVertex;  // ESD vertex after fitter
  UShort_t  fMode;            // 0 ITS+TPC; 1 TPC
  Double_t  fFieldkG;         // z component of field (kGauss) 
  Double_t  fNominalPos[3];   // initial knowledge on vertex position
  Double_t  fNominalCov[6];   // initial knowledge on vertex position
  TObjArray fTrkArraySel;     // array with tracks to be processed
  UShort_t  *fIdSel;          // IDs of the tracks (AliESDtrack::GetID())
  Int_t     *fTrksToSkip;     // track IDs to be skipped for find and fit 
  Int_t     fNTrksToSkip;     // number of tracks to be skipped 
  Bool_t    fConstraint;      // true when "mean vertex" was set in 
                              // fNominal ... and must be used in the fit
  Bool_t    fOnlyFitter;      // primary with one fitter shot only
                              // (use only with beam constraint)
  Int_t     fMinTracks;       // minimum number of tracks
  Int_t     fMinClusters;     // minimum number of ITS or TPC clusters per track
  Double_t  fDCAcut;          // maximum DCA between 2 tracks used for vertex
  Double_t  fDCAcutIter0;     // maximum DCA between 2 tracks used for vertex
  Double_t  fNSigma;          // number of sigmas for d0 cut in PrepareTracks()
  Double_t  fMaxd0z0;         // value for sqrt(d0d0+z0z0) cut 
                              // in PrepareTracks(1) if fConstraint=kFALSE
  Double_t  fMinDetFitter;    // minimum determinant to try to invertex matrix
  Double_t  fMaxTgl;          // maximum tgl of tracks
  Bool_t    fITSrefit;        // if kTRUE (default), use only kITSrefit tracks
                              // if kFALSE, use all tracks (also TPC only)
  Bool_t    fITSpureSA;       // if kFALSE (default) skip ITSpureSA tracks
                              // if kTRUE use only those
  Double_t  fFiducialR;       // radius of fiducial cylinder for tracks 
  Double_t  fFiducialZ;       // length of fiducial cylinder for tracks
  Double_t  fnSigmaForUi00;   // n. sigmas from finder in TrackToPoint
  Int_t     fAlgo;            // option for vertex finding algorythm
  Int_t     fAlgoIter0;       // this is for iteration 0
  // fAlgo=1 (default) finds minimum-distance point among all selected tracks
  //         approximated as straight lines 
  //         and uses errors on track parameters as weights
  // fAlgo=2 finds minimum-distance point among all the selected tracks
  //         approximated as straight lines 
  // fAlgo=3 finds the average point among DCA points of all pairs of tracks
  //         treated as helices
  // fAlgo=4 finds the average point among DCA points of all pairs of tracks
  //         approximated as straight lines 
  //         and uses errors on track parameters as weights
  // fAlgo=5 finds the average point among DCA points of all pairs of tracks
  //         approximated as straight lines 


 private:
  AliVertexerTracks(const AliVertexerTracks & source);
  AliVertexerTracks & operator=(const AliVertexerTracks & source);

  ClassDef(AliVertexerTracks,14) // 3D Vertexing with tracks 
};

#endif
Commit	Line	Data
2d57349e	1	#ifndef ALIVERTEXERTRACKS_H
	2	#define ALIVERTEXERTRACKS_H
	3	/* Copyright(c) 1998-2003, ALICE Experiment at CERN, All rights reserved. *
	4	* See cxx source for full Copyright notice */
	5
	6
	7	//-------------------------------------------------------
6d8df534	8	// Class for vertex determination with tracks
2d57349e	9	//
	10	// Origin: AliITSVertexerTracks
	11	// A.Dainese, Padova, andrea.dainese@pd.infn.it
	12	// M.Masera, Torino, massimo.masera@to.infn.it
	13	// Moved to STEER and adapted to ESD tracks:
	14	// F.Prino, Torino, prino@to.infn.it
	15	//-------------------------------------------------------
	16
	17	/*****************************************************************************
	18	* *
6d8df534	19	* This class determines the vertex of a set of tracks. *
2d57349e	20	* Different algorithms are implemented, see data member fAlgo. *
	21	* *
	22	*****************************************************************************/
	23
2d57349e	24	#include <TObjArray.h>
817e1004	25	#include <TMatrixD.h>
2d57349e	26
6d8df534	27	#include "AliLog.h"
f5740e9a	28	#include "AliESDVertex.h"
6d8df534	29
817e1004	30
f5740e9a	31	class AliExternalTrackParam;
0aa2faf4	32	class AliVEvent;
8e104736	33	class AliStrLine;
2d57349e	34
	35	class AliVertexerTracks : public TObject {
	36
	37	public:
	38	AliVertexerTracks();
dc3719f3	39	AliVertexerTracks(Double_t fieldkG);
2d57349e	40	virtual ~AliVertexerTracks();
2d57349e	41
f5740e9a	42	AliESDVertex* FindPrimaryVertex(const AliVEvent *vEvent);
	43	AliESDVertex* FindPrimaryVertex(const TObjArray trkArrayOrig,UShort_t idOrig);
	44	AliESDVertex* VertexForSelectedTracks(const TObjArray trkArray,UShort_t id,
6d8df534	45	Bool_t optUseFitter=kTRUE,
97669588	46	Bool_t optPropagate=kTRUE,
97669588	47	Bool_t optUseDiamondConstraint=kFALSE);
6d8df534	48	AliESDVertex* VertexForSelectedESDTracks(TObjArray *trkArray,
6d8df534	49	Bool_t optUseFitter=kTRUE,
97669588	50	Bool_t optPropagate=kTRUE,
97669588	51	Bool_t optUseDiamondConstraint=kFALSE);
6d8df534	52	AliESDVertex* RemoveTracksFromVertex(AliESDVertex *inVtx,
f5740e9a	53	const TObjArray trkArray,UShort_t id,
f5740e9a	54	const Float_t *diamondxy) const;
6b908072	55	AliESDVertex* RemoveConstraintFromVertex(AliESDVertex *inVtx,
	56	Float_t *diamondxyz,
	57	Float_t *diamondcov) const;
a00021a7	58	void SetITSMode(Double_t dcacut=0.1,
	59	Double_t dcacutIter0=0.1,
	60	Double_t maxd0z0=0.5,
	61	Int_t minCls=5,
	62	Int_t mintrks=1,
	63	Double_t nsigma=3.,
	64	Double_t mindetfitter=100.,
	65	Double_t maxtgl=1000.,
	66	Double_t fidR=3.,
8c75f668	67	Double_t fidZ=30.,
	68	Int_t finderAlgo=1,
	69	Int_t finderAlgoIter0=4);
a00021a7	70	void SetTPCMode(Double_t dcacut=0.1,
	71	Double_t dcacutIter0=1.0,
	72	Double_t maxd0z0=5.0,
	73	Int_t minCls=10,
	74	Int_t mintrks=1,
	75	Double_t nsigma=3.,
	76	Double_t mindetfitter=0.1,
	77	Double_t maxtgl=1.5,
	78	Double_t fidR=3.,
8c75f668	79	Double_t fidZ=30.,
	80	Int_t finderAlgo=1,
	81	Int_t finderAlgoIter0=4);
a00021a7	82	void SetCuts(Double_t *cuts);
302c78d4	83	void SetConstraintOff() { fConstraint=kFALSE; SetVtxStart(); SetVtxStartSigma(); return; }
fee9ef0d	84	void SetConstraintOn() { fConstraint=kTRUE; return; }
fee9ef0d	85	void SetDCAcut(Double_t maxdca) { fDCAcut=maxdca; return; }
f09c879d	86	void SetDCAcutIter0(Double_t maxdca) { fDCAcutIter0=maxdca; return; }
fee9ef0d	87	void SetFinderAlgorithm(Int_t opt=1) { fAlgo=opt; return; }
6d8df534	88	void SetITSrefitRequired() { fITSrefit=kTRUE; return; }
40cfa14d	89	void SetITSpureSA() { fITSpureSA=kTRUE; return; }
0aa2faf4	90	Bool_t GetITSrefitRequired() const { return fITSrefit; }
50ff0bcd	91	void SetITSrefitNotRequired() { fITSrefit=kFALSE; return; }
6b29d399	92	void SetFiducialRZ(Double_t r=3,Double_t z=30) { fFiducialR=r; fFiducialZ=z; return; }
fee9ef0d	93	void SetMaxd0z0(Double_t maxd0z0=0.5) { fMaxd0z0=maxd0z0; return; }
6b29d399	94	void SetMinClusters(Int_t n=5) { fMinClusters=n; return; }
0aa2faf4	95	Int_t GetMinClusters() const { return fMinClusters; }
6d8df534	96	void SetMinTracks(Int_t n=1) { fMinTracks=n; return; }
fee9ef0d	97	void SetNSigmad0(Double_t n=3) { fNSigma=n; return; }
fee9ef0d	98	Double_t GetNSigmad0() const { return fNSigma; }
f09c879d	99	void SetMinDetFitter(Double_t mindet=100.) { fMinDetFitter=mindet; return; }
f09c879d	100	void SetMaxTgl(Double_t maxtgl=1.) { fMaxTgl=maxtgl; return; }
fee9ef0d	101	void SetOnlyFitter() { if(!fConstraint) AliFatal("Set constraint first!");
fee9ef0d	102	fOnlyFitter=kTRUE; return; }
f5740e9a	103	void SetSkipTracks(Int_t n,const Int_t *skipped);
3b768a1d	104	void SetVtxStart(Double_t x=0,Double_t y=0,Double_t z=0)
07680cae	105	{ fNominalPos[0]=x; fNominalPos[1]=y; fNominalPos[2]=z; return; }
146c29df	106	void SetVtxStartSigma(Double_t sx=3.,Double_t sy=3.,Double_t sz=15.)
50ff0bcd	107	{ fNominalCov[0]=sxsx; fNominalCov[2]=sysy; fNominalCov[5]=sz*sz;
	108	fNominalCov[1]=0.; fNominalCov[3]=0.; fNominalCov[4]=0.; return; }
	109	void SetVtxStart(AliESDVertex *vtx);
f5740e9a	110	static Double_t GetStrLinMinDist(const Double_t p0,const Double_t p1,const Double_t *x0);
71d84967	111	static Double_t GetDeterminant3X3(Double_t matr[][3]);
817e1004	112	static void GetStrLinDerivMatrix(const Double_t p0,const Double_t p1,Double_t (m)[3],Double_t d);
f5740e9a	113	static void GetStrLinDerivMatrix(const Double_t p0,const Double_t p1,const Double_t sigmasq,Double_t (m)[3],Double_t *d);
f5740e9a	114	static AliESDVertex TrackletVertexFinder(const TClonesArray *lines, Int_t optUseWeights=0);
8e104736	115	static AliESDVertex TrackletVertexFinder(AliStrLine **lines, const Int_t knacc, Int_t optUseWeights=0);
dc3719f3	116	void SetFieldkG(Double_t field=-999.) { fFieldkG=field; return; }
	117	Double_t GetFieldkG() const {
	118	if(fFieldkG<-99.) AliFatal("Field value not set");
	119	return fFieldkG; }
3b768a1d	120	void SetNSigmaForUi00(Double_t n=1.5) { fnSigmaForUi00=n; return; }
3b768a1d	121	Double_t GetNSigmaForUi00() const { return fnSigmaForUi00; }
07680cae	122
2d57349e	123	protected:
fee9ef0d	124	void HelixVertexFinder();
0c69be49	125	void OneTrackVertFinder();
f5740e9a	126	Int_t PrepareTracks(const TObjArray &trkArrayOrig,const UShort_t *idOrig,
6d8df534	127	Int_t optImpParCut);
f09c879d	128	Bool_t PropagateTrackTo(AliExternalTrackParam *track,
f09c879d	129	Double_t xToGo);
6d8df534	130	Bool_t TrackToPoint(AliExternalTrackParam *t,
817e1004	131	TMatrixD &ri,TMatrixD &wWi,
0bf2e2b4	132	Bool_t uUi3by3=kFALSE) const;
2d57349e	133	void VertexFinder(Int_t optUseWeights=0);
6d8df534	134	void VertexFitter();
fee9ef0d	135	void StrLinVertexFinderMinDist(Int_t optUseWeights=0);
6d8df534	136	void TooFewTracks();
eae1677e	137
146c29df	138	AliESDVertex fVert; // vertex after vertex finder
ec1be5d5	139	AliESDVertex *fCurrentVertex; // ESD vertex after fitter
f09c879d	140	UShort_t fMode; // 0 ITS+TPC; 1 TPC
dc3719f3	141	Double_t fFieldkG; // z component of field (kGauss)
07680cae	142	Double_t fNominalPos[3]; // initial knowledge on vertex position
50ff0bcd	143	Double_t fNominalCov[6]; // initial knowledge on vertex position
f09c879d	144	TObjArray fTrkArraySel; // array with tracks to be processed
	145	UShort_t *fIdSel; // IDs of the tracks (AliESDtrack::GetID())
	146	Int_t *fTrksToSkip; // track IDs to be skipped for find and fit
	147	Int_t fNTrksToSkip; // number of tracks to be skipped
fee9ef0d	148	Bool_t fConstraint; // true when "mean vertex" was set in
	149	// fNominal ... and must be used in the fit
	150	Bool_t fOnlyFitter; // primary with one fitter shot only
	151	// (use only with beam constraint)
2d57349e	152	Int_t fMinTracks; // minimum number of tracks
6b29d399	153	Int_t fMinClusters; // minimum number of ITS or TPC clusters per track
2d57349e	154	Double_t fDCAcut; // maximum DCA between 2 tracks used for vertex
f09c879d	155	Double_t fDCAcutIter0; // maximum DCA between 2 tracks used for vertex
07680cae	156	Double_t fNSigma; // number of sigmas for d0 cut in PrepareTracks()
43c9dae1	157	Double_t fMaxd0z0; // value for sqrt(d0d0+z0z0) cut
fee9ef0d	158	// in PrepareTracks(1) if fConstraint=kFALSE
f09c879d	159	Double_t fMinDetFitter; // minimum determinant to try to invertex matrix
f09c879d	160	Double_t fMaxTgl; // maximum tgl of tracks
50ff0bcd	161	Bool_t fITSrefit; // if kTRUE (default), use only kITSrefit tracks
50ff0bcd	162	// if kFALSE, use all tracks (also TPC only)
40cfa14d	163	Bool_t fITSpureSA; // if kFALSE (default) skip ITSpureSA tracks
40cfa14d	164	// if kTRUE use only those
6b29d399	165	Double_t fFiducialR; // radius of fiducial cylinder for tracks
6b29d399	166	Double_t fFiducialZ; // length of fiducial cylinder for tracks
3b768a1d	167	Double_t fnSigmaForUi00; // n. sigmas from finder in TrackToPoint
f09c879d	168	Int_t fAlgo; // option for vertex finding algorythm
8c75f668	169	Int_t fAlgoIter0; // this is for iteration 0
2d57349e	170	// fAlgo=1 (default) finds minimum-distance point among all selected tracks
	171	// approximated as straight lines
	172	// and uses errors on track parameters as weights
	173	// fAlgo=2 finds minimum-distance point among all the selected tracks
	174	// approximated as straight lines
	175	// fAlgo=3 finds the average point among DCA points of all pairs of tracks
	176	// treated as helices
	177	// fAlgo=4 finds the average point among DCA points of all pairs of tracks
	178	// approximated as straight lines
	179	// and uses errors on track parameters as weights
	180	// fAlgo=5 finds the average point among DCA points of all pairs of tracks
	181	// approximated as straight lines
	182
3b768a1d	183
fe12e09c	184	private:
	185	AliVertexerTracks(const AliVertexerTracks & source);
	186	AliVertexerTracks & operator=(const AliVertexerTracks & source);
2d57349e	187
40cfa14d	188	ClassDef(AliVertexerTracks,14) // 3D Vertexing with tracks
2d57349e	189	};
	190
	191	#endif
43c9dae1	192