[u/mrichter/AliRoot.git] / TPC / AliTPCmapper.h

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

////////////////////////////////////////////////////////////////////////
//
// AliTPCmapper class
// Class for all mapping functions (hardware coordinates <-> pad coordinates)
// Author: Christian Lippmann
//       
/////////////////////////////////////////////////////////////////////////

#include <TObject.h>

class AliTPCAltroMapping;

class AliTPCmapper : public TObject{

public:

  AliTPCmapper(const char * dirname=0);
  virtual ~AliTPCmapper();

  AliTPCmapper& operator = (const AliTPCmapper& mapper);
  AliTPCmapper(const AliTPCmapper& mapper);

  void Init(const char * dirname);
  //
  AliTPCAltroMapping **GetAltroMapping() { return fMapping; };

  // ALTRO mapping functions
  Int_t GetPad(Int_t patch, Int_t hwAddress) const;
  Int_t GetPad(Int_t patch, Int_t branch, Int_t fec, Int_t chip, Int_t channel) const;
  Int_t GetPadRow(Int_t patch, Int_t hwAddress) const;
  Int_t GetPadRow(Int_t patch, Int_t branch, Int_t fec, Int_t chip, Int_t channel) const;

  // ALTRO mapping functions on roc level (padrow = 0 ... kNpadrowIROC, kNpadrowOROC)
  Int_t GetHWAddress(Int_t roc, Int_t padrow, Int_t pad) const;
  Int_t GetRcu(Int_t roc, Int_t padrow, Int_t pad) const;
  Int_t GetPatch(Int_t roc, Int_t padrow, Int_t pad) const;
  Int_t GetBranch(Int_t roc, Int_t padrow, Int_t pad) const;
  Int_t GetFEChw(Int_t roc, Int_t padrow, Int_t pad) const;
  Int_t GetFEC(Int_t roc, Int_t padrow, Int_t pad) const;
  Int_t GetChip(Int_t roc, Int_t padrow, Int_t pad) const;
  Int_t GetChannel(Int_t roc, Int_t padrow, Int_t pad) const;

  // ALTRO mapping functions on sector level (globalpadrow = 0 ... kNpadrow)
  Int_t GetGlobalPadRow(Int_t patch, Int_t hwAddress) const;
  Int_t GetGlobalPadRow(Int_t patch, Int_t branch, Int_t fec, Int_t chip, Int_t channel) const;
  Int_t GetHWAddressSector(Int_t globalpadrow, Int_t pad) const;
  Int_t GetRcuSector(Int_t globalpadrow, Int_t pad) const;
  Int_t GetPatchSector(Int_t globalpadrow, Int_t pad) const;
  Int_t GetBranchSector(Int_t globalpadrow, Int_t pad) const;
  Int_t GetFEChwSector(Int_t globalpadrow, Int_t pad) const;
  Int_t GetFECSector(Int_t globalpadrow, Int_t pad) const;
  Int_t GetChipSector(Int_t globalpadrow, Int_t pad) const;
  Int_t GetChannelSector(Int_t globalpadrow, Int_t pad) const;

  // Coding and decoding of hardware addresses
  Int_t CodeHWAddress(Int_t branch,  Int_t fec,  Int_t chip, Int_t channel) const;
  Int_t DecodedHWAddressBranch(Int_t hwAddress) const;
  Int_t DecodedHWAddressFECaddr(Int_t hwAddress) const;
  Int_t DecodedHWAddressChipaddr(Int_t hwAddress) const;
  Int_t DecodedHWAddressChanneladdr(Int_t hwAddress) const;

  // Pad Geometry on sector level (padrow = 0 ... kNpadrow)
  Int_t    GetNpads(Int_t roc, Int_t padrow) const;
  Int_t    GetNpads(Int_t globalpadrow) const;
  Int_t    GetNpadrows(Int_t roc) const;
  /*
  Double_t GetPadXlocal(Int_t globalpadrow) const;
  Double_t GetPadYlocal(Int_t globalpadrow, Int_t pad) const;
  Double_t GetPadXglobal(Int_t globalpadrow, Int_t pad, Int_t sector) const;
  Double_t GetPadYglobal(Int_t globalpadrow, Int_t pad, Int_t sector) const;
  Double_t GetPadWidth(Int_t globalpadrow) const;
  Double_t GetPadLength(Int_t globalpadrow) const;
  */

  // Conversion between hardware FEC numbering and official numbering
  Int_t HwToOffline(Int_t patch, Int_t branch, Int_t fec) const;
  Int_t OfflineToHwBranch(Int_t patch, Int_t fec) const;
  Int_t OfflineToHwFec(Int_t patch, Int_t fec) const;

