[u/mrichter/AliRoot.git] / MUON / AliMUONEventReconstructor.h

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

/*$Id$*/

////////////////////////////////////
// MUON event reconstructor in ALICE
////////////////////////////////////

#include <TObject.h>

class AliMUONHit;
class AliMUONHitForRec;
class AliMUONSegment;
class TClonesArray;
class TFile;
class TTree;
class AliMUONRecoEvent;

// Constants which should be elsewhere ????
const Int_t kMaxMuonTrackingChambers = 10;
const Int_t kMaxMuonTrackingStations = kMaxMuonTrackingChambers / 2;

class AliMUONEventReconstructor : public TObject {

 public:
  AliMUONEventReconstructor(void); // Constructor
  virtual ~AliMUONEventReconstructor(void); // Destructor
  AliMUONEventReconstructor (const AliMUONEventReconstructor& Reconstructor); // copy constructor
  AliMUONEventReconstructor& operator=(const AliMUONEventReconstructor& Reconstructor); // assignment operator

  // Parameters for event reconstruction: public methods
  // Get and Set, Set to defaults
  Double_t GetMinBendingMomentum(void) const {return fMinBendingMomentum;}
  void SetMinBendingMomentum(Double_t MinBendingMomentum) {fMinBendingMomentum = MinBendingMomentum;}
  Double_t GetMaxBendingMomentum(void) const {return fMaxBendingMomentum;}
  void SetMaxBendingMomentum(Double_t MaxBendingMomentum) {fMaxBendingMomentum = MaxBendingMomentum;}
  Double_t GetMaxChi2(void) const {return fMaxChi2;}
  void SetMaxChi2(Double_t MaxChi2) {fMaxChi2 = MaxChi2;}
  Double_t GetMaxSigma2Distance(void) const {return fMaxSigma2Distance;}
  void SetMaxSigma2Distance(Double_t MaxSigma2Distance) {fMaxSigma2Distance = MaxSigma2Distance;}
  Double_t GetBendingResolution(void) const {return fBendingResolution;}
  void SetBendingResolution(Double_t BendingResolution) {fBendingResolution = BendingResolution;}
  Double_t GetNonBendingResolution(void) const {return fNonBendingResolution;}
  void SetNonBendingResolution(Double_t NonBendingResolution) {fNonBendingResolution = NonBendingResolution;}
  Double_t GetChamberThicknessInX0(void) const {return fChamberThicknessInX0;}
  void SetChamberThicknessInX0(Double_t ChamberThicknessInX0) {fChamberThicknessInX0 = ChamberThicknessInX0;}
  Double_t GetSimpleBValue(void) const {return fSimpleBValue;}
  void SetSimpleBValue(Double_t SimpleBValue) {fSimpleBValue = SimpleBValue;}
  Double_t GetSimpleBLength(void) const {return fSimpleBLength;}
  void SetSimpleBLength(Double_t SimpleBLength) {fSimpleBLength = SimpleBLength;}
  Double_t GetSimpleBPosition(void) const {return fSimpleBPosition;}
  void SetSimpleBPosition(Double_t SimpleBPosition) {fSimpleBPosition = SimpleBPosition;}
  Int_t GetRecGeantHits(void) const {return fRecGeantHits;}
  void SetRecGeantHits(Int_t RecGeantHits) {fRecGeantHits = RecGeantHits;}
  Double_t GetEfficiency(void) const {return fEfficiency;}
  void SetEfficiency(Double_t Efficiency) {fEfficiency = Efficiency;}
  Int_t GetPrintLevel(void) const {return fPrintLevel;}
  void SetPrintLevel(Int_t PrintLevel) {fPrintLevel = PrintLevel;}
  void SetReconstructionParametersToDefaults(void);

  // Parameters for GEANT background events
  TFile* GetBkgGeantFile(void) const {return fBkgGeantFile;}
  void SetBkgGeantFile(Text_t *BkgGeantFileName); // set background file for GEANT hits
  void NextBkgGeantEvent(void); // next event in background file for GEANT hits

  // Hits for reconstruction
  Int_t GetNHitsForRec(void) const {return fNHitsForRec;} // Number

  // Reconstructed tracks
  Int_t GetNRecTracks() const {return fNRecTracks;} // Number
  void SetNRecTracks(Int_t NRecTracks) {fNRecTracks = NRecTracks;}
  TClonesArray* GetRecTracksPtr(void) const {return fRecTracksPtr;} // Array

