[u/mrichter/AliRoot.git] / TRD / AliTRDtrackerV1.h

#ifndef ALITRDTRACKERV1_H
#define ALITRDTRACKERV1_H

/* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
 * See cxx source for full Copyright notice                               */ 

/* $Id$ */

////////////////////////////////////////////////////////////////////////////
//                                                                        //
//  The TRD tracker                                                       //
//                                                                        //
//  Authors:                                                              //
//    Marian Ivanov <M.Ivanov@gsi.de>                                     //
//    Alex Bercuci <A.Bercuci@gsi.de>                                     //
//    Jouri Belikov <J.Belikov@cern.ch>                                   //
//    Markus Fasel <M.Fasel@gsi.de>                                       //
//                                                                        //
////////////////////////////////////////////////////////////////////////////

#ifndef ALITRACKER_H
#include "AliTracker.h"
#endif

#ifndef ALITRDTRACKINGSECTOR_H
#include "AliTRDtrackingSector.h"
#endif

/**************************************************************************
 * Class Status see source file                                           *
 **************************************************************************/
 
class TFile;
class TTreeSRedirector;
class TClonesArray;
class TLinearFitter;

class AliRieman;
class AliESDEvent;
class AliCluster;
class AliTrackPoint;

class AliTRDcluster;
class AliTRDseedV1;
class AliTRDtrackingChamber;
class AliTRDchamberTimeBin;
class AliTRDtrackerFitter;
class AliTRDtrackV1;
class AliTRDReconstructor;
class AliTRDtrackerV1 : public AliTracker
{
public:
  enum{
    kMaxLayersPerSector   = 1000
    , kMaxTimeBinIndex    = 216
    , kTrackingSectors    = 18
    , kNTimeBins          = 35
    , kNPlanes            = 6
    , kNSeedPlanes        = 4
    , kMaxTracksStack     = 100
    , kNConfigs           = 15
  };
  AliTRDtrackerV1(AliTRDReconstructor *rec = 0x0);
  virtual ~AliTRDtrackerV1();
  
  //temporary
  AliTRDtrackingSector* GetTrackingSector(Int_t sec) {return &fTrSec[sec];}
  
  Int_t           Clusters2Tracks(AliESDEvent *esd);
  static TTreeSRedirector* DebugStreamer() {return fgDebugStreamer;}
  AliCluster*     GetCluster(Int_t index) const;
  AliTRDseedV1*   GetTracklet(Int_t index) const;
  AliKalmanTrack* GetTrack(Int_t index) const;
  TClonesArray*   GetListOfClusters() {return fClusters;}
  TClonesArray*   GetListOfTracklets() {return fTracklets;}
  TClonesArray*   GetListOfTracks() {return fTracks;}
  static const Int_t     GetNTimeBins() {return fgNTimeBins;}
  static void     GetExtrapolationConfig(Int_t iconfig, Int_t planes[2]);
  static void     GetSeedingConfig(Int_t iconfig, Int_t planes[4]);
  static TLinearFitter*  GetTiltedRiemanFitter();
  static TLinearFitter*  GetTiltedRiemanFitterConstraint();
  static AliRieman*      GetRiemanFitter();
  static void     FitRieman(AliTRDcluster **clusters, Double_t chi2[2]);
  static Float_t  FitRieman(AliTRDseedV1 *tracklets, Double_t *chi2, Int_t *planes = 0x0);
  static Float_t  FitTiltedRiemanConstraint(AliTRDseedV1 *tracklets, Double_t zVertex);
  static Float_t  FitTiltedRieman(AliTRDseedV1 *tracklets, Bool_t sigError);
  
 	static Double_t FitRiemanTilt(AliTRDtrackV1 *trk, AliTRDseedV1 *tracklets = 0x0, Bool_t err=0, Int_t np = 0, AliTrackPoint *points = 0x0);
 	static Double_t FitLine(AliTRDtrackV1 *trk, AliTRDseedV1 *tracklets = 0x0, Bool_t err=0, Int_t np = 0, AliTrackPoint *points = 0x0);
 	//static Double_t FitKalman(AliTRDtrackV1 *trk, AliTRDseedV1 *tracklets = 0x0, Bool_t up=0, Int_t np = 0, AliTrackPoint *points = 0x0);