  // More mapping functions
  Int_t GetEquipmentID(Int_t roc, Int_t padrow, Int_t pad) const;
  Int_t GetEquipmentIDsector(Int_t side, Int_t sector, Int_t globalpadrow, Int_t pad) const;
  Int_t GetEquipmentIDfromPatch(Int_t side, Int_t sector, Int_t patch) const;
  Int_t GetSectorFromRoc(Int_t roc) const;
  Int_t GetSideFromRoc(Int_t roc) const;
  Int_t GetRocFromPatch(Int_t side, Int_t sector, Int_t patch) const;
  Int_t GetRoc(Int_t side, Int_t sector, Int_t globalpadrow, Int_t pad) const;
  Int_t GetSideFromEquipmentID(Int_t equipmentID) const;
  Int_t GetSectorFromEquipmentID(Int_t equipmentID) const;
  Int_t GetRocFromEquipmentID(Int_t equipmentID) const;
  Int_t GetPatchFromEquipmentID(Int_t equipmentID) const;

  // Even more
  Int_t  GetNfec(Int_t patch, Int_t branch) const;
  Int_t  GetNfec(Int_t patch) const;
  Bool_t IsIROC(Int_t roc) const;
  Bool_t IsOROC(Int_t roc) const;

 private:

  Int_t fNside;        // TPC has 2 sides
  Int_t fNsector;      // TPC side has 18 sectors
  Int_t fNrcu;         // Sector has 6 RCUs (patches)
  Int_t fNbranch;      // RCU has 2 branches
  Int_t fNaltro;       // FEC has 8 ALTROs
  Int_t fNchannel;     // ALTRO has 16 channels
  Int_t fNpadrow;      // Sector has 159 padrows
  Int_t fNpadrowIROC;  // IROC has 63 padrows
  Int_t fNpadrowOROC;  // OROC has 96 padrows

  Int_t fTpcDdlOffset; // DDL offset for TPC

  AliTPCAltroMapping *fMapping[6];    // The ALTRO mapping for each patch (rcu)

  ClassDef(AliTPCmapper,2)

};

#endif
Commit	Line	Data
bb18c002	1	#ifndef AliTPCmapper_H
	2	#define AliTPCmapper_H
	3	/* Copyright(c) 1998-2006, ALICE Experiment at CERN, All rights reserved. *
	4	* See cxx source for full Copyright notice */
	5
bdf99a93	6	////////////////////////////////////////////////////////////////////////
	7	//
	8	// AliTPCmapper class
	9	// Class for all mapping functions (hardware coordinates <-> pad coordinates)
	10	// Author: Christian Lippmann
	11	//
	12	/////////////////////////////////////////////////////////////////////////
	13
