rawdata::RawDigit Class Reference

#include "/cvmfs/nova-development.opensciencegrid.org/novasoft/releases/N21-05-06/RawData/RawDigit.h"

Inheritance diagram for rawdata::RawDigit:

Public Member Functions
	RawDigit ()
virtual	~RawDigit ()
	RawDigit (uint32_t channel, uint32_t daqchannel, std::vector< int16_t > adclist, int32_t tdc)
uint32_t	NADC () const
int16_t	ADC (uint32_t i) const
uint32_t	Channel () const
uint32_t	DaqChannel () const
uint8_t	Version () const
int16_t	ADC () const
	Best estimator of the hit charge. More...
int32_t	TDC () const
	The time of the last baseline sample. More...
void	SetADC (uint32_t i, int16_t iADC)
void	SetTDC (int32_t iTDC)
void	SetChannel (uint32_t iChan)
void	SetDaqChannel (uint32_t iChan)
void	SetVersion (uint8_t v)
void	SetMC (bool isMC=true)
bool	IsRealData () const
bool	IsMC () const

Public Attributes
uint8_t	fFrameSequenceNumber
uint8_t	fFEBStatus
bool	fDebugMode
bool	fDataPresent
bool	fLinkStatus
uint16_t	fReserved
	Should be 0xCAFE. More...
std::vector< int16_t >	fADC
	list of ADC(-like) charge values More...
std::vector< int32_t >	fTDC
	TDC(-like) time value. Event time is subtracted. Vector structure is a historical artifact. More...
uint8_t	fVersion
	NanoSlice version. More...

Private Attributes
uint32_t	fChannel
	channel ID More...
uint32_t	fDaqChannel
	DAQ readout channel. More...
uint32_t	fMCBits
	status bits for MC information More...

Friends
std::ostream &	operator<< (std::ostream &o, const RawDigit &r)

Detailed Description

Definition at line 36 of file RawDigit.h.

Constructor & Destructor Documentation

rawdata::RawDigit::RawDigit

(

)

Definition at line 18 of file RawDigit.cxx.

                     :   
    fFrameSequenceNumber(1),
    fFEBStatus(1),
    fDebugMode(false),
    fDataPresent(false),
    fLinkStatus(false),
    fReserved(1),
    fADC(0),
    fTDC(1, 0),
    fVersion(0),  
    fChannel(0),
    fDaqChannel(0),
    fMCBits(0)
  {
  }

virtual rawdata::RawDigit::~RawDigit ( )

inlinevirtual

Definition at line 39 of file RawDigit.h.

References fFrameSequenceNumber.

{}; //Destructor

rawdata::RawDigit::RawDigit	(	uint32_t	channel,
		uint32_t	daqchannel,
		std::vector< int16_t >	adclist,
		int32_t	tdc
	)

Definition at line 36 of file RawDigit.cxx.

                                  :
    fFrameSequenceNumber(1),
    fFEBStatus(1),
    fDebugMode(false),
    fDataPresent(false),
    fLinkStatus(false),
    fReserved(1),
    fADC(adclist), 
    fTDC(tdc),
    fVersion(0),  
    fChannel(channel),
    fDaqChannel(daqchannel),
    fMCBits(0)
  {
  }

Member Function Documentation

int16_t rawdata::RawDigit::ADC

(

uint32_t

i

)

const

Definition at line 58 of file RawDigit.cxx.

References fADC, MECModelEnuComparisons::i, and printf().

