[u/mrichter/AliRoot.git] / RAW / AliRawReaderRoot.cxx

/**************************************************************************
 * Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
 *                                                                        *
 * Author: The ALICE Off-line Project.                                    *
 * Contributors are mentioned in the code where appropriate.              *
 *                                                                        *
 * Permission to use, copy, modify and distribute this software and its   *
 * documentation strictly for non-commercial purposes is hereby granted   *
 * without fee, provided that the above copyright notice appears in all   *
 * copies and that both the copyright notice and this permission notice   *
 * appear in the supporting documentation. The authors make no claims     *
 * about the suitability of this software for any purpose. It is          *
 * provided "as is" without express or implied warranty.                  *
 **************************************************************************/

/* $Id$ */

///////////////////////////////////////////////////////////////////////////////
///
/// This is a class for reading raw data from a root file.
///
/// The root file is expected to contain a tree of name "RAW" with
/// a branch of name "rawevent" which contains objects of type
/// AliRawEvent.
/// 
/// The file name and the event number are arguments of the constructor
/// of AliRawReaderRoot.
///
///////////////////////////////////////////////////////////////////////////////

#include <TFile.h>
#include <TTree.h>
#include "AliRawReaderRoot.h"
#include "AliRawEvent.h"
#include "AliRawEventHeaderBase.h"
#include "AliRawEquipment.h"
#include "AliRawEquipmentHeader.h"
#include "AliRawData.h"


ClassImp(AliRawReaderRoot)


AliRawReaderRoot::AliRawReaderRoot(const char* fileName, Int_t eventNumber) :
  fFile(NULL),
  fBranch(NULL),
  fEventIndex(eventNumber),
  fEvent(NULL),
  fSubEventIndex(0),
  fSubEvent(NULL),
  fEquipmentIndex(0),
  fEquipment(NULL),
  fRawData(NULL),
  fPosition(NULL),
  fEnd(NULL)
{
// create an object to read digits from the given input file for the
// event with the given number

  TDirectory* dir = gDirectory;
  fFile = TFile::Open(fileName);
  dir->cd();
  if (!fFile || !fFile->IsOpen()) {
    Error("AliRawReaderRoot", "could not open file %s", fileName);
    return;
  }
  TTree* tree = (TTree*) fFile->Get("RAW");
  if (!tree) {
    Error("AliRawReaderRoot", "no raw data tree found");
    return;
  }
  fBranch = tree->GetBranch("rawevent");
  if (!fBranch) {
    Error("AliRawReaderRoot", "no raw data branch found");
    return;
  }

  fEvent = new AliRawEvent;
  fBranch->SetAddress(&fEvent);
  if (fEventIndex >= 0) {
    if (fBranch->GetEntry(fEventIndex) <= 0) {
      Error("AliRawReaderRoot", "no event with number %d found", fEventIndex);
      return;
    }
  }
}

AliRawReaderRoot::AliRawReaderRoot(AliRawEvent* event) :
  fFile(NULL),
  fBranch(NULL),
  fEventIndex(-1),
  fEvent(event),
  fSubEventIndex(0),
  fSubEvent(NULL),
  fEquipmentIndex(0),
  fEquipment(NULL),
  fRawData(NULL),
  fPosition(NULL),
  fEnd(NULL)
{
// create an object to read digits from the given raw event

}