  Int_t           FollowBackProlongation(AliTRDtrackV1 &t);
  Int_t           FollowProlongation(AliTRDtrackV1 &t);
  Int_t           LoadClusters(TTree *cTree);
  Int_t           PropagateBack(AliESDEvent *event);
  Int_t           ReadClusters(TClonesArray* &array, TTree *in) const;
  Int_t           RefitInward(AliESDEvent *event);
  static void     SetNTimeBins(Int_t nTimeBins){fgNTimeBins = nTimeBins; }
  void            SetReconstructor(const AliTRDReconstructor *rec); 
  void            UnloadClusters();
  
  static Int_t    Freq(Int_t n, const Int_t *inlist, Int_t *outlist, Bool_t down); // to be removed 

  class AliTRDLeastSquare{
  public:
    AliTRDLeastSquare();
    ~AliTRDLeastSquare(){};
    
    void		AddPoint(Double_t *x, Double_t y, Double_t sigmaY);
    void		RemovePoint(Double_t *x, Double_t y, Double_t sigmaY);
    void		Eval();
    
    Double_t	GetFunctionParameter(Int_t ParNumber) const {return fParams[ParNumber];}
    Double_t	GetFunctionValue(Double_t *xpos) const;
    void		GetCovarianceMatrix(Double_t *storage) const;
  private:
          AliTRDLeastSquare(const AliTRDLeastSquare &);
    AliTRDLeastSquare& operator=(const AliTRDLeastSquare &);
    Double_t 	fParams[2];						// Fitparameter	
    Double_t 	fCovarianceMatrix[3];			// Covariance Matrix
    Double_t 	fSums[6];						// Sums
  };

protected:
  static Bool_t  AdjustSector(AliTRDtrackV1 *track); 
  Double_t       BuildSeedingConfigs(AliTRDtrackingChamber **stack, Int_t *configs);
  static Float_t CalculateChi2Z(AliTRDseedV1 *tracklets, Double_t offset, Double_t slope, Double_t xref);
  Int_t          Clusters2TracksSM(Int_t sector, AliESDEvent *esd);
  Int_t          Clusters2TracksStack(AliTRDtrackingChamber **stack, TClonesArray *esdTrackList);
  AliTRDseedV1*  GetTracklet(AliTRDtrackV1 *trk, Int_t plane, Int_t &idx);
  Bool_t         GetTrackPoint(Int_t index, AliTrackPoint &p) const;	
  Int_t          MakeSeeds(AliTRDtrackingChamber **stack, AliTRDseedV1 *sseed, Int_t *ipar);
  AliTRDtrackV1* MakeTrack(AliTRDseedV1 *seeds, Double_t *params);
  static Int_t   PropagateToX(AliTRDtrackV1 &t, Double_t xToGo, Double_t maxStep);
  AliTRDtrackV1* SetTrack(AliTRDtrackV1 *track);
  AliTRDseedV1*  SetTracklet(AliTRDseedV1 *tracklet);

private:
  AliTRDtrackerV1(const AliTRDtrackerV1 &tracker);
  AliTRDtrackerV1 &operator=(const AliTRDtrackerV1 &tracker);
  Double_t       	CookLikelihood(AliTRDseedV1 *cseed, Int_t planes[4], Double_t *chi2);
  Double_t       	CalculateTrackLikelihood(AliTRDseedV1 *tracklets, Double_t *chi2);
  Int_t          	ImproveSeedQuality(AliTRDtrackingChamber **stack, AliTRDseedV1 *tracklet);
  static Float_t	CalculateReferenceX(AliTRDseedV1 *tracklets);
  void        ResetSeedTB();
  Float_t     GetChi2Y(AliTRDseedV1 *tracklets) const;
  Float_t     GetChi2Z(AliTRDseedV1 *tracklets) const;

private:
  const AliTRDReconstructor *fReconstructor;                 // reconstructor manager
  AliTRDgeometry      *fGeom;                          // Pointer to TRD geometry
  AliTRDtrackingSector fTrSec[kTrackingSectors];       // Array of tracking sectors;    

  TClonesArray        *fClusters;                       // List of clusters
  TClonesArray        *fTracklets;                      // List of tracklets
  TClonesArray        *fTracks;                         // List of tracks
  
