CastorMergerData Class Reference

#include <CastorMergerData.h>

Public Member Functions
void	adoptData (const unsigned short *data, int length)
void	allocate (int version_to_create=0)
	CastorMergerData ()
	CastorMergerData (int version_to_create)
	CastorMergerData (const unsigned short *data, int length)
	CastorMergerData (const CastorMergerData &)
bool	check () const
	Check for a good event Requires a minimum length, matching wordcount and length, not an empty event. More...
unsigned int	getBunchNumber () const
	Get the HTR bunch number. More...
unsigned int	getErrorsWord () const
	Get the errors word. More...
unsigned int	getExtHdr1 () const
	Get the Merger Ext Header words. More...
unsigned int	getExtHdr2 () const
unsigned int	getExtHdr3 () const
unsigned int	getExtHdr4 () const
unsigned int	getExtHdr5 () const
unsigned int	getExtHdr6 () const
unsigned int	getExtHdr7 () const
unsigned int	getExtHdr8 () const
unsigned int	getFirmwareRevision () const
	Get the Merger firmware version. More...
int	getFormatVersion () const
	Get the version number of this event. More...
unsigned int	getL1ANumber () const
	Get the HTR event number. More...
unsigned int	getOrbitNumber () const
	Get the HTR orbit number. More...
const unsigned short *	getRawData () const
	Get a pointer to the raw data. More...
const int	getRawLength () const
	Get the length of the raw data. More...
CastorMergerData &	operator= (const CastorMergerData &)
void	pack (unsigned char *tp_lengths, unsigned short *tp_samples)
	Unpack the HTR data into TP and DAQ data sorted by channel. More...
void	packHeaderTrailer (int L1Anumber, int bcn, int submodule, int orbitn, int pipeline, int ndd, int nps, int firmwareRev=0)
	pack header and trailer (call after pack) More...
void	unpack (unsigned char *tp_lengths, unsigned short *tp_samples) const
	Unpack the HTR data into TP and DAQ data sorted by channel. More...
	~CastorMergerData ()

Protected Member Functions
void	determineSectionLengths (int &tpWords, int &headerWords, int &trailerWords) const
void	determineStaticLengths (int &headerWords, int &trailerWords) const

Protected Attributes
int	m_formatVersion
unsigned short *	m_ownData
const unsigned short *	m_rawConst
int	m_rawLength
unsigned short *	m_unpackedData

Detailed Description

Interpretive class for CastorMergerData Since this class requires external specification of the length of the data, it is implemented as an interpreter, rather than a cast-able header class.

Author

A. Campbell - DESY

Definition at line 14 of file CastorMergerData.h.

Constructor & Destructor Documentation

CastorMergerData::CastorMergerData

(

)

Definition at line 13 of file CastorMergerData.cc.

Referenced by ~CastorMergerData().

: m_formatVersion(-2), m_rawLength(0), m_rawConst(0), m_ownData(0) { }

CastorMergerData::~CastorMergerData ( )

inline

Definition at line 18 of file CastorMergerData.h.

References adoptData(), allocate(), CastorMergerData(), data, getFirmwareRevision(), m_ownData, and operator=().

{ if (m_ownData!=0) delete [] m_ownData; }

CastorMergerData::CastorMergerData

(

int

version_to_create

)

Definition at line 20 of file CastorMergerData.cc.

References allocate().

                                                        : m_formatVersion(version_to_create) {
  allocate(version_to_create);
}

CastorMergerData::CastorMergerData	(	const unsigned short *	data,
		int	length
	)

Definition at line 14 of file CastorMergerData.cc.

References adoptData(), and m_ownData.

                                                                         {
  adoptData(data,length);
  m_ownData=0;
}

CastorMergerData::CastorMergerData

(

const CastorMergerData &

hd

)

Definition at line 18 of file CastorMergerData.cc.

: m_formatVersion(hd.m_formatVersion), m_rawLength(hd.m_rawLength), m_rawConst(hd.m_rawConst), m_ownData(0) { }

Member Function Documentation