  // Hits on reconstructed tracks
  Int_t GetNRecTrackHits() const {return fNRecTrackHits;} // Number
  void SetNRecTrackHits(Int_t NRecTrackHits) {fNRecTrackHits = NRecTrackHits;}
  TClonesArray* GetRecTrackHitsPtr(void) const {return fRecTrackHitsPtr;} // Array

  // Functions
  Double_t GetImpactParamFromBendingMomentum(Double_t BendingMomentum) const;
  Double_t GetBendingMomentumFromImpactParam(Double_t ImpactParam) const;
  void EventReconstruct(void);
  void EventDump(void);  // dump reconstructed event
  void FillEvent();      // fill and write tree of reconstructed events

 protected:

 private:

  // Parameters for event reconstruction
  Double_t fMinBendingMomentum; // minimum value (GeV/c) of momentum in bending plane
  // Parameters for event reconstruction
  Double_t fMaxBendingMomentum; // maximum value (GeV/c) of momentum in bending plane
  Double_t fMaxChi2; // maximum Chi2 per degree of Freedom
  Double_t fMaxSigma2Distance; // maximum square distance in units of the variance (maximum chi2)
  Double_t fRMin[kMaxMuonTrackingChambers]; // minimum radius (cm)
  Double_t fRMax[kMaxMuonTrackingChambers]; // maximum radius (cm)
  Double_t fSegmentMaxDistBending[kMaxMuonTrackingStations]; // maximum distance (cm) for segments in bending plane
  Double_t fSegmentMaxDistNonBending[kMaxMuonTrackingStations]; // maximum distance (cm) for segments in non bending plane
  Double_t fBendingResolution; // chamber resolution (cm) in bending plane
  Double_t fNonBendingResolution; // chamber resolution (cm) in non bending plane
  Double_t fChamberThicknessInX0; // chamber thickness in number of radiation lengths
                                  // how to take it from simulation ????
  Double_t fSimpleBValue; // simple magnetic field: value (kG)
  Double_t fSimpleBLength; // simple magnetic field: length (cm)
  Double_t fSimpleBPosition; // simple magnetic field: Z central position (cm)
  Int_t fRecGeantHits; // reconstruction from raw clusters (0) or from GEANT hits (1)
  Double_t fEfficiency; // chamber efficiency (used for GEANT hits only)
  Int_t fPrintLevel; // print level

  // Parameters for GEANT background events
  // should be in AliMUON class ????
  TFile *fBkgGeantFile; // pointer to file
  TTree *fBkgGeantTK; // pointer to tree TK
  TClonesArray *fBkgGeantParticles;   // pointer to list of particles in tree TK
  TTree *fBkgGeantTH; // pointer to tree TH
  TClonesArray *fBkgGeantHits;   // pointer to list of hits in tree TH
  Int_t fBkgGeantEventNumber;   // event number
  
  // Hits for reconstruction (should be in AliMUON ????)
  TClonesArray *fHitsForRecPtr; // pointer to the array of hits for reconstruction
  Int_t fNHitsForRec; // number of hits for reconstruction
  // Information per chamber (should be in AliMUONChamber ????)
  Int_t fNHitsForRecPerChamber[kMaxMuonTrackingChambers]; // number of HitsForRec
  Int_t fIndexOfFirstHitForRecPerChamber[kMaxMuonTrackingChambers]; // index (0...) of first HitForRec

  // Segments inside a station
  TClonesArray *fSegmentsPtr[kMaxMuonTrackingStations]; // array of pointers to the segments for each station
  Int_t fNSegments[kMaxMuonTrackingStations]; // number of segments for each station

  // Reconstructed tracks
  TClonesArray *fRecTracksPtr; // pointer to array of reconstructed tracks
  Int_t fNRecTracks; // number of reconstructed tracks

  // Track hits on reconstructed tracks
  TClonesArray *fRecTrackHitsPtr; // pointer to array of hits on reconstructed tracks
  Int_t fNRecTrackHits; // number of hits on reconstructed tracks

  // Objects needed for tree writing
  AliMUONRecoEvent *fRecoEvent; // the reconstructed event
  TTree            *fEventTree; // tree of reconstructed events
  TFile            *fTreeFile;  // file where the tree is outputed