  // should go to the recoParam
  static const Double_t    fgkMaxChi2;                     // Max increment in track chi2 
  static const Float_t     fgkMinClustersInTrack;          // Min number of clusters in track
  static const Float_t     fgkLabelFraction;               // Min fraction of same label
  static const Double_t    fgkMaxSnp;                      // Maximal snp for tracking
  static const Double_t    fgkMaxStep;                     // Maximal step for tracking  
	
	// stand alone tracking
	static Double_t      fgTopologicQA[kNConfigs];        //  Topologic quality
	Double_t             fTrackQuality[kMaxTracksStack];  //  Track quality 
	Int_t                fSeedLayer[kMaxTracksStack];     //  Seed layer
  AliTRDchamberTimeBin *fSeedTB[kNSeedPlanes]; // seeding time bin planes
	Int_t                fSieveSeeding;                   //! Seeding iterator
	
  static Int_t         fgNTimeBins;                     // Timebins per plane in track prolongation 
	static TLinearFitter *fgTiltedRieman;                 //  Fitter for the tilted Rieman fit without vertex constriant
	static TLinearFitter *fgTiltedRiemanConstrained;      //  Fitter for the tilted Rieman fit with vertex constraint	
	static AliRieman     *fgRieman;                       //  Fitter for the untilted Rieman fit
  
	static TTreeSRedirector *fgDebugStreamer;             //!Debug streamer
	
	ClassDef(AliTRDtrackerV1, 2)                          //  TRD tracker development class

};
#endif
Commit	Line	Data
e4f2f73d	1	#ifndef ALITRDTRACKERV1_H
e4f2f73d	2	#define ALITRDTRACKERV1_H
eb38ed55	3
e4f2f73d	4	/* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
	5	* See cxx source for full Copyright notice */
	6
	7	/* $Id$ */
	8
	9	////////////////////////////////////////////////////////////////////////////
	10	// //
	11	// The TRD tracker //
	12	// //
	13	// Authors: //
eb38ed55	14	// Marian Ivanov <M.Ivanov@gsi.de> //
e4f2f73d	15	// Alex Bercuci <A.Bercuci@gsi.de> //
eb38ed55	16	// Jouri Belikov <J.Belikov@cern.ch> //
e4f2f73d	17	// Markus Fasel <M.Fasel@gsi.de> //
e4f2f73d	18	// //
eb38ed55	19	////////////////////////////////////////////////////////////////////////////
e4f2f73d	20
eb38ed55	21	#ifndef ALITRACKER_H
eb38ed55	22	#include "AliTracker.h"
e4f2f73d	23	#endif
e4f2f73d	24
eb38ed55	25	#ifndef ALITRDTRACKINGSECTOR_H
	26	#include "AliTRDtrackingSector.h"
	27	#endif
e4f2f73d	28
	29	/**************************************************************************
	30	* Class Status see source file *
	31	**************************************************************************/
	32
	33	class TFile;
	34	class TTreeSRedirector;
	35	class TClonesArray;
eb38ed55	36	class TLinearFitter;
e4f2f73d	37
	38	class AliRieman;
	39	class AliESDEvent;