void CastorMergerData::adoptData	(	const unsigned short *	data,
		int	length
	)

Definition at line 43 of file CastorMergerData.cc.

References data, m_formatVersion, m_rawConst, and m_rawLength.

Referenced by CastorMergerData(), and ~CastorMergerData().

                                                                       {
  m_rawLength=length;
  m_rawConst=data;
  if (m_rawLength<5) {
    m_formatVersion=-2; // invalid!
  } else {
    m_formatVersion=(m_rawConst[4]>>12)&0xF;
  }
}

void CastorMergerData::allocate

(

int

version_to_create = 0

)

Definition at line 24 of file CastorMergerData.cc.

References m_formatVersion, m_ownData, m_rawConst, and m_rawLength.

Referenced by CastorMergerData(), and ~CastorMergerData().

                                                     {
  m_formatVersion=version_to_create;
  // the needed space is for the biggest possible event...
  const int needed=0x200;
  // create a buffer big enough...
  m_ownData=new unsigned short[needed];
  m_rawLength=0;
  m_rawConst=m_ownData;
}

bool CastorMergerData::check

(

)

const

Check for a good event Requires a minimum length, matching wordcount and length, not an empty event.

Definition at line 56 of file CastorMergerData.cc.

References m_rawConst, and m_rawLength.

Referenced by getRawLength().

                                   {
     // length checks
    //  minimum length
    if (m_rawLength<6+12) return false;
    //  matches wordcount
    if (m_rawLength!=m_rawConst[m_rawLength-3]) return false;
 
  return true;
}

void CastorMergerData::determineSectionLengths ( int &  tpWords, int &  headerWords, int &  trailerWords  ) const

protected

Definition at line 86 of file CastorMergerData.cc.

References m_rawConst.

Referenced by getExtHdr8(), and unpack().

                                                                                                      {
 
    tpWords=m_rawConst[5]>>8; // should be 8 but could be up to 12
    headerWords=8;
    trailerWords=0; // minimum, may be more...
}

void CastorMergerData::determineStaticLengths ( int &  headerWords, int &  trailerWords  ) const

protected

Definition at line 93 of file CastorMergerData.cc.

Referenced by getExtHdr8(), and pack().

                                                                                       {
   headerWords=8;
   trailerWords=0; // minimum, may be more...

}

unsigned int CastorMergerData::getBunchNumber ( ) const

inline

Get the HTR bunch number.

Definition at line 76 of file CastorMergerData.h.

References getOrbitNumber(), and m_rawConst.

                                             { 
    return (m_rawConst[4]&0xFFF); 
  }

unsigned int CastorMergerData::getErrorsWord ( ) const

inline

Get the errors word.

Definition at line 30 of file CastorMergerData.h.

References m_rawConst.

Referenced by CastorCTDCHeader::copyMergerData().

                                            { 
    return m_rawConst[2]&0xFFFF; }

unsigned int CastorMergerData::getExtHdr1 ( ) const

inline

Get the Merger Ext Header words.

Definition at line 84 of file CastorMergerData.h.

References m_rawConst.

                                         { 
    return (m_rawConst[0]);}

unsigned int CastorMergerData::getExtHdr2 ( ) const

inline

Definition at line 86 of file CastorMergerData.h.

References m_rawConst.

                                         { 
    return (m_rawConst[1]); }

unsigned int CastorMergerData::getExtHdr3 ( ) const

inline

Definition at line 88 of file CastorMergerData.h.

References m_rawConst.

                                         { 
    return (m_rawConst[2]);} 

unsigned int CastorMergerData::getExtHdr4 ( ) const

inline

Definition at line 90 of file CastorMergerData.h.

References m_rawConst.

                                         { 
    return (m_rawConst[3]); }

unsigned int CastorMergerData::getExtHdr5 ( ) const

inline

Definition at line 92 of file CastorMergerData.h.

References m_rawConst.

                                         { 
    return (m_rawConst[4]);} 

unsigned int CastorMergerData::getExtHdr6 ( ) const

inline

Definition at line 94 of file CastorMergerData.h.