Referenced by murem::MRCCParticle::AddHit(), me::MEFinder::AddMEHit(), murem::MRCCParticle::AddMRCCHit(), calib::ADCShapeFitAna::analyze(), rsim::RecordNoiseSpectrumFile::analyze(), calhit::CalHitAna::analyze(), rsim::MakeNoiseSpectrumFile::analyze(), ddt::SMMADC::analyze(), zcl::SMMTriggerAna::analyze(), mcchk::MonopoleAna::analyze(), sn::SupernovaAna::analyze(), murem::MuonRemoveAna::analyze(), pa::HitEva::analyze(), pa::ClusterEva::analyze(), zcl::MMCheater::analyze(), zcl::FmmTriggerAna::analyze(), zcl::FmmTrackerValidation::analyze(), zcl::FmmTrackerAna::analyze(), showere::ShowerEnergyAna::analyze(), rockmuon::NDRockMuon::analyze(), comi::NearlineAna::analyze(), remid::ReMIdDedxRock::analyze(), remid::ReMIdDedxFD::analyze(), remid::ReMIdDedxStudies::analyze(), zcl::FastMMStudy::analyze(), LightLevels::analyze(), ncs::Xeff::analyze(), ncs::ROCKMRE::analyze(), upmuana::UpMuRecoAna::analyze(), ncs::NCAna::analyze(), slid::NuEEnergyAlg::CellEnergy(), rsim::ReadoutSim::CreateRawDigits(), raw2daq::RawDigit2DAQHit::FillDAQHits(), filter::Filter::FillDigitVariables(), dprf::ChannelPlots::FillFebRawPlots(), calib::StopperThreshold::FillHist(), mcdatadaq::DAQSimulator::fillMicroSlices(), calib::StopperThreshold::FillTree(), calib::CalibAna::FillWithCellHit(), bsf::BremShowerFilter::filter(), showere::ShowerEnergyFilterMC::filter(), bsf::BremShowerFilter::findShowerByReco(), jmshower::RecoJMShower::GetCentroid(), calib::Calibrator::GetTNS(), slid::NuEEnergyAlg::HadronicDepEnergy(), evd::RawDataDrawer::HitColor(), ddthelpers::is_equal(), zcl::FastMonopoleTriggers::is_trigger_by_epoch1_fmmtrigger(), calib::Calibrator::MakeCellHit(), slid::NuEEnergyAlg::NonStdCellEnergy(), rb::operator<<(), rb::CellHit::operator==(), zcl::FastMonopoleTriggers::passed_epoch2_fmmtrigger(), ddthelpers::print(), slicer::MMSlicer::produce(), noe::noe::produce(), zcl::SPCluster::produce(), zcl::FmmTriggerEvd::produce(), murem::MergeDigits::produce(), murem::MuonRemove::produce(), jmshower::RecoJMShower::RecoShowers(), sn::LowHighADCRemover::remove(), rb::Cluster::TotalADC(), zcl::FMMTracker::Tracking2D(), dq::FlasherFinder::Veto(), zcl::FastMonopoleTriggers::WeightedCenterCut(), and zcl::FastMMStudy::WeightedCenterCut().

  {
    if(i > fADC.size()){
      printf("RawDigit::ADC(%d) out of range!\n", i);
    }
    return fADC[i];
  }

int16_t rawdata::RawDigit::ADC

(

)

const

Best estimator of the hit charge.

The DCS value appropriate for this readout version

Definition at line 67 of file RawDigit.cxx.

References ana::assert(), fADC, fVersion, daqdataformats::NanoSliceVersionConvention::getNPretriggeredSamples(), daqdataformats::NanoSliceVersionConvention::getNSamples(), and IsMC().

Referenced by NADC(), rb::CellHit::operator==(), and Version().

  {
    if(IsMC() && fVersion == 0 && fADC.size() == 3){
      // This is the old-style MC version of fast timing. ADC(0) is the DCS
      // value.
      return fADC[0];
    }

    static daqdataformats::NanoSliceVersionConvention conv;

    const unsigned int nSamples = conv.getNSamples(fVersion);
    const unsigned int nPretrig = conv.getNPretriggeredSamples(fVersion);

    assert(fADC.size() == nSamples);

    if(fVersion == 0){
      // Version zero is a single DCS value. But I don't see anywhere that
      // tells us it's DCS, so hardcode it. Check all the sizes make sense.
      assert(nSamples == 1);
      assert(nPretrig == 0);

      return fADC[0];
    }

    // Otherwise it's raw and we need to calculate the DCS value for ourselves

    // Otherwise we don't have the peak value in our dataset
    assert(nSamples > nPretrig);

    // Look back 3 samples (1.5us in the FD)
    const unsigned int kDCSDistance = 3;

    // Otherwise we don't have the baseline point in our dataset
    assert(nPretrig >= kDCSDistance);

    // The DCS value is the peak value minus the baseline value
    return fADC[nPretrig]-fADC[nPretrig-kDCSDistance];
  }

uint32_t rawdata::RawDigit::Channel ( ) const

inline

Definition at line 84 of file RawDigit.h.

References fChannel.