  // Functions
  void ResetHitsForRec(void);
  void MakeEventToBeReconstructed(void);
  void AddHitsForRecFromGEANT(TTree *TH);
  void AddHitsForRecFromBkgGEANT(TTree *TH, TClonesArray *Hits);
  AliMUONHitForRec* NewHitForRecFromGEANT(AliMUONHit* Hit, Int_t TrackNumber, Int_t HitNumber, Int_t Signal);
/*   void AddHitsForRecFromCathodeCorrelations(TTree* TC); */
  void AddHitsForRecFromRawClusters(TTree* TR);
  void SortHitsForRecWithIncreasingChamber();
  void MakeSegments(void);
  void ResetSegments(void);
  void MakeSegmentsPerStation(Int_t Station);
  void MakeTracks(void);
  void ResetTrackHits(void);
  void ResetTracks(void);
  Int_t MakeTrackCandidatesWithTwoSegments(AliMUONSegment *BegSegment);
  Int_t MakeTrackCandidatesWithOneSegmentAndOnePoint(AliMUONSegment *BegSegment);
  void MakeTrackCandidates(void);
  void FollowTracks(void);
  void RemoveDoubleTracks(void);

  ClassDef(AliMUONEventReconstructor, 0) // MUON event reconstructor in ALICE
    };
	
#endif
Commit	Line	Data
a9e2aefa	1	#ifndef ALIMUONEVENTRECONSTRUCTOR_H
	2	#define ALIMUONEVENTRECONSTRUCTOR_H
	3	/* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
	4	* See cxx source for full Copyright notice */
	5
	6	/$Id$/
	7
3831f268	8	////////////////////////////////////
	9	// MUON event reconstructor in ALICE
	10	////////////////////////////////////
	11
	12	#include <TObject.h>
a9e2aefa	13
	14	class AliMUONHit;
	15	class AliMUONHitForRec;
	16	class AliMUONSegment;
	17	class TClonesArray;
	18	class TFile;
	19	class TTree;
c7ba256d	20	class AliMUONRecoEvent;
a9e2aefa	21
a9e2aefa	22	// Constants which should be elsewhere ????
9cbdf048	23	const Int_t kMaxMuonTrackingChambers = 10;
9cbdf048	24	const Int_t kMaxMuonTrackingStations = kMaxMuonTrackingChambers / 2;
a9e2aefa	25
	26	class AliMUONEventReconstructor : public TObject {
	27
	28	public:
	29	AliMUONEventReconstructor(void); // Constructor
	30	virtual ~AliMUONEventReconstructor(void); // Destructor
9cbdf048	31	AliMUONEventReconstructor (const AliMUONEventReconstructor& Reconstructor); // copy constructor
9cbdf048	32	AliMUONEventReconstructor& operator=(const AliMUONEventReconstructor& Reconstructor); // assignment operator
a9e2aefa	33
	34	// Parameters for event reconstruction: public methods
	35	// Get and Set, Set to defaults
3831f268	36	Double_t GetMinBendingMomentum(void) const {return fMinBendingMomentum;}
a9e2aefa	37	void SetMinBendingMomentum(Double_t MinBendingMomentum) {fMinBendingMomentum = MinBendingMomentum;}
3831f268	38	Double_t GetMaxBendingMomentum(void) const {return fMaxBendingMomentum;}
d0bfce8d	39	void SetMaxBendingMomentum(Double_t MaxBendingMomentum) {fMaxBendingMomentum = MaxBendingMomentum;}
3831f268	40	Double_t GetMaxChi2(void) const {return fMaxChi2;}
d0bfce8d	41	void SetMaxChi2(Double_t MaxChi2) {fMaxChi2 = MaxChi2;}
3831f268	42	Double_t GetMaxSigma2Distance(void) const {return fMaxSigma2Distance;}
a9e2aefa	43	void SetMaxSigma2Distance(Double_t MaxSigma2Distance) {fMaxSigma2Distance = MaxSigma2Distance;}
3831f268	44	Double_t GetBendingResolution(void) const {return fBendingResolution;}
a9e2aefa	45	void SetBendingResolution(Double_t BendingResolution) {fBendingResolution = BendingResolution;}
3831f268	46	Double_t GetNonBendingResolution(void) const {return fNonBendingResolution;}
a9e2aefa	47	void SetNonBendingResolution(Double_t NonBendingResolution) {fNonBendingResolution = NonBendingResolution;}
3831f268	48	Double_t GetChamberThicknessInX0(void) const {return fChamberThicknessInX0;}
a9e2aefa	49	void SetChamberThicknessInX0(Double_t ChamberThicknessInX0) {fChamberThicknessInX0 = ChamberThicknessInX0;}
3831f268	50	Double_t GetSimpleBValue(void) const {return fSimpleBValue;}
a9e2aefa	51	void SetSimpleBValue(Double_t SimpleBValue) {fSimpleBValue = SimpleBValue;}
3831f268	52	Double_t GetSimpleBLength(void) const {return fSimpleBLength;}
a9e2aefa	53	void SetSimpleBLength(Double_t SimpleBLength) {fSimpleBLength = SimpleBLength;}
3831f268	54	Double_t GetSimpleBPosition(void) const {return fSimpleBPosition;}
a9e2aefa	55	void SetSimpleBPosition(Double_t SimpleBPosition) {fSimpleBPosition = SimpleBPosition;}
3831f268	56	Int_t GetRecGeantHits(void) const {return fRecGeantHits;}
a9e2aefa	57	void SetRecGeantHits(Int_t RecGeantHits) {fRecGeantHits = RecGeantHits;}
3831f268	58	Double_t GetEfficiency(void) const {return fEfficiency;}
a9e2aefa	59	void SetEfficiency(Double_t Efficiency) {fEfficiency = Efficiency;}
3831f268	60	Int_t GetPrintLevel(void) const {return fPrintLevel;}
a9e2aefa	61	void SetPrintLevel(Int_t PrintLevel) {fPrintLevel = PrintLevel;}
	62	void SetReconstructionParametersToDefaults(void);
	63
	64	// Parameters for GEANT background events
3831f268	65	TFile* GetBkgGeantFile(void) const {return fBkgGeantFile;}
a9e2aefa	66	void SetBkgGeantFile(Text_t *BkgGeantFileName); // set background file for GEANT hits
	67	void NextBkgGeantEvent(void); // next event in background file for GEANT hits
	68
	69	// Hits for reconstruction
3831f268	70	Int_t GetNHitsForRec(void) const {return fNHitsForRec;} // Number
8429a5e4	71
8429a5e4	72	// Reconstructed tracks
3831f268	73	Int_t GetNRecTracks() const {return fNRecTracks;} // Number
8429a5e4	74	void SetNRecTracks(Int_t NRecTracks) {fNRecTracks = NRecTracks;}
3831f268	75	TClonesArray* GetRecTracksPtr(void) const {return fRecTracksPtr;} // Array
8429a5e4	76
8429a5e4	77	// Hits on reconstructed tracks
3831f268	78	Int_t GetNRecTrackHits() const {return fNRecTrackHits;} // Number
8429a5e4	79	void SetNRecTrackHits(Int_t NRecTrackHits) {fNRecTrackHits = NRecTrackHits;}
3831f268	80	TClonesArray* GetRecTrackHitsPtr(void) const {return fRecTrackHitsPtr;} // Array
a9e2aefa	81
a9e2aefa	82	// Functions
3831f268	83	Double_t GetImpactParamFromBendingMomentum(Double_t BendingMomentum) const;
3831f268	84	Double_t GetBendingMomentumFromImpactParam(Double_t ImpactParam) const;
a9e2aefa	85	void EventReconstruct(void);
04b5ea16	86	void EventDump(void); // dump reconstructed event
c7ba256d	87	void FillEvent(); // fill and write tree of reconstructed events
a9e2aefa	88
9cbdf048	89	protected:
9cbdf048	90
a9e2aefa	91	private:
	92
	93	// Parameters for event reconstruction
	94	Double_t fMinBendingMomentum; // minimum value (GeV/c) of momentum in bending plane
d0bfce8d	95	// Parameters for event reconstruction
	96	Double_t fMaxBendingMomentum; // maximum value (GeV/c) of momentum in bending plane
	97	Double_t fMaxChi2; // maximum Chi2 per degree of Freedom
a9e2aefa	98	Double_t fMaxSigma2Distance; // maximum square distance in units of the variance (maximum chi2)
9cbdf048	99	Double_t fRMin[kMaxMuonTrackingChambers]; // minimum radius (cm)
	100	Double_t fRMax[kMaxMuonTrackingChambers]; // maximum radius (cm)
	101	Double_t fSegmentMaxDistBending[kMaxMuonTrackingStations]; // maximum distance (cm) for segments in bending plane
ba5b68db	102	Double_t fSegmentMaxDistNonBending[kMaxMuonTrackingStations]; // maximum distance (cm) for segments in non bending plane
a9e2aefa	103	Double_t fBendingResolution; // chamber resolution (cm) in bending plane
	104	Double_t fNonBendingResolution; // chamber resolution (cm) in non bending plane
	105	Double_t fChamberThicknessInX0; // chamber thickness in number of radiation lengths
	106	// how to take it from simulation ????
	107	Double_t fSimpleBValue; // simple magnetic field: value (kG)
	108	Double_t fSimpleBLength; // simple magnetic field: length (cm)
	109	Double_t fSimpleBPosition; // simple magnetic field: Z central position (cm)
	110	Int_t fRecGeantHits; // reconstruction from raw clusters (0) or from GEANT hits (1)
	111	Double_t fEfficiency; // chamber efficiency (used for GEANT hits only)
	112	Int_t fPrintLevel; // print level
	113
	114	// Parameters for GEANT background events
	115	// should be in AliMUON class ????
	116	TFile *fBkgGeantFile; // pointer to file
	117	TTree *fBkgGeantTK; // pointer to tree TK
	118	TClonesArray *fBkgGeantParticles; // pointer to list of particles in tree TK
	119	TTree *fBkgGeantTH; // pointer to tree TH
	120	TClonesArray *fBkgGeantHits; // pointer to list of hits in tree TH
	121	Int_t fBkgGeantEventNumber; // event number
	122
	123	// Hits for reconstruction (should be in AliMUON ????)
	124	TClonesArray *fHitsForRecPtr; // pointer to the array of hits for reconstruction
	125	Int_t fNHitsForRec; // number of hits for reconstruction
	126	// Information per chamber (should be in AliMUONChamber ????)
9cbdf048	127	Int_t fNHitsForRecPerChamber[kMaxMuonTrackingChambers]; // number of HitsForRec
9cbdf048	128	Int_t fIndexOfFirstHitForRecPerChamber[kMaxMuonTrackingChambers]; // index (0...) of first HitForRec
a9e2aefa	129
a9e2aefa	130	// Segments inside a station
9cbdf048	131	TClonesArray *fSegmentsPtr[kMaxMuonTrackingStations]; // array of pointers to the segments for each station
9cbdf048	132	Int_t fNSegments[kMaxMuonTrackingStations]; // number of segments for each station
a9e2aefa	133
8429a5e4	134	// Reconstructed tracks
a9e2aefa	135	TClonesArray *fRecTracksPtr; // pointer to array of reconstructed tracks
	136	Int_t fNRecTracks; // number of reconstructed tracks
	137
8429a5e4	138	// Track hits on reconstructed tracks
	139	TClonesArray *fRecTrackHitsPtr; // pointer to array of hits on reconstructed tracks
	140	Int_t fNRecTrackHits; // number of hits on reconstructed tracks
	141
c7ba256d	142	// Objects needed for tree writing
	143	AliMUONRecoEvent *fRecoEvent; // the reconstructed event
	144	TTree *fEventTree; // tree of reconstructed events
	145	TFile *fTreeFile; // file where the tree is outputed
	146
a9e2aefa	147	// Functions
	148	void ResetHitsForRec(void);
	149	void MakeEventToBeReconstructed(void);
	150	void AddHitsForRecFromGEANT(TTree *TH);
	151	void AddHitsForRecFromBkgGEANT(TTree TH, TClonesArray Hits);
	152	AliMUONHitForRec* NewHitForRecFromGEANT(AliMUONHit* Hit, Int_t TrackNumber, Int_t HitNumber, Int_t Signal);
	153	/* void AddHitsForRecFromCathodeCorrelations(TTree* TC); */
	154	void AddHitsForRecFromRawClusters(TTree* TR);
	155	void SortHitsForRecWithIncreasingChamber();
	156	void MakeSegments(void);
	157	void ResetSegments(void);
	158	void MakeSegmentsPerStation(Int_t Station);
	159	void MakeTracks(void);
8429a5e4	160	void ResetTrackHits(void);
a9e2aefa	161	void ResetTracks(void);
	162	Int_t MakeTrackCandidatesWithTwoSegments(AliMUONSegment *BegSegment);
	163	Int_t MakeTrackCandidatesWithOneSegmentAndOnePoint(AliMUONSegment *BegSegment);
	164	void MakeTrackCandidates(void);
	165	void FollowTracks(void);
8429a5e4	166	void RemoveDoubleTracks(void);
a9e2aefa	167
ecfa008b	168	ClassDef(AliMUONEventReconstructor, 0) // MUON event reconstructor in ALICE
a9e2aefa	169	};
	170
	171	#endif