References m_rawConst.

                                         { 
    return (m_rawConst[5]);} 

unsigned int CastorMergerData::getExtHdr7 ( ) const

inline

Definition at line 96 of file CastorMergerData.h.

References m_rawConst.

                                         { 
    return (m_rawConst[6]);} 

unsigned int CastorMergerData::getExtHdr8 ( ) const

inline

Definition at line 98 of file CastorMergerData.h.

References determineSectionLengths(), determineStaticLengths(), and m_rawConst.

                                         { 
    return (m_rawConst[7]);}  

unsigned int CastorMergerData::getFirmwareRevision

(

)

const

Get the Merger firmware version.

Definition at line 147 of file CastorMergerData.cc.

References m_rawConst.

Referenced by ~CastorMergerData().

                                                         {
  return (m_rawConst[6]);
}

int CastorMergerData::getFormatVersion ( ) const

inline

Get the version number of this event.

Definition at line 34 of file CastorMergerData.h.

References m_formatVersion.

{ return m_formatVersion; }

unsigned int CastorMergerData::getL1ANumber ( ) const

inline

Get the HTR event number.

Definition at line 72 of file CastorMergerData.h.

References m_rawConst.

                                           { 
    return (m_rawConst[0]&0xFF)+(m_rawConst[1]<<8); 
  }

unsigned int CastorMergerData::getOrbitNumber

(

)

const

Get the HTR orbit number.

Definition at line 143 of file CastorMergerData.cc.

References m_rawConst.

Referenced by getBunchNumber().

                                                    { 
  return (m_rawConst[3]>>11);
}

const unsigned short* CastorMergerData::getRawData ( ) const

inline

Get a pointer to the raw data.

Definition at line 37 of file CastorMergerData.h.

References m_rawConst.

Referenced by CastorCTDCHeader::copyMergerData().

{ return m_rawConst; }

const int CastorMergerData::getRawLength ( ) const

inline

Get the length of the raw data.

Definition at line 40 of file CastorMergerData.h.

References check(), m_rawLength, pack(), packHeaderTrailer(), and unpack().

Referenced by CastorCTDCHeader::copyMergerData(), and CastorCtdcPacker::pack().

{ return m_rawLength; }

CastorMergerData & CastorMergerData::operator=

(

const CastorMergerData &

hd

)

Definition at line 34 of file CastorMergerData.cc.

References m_formatVersion, m_ownData, m_rawConst, and m_rawLength.

Referenced by ~CastorMergerData().

                                                                        {
  if (m_ownData==0) {
    m_formatVersion=hd.m_formatVersion;
    m_rawLength=hd.m_rawLength;
    m_rawConst=hd.m_rawConst;
  }
  return (*this);
}

void CastorMergerData::pack	(	unsigned char *	tp_lengths,
		unsigned short *	tp_samples
	)

Unpack the HTR data into TP and DAQ data sorted by channel.

Parameters

daq_lengths	unsigned char[24] of lengths
daq_samples	unsigned short [24*20] of data
tp_lengths	unsigned char[24] of lengths
tp_samples	unsigned short [24*20] of data

Definition at line 98 of file CastorMergerData.cc.

References determineStaticLengths(), m_ownData, and m_rawLength.

Referenced by pyrootRender.interactiveRender::draw(), and getRawLength().

                                                                      {
  
  int tp_words_total=0, headerLen, trailerLen;
  determineStaticLengths(headerLen,trailerLen);

  tp_words_total=0;
  int isample;

  // trigger words
  unsigned short* ptr=m_ownData+headerLen;
  if (tp_samples!=0 && tp_lengths!=0) {
      for (isample=0; isample<tp_lengths[0] && isample<12; isample++) {
    ptr[tp_words_total]=tp_samples[isample];
    tp_words_total++;
      }
  }

   m_ownData[5]=(tp_words_total<<8)|0x1;
   unsigned short totalLen=headerLen+tp_words_total+trailerLen;

   m_rawLength=totalLen;
   m_ownData[totalLen-2]=totalLen/2; // 32-bit words
   m_ownData[totalLen-3]=totalLen;
   m_ownData[totalLen-4]=tp_words_total;
 
}