Referenced by sn::SupernovaAna::analyze(), slid::NuEEnergyAlg::CellEnergy(), evd::RawDataDrawer::DimFiltered(), raw2daq::RawDigit2DAQHit::FillDAQHits(), mcdatadaq::DAQSimulator::fillMicroSlices(), cmap::dataprov::CMap::GetCell(), mcdatadaq::DAQSimulator::getNanoSliceOrder(), cmap::dataprov::CMap::GetPlane(), nerd::WeightSharedHitsAlg::GetWeights(), fuzz::WeightSharedHitsAlg::GetWeights(), slid::DeconvolveAlg::GetWeights(), rb::operator<<(), rawdata::operator<<(), calib::ResizeDetector::produce(), murem::MergeDigits::produce(), evd::RawDataDrawer::RawDigit2D(), evd::RawDataDrawer::RawDigit3D(), and evd::RawDataDrawer::RawDigitHardware().

{ return fChannel;          }

uint32_t rawdata::RawDigit::DaqChannel ( ) const

inline

Definition at line 85 of file RawDigit.h.

References fDaqChannel.

Referenced by sn::DaqChannelMask::AddHit(), dprf::ChannelPlots::analyze(), dprf::TrackPlots::analyze(), febstat::EventFEBStatus::analyze(), comi::NearlineAna::analyze(), sn::DaqChannelMask::ChannelIsMasked(), dprf::ChannelPlots::FillFebRawPlots(), util::HashFunctions::Generate(), cmap::dataprov::CMap::GetCell(), calib::Calibrator::getFebType(), cmap::dataprov::CMap::GetPlane(), dq::FlasherFinder::IsInstigator(), mcdatadaq::DAQSimulator::print(), MergeTBDaqCollections::MergeTBDaqCollections::produce(), sn::DaqChannelMask::Rate(), and dq::FlasherFinder::Veto().

{ return fDaqChannel;       }

bool rawdata::RawDigit::IsMC ( ) const

inline

Definition at line 108 of file RawDigit.h.

References msf_helper::o, operator<<, and r().

Referenced by ADC(), zcl::FmmTriggerAna::analyze(), zcl::FmmTrackerValidation::analyze(), calib::Calibrator::GetTNS(), zcl::FastMonopoleTriggers::is_trigger_by_epoch1_fmmtrigger(), IsRealData(), rawdata::operator<<(), zcl::FastMonopoleTriggers::passed_epoch2_fmmtrigger(), sn::SNBackgroundRejection::produce(), and murem::MuonRemove::produce().

{ return fMCBits & (1<<31); }

bool rawdata::RawDigit::IsRealData ( ) const

inline

Definition at line 107 of file RawDigit.h.

References IsMC().

Referenced by calib::Calibrator::GetAttenScale(), cmap::dataprov::CMap::GetCell(), calib::Calibrator::GetDriftScale(), calib::Calibrator::GetPECorrToGeVScale(), cmap::dataprov::CMap::GetPlane(), calib::Calibrator::MakeCellHit(), and rawdata::operator<<().

{ return !this->IsMC();     }

uint32_t rawdata::RawDigit::NADC ( ) const

inline

Definition at line 81 of file RawDigit.h.

References ADC(), and MECModelEnuComparisons::i.

Referenced by calib::ADCShapeFitAna::analyze(), LightLevels::analyze(), rsim::FPGA_DualCorrelatedSampling::ASICToDigits(), rsim::ReadoutSim::CreateRawDigits(), raw2daq::RawDigit2DAQHit::FillDAQHits(), calib::Calibrator::GetTNS(), rawdata::operator<<(), murem::MergeDigits::produce(), and murem::MuonRemove::produce().

{ return fADC.size();       }

void rawdata::RawDigit::SetADC	(	uint32_t	i,
		int16_t	iADC
	)

Definition at line 108 of file RawDigit.cxx.

References fADC, and MECModelEnuComparisons::i.

Referenced by calib::TestParticleCorrections::analyze(), rsim::FPGA_DualCorrelatedSampling::ASICToDigits(), rsim::FPGA_MatchedFiltering::ASICToDigits(), rsim::ReadoutSim::CreateRawDigits(), daq2raw::DAQHit2Raw::FillRawDigits(), calib::Calibrator::MakeCellHit(), daq2raw::OnlineUnpack::ProcessRawEvent_(), murem::MergeDigits::produce(), murem::MuonRemove::produce(), rawp::CheckDAQChannelMap::Reco(), rawp::FillRawDigits::Reco(), and TDC().

                                                {
    if (fADC.size()<i+1) fADC.resize(i+1);
    fADC[i]=iADC;
    return;
  }