AliRawReaderRoot::AliRawReaderRoot(const AliRawReaderRoot& rawReader) :
  AliRawReader(rawReader),
  fFile(NULL),
  fBranch(NULL),
  fEventIndex(rawReader.fEventIndex),
  fEvent(NULL),
  fSubEventIndex(rawReader.fSubEventIndex),
  fSubEvent(NULL),
  fEquipmentIndex(rawReader.fEquipmentIndex),
  fEquipment(NULL),
  fRawData(NULL),
  fPosition(NULL),
  fEnd(NULL)
{
// copy constructor

  if (rawReader.fFile) {
    TDirectory* dir = gDirectory;
    fFile = TFile::Open(rawReader.fFile->GetName());
    dir->cd();
    if (!fFile || !fFile->IsOpen()) {
      Error("AliRawReaderRoot", "could not open file %s", 
	    rawReader.fFile->GetName());
      return;
    }
    TTree* tree = (TTree*) fFile->Get("RAW");
    if (!tree) {
      Error("AliRawReaderRoot", "no raw data tree found");
      return;
    }
    fBranch = tree->GetBranch("rawevent");
    if (!fBranch) {
      Error("AliRawReaderRoot", "no raw data branch found");
      return;
    }

    fEvent = new AliRawEvent;
    fBranch->SetAddress(&fEvent);
    if (fEventIndex >= 0) {
      if (fBranch->GetEntry(fEventIndex) <= 0) {
	Error("AliRawReaderRoot", "no event with number %d found", 
	      fEventIndex);
	return;
      }
    }
  } else {
    fEvent = rawReader.fEvent;
  }

  if (fSubEventIndex > 0) {
    fSubEvent = fEvent->GetSubEvent(fSubEventIndex-1);
    fEquipment = fSubEvent->GetEquipment(fEquipmentIndex);
    fRawData = fEquipment->GetRawData();
      fCount = 0;
    fHeader = (AliRawDataHeader*) ((UChar_t*) fRawData->GetBuffer() + 
      ((UChar_t*) rawReader.fHeader - 
       (UChar_t*) rawReader.fRawData->GetBuffer()));
    fPosition = (UChar_t*) fRawData->GetBuffer() + 
      (rawReader.fPosition - (UChar_t*) rawReader.fRawData->GetBuffer());
    fEnd = ((UChar_t*) fRawData->GetBuffer()) + fRawData->GetSize();
  }
}

AliRawReaderRoot& AliRawReaderRoot::operator = (const AliRawReaderRoot& 
						rawReader)
{
// assignment operator

  this->~AliRawReaderRoot();
  new(this) AliRawReaderRoot(rawReader);
  return *this;
}

AliRawReaderRoot::~AliRawReaderRoot()
{
// delete objects and close root file

  if (fFile) {
    if (fEvent) delete fEvent;
    fFile->Close();
    delete fFile;
  }
}


UInt_t AliRawReaderRoot::GetType() const
{
// get the type from the event header

  if (!fEvent) return 0;
  return fEvent->GetHeader()->Get("Type");
}

UInt_t AliRawReaderRoot::GetRunNumber() const
{
// get the run number from the event header

  if (!fEvent) return 0;
  return fEvent->GetHeader()->Get("RunNb");
}

const UInt_t* AliRawReaderRoot::GetEventId() const
{
// get the event id from the event header

  if (!fEvent) return NULL;
  return fEvent->GetHeader()->GetP("Id");
}

const UInt_t* AliRawReaderRoot::GetTriggerPattern() const
{
// get the trigger pattern from the event header

  if (!fEvent) return NULL;
  return fEvent->GetHeader()->GetP("TriggerPattern");
}

const UInt_t* AliRawReaderRoot::GetDetectorPattern() const
{
// get the detector pattern from the event header

  if (!fEvent) return NULL;
  return fEvent->GetHeader()->GetP("DetectorPattern");
}

const UInt_t* AliRawReaderRoot::GetAttributes() const
{
// get the type attributes from the event header

  if (!fEvent) return NULL;
  return fEvent->GetHeader()->GetP("TypeAttribute");
}

const UInt_t* AliRawReaderRoot::GetSubEventAttributes() const
{
// get the type attributes from the sub event header

  if (!fSubEvent) return NULL;
  return fSubEvent->GetHeader()->GetP("TypeAttribute");
}

UInt_t AliRawReaderRoot::GetLDCId() const
{
// get the LDC Id from the event header

  if (!fEvent || !fSubEvent) return 0;
  return fSubEvent->GetHeader()->Get("LdcId");
}

UInt_t AliRawReaderRoot::GetGDCId() const
{
// get the GDC Id from the event header

  if (!fEvent) return 0;
  return fEvent->GetHeader()->Get("GdcId");
}


Int_t AliRawReaderRoot::GetEquipmentSize() const
{
// get the size of the equipment

  if (!fEvent || !fEquipment || !fEquipment->GetEquipmentHeader()) return 0;
  return fEquipment->GetEquipmentHeader()->GetEquipmentSize();
}

Int_t AliRawReaderRoot::GetEquipmentType() const
{
// get the type from the equipment header

  if (!fEvent || !fEquipment || !fEquipment->GetEquipmentHeader()) return -1;
  return fEquipment->GetEquipmentHeader()->GetEquipmentType();
}

Int_t AliRawReaderRoot::GetEquipmentId() const
{
// get the ID from the equipment header

  if (!fEvent || !fEquipment || !fEquipment->GetEquipmentHeader()) return -1;
  return fEquipment->GetEquipmentHeader()->GetId();
}

const UInt_t* AliRawReaderRoot::GetEquipmentAttributes() const
{
// get the attributes from the equipment header

  if (!fEvent || !fEquipment || !fEquipment->GetEquipmentHeader()) return NULL;
  return fEquipment->GetEquipmentHeader()->GetTypeAttribute();
}

Int_t AliRawReaderRoot::GetEquipmentElementSize() const
{
// get the basic element size from the equipment header

  if (!fEvent || !fEquipment || !fEquipment->GetEquipmentHeader()) return 0;
  return fEquipment->GetEquipmentHeader()->GetBasicSizeType();
}


Bool_t AliRawReaderRoot::ReadHeader()
{
// read a data header at the current position
// returns kFALSE if the data header could not be read

  fErrorCode = 0;
  if (!fEvent) return kFALSE;

  do {
    // skip payload (if event was not selected)
    if (fCount > 0) fPosition += fCount;

    // get the first or the next equipment if at the end of an equipment
    if (!fEquipment || (fPosition >= fEnd)) {

      // get the first or the next sub event if at the end of a sub event
      if (!fSubEvent || (fEquipmentIndex >= fSubEvent->GetNEquipments())) {

	// check for end of event data
	if (fSubEventIndex >= fEvent->GetNSubEvents()) return kFALSE;
	fSubEvent = fEvent->GetSubEvent(fSubEventIndex++);

	// check the magic word of the sub event
	if (!fSubEvent->GetHeader()->IsValid()) {
	  Error("ReadHeader", "wrong magic number in sub event!");
	  fSubEvent->GetHeader()->Dump();
	  fErrorCode = kErrMagic;
	  return kFALSE;
	}

	fEquipmentIndex = 0;
	fEquipment = NULL;
	fRawData = NULL;
      }

      // get the next equipment and raw data
      fCount = 0;
      fEquipment = fSubEvent->GetEquipment(fEquipmentIndex++);
      if (!fEquipment) continue;
      fRawData = fEquipment->GetRawData();
      if (!fRawData) {
	fPosition = fEnd;
	continue;
      }
      fPosition = (UChar_t*) fRawData->GetBuffer();
      fEnd = ((UChar_t*) fRawData->GetBuffer()) + fRawData->GetSize();
    }

    // continue with the next equipment if no data left in the payload
    if (fPosition >= fEnd) continue;

    if (fRequireHeader) {
      // check that there are enough bytes left for the data header
      if (fPosition + sizeof(AliRawDataHeader) > fEnd) {
	Error("ReadHeader", "could not read data header!");
	Warning("ReadHeader", "skipping %d bytes", fEnd - fPosition);
	fEquipment->GetEquipmentHeader()->Dump();
	fCount = 0;
	fPosition = fEnd;
	fErrorCode = kErrNoDataHeader;
	continue;
      }

      // "read" the data header
      fHeader = (AliRawDataHeader*) fPosition;
      fPosition += sizeof(AliRawDataHeader);
    }

    if (fHeader && (fHeader->fSize != 0xFFFFFFFF)) {
      fCount = fHeader->fSize - sizeof(AliRawDataHeader);

      // check consistency of data size in the header and in the sub event
      if (fPosition + fCount > fEnd) {  
	Error("ReadHeader", "size in data header exceeds event size!");
	Warning("ReadHeader", "skipping %d bytes", fEnd - fPosition);
	fEquipment->GetEquipmentHeader()->Dump();
	fCount = 0;
	fPosition = fEnd;
	fErrorCode = kErrSize;
	continue;
      }

    } else {
      fCount = fEnd - fPosition;
    }

  } while (!IsSelected());

  return kTRUE;
}

Bool_t AliRawReaderRoot::ReadNextData(UChar_t*& data)
{
// reads the next payload at the current position
// returns kFALSE if the data could not be read

  fErrorCode = 0;
  while (fCount == 0) {
    if (!ReadHeader()) return kFALSE;
  }
  data = fPosition;
  fPosition += fCount;  
  fCount = 0;
  return kTRUE;
}

Bool_t AliRawReaderRoot::ReadNext(UChar_t* data, Int_t size)
{
// reads the next block of data at the current position
// returns kFALSE if the data could not be read

  fErrorCode = 0;
  if (fPosition + size > fEnd) {
    Error("ReadNext", "could not read data!");
    fErrorCode = kErrOutOfBounds;
    return kFALSE;
  }
  memcpy(data, fPosition, size);
  fPosition += size;
  fCount -= size;
  return kTRUE;
}


Bool_t AliRawReaderRoot::Reset()
{
// reset the current position to the beginning of the event

  fSubEventIndex = 0;
  fSubEvent = NULL;
  fEquipmentIndex = 0;
  fEquipment = NULL;
  fRawData = NULL;
  fHeader = NULL;

  fCount = 0;
  fPosition = fEnd = NULL;
  return kTRUE;
}


Bool_t AliRawReaderRoot::NextEvent()
{
// go to the next event in the root file

  if (!fFile) return kFALSE;

  do {
    if (fBranch->GetEntry(fEventIndex+1) <= 0) {
      delete fEvent;
      fEvent = new AliRawEvent;
      fBranch->SetAddress(&fEvent);
      return kFALSE;
    }
    fEventIndex++;
  } while (!IsEventSelected());
  return Reset();
}

Bool_t AliRawReaderRoot::RewindEvents()
{
// go back to the beginning of the root file

  if (!fFile) return kFALSE;

  fEventIndex = -1;
  delete fEvent;
  fEvent = new AliRawEvent;
  fBranch->SetAddress(&fEvent);
  return Reset();
}


Int_t AliRawReaderRoot::CheckData() const
{
// check the consistency of the data

  if (!fEvent) return 0;

  AliRawEvent* subEvent = NULL;
  Int_t subEventIndex = 0;
  AliRawEquipment* equipment = NULL;
  Int_t equipmentIndex = 0;
  UChar_t* position = 0;
  UChar_t* end = 0;
  Int_t result = 0;

  while (kTRUE) {
    // get the first or the next sub event if at the end of an equipment
    if (!subEvent || (equipmentIndex >= subEvent->GetNEquipments())) {

      // check for end of event data
      if (subEventIndex >= fEvent->GetNSubEvents()) return result;
      subEvent = fEvent->GetSubEvent(subEventIndex++);

      // check the magic word of the sub event
      if (!fSubEvent->GetHeader()->IsValid()) {
	result |= kErrMagic;
	return result;
      }

      equipmentIndex = 0;
    }

    // get the next equipment and raw data
    equipment = subEvent->GetEquipment(equipmentIndex++);
    if (!equipment) continue;
    AliRawData* rawData = equipment->GetRawData();
    if (!rawData) continue;
    position = (UChar_t*) rawData->GetBuffer();
    end = ((UChar_t*) rawData->GetBuffer()) + rawData->GetSize();

    // continue with the next sub event if no data left in the payload
    if (position >= end) continue;

    if (fRequireHeader) {
    // check that there are enough bytes left for the data header
      if (position + sizeof(AliRawDataHeader) > end) {
	result |= kErrNoDataHeader;
	continue;
      }

      // check consistency of data size in the header and in the equipment
      AliRawDataHeader* header = (AliRawDataHeader*) position;
      if (header->fSize != 0xFFFFFFFF) {
	if (position + header->fSize > end) result |= kErrSize;
      }
    }
  };

  return result;
}
Commit	Line	Data
	1	/**************************************************************************
	2	* Copyright(c) 1998-1999, ALICE Experiment at CERN, All rights reserved. *
	3	* *
	4	* Author: The ALICE Off-line Project. *
	5	* Contributors are mentioned in the code where appropriate. *
	6	* *
	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	**************************************************************************/
	15
	16	/* $Id$ */
	17
	18	///////////////////////////////////////////////////////////////////////////////
	19	///
	20	/// This is a class for reading raw data from a root file.
	21	///
	22	/// The root file is expected to contain a tree of name "RAW" with
	23	/// a branch of name "rawevent" which contains objects of type
	24	/// AliRawEvent.
	25	///
	26	/// The file name and the event number are arguments of the constructor
	27	/// of AliRawReaderRoot.
	28	///
	29	///////////////////////////////////////////////////////////////////////////////
	30
	31	#include <TFile.h>
	32	#include <TTree.h>
	33	#include "AliRawReaderRoot.h"
	34	#include "AliRawEvent.h"
	35	#include "AliRawEventHeaderBase.h"
	36	#include "AliRawEquipment.h"
	37	#include "AliRawEquipmentHeader.h"
	38	#include "AliRawData.h"
	39
	40
	41	ClassImp(AliRawReaderRoot)
	42
	43
	44	AliRawReaderRoot::AliRawReaderRoot(const char* fileName, Int_t eventNumber) :
	45	fFile(NULL),
	46	fBranch(NULL),
	47	fEventIndex(eventNumber),
	48	fEvent(NULL),
	49	fSubEventIndex(0),
	50	fSubEvent(NULL),
	51	fEquipmentIndex(0),
	52	fEquipment(NULL),
	53	fRawData(NULL),
	54	fPosition(NULL),
	55	fEnd(NULL)
	56	{
	57	// create an object to read digits from the given input file for the
	58	// event with the given number
	59
	60	TDirectory* dir = gDirectory;
	61	fFile = TFile::Open(fileName);
	62	dir->cd();
	63	if (!fFile \|\| !fFile->IsOpen()) {
	64	Error("AliRawReaderRoot", "could not open file %s", fileName);
	65	return;
	66	}
	67	TTree* tree = (TTree*) fFile->Get("RAW");
	68	if (!tree) {
	69	Error("AliRawReaderRoot", "no raw data tree found");
	70	return;
	71	}
	72	fBranch = tree->GetBranch("rawevent");
	73	if (!fBranch) {
	74	Error("AliRawReaderRoot", "no raw data branch found");
	75	return;
	76	}
	77
	78	fEvent = new AliRawEvent;
	79	fBranch->SetAddress(&fEvent);
	80	if (fEventIndex >= 0) {
	81	if (fBranch->GetEntry(fEventIndex) <= 0) {
	82	Error("AliRawReaderRoot", "no event with number %d found", fEventIndex);
	83	return;
	84	}
	85	}
	86	}
	87
	88	AliRawReaderRoot::AliRawReaderRoot(AliRawEvent* event) :
	89	fFile(NULL),
	90	fBranch(NULL),
	91	fEventIndex(-1),
	92	fEvent(event),
	93	fSubEventIndex(0),
	94	fSubEvent(NULL),
	95	fEquipmentIndex(0),
	96	fEquipment(NULL),
	97	fRawData(NULL),
	98	fPosition(NULL),
	99	fEnd(NULL)
	100	{
	101	// create an object to read digits from the given raw event
	102
	103	}
	104
	105	AliRawReaderRoot::AliRawReaderRoot(const AliRawReaderRoot& rawReader) :
	106	AliRawReader(rawReader),
	107	fFile(NULL),
	108	fBranch(NULL),
	109	fEventIndex(rawReader.fEventIndex),
	110	fEvent(NULL),
	111	fSubEventIndex(rawReader.fSubEventIndex),
	112	fSubEvent(NULL),
	113	fEquipmentIndex(rawReader.fEquipmentIndex),
	114	fEquipment(NULL),
	115	fRawData(NULL),
	116	fPosition(NULL),
	117	fEnd(NULL)
	118	{
	119	// copy constructor
	120
	121	if (rawReader.fFile) {
	122	TDirectory* dir = gDirectory;
	123	fFile = TFile::Open(rawReader.fFile->GetName());
	124	dir->cd();
	125	if (!fFile \|\| !fFile->IsOpen()) {
	126	Error("AliRawReaderRoot", "could not open file %s",
	127	rawReader.fFile->GetName());
	128	return;
	129	}
	130	TTree* tree = (TTree*) fFile->Get("RAW");
	131	if (!tree) {
	132	Error("AliRawReaderRoot", "no raw data tree found");
	133	return;
	134	}
	135	fBranch = tree->GetBranch("rawevent");
	136	if (!fBranch) {
	137	Error("AliRawReaderRoot", "no raw data branch found");
	138	return;
	139	}
	140
	141	fEvent = new AliRawEvent;
	142	fBranch->SetAddress(&fEvent);
	143	if (fEventIndex >= 0) {
	144	if (fBranch->GetEntry(fEventIndex) <= 0) {
	145	Error("AliRawReaderRoot", "no event with number %d found",
	146	fEventIndex);
	147	return;
	148	}
	149	}
	150	} else {
	151	fEvent = rawReader.fEvent;
	152	}
	153
	154	if (fSubEventIndex > 0) {
	155	fSubEvent = fEvent->GetSubEvent(fSubEventIndex-1);
	156	fEquipment = fSubEvent->GetEquipment(fEquipmentIndex);
	157	fRawData = fEquipment->GetRawData();
	158	fCount = 0;
	159	fHeader = (AliRawDataHeader) ((UChar_t) fRawData->GetBuffer() +
	160	((UChar_t*) rawReader.fHeader -
	161	(UChar_t*) rawReader.fRawData->GetBuffer()));
	162	fPosition = (UChar_t*) fRawData->GetBuffer() +
	163	(rawReader.fPosition - (UChar_t*) rawReader.fRawData->GetBuffer());
	164	fEnd = ((UChar_t*) fRawData->GetBuffer()) + fRawData->GetSize();
	165	}
	166	}
	167
	168	AliRawReaderRoot& AliRawReaderRoot::operator = (const AliRawReaderRoot&
	169	rawReader)
	170	{
	171	// assignment operator
	172
	173	this->~AliRawReaderRoot();
	174	new(this) AliRawReaderRoot(rawReader);
	175	return *this;
	176	}
	177
	178	AliRawReaderRoot::~AliRawReaderRoot()
	179	{
	180	// delete objects and close root file
	181
	182	if (fFile) {
	183	if (fEvent) delete fEvent;
	184	fFile->Close();
	185	delete fFile;
	186	}
	187	}
	188
	189
	190	UInt_t AliRawReaderRoot::GetType() const
	191	{
	192	// get the type from the event header
	193
	194	if (!fEvent) return 0;
	195	return fEvent->GetHeader()->Get("Type");
	196	}
	197
	198	UInt_t AliRawReaderRoot::GetRunNumber() const
	199	{
	200	// get the run number from the event header
	201
	202	if (!fEvent) return 0;
	203	return fEvent->GetHeader()->Get("RunNb");
	204	}
	205
	206	const UInt_t* AliRawReaderRoot::GetEventId() const
	207	{
	208	// get the event id from the event header
	209
	210	if (!fEvent) return NULL;
	211	return fEvent->GetHeader()->GetP("Id");
	212	}
	213
	214	const UInt_t* AliRawReaderRoot::GetTriggerPattern() const
	215	{
	216	// get the trigger pattern from the event header
	217
	218	if (!fEvent) return NULL;
	219	return fEvent->GetHeader()->GetP("TriggerPattern");
	220	}
	221
	222	const UInt_t* AliRawReaderRoot::GetDetectorPattern() const
	223	{
	224	// get the detector pattern from the event header
	225
	226	if (!fEvent) return NULL;
	227	return fEvent->GetHeader()->GetP("DetectorPattern");
	228	}
	229
	230	const UInt_t* AliRawReaderRoot::GetAttributes() const
	231	{
	232	// get the type attributes from the event header
	233
	234	if (!fEvent) return NULL;
	235	return fEvent->GetHeader()->GetP("TypeAttribute");
	236	}
	237
	238	const UInt_t* AliRawReaderRoot::GetSubEventAttributes() const
	239	{
	240	// get the type attributes from the sub event header
	241
	242	if (!fSubEvent) return NULL;
	243	return fSubEvent->GetHeader()->GetP("TypeAttribute");
	244	}
	245
	246	UInt_t AliRawReaderRoot::GetLDCId() const
	247	{
	248	// get the LDC Id from the event header
	249
	250	if (!fEvent \|\| !fSubEvent) return 0;
	251	return fSubEvent->GetHeader()->Get("LdcId");
	252	}
	253
	254	UInt_t AliRawReaderRoot::GetGDCId() const
	255	{
	256	// get the GDC Id from the event header
	257
	258	if (!fEvent) return 0;
	259	return fEvent->GetHeader()->Get("GdcId");
	260	}
	261
	262
	263	Int_t AliRawReaderRoot::GetEquipmentSize() const
	264	{
	265	// get the size of the equipment
	266
	267	if (!fEvent \|\| !fEquipment \|\| !fEquipment->GetEquipmentHeader()) return 0;
	268	return fEquipment->GetEquipmentHeader()->GetEquipmentSize();
	269	}
	270
	271	Int_t AliRawReaderRoot::GetEquipmentType() const
	272	{
	273	// get the type from the equipment header
	274
	275	if (!fEvent \|\| !fEquipment \|\| !fEquipment->GetEquipmentHeader()) return -1;
	276	return fEquipment->GetEquipmentHeader()->GetEquipmentType();
	277	}
	278
	279	Int_t AliRawReaderRoot::GetEquipmentId() const
	280	{
	281	// get the ID from the equipment header
	282
	283	if (!fEvent \|\| !fEquipment \|\| !fEquipment->GetEquipmentHeader()) return -1;
	284	return fEquipment->GetEquipmentHeader()->GetId();
	285	}
	286
	287	const UInt_t* AliRawReaderRoot::GetEquipmentAttributes() const
	288	{
	289	// get the attributes from the equipment header
	290
	291	if (!fEvent \|\| !fEquipment \|\| !fEquipment->GetEquipmentHeader()) return NULL;
	292	return fEquipment->GetEquipmentHeader()->GetTypeAttribute();
	293	}
	294
	295	Int_t AliRawReaderRoot::GetEquipmentElementSize() const
	296	{
	297	// get the basic element size from the equipment header
	298
	299	if (!fEvent \|\| !fEquipment \|\| !fEquipment->GetEquipmentHeader()) return 0;
	300	return fEquipment->GetEquipmentHeader()->GetBasicSizeType();
	301	}
	302
	303
	304	Bool_t AliRawReaderRoot::ReadHeader()
	305	{
	306	// read a data header at the current position
	307	// returns kFALSE if the data header could not be read
	308
	309	fErrorCode = 0;
	310	if (!fEvent) return kFALSE;
	311
	312	do {
	313	// skip payload (if event was not selected)
	314	if (fCount > 0) fPosition += fCount;
	315
	316	// get the first or the next equipment if at the end of an equipment
	317	if (!fEquipment \|\| (fPosition >= fEnd)) {
	318
	319	// get the first or the next sub event if at the end of a sub event
	320	if (!fSubEvent \|\| (fEquipmentIndex >= fSubEvent->GetNEquipments())) {
	321
	322	// check for end of event data
	323	if (fSubEventIndex >= fEvent->GetNSubEvents()) return kFALSE;
	324	fSubEvent = fEvent->GetSubEvent(fSubEventIndex++);
	325
	326	// check the magic word of the sub event
	327	if (!fSubEvent->GetHeader()->IsValid()) {
	328	Error("ReadHeader", "wrong magic number in sub event!");
	329	fSubEvent->GetHeader()->Dump();
	330	fErrorCode = kErrMagic;
	331	return kFALSE;
	332	}
	333
	334	fEquipmentIndex = 0;
	335	fEquipment = NULL;
	336	fRawData = NULL;
	337	}
	338
	339	// get the next equipment and raw data
	340	fCount = 0;
	341	fEquipment = fSubEvent->GetEquipment(fEquipmentIndex++);
	342	if (!fEquipment) continue;
	343	fRawData = fEquipment->GetRawData();
	344	if (!fRawData) {
	345	fPosition = fEnd;
	346	continue;
	347	}
	348	fPosition = (UChar_t*) fRawData->GetBuffer();
	349	fEnd = ((UChar_t*) fRawData->GetBuffer()) + fRawData->GetSize();
	350	}
	351
	352	// continue with the next equipment if no data left in the payload
	353	if (fPosition >= fEnd) continue;
	354
	355	if (fRequireHeader) {
	356	// check that there are enough bytes left for the data header
	357	if (fPosition + sizeof(AliRawDataHeader) > fEnd) {
	358	Error("ReadHeader", "could not read data header!");
	359	Warning("ReadHeader", "skipping %d bytes", fEnd - fPosition);
	360	fEquipment->GetEquipmentHeader()->Dump();
	361	fCount = 0;
	362	fPosition = fEnd;
	363	fErrorCode = kErrNoDataHeader;
	364	continue;
	365	}
	366
	367	// "read" the data header
	368	fHeader = (AliRawDataHeader*) fPosition;
	369	fPosition += sizeof(AliRawDataHeader);
	370	}
	371
	372	if (fHeader && (fHeader->fSize != 0xFFFFFFFF)) {
	373	fCount = fHeader->fSize - sizeof(AliRawDataHeader);
	374
	375	// check consistency of data size in the header and in the sub event
	376	if (fPosition + fCount > fEnd) {
	377	Error("ReadHeader", "size in data header exceeds event size!");
	378	Warning("ReadHeader", "skipping %d bytes", fEnd - fPosition);
	379	fEquipment->GetEquipmentHeader()->Dump();
	380	fCount = 0;
	381	fPosition = fEnd;
	382	fErrorCode = kErrSize;
	383	continue;
	384	}
	385
	386	} else {
	387	fCount = fEnd - fPosition;
	388	}
	389
	390	} while (!IsSelected());
	391
	392	return kTRUE;
	393	}
	394
	395	Bool_t AliRawReaderRoot::ReadNextData(UChar_t*& data)
	396	{
	397	// reads the next payload at the current position
	398	// returns kFALSE if the data could not be read
	399
	400	fErrorCode = 0;
	401	while (fCount == 0) {
	402	if (!ReadHeader()) return kFALSE;
	403	}
	404	data = fPosition;
	405	fPosition += fCount;
	406	fCount = 0;
	407	return kTRUE;
	408	}
	409
	410	Bool_t AliRawReaderRoot::ReadNext(UChar_t* data, Int_t size)
	411	{
	412	// reads the next block of data at the current position
	413	// returns kFALSE if the data could not be read
	414
	415	fErrorCode = 0;
	416	if (fPosition + size > fEnd) {
	417	Error("ReadNext", "could not read data!");
	418	fErrorCode = kErrOutOfBounds;
	419	return kFALSE;
	420	}
	421	memcpy(data, fPosition, size);
	422	fPosition += size;
	423	fCount -= size;
	424	return kTRUE;
	425	}
	426
	427
	428	Bool_t AliRawReaderRoot::Reset()
	429	{
	430	// reset the current position to the beginning of the event
	431
	432	fSubEventIndex = 0;
	433	fSubEvent = NULL;
	434	fEquipmentIndex = 0;
	435	fEquipment = NULL;
	436	fRawData = NULL;
	437	fHeader = NULL;
	438
	439	fCount = 0;
	440	fPosition = fEnd = NULL;
	441	return kTRUE;
	442	}
	443
	444
	445	Bool_t AliRawReaderRoot::NextEvent()
	446	{
	447	// go to the next event in the root file
	448
	449	if (!fFile) return kFALSE;
	450
	451	do {
	452	if (fBranch->GetEntry(fEventIndex+1) <= 0) {
	453	delete fEvent;
	454	fEvent = new AliRawEvent;
	455	fBranch->SetAddress(&fEvent);
	456	return kFALSE;
	457	}
	458	fEventIndex++;
	459	} while (!IsEventSelected());
	460	return Reset();
	461	}
	462
	463	Bool_t AliRawReaderRoot::RewindEvents()
	464	{
	465	// go back to the beginning of the root file
	466
	467	if (!fFile) return kFALSE;
	468
	469	fEventIndex = -1;
	470	delete fEvent;
	471	fEvent = new AliRawEvent;
	472	fBranch->SetAddress(&fEvent);
	473	return Reset();
	474	}
	475
	476
	477	Int_t AliRawReaderRoot::CheckData() const
	478	{
	479	// check the consistency of the data
	480
	481	if (!fEvent) return 0;
	482
	483	AliRawEvent* subEvent = NULL;
	484	Int_t subEventIndex = 0;
	485	AliRawEquipment* equipment = NULL;
	486	Int_t equipmentIndex = 0;
	487	UChar_t* position = 0;
	488	UChar_t* end = 0;
	489	Int_t result = 0;
	490
	491	while (kTRUE) {
	492	// get the first or the next sub event if at the end of an equipment
	493	if (!subEvent \|\| (equipmentIndex >= subEvent->GetNEquipments())) {
	494
	495	// check for end of event data
	496	if (subEventIndex >= fEvent->GetNSubEvents()) return result;
	497	subEvent = fEvent->GetSubEvent(subEventIndex++);
	498
	499	// check the magic word of the sub event
	500	if (!fSubEvent->GetHeader()->IsValid()) {
	501	result \|= kErrMagic;
	502	return result;
	503	}
	504
	505	equipmentIndex = 0;
	506	}
	507
	508	// get the next equipment and raw data
	509	equipment = subEvent->GetEquipment(equipmentIndex++);
	510	if (!equipment) continue;
	511	AliRawData* rawData = equipment->GetRawData();
	512	if (!rawData) continue;
	513	position = (UChar_t*) rawData->GetBuffer();
	514	end = ((UChar_t*) rawData->GetBuffer()) + rawData->GetSize();
	515
	516	// continue with the next sub event if no data left in the payload
	517	if (position >= end) continue;
	518
	519	if (fRequireHeader) {
	520	// check that there are enough bytes left for the data header
	521	if (position + sizeof(AliRawDataHeader) > end) {
	522	result \|= kErrNoDataHeader;
	523	continue;
	524	}
	525
	526	// check consistency of data size in the header and in the equipment
	527	AliRawDataHeader* header = (AliRawDataHeader*) position;
	528	if (header->fSize != 0xFFFFFFFF) {
	529	if (position + header->fSize > end) result \|= kErrSize;
	530	}
	531	}
	532	};
	533
	534	return result;
	535	}