[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{
    kOwner = BIT(14)
  };
  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);

  Bool_t          IsClustersOwner() const {return TestBit(kOwner);}
  void            SetClustersOwner(Bool_t own=kTRUE) {SetBit(kOwner, own); if(!own) fClusters = 0x0;}

  Int_t           FollowBackProlongation(AliTRDtrackV1 &t);
  Int_t           FollowProlongation(AliTRDtrackV1 &t);
  Int_t           LoadClusters(TTree *cTree);
  Int_t           LoadClusters(TClonesArray *clusters);
  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);
  Int_t          BuildTrackingContainers();
  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:
66f6bfd9	53	enum{
	54	kOwner = BIT(14)
	55	};
3b57a3f7	56	enum{
	57	kMaxLayersPerSector = 1000
	58	, kMaxTimeBinIndex = 216
	59	, kTrackingSectors = 18
	60	, kNTimeBins = 35
	61	, kNPlanes = 6
	62	, kNSeedPlanes = 4
	63	, kMaxTracksStack = 100
	64	, kNConfigs = 15
	65	};
3a039a31	66	AliTRDtrackerV1(AliTRDReconstructor *rec = 0x0);
3b57a3f7	67	virtual ~AliTRDtrackerV1();
e4f2f73d	68
eb38ed55	69	//temporary
	70	AliTRDtrackingSector* GetTrackingSector(Int_t sec) {return &fTrSec[sec];}
	71
3b57a3f7	72	Int_t Clusters2Tracks(AliESDEvent *esd);
eb38ed55	73	static TTreeSRedirector* DebugStreamer() {return fgDebugStreamer;}
3b57a3f7	74	AliCluster* GetCluster(Int_t index) const;
	75	AliTRDseedV1* GetTracklet(Int_t index) const;
	76	AliKalmanTrack* GetTrack(Int_t index) const;
	77	TClonesArray* GetListOfClusters() {return fClusters;}
	78	TClonesArray* GetListOfTracklets() {return fTracklets;}
	79	TClonesArray* GetListOfTracks() {return fTracks;}
	80	static const Int_t GetNTimeBins() {return fgNTimeBins;}
	81	static void GetExtrapolationConfig(Int_t iconfig, Int_t planes[2]);
	82	static void GetSeedingConfig(Int_t iconfig, Int_t planes[4]);
	83	static TLinearFitter* GetTiltedRiemanFitter();
	84	static TLinearFitter* GetTiltedRiemanFitterConstraint();
	85	static AliRieman* GetRiemanFitter();
	86	static void FitRieman(AliTRDcluster **clusters, Double_t chi2[2]);
	87	static Float_t FitRieman(AliTRDseedV1 tracklets, Double_t chi2, Int_t *planes = 0x0);
	88	static Float_t FitTiltedRiemanConstraint(AliTRDseedV1 *tracklets, Double_t zVertex);
	89	static Float_t FitTiltedRieman(AliTRDseedV1 *tracklets, Bool_t sigError);
eb38ed55	90
3b57a3f7	91	static Double_t FitRiemanTilt(AliTRDtrackV1 trk, AliTRDseedV1 tracklets = 0x0, Bool_t err=0, Int_t np = 0, AliTrackPoint *points = 0x0);
9e333711	92	static Double_t FitLine(AliTRDtrackV1 trk, AliTRDseedV1 tracklets = 0x0, Bool_t err=0, Int_t np = 0, AliTrackPoint *points = 0x0);
1bf51039	93	static Double_t FitKalman(AliTRDtrackV1 trk, AliTRDseedV1 tracklets = 0x0, Bool_t up=0, Int_t np = 0, AliTrackPoint *points = 0x0);
8acca6a3	94
66f6bfd9	95	Bool_t IsClustersOwner() const {return TestBit(kOwner);}
	96	void SetClustersOwner(Bool_t own=kTRUE) {SetBit(kOwner, own); if(!own) fClusters = 0x0;}
	97
3b57a3f7	98	Int_t FollowBackProlongation(AliTRDtrackV1 &t);
	99	Int_t FollowProlongation(AliTRDtrackV1 &t);
	100	Int_t LoadClusters(TTree *cTree);
66f6bfd9	101	Int_t LoadClusters(TClonesArray *clusters);
3b57a3f7	102	Int_t PropagateBack(AliESDEvent *event);
	103	Int_t ReadClusters(TClonesArray* &array, TTree *in) const;
	104	Int_t RefitInward(AliESDEvent *event);
	105	static void SetNTimeBins(Int_t nTimeBins){fgNTimeBins = nTimeBins; }
acd241e9	106	void SetReconstructor(const AliTRDReconstructor *rec);
3b57a3f7	107	void UnloadClusters();
	108
	109	static Int_t Freq(Int_t n, const Int_t inlist, Int_t outlist, Bool_t down); // to be removed
	110
	111	class AliTRDLeastSquare{
	112	public:
	113	AliTRDLeastSquare();
	114	~AliTRDLeastSquare(){};
	115
	116	void AddPoint(Double_t *x, Double_t y, Double_t sigmaY);
	117	void RemovePoint(Double_t *x, Double_t y, Double_t sigmaY);
	118	void Eval();
	119
	120	Double_t GetFunctionParameter(Int_t ParNumber) const {return fParams[ParNumber];}
	121	Double_t GetFunctionValue(Double_t *xpos) const;
	122	void GetCovarianceMatrix(Double_t *storage) const;
	123	private:
	124	AliTRDLeastSquare(const AliTRDLeastSquare &);
	125	AliTRDLeastSquare& operator=(const AliTRDLeastSquare &);
	126	Double_t fParams[2]; // Fitparameter
	127	Double_t fCovarianceMatrix[3]; // Covariance Matrix
	128	Double_t fSums[6]; // Sums
	129	};
fbb2ea06	130
eb38ed55	131	protected:
3b57a3f7	132	static Bool_t AdjustSector(AliTRDtrackV1 *track);
3b57a3f7	133	Double_t BuildSeedingConfigs(AliTRDtrackingChamber *stack, Int_t configs);
66f6bfd9	134	Int_t BuildTrackingContainers();
3b57a3f7	135	static Float_t CalculateChi2Z(AliTRDseedV1 *tracklets, Double_t offset, Double_t slope, Double_t xref);
	136	Int_t Clusters2TracksSM(Int_t sector, AliESDEvent *esd);
	137	Int_t Clusters2TracksStack(AliTRDtrackingChamber *stack, TClonesArray esdTrackList);
	138	AliTRDseedV1* GetTracklet(AliTRDtrackV1 *trk, Int_t plane, Int_t &idx);
	139	Bool_t GetTrackPoint(Int_t index, AliTrackPoint &p) const;
	140	Int_t MakeSeeds(AliTRDtrackingChamber *stack, AliTRDseedV1 sseed, Int_t *ipar);
	141	AliTRDtrackV1* MakeTrack(AliTRDseedV1 seeds, Double_t params);
	142	static Int_t PropagateToX(AliTRDtrackV1 &t, Double_t xToGo, Double_t maxStep);
d20df6fc	143	AliTRDtrackV1* SetTrack(AliTRDtrackV1 *track);
3b57a3f7	144	AliTRDseedV1* SetTracklet(AliTRDseedV1 *tracklet);
e4f2f73d	145
0906e73e	146	private:
3a039a31	147	AliTRDtrackerV1(const AliTRDtrackerV1 &tracker);
	148	AliTRDtrackerV1 &operator=(const AliTRDtrackerV1 &tracker);
	149	Double_t CookLikelihood(AliTRDseedV1 cseed, Int_t planes[4], Double_t chi2);
	150	Double_t CalculateTrackLikelihood(AliTRDseedV1 tracklets, Double_t chi2);
	151	Int_t ImproveSeedQuality(AliTRDtrackingChamber *stack, AliTRDseedV1 tracklet);
	152	static Float_t CalculateReferenceX(AliTRDseedV1 *tracklets);
	153	void ResetSeedTB();
	154	Float_t GetChi2Y(AliTRDseedV1 *tracklets) const;
	155	Float_t GetChi2Z(AliTRDseedV1 *tracklets) const;
e4f2f73d	156
0906e73e	157	private:
3a039a31	158	const AliTRDReconstructor *fReconstructor; // reconstructor manager
	159	AliTRDgeometry *fGeom; // Pointer to TRD geometry
	160	AliTRDtrackingSector fTrSec[kTrackingSectors]; // Array of tracking sectors;
e4f2f73d	161
bb56afff	162	TClonesArray *fClusters; // List of clusters
	163	TClonesArray *fTracklets; // List of tracklets
	164	TClonesArray *fTracks; // List of tracks
eb38ed55	165
	166	// should go to the recoParam
	167	static const Double_t fgkMaxChi2; // Max increment in track chi2
	168	static const Float_t fgkMinClustersInTrack; // Min number of clusters in track
	169	static const Float_t fgkLabelFraction; // Min fraction of same label
	170	static const Double_t fgkMaxSnp; // Maximal snp for tracking
	171	static const Double_t fgkMaxStep; // Maximal step for tracking
	172
	173	// stand alone tracking
2985ffcb	174	static Double_t fgTopologicQA[kNConfigs]; // Topologic quality
e4f2f73d	175	Double_t fTrackQuality[kMaxTracksStack]; // Track quality
e4f2f73d	176	Int_t fSeedLayer[kMaxTracksStack]; // Seed layer
d611c74f	177	AliTRDchamberTimeBin *fSeedTB[kNSeedPlanes]; // seeding time bin planes
e4f2f73d	178	Int_t fSieveSeeding; //! Seeding iterator
eb38ed55	179
2985ffcb	180	static Int_t fgNTimeBins; // Timebins per plane in track prolongation
	181	static TLinearFitter *fgTiltedRieman; // Fitter for the tilted Rieman fit without vertex constriant
	182	static TLinearFitter *fgTiltedRiemanConstrained; // Fitter for the tilted Rieman fit with vertex constraint
	183	static AliRieman *fgRieman; // Fitter for the untilted Rieman fit
bb56afff	184
	185	static TTreeSRedirector *fgDebugStreamer; //!Debug streamer
	186
eb38ed55	187	ClassDef(AliTRDtrackerV1, 2) // TRD tracker development class
e4f2f73d	188
	189	};
	190	#endif