HLT/TPCLib/AliHLTTPCDefinitions.h

   1 // XEmacs -*-C++-*-
   2 // @(#) $Id$
   3
   4 #ifndef ALIHLTTPCDEFINITIONS_H
   5 #define ALIHLTTPCDEFINITIONS_H
   6 //* This file is property of and copyright by the ALICE HLT Project        *
   7 //* ALICE Experiment at CERN, All rights reserved.                         *
   8 //* See cxx source for full Copyright notice                               *
   9
  10 #include "AliHLTDataTypes.h"
  11 #include "Rtypes.h"
  12
  13 /**
  14  * @class AliHLTTPCDefinitions
  15  * Data type definitions for the libAliHLTTPC library.
  16  *
  17  * @ingroup alihlt_tpc
  18  */
  19 class AliHLTTPCDefinitions
  20 {
  21 public:
  22
  23         static AliHLTUInt8_t GetMinSliceNr( const AliHLTComponentBlockData& block )
  24                 {
  25                 return (AliHLTUInt8_t)( (block.fSpecification & 0x00FF0000) >> 16 );
  26                 }
  27         static AliHLTUInt8_t GetMinSliceNr( ULong_t spec )
  28                 {
  29                 return (AliHLTUInt8_t)( (spec & 0x00FF0000) >> 16 );
  30                 }
  31         static AliHLTUInt8_t GetMaxSliceNr( const AliHLTComponentBlockData& block )
  32                 {
  33                 return (AliHLTUInt8_t)( (block.fSpecification & 0xFF000000) >> 24 );
  34                 }
  35         static AliHLTUInt8_t GetMaxSliceNr( ULong_t spec )
  36                 {
  37                 return (AliHLTUInt8_t)( (spec & 0xFF000000) >> 24 );
  38                 }
  39         static Int_t GetSingleSliceNr( const AliHLTComponentBlockData& block )
  40                 {
  41                 return GetSingleSliceNr(block.fSpecification);
  42                 }
  43         static Int_t GetSingleSliceNr( ULong_t spec );
  44         static AliHLTUInt8_t GetMinPatchNr( const AliHLTComponentBlockData& block )
  45                 {
  46                 return (AliHLTUInt8_t)( (block.fSpecification & 0x000000FF) );
  47                 }
  48         static AliHLTUInt8_t GetMinPatchNr( ULong_t spec )
  49                 {
  50                 return (AliHLTUInt8_t)( (spec & 0x000000FF) );
  51                 }
  52         static AliHLTUInt8_t GetMaxPatchNr( const AliHLTComponentBlockData& block )
  53                 {
  54                 return (AliHLTUInt8_t)( (block.fSpecification & 0x0000FF00) >> 8 );
  55                 }
  56         static AliHLTUInt8_t GetMaxPatchNr( ULong_t spec )
  57                 {
  58                 return (AliHLTUInt8_t)( (spec & 0x0000FF00) >> 8 );
  59                 }
  60         static Int_t GetSinglePatchNr( const AliHLTComponentBlockData& block )
  61                 {
  62                 return GetSinglePatchNr(block.fSpecification);
  63                 }
  64         static Int_t GetSinglePatchNr( ULong_t spec );
  65         static AliHLTUInt32_t EncodeDataSpecification( AliHLTUInt8_t minSliceNr,
  66                                                 AliHLTUInt8_t maxSliceNr,
  67                                                 AliHLTUInt8_t minPatchNr,
  68                                                 AliHLTUInt8_t maxPatchNr )
  69                 {
  70                 return ((maxSliceNr & 0xFF) << 24) | ((minSliceNr & 0xFF) << 16) | ((maxPatchNr & 0xFF) << 8) | ((minPatchNr & 0xFF));
  71                 }
  72
  73         /**
  74          * Converts a slice and patch number to a DDL ID number for TPC.
  75          * \param slice  The slice number in the range [0..35] (0..17 for A side and 18..35 for C side).
  76          * \param patch  The patch number in the range [0..5].
  77          * \returns the DDL ID number of TPC or -1 if the slice or patch was invalid.
  78          * \note A side is in the -z axis direction (same side as the muon spectrometer)
  79          *       and C side is in the +z axis direction.
  80          */
  81         static AliHLTInt32_t SlicePatchToDDLId(AliHLTUInt8_t slice, AliHLTUInt8_t patch)
  82                 {
  83                 if (slice > 35 or patch > 5) return -1;
  84                 return 768 + (patch > 1 ? 72 + 4*slice + patch - 2 : 2*slice + patch);
  85                 }
  86
  87         /**
  88          * Converts a DDL ID number for the TPC to a slice and patch number.
  89          * \param [in] ddlid  The DDL ID number to convert.
  90          * \param [out] slice  The resultant slice number in the range [0..35].
  91          * \param [out] patch  The resultant patch number in the range [0..5].
  92          * \returns true if the DDL ID number was valid and slice and patch were set,
  93          *     otherwise false for an invalid DDL ID.
  94          */
  95         static bool DDLIdToSlicePatch(AliHLTInt32_t ddlid, AliHLTUInt8_t& slice, AliHLTUInt8_t& patch);
  96
  97   /** DDL entropy encoded data */
  98   static const AliHLTComponentDataType fgkDDLEncodedEntropyRawDataType; // see above
  99   static const AliHLTComponentDataType& DDLEncodedEntropyRawDataType();
 100   /** packed RAW data */
 101   static const AliHLTComponentDataType fgkPackedRawDataType;            // see above
 102   static const AliHLTComponentDataType& PackedRawDataType();
 103   /** unpacked RAW data */
 104   static const AliHLTComponentDataType fgkUnpackedRawDataType;          // see above
 105   static const AliHLTComponentDataType& UnpackedRawDataType();
 106   /** cluster data */
 107   static const AliHLTComponentDataType fgkClustersDataType;             // see above
 108   static const AliHLTComponentDataType& ClustersDataType();
 109   /** raw cluster data (not transformed) */
 110   static const AliHLTComponentDataType fgkRawClustersDataType;          // see above
 111   static const AliHLTComponentDataType& RawClustersDataType();
 112   /** HW cluster data */
 113   static const AliHLTComponentDataType fgkHWClustersDataType;           // see above
 114   static const AliHLTComponentDataType& HWClustersDataType();
 115   /** HW alternative output cluster data */
 116   static const AliHLTComponentDataType fgkAlterClustersDataType;        // see above
 117   static const AliHLTComponentDataType& AlterClustersDataType();
 118   /** track segments in local coordinates */
 119   static const AliHLTComponentDataType fgkTrackSegmentsDataType;        // see above
 120   static const AliHLTComponentDataType& TrackSegmentsDataType();
 121   /** tracks in global koordinates */
 122   static const AliHLTComponentDataType fgkTracksDataType;               // see above
 123   static const AliHLTComponentDataType& TracksDataType();
 124   /** vertex data structure */
 125   static const AliHLTComponentDataType fgkVertexDataType;               // see above
 126   static const AliHLTComponentDataType& VertexDataType();
 127
 128   // Cluster & Tracks model data
 129   /** data compression descriptor*/
 130   static const AliHLTComponentDataType fgkDataCompressionDescriptorDataType;          // see above
 131   static const AliHLTComponentDataType& DataCompressionDescriptorDataType();
 132   /** cluster tracks model data type */
 133   static const AliHLTComponentDataType fgkClusterTracksModelDataType;          // see above
 134   static const AliHLTComponentDataType& ClusterTracksModelDataType();
 135   /** remaining clusters model data type */
 136   static const AliHLTComponentDataType fgkRemainingClustersModelDataType;      // see above
 137   static const AliHLTComponentDataType& RemainingClustersModelDataType();
 138   /** track clusters compressed data type */
 139   static const AliHLTComponentDataType fgkClusterTracksCompressedDataType;     // see above
 140   static const AliHLTComponentDataType& ClusterTracksCompressedDataType();
 141   /** track cluster ids data type */
 142   static const AliHLTComponentDataType& ClusterIdTracksDataType();
 143   /** compressed cluster ids data type */
 144   static const AliHLTComponentDataType& CompressedClusterIdDataType();
 145   /** remaining clusters compressed data type */
 146   static const AliHLTComponentDataType fgkRemainingClustersCompressedDataType; // see above
 147   static const AliHLTComponentDataType& RemainingClustersCompressedDataType();
 148   /** remaining clusters ids data type */
 149   static const AliHLTComponentDataType& RemainingClusterIdsDataType();
 150
 151   // Calibration data
 152   /** pedestal calibration data */
 153   static const AliHLTComponentDataType& CalibPedestalDataType();
 154   /** signal calibration data */
 155   static const AliHLTComponentDataType& CalibPulserDataType();
 156   /** central electrode calibration data */
 157   static const AliHLTComponentDataType& CalibCEDataType();
 158
 159   // offline calbration components
 160
 161   /** alignment calibration data */
 162   static const AliHLTComponentDataType& OfflineCalibAlignDataType();
 163   /** track calibration data */
 164   static const AliHLTComponentDataType& OfflineCalibTracksDataType();
 165   /** gain calibration data */
 166   static const AliHLTComponentDataType& OfflineCalibTracksGainDataType();
 167   /** cluster monte carlo information */
 168   static const AliHLTComponentDataType fgkAliHLTDataTypeClusterMCInfo;    // see above
 169   static const AliHLTComponentDataType& AliHLTDataTypeClusterMCInfo();
 170
 171   // ids for the different parameters of a cluster
 172   enum AliClusterParameterId_t {
 173     kPadRow = 0,
 174     kPad,
 175     kTime,
 176     kSigmaY2,
 177     kSigmaZ2,
 178     kCharge,
 179     kQMax,
 180     kResidualPad,
 181     kResidualTime,
 182     kClusterCount,
 183     kLast = kQMax
 184   };
 185
 186   // helper struct for the definition of cluster parameters
 187   struct AliClusterParameter {
 188     AliClusterParameterId_t fId; //! id of the parameter
 189     const char* fName;           //! name of the parameter
 190     int fBitLength;              //! bit length
 191     int fOptional;               //! optional parameter
 192     int fScale;                  //! scale for conversion to int number
 193   };
 194
 195   static const AliClusterParameter fgkClusterParameterDefinitions[];
 196   static unsigned GetNumberOfClusterParameterDefinitions();
 197   static const unsigned fgkMaxClusterDeltaPad;
 198   static unsigned GetMaxClusterDeltaPad() {return fgkMaxClusterDeltaPad;}
 199   static const unsigned fgkMaxClusterDeltaTime;
 200   static unsigned GetMaxClusterDeltaTime() {return fgkMaxClusterDeltaTime;}
 201
 202 private:
 203
 204   /// Do not allow creation of this class since everything is static.
 205   AliHLTTPCDefinitions();
 206   virtual ~AliHLTTPCDefinitions();
 207
 208   ClassDef(AliHLTTPCDefinitions, 0)  // Useful static definitions and methods for TPC
 209 };
 210
 211 #endif