void rawdata::RawDigit::SetChannel ( uint32_t  iChan )

inline

Definition at line 99 of file RawDigit.h.

Referenced by rsim::ReadoutSim::CreateRawDigits(), daq2raw::DAQHit2Raw::FillRawDigits(), daq2raw::OnlineUnpack::ProcessRawEvent_(), cheat::MCCheater::produce(), rawp::FillRawDigits::Reco(), and rawp::CheckDAQChannelMap::Reco().

{ fChannel    = iChan;      }

void rawdata::RawDigit::SetDaqChannel ( uint32_t  iChan )

inline

Definition at line 100 of file RawDigit.h.

Referenced by rsim::ReadoutSim::CreateRawDigits(), and daq2raw::OnlineUnpack::ProcessRawEvent_().

{ fDaqChannel = iChan;      }

void rawdata::RawDigit::SetMC ( bool  isMC = true )

inline

Definition at line 106 of file RawDigit.h.

Referenced by calib::TestParticleCorrections::analyze(), calib::DriftResponseCalc::FillPeCorrHits(), daq2raw::DAQHit2Raw::FillRawDigits(), calib::MuondEdx::getPECorr(), calib::DetRespDrift::getPECorr(), calib::MuonTrackHits::getPECorr(), calib::MuondEdxAna::getPECorr(), calib::CalibAna::GetPECorr(), calib::MuonTrackHits::getPECorrToGeV(), calib::MuondEdxAna::getPECorrToGeV(), calib::CalibAna::GetPECorrToMeV(), MergeCalCollections::MergeCalCollections::produce(), MergeDaqCollections::MergeDaqCollections::produce(), murem::MergeDigits::produce(), and lem::GenFromLib::readNext().

{ if(isMC) fMCBits |= (1<<31); else fMCBits = 0; }

void rawdata::RawDigit::SetTDC

(

int32_t

iTDC

)

Definition at line 116 of file RawDigit.cxx.

References ana::assert(), and fTDC.

Referenced by rsim::FPGA_DualCorrelatedSampling::ASICToDigits(), rsim::FPGA_MatchedFiltering::ASICToDigits(), rsim::ReadoutSim::CreateRawDigits(), daq2raw::DAQHit2Raw::FillRawDigits(), daq2raw::OnlineUnpack::ProcessRawEvent_(), rawp::CheckDAQChannelMap::Reco(), rawp::FillRawDigits::Reco(), and TDC().

                                    {
    assert(fTDC.size() == 1);
    fTDC[0] = iTDC;
  }

void rawdata::RawDigit::SetVersion ( uint8_t  v )

inline

Definition at line 101 of file RawDigit.h.

References registry_explorer::v.

Referenced by rsim::FPGA_DualCorrelatedSampling::ASICToDigits(), rsim::ReadoutSim::CreateRawDigits(), and calib::Calibrator::MakeCellHit().

{ fVersion = v; }

int32_t rawdata::RawDigit::TDC ( ) const

inline

The time of the last baseline sample.

Definition at line 94 of file RawDigit.h.

References SetADC(), and SetTDC().

Referenced by calhit::CalHitAna::analyze(), sn::SupernovaAna::analyze(), pa::HitEva::analyze(), zcl::MMCheater::analyze(), zcl::FastMMStudy::analyze(), cheat::BackTracker::ClusterToParticle(), rsim::ReadoutSim::CreateRawDigits(), digi_sort(), evd::RawDataDrawer::DimFiltered(), raw2daq::RawDigit2DAQHit::FillDAQHits(), mcdatadaq::DAQSimulator::fillMicroSlices(), calib::CalibAna::FillWithCellHit(), bsf::BremShowerFilter::filter(), mono::Cluster::find(), util::HashFunctions::Generate(), mcdatadaq::DAQSimulator::getNanoSliceOrder(), calib::Calibrator::GetTNS(), mono::Cluster::hit_is_in_time_with_road(), evd::RawDataDrawer::HitColor(), sn::HighEnergyRemover::HitInTDCVetoWindow(), cheat::BackTracker::HitToParticlesMap(), ddthelpers::is_equal(), dq::FlasherFinder::IsInstigator(), mono::Cluster::make(), murem::FindParent::MatchToOrigSlice(), rb::operator<<(), rb::CellHit::operator==(), ddthelpers::print(), mcdatadaq::DAQSimulator::print(), noe::noe::produce(), MergeDaqCollections::MergeDaqCollections::produce(), murem::MuonRemove::produce(), evd::RawDataDrawer::RawDigit2D(), evd::RawDataDrawer::RawDigit3D(), evd::RawDataDrawer::RawDigitHardware(), mono::Track::Track(), dq::FlasherFinder::Veto(), moonshadowana::MoonShadowAna::WriteHitListInfo(), and moonshadowana::MoonShadowAnaHough::WriteHitListInfo().

{ return fTDC[0];           }

uint8_t rawdata::RawDigit::Version ( ) const

inline

Definition at line 87 of file RawDigit.h.

References ADC(), and fVersion.

Referenced by calib::Calibrator::GetTNS(), calib::Calibrator::MakeCellHit(), rawdata::operator<<(), murem::MergeDigits::produce(), and murem::MuonRemove::produce().

{ return fVersion;          }

Friends And Related Function Documentation

std::ostream& operator<< ( std::ostream &  o, const RawDigit &  r  )

friend

Definition at line 122 of file RawDigit.cxx.

Referenced by IsMC().

  {
    if(r.IsMC()){
      o << std::setiosflags(std::ios::fixed) << std::setprecision(2);
      o << " Version = "     << std::setw(5) << std::right << (int)r.Version()
        << " NADC = "        << std::setw(5) << std::right << r.NADC();
    }    
    else if (r.IsRealData()){
      o << std::setiosflags(std::ios::fixed) << std::setprecision(2);
      o << " Channel = "     << std::setw(5) << std::right << r.Channel()
        << " Version = "     << std::setw(5) << std::right << (int)r.Version()
        << " NADC = "        << std::setw(5) << std::right << r.NADC();
    }     
    return o;
  }

Member Data Documentation

std::vector<int16_t> rawdata::RawDigit::fADC

list of ADC(-like) charge values

Definition at line 49 of file RawDigit.h.

Referenced by ADC(), calib::Calibrator::MakeCellHit(), SetADC(), and rb::standard_compare().

uint32_t rawdata::RawDigit::fChannel

private

channel ID

Definition at line 57 of file RawDigit.h.

Referenced by Channel().

uint32_t rawdata::RawDigit::fDaqChannel

private

DAQ readout channel.

Definition at line 58 of file RawDigit.h.

Referenced by DaqChannel().

bool rawdata::RawDigit::fDataPresent

Definition at line 45 of file RawDigit.h.

Referenced by daq2raw::OnlineUnpack::ProcessRawEvent_().

bool rawdata::RawDigit::fDebugMode

Definition at line 44 of file RawDigit.h.

Referenced by daq2raw::OnlineUnpack::ProcessRawEvent_().

uint8_t rawdata::RawDigit::fFEBStatus

Definition at line 43 of file RawDigit.h.

Referenced by febstat::EventFEBStatus::analyze(), and daq2raw::OnlineUnpack::ProcessRawEvent_().

uint8_t rawdata::RawDigit::fFrameSequenceNumber

Definition at line 39 of file RawDigit.h.

Referenced by daq2raw::OnlineUnpack::ProcessRawEvent_(), and ~RawDigit().

bool rawdata::RawDigit::fLinkStatus

Definition at line 46 of file RawDigit.h.

Referenced by daq2raw::OnlineUnpack::ProcessRawEvent_().

uint32_t rawdata::RawDigit::fMCBits

private

status bits for MC information

Definition at line 70 of file RawDigit.h.

uint16_t rawdata::RawDigit::fReserved

Should be 0xCAFE.

Definition at line 47 of file RawDigit.h.

Referenced by daq2raw::OnlineUnpack::ProcessRawEvent_().

std::vector<int32_t> rawdata::RawDigit::fTDC

TDC(-like) time value. Event time is subtracted. Vector structure is a historical artifact.

Definition at line 50 of file RawDigit.h.

Referenced by rb::CellHit::operator==(), SetTDC(), and rb::standard_compare().

uint8_t rawdata::RawDigit::fVersion

NanoSlice version.

Definition at line 52 of file RawDigit.h.

Referenced by ADC(), daq2raw::OnlineUnpack::ProcessRawEvent_(), and Version().

---

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

• /cvmfs/nova-development.opensciencegrid.org/novasoft/releases/N21-05-06/RawData/RawDigit.h
• /cvmfs/nova-development.opensciencegrid.org/novasoft/releases/N21-05-06/RawData/RawDigit.cxx