Collection of charge vs time digitized from a single readout channel. More...

#include "RawDigit.h"

Public Types
typedef std::vector< short >	ADCvector_t
	Type representing a (compressed) vector of ADC counts. More...

Public Member Functions
	RawDigit ()
	Default constructor: an empty raw digit. More...

	RawDigit (ChannelID_t channel, ULong64_t samples, ADCvector_t const &adclist, raw::Compress_t compression=raw::kNone)
	Constructor: sets all the fields. More...

	RawDigit (ChannelID_t channel, ULong64_t samples, ADCvector_t &&adclist, raw::Compress_t compression=raw::kNone)
	Constructor: sets all the fields. More...

void	SetPedestal (float ped, float sigma=1.)
	Set pedestal and its RMS (the latter is 0 by default) More...

Accessors
const ADCvector_t &	ADCs () const
	Reference to the compressed ADC count vector. More...

size_t	NADC () const
	Number of elements in the compressed ADC sample vector. More...

short	ADC (int i) const
	ADC vector element number i; no decompression is applied. More...

ChannelID_t	Channel () const
	DAQ channel this raw data was read from. More...

ULong64_t	Samples () const
	Number of samples in the uncompressed ADC data. More...

float	GetPedestal () const

float	GetSigma () const
	TODO RMS of the pedestal level? More...

raw::Compress_t	Compression () const
	Compression algorithm used to store the ADC counts. More...

Private Attributes
std::vector< short >	fADC
	ADC readout per tick, before pedestal subtraction. More...

ChannelID_t	fChannel
	channel number in the readout More...

ULong64_t	fSamples
	number of ticks of the clock More...

float	fPedestal
	pedestal for this channel More...

float	fSigma
	sigma of the pedestal counts for this channel More...

Compress_t	fCompression
	compression scheme used for the ADC vector More...

Detailed Description

Collection of charge vs time digitized from a single readout channel.

This class hosts potentially compressed data. It does not provide methods to uncompress it, not the same object can become compressed/uncompressed or change compression type: to use a compressed RawDigit, one has to create a new buffer, fill and use it:

raw::RawDigit::ADCvector_t ADCs(digits.Samples()); // fix the size!
raw::Uncompress(digits.ADCs(), ADCs, digits.Compression());

(remember that you have to provide raw::Uncompress() with a buffer large enough to contain the uncompressed data).

The class provides some flags, defined in FlagIndices_t. The construction of a RawDigit should be for example in the form:

raw::RawDigit::ADCvector_t ADCs;
// ... fill the digits etc.
raw::RawDigit saturatedDigit(
  channel, ADCs.size(), ADCs, raw::kNone,
  DefaultFlags | SaturationBit
  );
raw::RawDigit unsaturatedDigit(
  channel, ADCs.size(), ADCs, raw::kNone,
  DefaultFlags & ~SaturationBit
  );

Definition at line 68 of file RawDigit.h.

Member Typedef Documentation

typedef std::vector<short> raw::RawDigit::ADCvector_t

Type representing a (compressed) vector of ADC counts.

Definition at line 72 of file RawDigit.h.

Constructor & Destructor Documentation

raw::RawDigit::RawDigit ( )

Default constructor: an empty raw digit.

Definition at line 19 of file RawDigit.cxx.

     : fADC(0)
     , fChannel(InvalidChannelID)
     , fSamples(0)
     , fPedestal(0.)
     , fSigma(0.)
     , fCompression(kNone)
   //  , fFlags(DefaultFlags)
   {}

raw::RawDigit::RawDigit	(	ChannelID_t	channel,
		ULong64_t	samples,
		ADCvector_t const &	adclist,
		raw::Compress_t	compression = `raw::kNone`
	)

Constructor: sets all the fields.

Parameters

channel	ID of the channel the digits were acquired from
samples	number of ADC samples in the uncompressed collection
adclist	list of ADC counts vs. time, compressed
compression	compression algorithm used in adclist

Data from the adclist is copied into the raw digits. Pedestal is set to 0 by default.

Definition at line 30 of file RawDigit.cxx.

     : fADC(adclist)
     , fChannel(channel)
     , fSamples(samples)
     , fPedestal(0.)
     , fSigma(0.)
     , fCompression(compression)
   //  , fFlags(flags)
   {}

raw::RawDigit::RawDigit	(	ChannelID_t	channel,
		ULong64_t	samples,
		ADCvector_t &&	adclist,
		raw::Compress_t	compression = `raw::kNone`
	)

Constructor: sets all the fields.

Parameters

channel	ID of the channel the digits were acquired from
samples	number of ADC samples in the uncompressed collection
adclist	list of ADC counts vs. time, compressed
compression	compression algorithm used in adclist

Data from the adclist is moved into the raw digits. Pedestal is set to 0 by default.

Definition at line 46 of file RawDigit.cxx.

     : fADC(std::move(adclist))
     , fChannel(channel)
     , fSamples(samples)
     , fPedestal(0.)
     , fSigma(0.)
     , fCompression(compression)
   //  , fFlags(flags)
   {}

Member Function Documentation

short raw::RawDigit::ADC ( int i ) const

inline

ADC vector element number i; no decompression is applied.

Definition at line 205 of file RawDigit.h.

References fADC.

 {
   return fADC.at(i);
 }

const raw::RawDigit::ADCvector_t & raw::RawDigit::ADCs ( ) const

inline

Reference to the compressed ADC count vector.

Definition at line 209 of file RawDigit.h.

