/**************************************************************************
* This file is property of and copyright by the ALICE HLT Project *
* All rights reserved. *
* *
* Primary Authors: Per Thomas Hille, Oystein Djuvsland *
* *
* 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. *
**************************************************************************/
#ifndef ALIHLTPHOSRAWANALYZERCOMPONENTV3_H
#define ALIHLTPHOSRAWANALYZERCOMPONENTV3_H
/**
* Raw data analyzer component base class for PHOS HLT
*
* @file AliHLTPHOSRawAnalyzerComponentv3.h
* @author Oystein Djuvsland
* @date
* @brief A clusterizer component for PHOS HLT
*/
// see below for class documentation
// or
// refer to README to build package
// or
// visit http://web.ift.uib.no/~kjeks/doc/alice-hlt
#include "AliHLTPHOSRcuProcessor.h"
class AliHLTPHOSRawAnalyzer;
class AliHLTPHOSRcuCellEnergyDataStruct;
class AliHLTPHOSMapper;
class AliHLTPHOSSanityInspector;
class AliHLTPHOSDigitMaker;
class AliHLTPHOSDigitContainerDataStruct;
class AliRawReaderMemory;
class AliAltroRawStreamV3;
class AliHLTPHOSChannelDataStruct;
//class RawDataWriter;
/**
* @class AliHLTPHOSRawAnalyzerComponentv3
* This the new and fast version of the component taking care of the decoding and energy and timing
* extraction of the raw data from PHOS.
*
*
General properties:
*
* Component ID: \b PhosRawAnalyzerv3
* Library: \b libAliHLTPHOS.so
* Input Data Types: @ref
* Output Data Types: @ref AliHLTPHOSDefinitions::fgkChannelDataType
*
* Mandatory arguments:
*
* \li No mandatory arguments for component
*
* Optional arguments:
*
* \li -offset value
* gives the offset added to the data during zero suppression (default value: 0)
* \li -bunchsizecut value
* minimum number of samples a bunch must contain to be considered (default value: 0)
* \li -minpeakposition value
* cut on minimum postion of the peak in the bunch (defaul value: 0)
* \li -maxpeakposition value
* cut on maximum postion of the peak in the bunch (defaul value: 100)
*
* Configuration:
*
* \li No configuration arguments
*
* Default CDB entries:
* \li No CDB entry yet, will come.
*
* Performance:
* Pretty good (~ 3 kHz), depends on amount of data...
*
* Memory consumption:
* Depends on the amount of data, but pretty godd
*
* Output size:
* Depends on the amount of data...
*
* More detailed description. (Soon)
*
* @ingroup alihlt_phos
*/
class AliHLTPHOSRawAnalyzerComponentv3 : public AliHLTPHOSRcuProcessor
{
public:
/** Standard constructor */
AliHLTPHOSRawAnalyzerComponentv3();
/** Destructor */
virtual ~AliHLTPHOSRawAnalyzerComponentv3();
/** interface function, see @ref AliHLTComponent for description */
virtual int DoInit(int argc =0, const char** argv = 0);
/** interface function, see @ref AliHLTComponent for description */
virtual int Deinit();
/** interface function, see @ref AliHLTComponent for description */
virtual const char* GetComponentID() = 0;
/** interface function, see @ref AliHLTComponent for description */
virtual void GetInputDataTypes( vector & list);
/** interface function, see @ref AliHLTComponent for description */
virtual AliHLTComponentDataType GetOutputDataType();
/** interface function, see @ref AliHLTComponent for description */
virtual void GetOutputDataSize(unsigned long& constBase, double& inputMultiplier);
/** interface function, see @ref AliHLTComponent for description */
virtual AliHLTComponent* Spawn() = 0;
protected:
/** interface function, see @ref AliHLTComponent for description */
using AliHLTPHOSRcuProcessor::DoEvent;
/** interface function, see @ref AliHLTComponent for description */
virtual int DoEvent( const AliHLTComponentEventData& evtData, const AliHLTComponentBlockData* blocks,
AliHLTComponentTriggerData& trigData, AliHLTUInt8_t* outputPtr,
AliHLTUInt32_t& size, vector& outputBlocks );
/**
* Do the real processing in the component
* @param iter is the pointer to the data blocks
* @param outputPtr is the pointer to the output buffer
* @param size is the available size for output
* @param totSize is the total size used for output
* @return the size output size used
*/
virtual Int_t DoIt(const AliHLTComponentBlockData* iter, AliHLTUInt8_t* outputPtr, const AliHLTUInt32_t size, UInt_t& totSize);
/** Pointer to an analyzer object used for raw data anlysis */
AliHLTPHOSRawAnalyzer *fAnalyzerPtr; //COMMENT
private:
int WriteRawData( AliHLTPHOSChannelDataStruct *dtaPtr );
/** Keep the copy constructor private since it should not be used */
AliHLTPHOSRawAnalyzerComponentv3(const AliHLTPHOSRawAnalyzerComponentv3 & );
/** Keep the assignement operator private since it should not be used */
AliHLTPHOSRawAnalyzerComponentv3 & operator = (const AliHLTPHOSRawAnalyzerComponentv3 &);
/** Mapping from harware address to geometrical address */
AliHLTPHOSMapper *fMapperPtr; //!transient
/** Pointer to object which may check the integrity of the data */
AliHLTPHOSSanityInspector *fSanityInspectorPtr; //!transient
/** Pointer to the raw data reader which reads from memory */
AliRawReaderMemory* fRawReaderMemoryPtr; //!transient
/** Pointer to the raw stream */
AliAltroRawStreamV3* fAltroRawStreamPtr; //!transient
/** Describing which algorithm we are using */
Short_t fAlgorithm; //COMMENT
/** The offset applied before ZS */
Int_t fOffset; //COMMENT
/** The minimum length a bunch can have to be considered */
Int_t fBunchSizeCut; //COMMENT
/** The lowest position a peak can have to be considered */
Int_t fMinPeakPosition; //COMMENT
/** The maximum position a peak can have to be considered */
Int_t fMaxPeakPosition; //COMMENT
bool fDoPushRawData;
// const UShort_t* fRawDataBuffer;
// RawDataWriter *fRawDataWriter;
// class RawDataWriter : public AliHLTLogging
class RawDataWriter
{
public:
RawDataWriter();
~RawDataWriter();
// void WriteChannelId(const UShort_t channeldid );
void NewChannel( );
void WriteBunchData(const UShort_t *bunchdata, const int length, const UInt_t starttimebin );
void ResetBuffer();
void SetChannelId( const UShort_t channeldid );
//void CopyBufferToSharedMemory(UShort_t *memPtr, const int sizetotal, const int sizeused );
int CopyBufferToSharedMemory(UShort_t *memPtr, const int sizetotal, const int sizeused );
void NewEvent();
private:
RawDataWriter (const RawDataWriter & );
RawDataWriter & operator = (const RawDataWriter &);
void Init();
// bool fIsFirstChannel;
UShort_t* fRawDataBuffer;
int fCurrentChannelSize;
int fBufferIndex;
int fBufferSize;
UShort_t *fCurrentChannelIdPtr;
UShort_t *fCurrentChannelSizePtr;
UShort_t *fCurrentChannelDataPtr;
int fTotalSize;
};
RawDataWriter *fRawDataWriter;
};
#endif