1 /**************************************************************************
2 * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
4 * Author: The ALICE Off-line Project. *
5 * Contributors are mentioned in the code where appropriate. *
7 * Permission to use, copy, modify and distribute this software and its *
8 * documentation strictly for non-commercial purposes is hereby granted *
9 * without fee, provided that the above copyright notice appears in all *
10 * copies and that both the copyright notice and this permission notice *
11 * appear in the supporting documentation. The authors make no claims *
12 * about the suitability of this software for any purpose. It is *
13 * provided "as is" without express or implied warranty. *
14 **************************************************************************/
16 ///////////////////////////////////////////////////////////////////////////////
18 // This is the base class for reading raw data and providing
19 // information about digits
21 // The derived classes, which operate on concrete raw data formats,
23 // - ReadHeader to read the next (mini or equipment) header
24 // - ReadNextData to read the next raw data block (=1 DDL)
25 // - ReadNext to read a given number of bytes
26 // - several getters like GetType
28 // Sequential access to the raw data is provided by the methods
29 // ReadHeader, ReadNextData, ReadNextInt, ReadNextShort, ReadNextChar
31 // If only data from a specific detector (and a given range of DDL numbers)
32 // should be read, this can be achieved by the Select method.
33 // Several getter provide information about the current event and the
34 // current type of raw data.
36 ///////////////////////////////////////////////////////////////////////////////
38 #include "AliRawReader.h"
41 ClassImp(AliRawReader)
44 AliRawReader::AliRawReader() :
47 fSelectDetectorID(-1),
52 // default constructor: initialize data members
56 AliRawReader::AliRawReader(const AliRawReader& rawReader) :
58 fMiniHeader(rawReader.fMiniHeader),
59 fCount(rawReader.fCount),
60 fSelectDetectorID(rawReader.fSelectDetectorID),
61 fSelectMinDDLID(rawReader.fSelectMinDDLID),
62 fSelectMaxDDLID(rawReader.fSelectMaxDDLID),
69 AliRawReader& AliRawReader::operator = (const AliRawReader& rawReader)
71 // assignment operator
73 fMiniHeader = rawReader.fMiniHeader;
74 fCount = rawReader.fCount;
76 fSelectDetectorID = rawReader.fSelectDetectorID;
77 fSelectMinDDLID = rawReader.fSelectMinDDLID;
78 fSelectMaxDDLID = rawReader.fSelectMaxDDLID;
80 fErrorCode = rawReader.fErrorCode;
86 void AliRawReader::Select(Int_t detectorID, Int_t minDDLID, Int_t maxDDLID)
88 // read only data of the detector with the given ID and in the given
89 // range of DDLs (minDDLID <= DDLID < maxDDLID).
90 // no selection is applied if a value < 0 is used.
92 fSelectDetectorID = detectorID;
93 fSelectMinDDLID = minDDLID;
94 fSelectMaxDDLID = maxDDLID;
97 Bool_t AliRawReader::IsSelected() const
99 // apply the selection (if any)
101 if (fSelectDetectorID >= 0) {
102 if (!fMiniHeader) return kFALSE;
103 if (fMiniHeader->fDetectorID != fSelectDetectorID) return kFALSE;
104 if ((fSelectMinDDLID >= 0) && (fMiniHeader->fDDLID < fSelectMinDDLID))
106 if ((fSelectMaxDDLID >= 0) && (fMiniHeader->fDDLID >= fSelectMaxDDLID))
113 Bool_t AliRawReader::CheckMiniHeader(AliMiniHeader* miniHeader) const
115 // check the magic number of the mini header
117 if (!miniHeader) miniHeader = fMiniHeader;
118 if (!miniHeader) return kFALSE;
119 UInt_t magicWord = miniHeader->fMagicWord[2]*65536 +
120 miniHeader->fMagicWord[1]*256 + miniHeader->fMagicWord[0];
121 if (magicWord != AliMiniHeader::kMagicWord) {
127 Bool_t AliRawReader::ReadNextInt(UInt_t& data)
129 // reads the next 4 bytes at the current position
130 // returns kFALSE if the data could not be read
132 while (fCount == 0) {
133 if (!ReadHeader()) return kFALSE;
135 if (fCount < (Int_t) sizeof(data)) {
137 "too few data left (%d bytes) to read an UInt_t!", fCount);
140 if (!ReadNext((UChar_t*) &data, sizeof(data))) {
141 Error("ReadNextInt", "could not read data!");
147 Bool_t AliRawReader::ReadNextShort(UShort_t& data)
149 // reads the next 2 bytes at the current position
150 // returns kFALSE if the data could not be read
152 while (fCount == 0) {
153 if (!ReadHeader()) return kFALSE;
155 if (fCount < (Int_t) sizeof(data)) {
156 Error("ReadNextShort",
157 "too few data left (%d bytes) to read an UShort_t!", fCount);
160 if (!ReadNext((UChar_t*) &data, sizeof(data))) {
161 Error("ReadNextShort", "could not read data!");
167 Bool_t AliRawReader::ReadNextChar(UChar_t& data)
169 // reads the next 1 byte at the current stream position
170 // returns kFALSE if the data could not be read
172 while (fCount == 0) {
173 if (!ReadHeader()) return kFALSE;
175 if (!ReadNext((UChar_t*) &data, sizeof(data))) {
176 Error("ReadNextChar", "could not read data!");
183 Int_t AliRawReader::CheckData() const
185 // check the consistency of the data
186 // derived classes should overwrite the default method which returns 0 (no err)
192 void AliRawReader::DumpData(Int_t limit)
194 // print the raw data
195 // if limit is not negative, only the first and last "limit" lines of raw data
200 Error("DumpData", "no header");
204 " type = %d run = %d ", GetType(), GetRunNumber());
206 printf("event = %8.8x %8.8x\n", GetEventId()[1], GetEventId()[0]);
208 printf("event = -------- --------\n");
210 if (GetTriggerPattern()) {
211 printf(" trigger = %8.8x %8.8x ",
212 GetTriggerPattern()[1], GetTriggerPattern()[0]);
214 printf(" trigger = -------- -------- ");
216 if (GetDetectorPattern()) {
217 printf("detector = %8.8x\n", GetDetectorPattern()[0]);
219 printf("detector = --------\n");
221 if (GetAttributes()) {
222 printf(" attributes = %8.8x %8.8x %8.8x ",
223 GetAttributes()[2], GetAttributes()[1], GetAttributes()[0]);
225 printf(" attributes = -------- -------- -------- ");
227 printf("GDC = %d\n", GetGDCId());
231 printf("-------------------------------------------------------------------------------\n");
232 printf("LDC = %d\n", GetLDCId());
234 printf("equipment:\n"
235 " size = %d type = %d id = %d\n",
236 GetEquipmentSize(), GetEquipmentType(), GetEquipmentId());
237 if (GetEquipmentAttributes()) {
238 printf(" attributes = %8.8x %8.8x %8.8x ", GetEquipmentAttributes()[2],
239 GetEquipmentAttributes()[1], GetEquipmentAttributes()[0]);
241 printf(" attributes = -------- -------- -------- ");
243 printf("element size = %d\n", GetEquipmentElementSize());
245 printf("mini header:\n"
246 " size = %d detector = %d DDL = %d\n"
247 " version = %d compression = %d\n",
248 GetDataSize(), GetDetectorID(), GetDDLID(),
249 GetVersion(), IsCompressed());
252 if (limit == 0) continue;
254 Int_t size = GetDataSize();
256 for (Int_t i = 0; i < 70; i++) line[i] = ' ';
262 for (Int_t n = 0; n < size; n++) {
263 if (!ReadNextChar(byte)) {
264 Error("DumpData", "couldn't read byte number %d\n", n);
268 printf("%8.8x %s\n", n-pos, line);
269 for (Int_t i = 0; i < 70; i++) line[i] = ' ';
272 if ((limit > 0) && (n/max == limit)) {
273 Int_t nContinue = ((size-1)/max+1-limit) * max;
275 printf(" [skipping %d bytes]\n", nContinue-n);
281 Int_t offset = pos/4;
282 if ((byte > 0x20) && (byte < 0x7f)) {
283 line[pos+offset] = byte;
285 line[pos+offset] = '.';
288 sprintf(hex, "%2.2x", byte);
289 line[max+max/4+3+2*pos+offset] = hex[0];
290 line[max+max/4+4+2*pos+offset] = hex[1];
294 if (pos > 0) printf("%8.8x %s\n", size-pos, line);
297 } while (ReadHeader());