0e75e410	14	#include <TObject.h>
bb18c002	15
accfa4d9	16	class AliTPCAltroMapping;
bb18c002	17
accfa4d9	18	class AliTPCmapper : public TObject{
bb18c002	19
	20	public:
	21
0e46ed2e	22	AliTPCmapper(const char * dirname=0);
accfa4d9	23	virtual ~AliTPCmapper();
	24
	25	AliTPCmapper& operator = (const AliTPCmapper& mapper);
	26	AliTPCmapper(const AliTPCmapper& mapper);
	27
0e46ed2e	28	void Init(const char * dirname);
0e46ed2e	29	//
fee88714	30	AliTPCAltroMapping **GetAltroMapping() { return fMapping; };
accfa4d9	31
	32	// ALTRO mapping functions
	33	Int_t GetPad(Int_t patch, Int_t hwAddress) const;
	34	Int_t GetPad(Int_t patch, Int_t branch, Int_t fec, Int_t chip, Int_t channel) const;
bdf99a93	35	Int_t GetPadRow(Int_t patch, Int_t hwAddress) const;
bdf99a93	36	Int_t GetPadRow(Int_t patch, Int_t branch, Int_t fec, Int_t chip, Int_t channel) const;
accfa4d9	37
	38	// ALTRO mapping functions on roc level (padrow = 0 ... kNpadrowIROC, kNpadrowOROC)
	39	Int_t GetHWAddress(Int_t roc, Int_t padrow, Int_t pad) const;
	40	Int_t GetRcu(Int_t roc, Int_t padrow, Int_t pad) const;
	41	Int_t GetPatch(Int_t roc, Int_t padrow, Int_t pad) const;
accfa4d9	42	Int_t GetBranch(Int_t roc, Int_t padrow, Int_t pad) const;
	43	Int_t GetFEChw(Int_t roc, Int_t padrow, Int_t pad) const;
	44	Int_t GetFEC(Int_t roc, Int_t padrow, Int_t pad) const;
	45	Int_t GetChip(Int_t roc, Int_t padrow, Int_t pad) const;
	46	Int_t GetChannel(Int_t roc, Int_t padrow, Int_t pad) const;
	47
bdf99a93	48	// ALTRO mapping functions on sector level (globalpadrow = 0 ... kNpadrow)
	49	Int_t GetGlobalPadRow(Int_t patch, Int_t hwAddress) const;
	50	Int_t GetGlobalPadRow(Int_t patch, Int_t branch, Int_t fec, Int_t chip, Int_t channel) const;
	51	Int_t GetHWAddressSector(Int_t globalpadrow, Int_t pad) const;
	52	Int_t GetRcuSector(Int_t globalpadrow, Int_t pad) const;
	53	Int_t GetPatchSector(Int_t globalpadrow, Int_t pad) const;
	54	Int_t GetBranchSector(Int_t globalpadrow, Int_t pad) const;
	55	Int_t GetFEChwSector(Int_t globalpadrow, Int_t pad) const;
	56	Int_t GetFECSector(Int_t globalpadrow, Int_t pad) const;
	57	Int_t GetChipSector(Int_t globalpadrow, Int_t pad) const;
	58	Int_t GetChannelSector(Int_t globalpadrow, Int_t pad) const;
accfa4d9	59
	60	// Coding and decoding of hardware addresses
	61	Int_t CodeHWAddress(Int_t branch, Int_t fec, Int_t chip, Int_t channel) const;
	62	Int_t DecodedHWAddressBranch(Int_t hwAddress) const;
	63	Int_t DecodedHWAddressFECaddr(Int_t hwAddress) const;
	64	Int_t DecodedHWAddressChipaddr(Int_t hwAddress) const;
	65	Int_t DecodedHWAddressChanneladdr(Int_t hwAddress) const;
	66
	67	// Pad Geometry on sector level (padrow = 0 ... kNpadrow)
	68	Int_t GetNpads(Int_t roc, Int_t padrow) const;
bdf99a93	69	Int_t GetNpads(Int_t globalpadrow) const;
accfa4d9	70	Int_t GetNpadrows(Int_t roc) const;
accfa4d9	71	/*
bdf99a93	72	Double_t GetPadXlocal(Int_t globalpadrow) const;
	73	Double_t GetPadYlocal(Int_t globalpadrow, Int_t pad) const;
	74	Double_t GetPadXglobal(Int_t globalpadrow, Int_t pad, Int_t sector) const;
	75	Double_t GetPadYglobal(Int_t globalpadrow, Int_t pad, Int_t sector) const;
	76	Double_t GetPadWidth(Int_t globalpadrow) const;
	77	Double_t GetPadLength(Int_t globalpadrow) const;
accfa4d9	78	*/
	79
	80	// Conversion between hardware FEC numbering and official numbering
	81	Int_t HwToOffline(Int_t patch, Int_t branch, Int_t fec) const;
	82	Int_t OfflineToHwBranch(Int_t patch, Int_t fec) const;
	83	Int_t OfflineToHwFec(Int_t patch, Int_t fec) const;
	84
	85	// More mapping functions
	86	Int_t GetEquipmentID(Int_t roc, Int_t padrow, Int_t pad) const;
bdf99a93	87	Int_t GetEquipmentIDsector(Int_t side, Int_t sector, Int_t globalpadrow, Int_t pad) const;
accfa4d9	88	Int_t GetEquipmentIDfromPatch(Int_t side, Int_t sector, Int_t patch) const;
	89	Int_t GetSectorFromRoc(Int_t roc) const;
	90	Int_t GetSideFromRoc(Int_t roc) const;
	91	Int_t GetRocFromPatch(Int_t side, Int_t sector, Int_t patch) const;
bdf99a93	92	Int_t GetRoc(Int_t side, Int_t sector, Int_t globalpadrow, Int_t pad) const;
accfa4d9	93	Int_t GetSideFromEquipmentID(Int_t equipmentID) const;
	94	Int_t GetSectorFromEquipmentID(Int_t equipmentID) const;
	95	Int_t GetRocFromEquipmentID(Int_t equipmentID) const;
	96	Int_t GetPatchFromEquipmentID(Int_t equipmentID) const;
	97
	98	// Even more
	99	Int_t GetNfec(Int_t patch, Int_t branch) const;
	100	Int_t GetNfec(Int_t patch) const;
	101	Bool_t IsIROC(Int_t roc) const;
	102	Bool_t IsOROC(Int_t roc) const;
	103
	104	private:
	105
bdf99a93	106	Int_t fNside; // TPC has 2 sides
fee88714	107	Int_t fNsector; // TPC side has 18 sectors
fee88714	108	Int_t fNrcu; // Sector has 6 RCUs (patches)
bdf99a93	109	Int_t fNbranch; // RCU has 2 branches
	110	Int_t fNaltro; // FEC has 8 ALTROs
	111	Int_t fNchannel; // ALTRO has 16 channels
	112	Int_t fNpadrow; // Sector has 159 padrows
	113	Int_t fNpadrowIROC; // IROC has 63 padrows
	114	Int_t fNpadrowOROC; // OROC has 96 padrows
	115
	116	Int_t fTpcDdlOffset; // DDL offset for TPC
accfa4d9	117
accfa4d9	118	AliTPCAltroMapping *fMapping[6]; // The ALTRO mapping for each patch (rcu)
accfa4d9	119
fee88714	120	ClassDef(AliTPCmapper,2)
bb18c002	121
bb18c002	122	};
	123
	124	#endif