void CastorMergerData::packHeaderTrailer	(	int	L1Anumber,
		int	bcn,
		int	submodule,
		int	orbitn,
		int	pipeline,
		int	ndd,
		int	nps,
		int	firmwareRev = 0
	)

pack header and trailer (call after pack)

Definition at line 126 of file CastorMergerData.cc.

References m_formatVersion, m_ownData, and m_rawLength.

Referenced by getRawLength().

                                                                                                                                           {
  m_ownData[0]=L1Anumber&0xFF;
  m_ownData[1]=(L1Anumber&0xFFFF00)>>8;

  m_ownData[2]=0x8000; // Version is valid, no error bits - status bits need definition
  m_ownData[3]=((orbitn&0x1F)<<11)|(submodule&0x7FF);
  m_ownData[4]=((m_formatVersion&0xF)<<12)|(bcn&0xFFF);
  m_ownData[5]|=((nps&0xF)<<4)|0x1;
  m_ownData[6]=((firmwareRev&0x70000)>>3)|(firmwareRev&0x1FFF);
  m_ownData[7]=(pipeline&0xFF) | ((ndd&0x1F)<<8);
  m_ownData[m_rawLength-4]&=0x7FF;
  m_ownData[m_rawLength-4]|=(ndd&0x1F)<<11;
  
  m_ownData[m_rawLength-2]=m_rawLength/2; // 32-bit words
  m_ownData[m_rawLength-1]=(L1Anumber&0xFF)<<8;
}

void CastorMergerData::unpack	(	unsigned char *	tp_lengths,
		unsigned short *	tp_samples
	)		const

Unpack the HTR data into TP and DAQ data sorted by channel.

Parameters

daq_lengths	unsigned char[24] of lengths. High bit set indicates error with this channel
daq_samples	unsigned short [24*20] of data
tp_lengths	unsigned char[24] of lengths
tp_samples	unsigned short [24*20] of data

Definition at line 67 of file CastorMergerData.cc.

References determineSectionLengths(), and m_rawConst.

Referenced by getRawLength().

                                                                          {

  if (tp_lengths!=0) memset(tp_lengths,0,1);

  int tp_words_total,headerLen,trailerLen;
  determineSectionLengths(tp_words_total,headerLen,trailerLen);

  int wordPtr;
  const unsigned short* tpBase=m_rawConst+headerLen;
  // process the trigger primitive words
  if (tp_lengths!=0) {
    for (wordPtr=0; wordPtr<tp_words_total; wordPtr++) {
       tp_samples[tp_lengths[0]]=tpBase[wordPtr];
       tp_lengths[0]++;
    }
  }
 
}

Member Data Documentation

int CastorMergerData::m_formatVersion

protected

Definition at line 107 of file CastorMergerData.h.

Referenced by adoptData(), allocate(), getFormatVersion(), operator=(), and packHeaderTrailer().

unsigned short* CastorMergerData::m_ownData

protected

Definition at line 110 of file CastorMergerData.h.

Referenced by allocate(), CastorMergerData(), operator=(), pack(), packHeaderTrailer(), and ~CastorMergerData().

const unsigned short* CastorMergerData::m_rawConst

protected

Definition at line 109 of file CastorMergerData.h.

Referenced by adoptData(), allocate(), check(), determineSectionLengths(), getBunchNumber(), getErrorsWord(), getExtHdr1(), getExtHdr2(), getExtHdr3(), getExtHdr4(), getExtHdr5(), getExtHdr6(), getExtHdr7(), getExtHdr8(), getFirmwareRevision(), getL1ANumber(), getOrbitNumber(), getRawData(), operator=(), and unpack().

int CastorMergerData::m_rawLength

protected

Definition at line 108 of file CastorMergerData.h.

Referenced by adoptData(), allocate(), check(), getRawLength(), operator=(), pack(), and packHeaderTrailer().

unsigned short* CastorMergerData::m_unpackedData

protected

Definition at line 111 of file CastorMergerData.h.