eb38ed55	40	class AliCluster;
3a039a31	41	class AliTrackPoint;
e4f2f73d	42
eb38ed55	43	class AliTRDcluster;
e4f2f73d	44	class AliTRDseedV1;
eb38ed55	45	class AliTRDtrackingChamber;
eb38ed55	46	class AliTRDchamberTimeBin;
e4f2f73d	47	class AliTRDtrackerFitter;
0906e73e	48	class AliTRDtrackV1;
3a039a31	49	class AliTRDReconstructor;
eb38ed55	50	class AliTRDtrackerV1 : public AliTracker
e4f2f73d	51	{
eb38ed55	52	public:
3b57a3f7	53	enum{
	54	kMaxLayersPerSector = 1000
	55	, kMaxTimeBinIndex = 216
	56	, kTrackingSectors = 18
	57	, kNTimeBins = 35
	58	, kNPlanes = 6
	59	, kNSeedPlanes = 4
	60	, kMaxTracksStack = 100
	61	, kNConfigs = 15
	62	};
3a039a31	63	AliTRDtrackerV1(AliTRDReconstructor *rec = 0x0);
3b57a3f7	64	virtual ~AliTRDtrackerV1();
e4f2f73d	65
eb38ed55	66	//temporary
	67	AliTRDtrackingSector* GetTrackingSector(Int_t sec) {return &fTrSec[sec];}
	68
3b57a3f7	69	Int_t Clusters2Tracks(AliESDEvent *esd);
eb38ed55	70	static TTreeSRedirector* DebugStreamer() {return fgDebugStreamer;}
3b57a3f7	71	AliCluster* GetCluster(Int_t index) const;
	72	AliTRDseedV1* GetTracklet(Int_t index) const;
	73	AliKalmanTrack* GetTrack(Int_t index) const;
	74	TClonesArray* GetListOfClusters() {return fClusters;}
	75	TClonesArray* GetListOfTracklets() {return fTracklets;}
	76	TClonesArray* GetListOfTracks() {return fTracks;}
	77	static const Int_t GetNTimeBins() {return fgNTimeBins;}
	78	static void GetExtrapolationConfig(Int_t iconfig, Int_t planes[2]);
	79	static void GetSeedingConfig(Int_t iconfig, Int_t planes[4]);
	80	static TLinearFitter* GetTiltedRiemanFitter();
	81	static TLinearFitter* GetTiltedRiemanFitterConstraint();
	82	static AliRieman* GetRiemanFitter();
	83	static void FitRieman(AliTRDcluster **clusters, Double_t chi2[2]);
	84	static Float_t FitRieman(AliTRDseedV1 tracklets, Double_t chi2, Int_t *planes = 0x0);
	85	static Float_t FitTiltedRiemanConstraint(AliTRDseedV1 *tracklets, Double_t zVertex);
	86	static Float_t FitTiltedRieman(AliTRDseedV1 *tracklets, Bool_t sigError);
eb38ed55	87
3b57a3f7	88	static Double_t FitRiemanTilt(AliTRDtrackV1 trk, AliTRDseedV1 tracklets = 0x0, Bool_t err=0, Int_t np = 0, AliTrackPoint *points = 0x0);
9e333711	89	static Double_t FitLine(AliTRDtrackV1 trk, AliTRDseedV1 tracklets = 0x0, Bool_t err=0, Int_t np = 0, AliTrackPoint *points = 0x0);
3b57a3f7	90	//static Double_t FitKalman(AliTRDtrackV1 trk, AliTRDseedV1 tracklets = 0x0, Bool_t up=0, Int_t np = 0, AliTrackPoint *points = 0x0);
8acca6a3	91
3b57a3f7	92	Int_t FollowBackProlongation(AliTRDtrackV1 &t);
	93	Int_t FollowProlongation(AliTRDtrackV1 &t);
	94	Int_t LoadClusters(TTree *cTree);
	95	Int_t PropagateBack(AliESDEvent *event);
	96	Int_t ReadClusters(TClonesArray* &array, TTree *in) const;
	97	Int_t RefitInward(AliESDEvent *event);
	98	static void SetNTimeBins(Int_t nTimeBins){fgNTimeBins = nTimeBins; }
acd241e9	99	void SetReconstructor(const AliTRDReconstructor *rec);
3b57a3f7	100	void UnloadClusters();
	101
	102	static Int_t Freq(Int_t n, const Int_t inlist, Int_t outlist, Bool_t down); // to be removed
	103
	104	class AliTRDLeastSquare{
	105	public:
	106	AliTRDLeastSquare();
	107	~AliTRDLeastSquare(){};
	108
	109	void AddPoint(Double_t *x, Double_t y, Double_t sigmaY);
	110	void RemovePoint(Double_t *x, Double_t y, Double_t sigmaY);
	111	void Eval();
	112
	113	Double_t GetFunctionParameter(Int_t ParNumber) const {return fParams[ParNumber];}
	114	Double_t GetFunctionValue(Double_t *xpos) const;
	115	void GetCovarianceMatrix(Double_t *storage) const;
	116	private:
	117	AliTRDLeastSquare(const AliTRDLeastSquare &);
	118	AliTRDLeastSquare& operator=(const AliTRDLeastSquare &);
	119	Double_t fParams[2]; // Fitparameter
	120	Double_t fCovarianceMatrix[3]; // Covariance Matrix
	121	Double_t fSums[6]; // Sums
	122	};
fbb2ea06	123
eb38ed55	124	protected:
3b57a3f7	125	static Bool_t AdjustSector(AliTRDtrackV1 *track);
	126	Double_t BuildSeedingConfigs(AliTRDtrackingChamber *stack, Int_t configs);
	127	static Float_t CalculateChi2Z(AliTRDseedV1 *tracklets, Double_t offset, Double_t slope, Double_t xref);
	128	Int_t Clusters2TracksSM(Int_t sector, AliESDEvent *esd);
	129	Int_t Clusters2TracksStack(AliTRDtrackingChamber *stack, TClonesArray esdTrackList);
	130	AliTRDseedV1* GetTracklet(AliTRDtrackV1 *trk, Int_t plane, Int_t &idx);
	131	Bool_t GetTrackPoint(Int_t index, AliTrackPoint &p) const;
	132	Int_t MakeSeeds(AliTRDtrackingChamber *stack, AliTRDseedV1 sseed, Int_t *ipar);
	133	AliTRDtrackV1* MakeTrack(AliTRDseedV1 seeds, Double_t params);
	134	static Int_t PropagateToX(AliTRDtrackV1 &t, Double_t xToGo, Double_t maxStep);
d20df6fc	135	AliTRDtrackV1* SetTrack(AliTRDtrackV1 *track);
3b57a3f7	136	AliTRDseedV1* SetTracklet(AliTRDseedV1 *tracklet);
e4f2f73d	137
0906e73e	138	private:
3a039a31	139	AliTRDtrackerV1(const AliTRDtrackerV1 &tracker);
	140	AliTRDtrackerV1 &operator=(const AliTRDtrackerV1 &tracker);
	141	Double_t CookLikelihood(AliTRDseedV1 cseed, Int_t planes[4], Double_t chi2);
	142	Double_t CalculateTrackLikelihood(AliTRDseedV1 tracklets, Double_t chi2);
	143	Int_t ImproveSeedQuality(AliTRDtrackingChamber *stack, AliTRDseedV1 tracklet);
	144	static Float_t CalculateReferenceX(AliTRDseedV1 *tracklets);
	145	void ResetSeedTB();
	146	Float_t GetChi2Y(AliTRDseedV1 *tracklets) const;
	147	Float_t GetChi2Z(AliTRDseedV1 *tracklets) const;
e4f2f73d	148
0906e73e	149	private:
3a039a31	150	const AliTRDReconstructor *fReconstructor; // reconstructor manager
	151	AliTRDgeometry *fGeom; // Pointer to TRD geometry
	152	AliTRDtrackingSector fTrSec[kTrackingSectors]; // Array of tracking sectors;
e4f2f73d	153
bb56afff	154	TClonesArray *fClusters; // List of clusters
	155	TClonesArray *fTracklets; // List of tracklets
	156	TClonesArray *fTracks; // List of tracks
eb38ed55	157
	158	// should go to the recoParam
	159	static const Double_t fgkMaxChi2; // Max increment in track chi2
	160	static const Float_t fgkMinClustersInTrack; // Min number of clusters in track
	161	static const Float_t fgkLabelFraction; // Min fraction of same label
	162	static const Double_t fgkMaxSnp; // Maximal snp for tracking
	163	static const Double_t fgkMaxStep; // Maximal step for tracking
	164
	165	// stand alone tracking
2985ffcb	166	static Double_t fgTopologicQA[kNConfigs]; // Topologic quality
e4f2f73d	167	Double_t fTrackQuality[kMaxTracksStack]; // Track quality
e4f2f73d	168	Int_t fSeedLayer[kMaxTracksStack]; // Seed layer
d611c74f	169	AliTRDchamberTimeBin *fSeedTB[kNSeedPlanes]; // seeding time bin planes
e4f2f73d	170	Int_t fSieveSeeding; //! Seeding iterator
eb38ed55	171
2985ffcb	172	static Int_t fgNTimeBins; // Timebins per plane in track prolongation
	173	static TLinearFitter *fgTiltedRieman; // Fitter for the tilted Rieman fit without vertex constriant
	174	static TLinearFitter *fgTiltedRiemanConstrained; // Fitter for the tilted Rieman fit with vertex constraint
	175	static AliRieman *fgRieman; // Fitter for the untilted Rieman fit
bb56afff	176
	177	static TTreeSRedirector *fgDebugStreamer; //!Debug streamer
	178
eb38ed55	179	ClassDef(AliTRDtrackerV1, 2) // TRD tracker development class
e4f2f73d	180
	181	};
	182	#endif