References fADC.

Referenced by nnet::RawWaveformDump::analyze(), nnet::RawWaveformClnSigDump::analyze(), evdb_tool::DrawRawHist::Fill(), detsim::DumpRawDigits::PrintRawDigit(), hit::RawHitFinder::produce(), caldata::CalWire::produce(), and caldata::CalWireT962::produce().

 {
   return fADC;
 }

raw::ChannelID_t raw::RawDigit::Channel ( ) const

inline

DAQ channel this raw data was read from.

Definition at line 213 of file RawDigit.h.

References fChannel.

Referenced by nnet::WaveformDenoiseTest::analyze(), nnet::RawWaveformDump::analyze(), nnet::RawWaveformClnSigDump::analyze(), evdb_tool::DrawRawHist::Fill(), evd::RawDataDrawer::FillQHisto(), lar_cluster3d::StandardHit3DBuilder::makeRawDigitAssns(), lar_cluster3d::SnippetHit3DBuilder::makeRawDigitAssns(), recob::HitCollectionAssociator::prepare_associations(), recob::HitRefinerAssociator::prepare_associations(), detsim::DumpRawDigits::PrintRawDigit(), hit::RawHitFinder::produce(), caldata::CalWire::produce(), caldata::CalWireT962::produce(), and evd::RawDataDrawer::RunOperation().

 {
   return fChannel;
 }

raw::Compress_t raw::RawDigit::Compression ( ) const

inline

Compression algorithm used to store the ADC counts.

Definition at line 229 of file RawDigit.h.

References fCompression.

Referenced by nnet::RawWaveformDump::analyze(), nnet::RawWaveformClnSigDump::analyze(), evdb_tool::DrawRawHist::Fill(), detsim::DumpRawDigits::PrintRawDigit(), hit::RawHitFinder::produce(), caldata::CalWire::produce(), and caldata::CalWireT962::produce().

 {
   return fCompression;
 }

float raw::RawDigit::GetPedestal ( ) const

inline

Pedestal level (ADC counts)

Deprecated:: Might be removed soon

Definition at line 221 of file RawDigit.h.

References fPedestal.

Referenced by nnet::RawWaveformDump::analyze(), nnet::RawWaveformClnSigDump::analyze(), evdb_tool::DrawRawHist::Fill(), evd::RawDataDrawer::FillQHisto(), evd::RawDataDrawer::FillTQHisto(), hit::RawHitFinder::produce(), caldata::CalWire::produce(), caldata::CalWireT962::produce(), and evd::RawDataDrawer::RunOperation().

 {
   return fPedestal;
 }

float raw::RawDigit::GetSigma ( ) const

inline

TODO RMS of the pedestal level?

Definition at line 225 of file RawDigit.h.

References fSigma.

 {
   return fSigma;
 }

size_t raw::RawDigit::NADC ( ) const

inline

Number of elements in the compressed ADC sample vector.

Definition at line 201 of file RawDigit.h.

References fADC.

Referenced by detsim::DumpRawDigits::PrintRawDigit().

 {
   return fADC.size();
 }

ULong64_t raw::RawDigit::Samples ( ) const

inline

Number of samples in the uncompressed ADC data.

Definition at line 217 of file RawDigit.h.

References fSamples.

Referenced by nnet::WaveformDenoiseTest::analyze(), nnet::NoiseWaveformDump::analyze(), nnet::RawWaveformDump::analyze(), nnet::RawWaveformClnSigDump::analyze(), evdb_tool::DrawRawHist::Fill(), detsim::DumpRawDigits::PrintRawDigit(), hit::RawHitFinder::produce(), caldata::CalWire::produce(), caldata::CalWireT962::produce(), evd::details::RawDigitCacheDataClass::Refill(), and recob::WireCreator::WireCreator().

 {
   return fSamples;
 }

void raw::RawDigit::SetPedestal	(	float	ped,
		float	sigma = `1.`
	)

Set pedestal and its RMS (the latter is 0 by default)

Definition at line 62 of file RawDigit.cxx.

References fPedestal, and fSigma.

   {
 
     fPedestal = ped;
     fSigma = sigma;
 
   } // RawDigit::SetPedestal()

Member Data Documentation

std::vector<short> raw::RawDigit::fADC

private

ADC readout per tick, before pedestal subtraction.

Definition at line 180 of file RawDigit.h.

Referenced by ADC(), ADCs(), and NADC().

ChannelID_t raw::RawDigit::fChannel

private

channel number in the readout

Definition at line 182 of file RawDigit.h.

Referenced by Channel().

Compress_t raw::RawDigit::fCompression

private

compression scheme used for the ADC vector

Definition at line 188 of file RawDigit.h.

Referenced by Compression().

float raw::RawDigit::fPedestal

private

pedestal for this channel

Definition at line 185 of file RawDigit.h.

Referenced by GetPedestal(), and SetPedestal().

ULong64_t raw::RawDigit::fSamples

private

number of ticks of the clock

Definition at line 183 of file RawDigit.h.

Referenced by Samples().

float raw::RawDigit::fSigma

private

sigma of the pedestal counts for this channel

Definition at line 186 of file RawDigit.h.

Referenced by GetSigma(), and SetPedestal().

The documentation for this class was generated from the following files:

lardataobj/v09_18_03/source/lardataobj/RawData/RawDigit.h
lardataobj/v09_18_03/source/lardataobj/RawData/RawDigit.cxx

Public Types

Public Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation