CbmRoot
Loading...
Searching...
No Matches
CbmFsdDigitize Class Reference

Class for the digitization of the CBM-FSD. More...

#include <CbmFsdDigitize.h>

Inheritance diagram for CbmFsdDigitize:
[legend]
Collaboration diagram for CbmFsdDigitize:
[legend]

Public Types

typedef std::pair< std::unique_ptr< CbmFsdDigi >, std::unique_ptr< CbmMatch > > Data
 Short for data to be handled (pair of digi and match)
 

Public Member Functions

 CbmFsdDigitize ()
 
virtual ~CbmFsdDigitize ()=default
 
 CbmFsdDigitize (const CbmFsdDigitize &)=delete
 
CbmFsdDigitize operator= (const CbmFsdDigitize &)=delete
 
ECbmModuleId GetSystemId () const
 Detector system ID.
 
virtual InitStatus Init ()
 Inherited from FairTask.
 
virtual void SetParContainers ()
 Inherited from FairTask.
 
virtual void Exec (Option_t *opt)
 
virtual void Finish ()
 End-of-run action.
 
Bool_t CheckOutput ()
 Check the output for being time-sorted.
 
Double_t GetLatency () const
 Return the detector specific latency @value latency.
 
void ClearOutput ()
 Clear the output arrays.
 
ULong64_t FillTimeSlice (CbmTimeSlice *timeSlice)
 Move data from the DaqBuffer into the current time slice.
 
ULong64_t FillTimeSlice (CbmTimeSlice *timeSlice, Double_t fillTime)
 Move data from the DaqBuffer into the current time slice.
 
ULong64_t GetDaqBufferSize () const
 Size of DAQ buffer @value Number of data in the DAQ buffer.
 
std::string GetDaqBufferStatus () const
 Debug output of DAQ buffer status @value String with status of DAQ buffer.
 
Double_t GetDaqBufferTimeFirst () const
 Time stamp of first data in the DAQ buffer @value Time stamp of first data in the DAQ buffer.
 
Double_t GetDaqBufferTimeLast () const
 Time stamp of last data in the DAQ buffer @value Time stamp of last data in the DAQ buffer.
 
void RegisterOutput ()
 Register the output arrays.
 
void SendData (Double_t time, CbmFsdDigi *digi, CbmMatch *match=nullptr)
 Send a digi and the corresponding match object to the DAQ.
 
virtual void FillCustomData (Double_t, Bool_t=kTRUE)
 Fill custom data into time slice.
 
void GetEventInfo ()
 Get event information.
 
Double_t GetEventTime () const
 Current event time @value Start time of current event [ns].
 
void SetCreateMatches (Bool_t choice=kTRUE)
 Set creation of links to MC.
 
void SetEventMode (Bool_t choice=kTRUE)
 Set event-by-event mode.
 
void SetInactiveChannelFile (const char *fileName)
 Set the file containing the list of inactive channels.
 
void SetProduceNoise (Bool_t choice=kTRUE)
 Set production of inter-event noise.
 
void SetRunStartTime (Double_t time)
 Set the run start time.
 

Protected Member Functions

virtual std::pair< size_t, bool > ReadInactiveChannels ()
 Set of inactive channels, indicated by CbmAddress.
 

Protected Attributes

Bool_t fEventMode
 
Bool_t fProduceNoise
 Flag for event-by-event mode.
 
Bool_t fCreateMatches
 Flag for production of inter-event noise.
 
Double_t fRunStartTime = 0
 Flag for creation of links to MC.
 
Int_t fCurrentInput
 Start time of run [ns].
 
Int_t fCurrentEvent
 Number of current input.
 
Int_t fCurrentMCEntry
 Number of current MC event.
 
Double_t fCurrentEventTime
 Number of current MC entry.
 
TString fInactiveChannelFileName = ""
 Time of current MC event [ns].
 
std::set< uint32_t > fInactiveChannels = {}
 Name of file with inactive channels.
 

Private Member Functions

void InitParams ()
 Initialise the parameters.
 
void ReleaseBuffer (Bool_t sendEverything)
 release digi from local buffer to CbmDaq TIME BASED
 
 ClassDef (CbmFsdDigitize, 1)
 
ULong64_t FillTimeSlice (CbmTimeSlice *timeSlice, Bool_t checkLimit, Double_t fillTime)
 Move data from the DaqBuffer into the current time slice.
 
bool IsChannelActive (const CbmFsdDigi &digi)
 Test if the channel of a digi object is set active.
 

Private Attributes

CbmFsdDigiParfDigiPar = nullptr
 
Int_t fNumPhotoDets = -1
 
Int_t fNumUnits = -1
 
TArrayD fTimeResolution {}
 
TArrayD fEnergyResolution {}
 
TArrayD fDeadTime {}
 
Int_t fNumEvents = 0
 
Double_t fNumPoints = 0.
 
Double_t fNumDigis = 0.
 
Double_t fTimeTot = 0.
 
TClonesArray * fPointArray = nullptr
 
std::map< int32_t, std::pair< CbmFsdDigi *, CbmMatch * > > fDigiBuffer
 
TString fBranchName
 Output branch name.
 
std::vector< CbmFsdDigi > * fDigis
 
std::vector< CbmMatch > * fMatches
 Output array (Digi)
 
std::multimap< double, DatafDaqBuffer
 Output array (CbmMatch)
 

Detailed Description

Class for the digitization of the CBM-FSD.

Date
14.07.2023
Author
Lukas Chlad l.chl.nosp@m.ad@g.nosp@m.si.de

The digitizer produces digits of type CbmFsdDigi as sum of Edep of Points and adds smearing in energy and time according to parameters

Definition at line 27 of file CbmFsdDigitize.h.

Member Typedef Documentation

◆ Data

std::pair<std::unique_ptr<CbmFsdDigi>, std::unique_ptr<CbmMatch> > CbmDigitize< CbmFsdDigi >::Data
inherited

Short for data to be handled (pair of digi and match)

Definition at line 48 of file CbmDigitize.h.

Constructor & Destructor Documentation

◆ CbmFsdDigitize() [1/2]

CbmFsdDigitize::CbmFsdDigitize ( )
inline

Default constructor

Definition at line 31 of file CbmFsdDigitize.h.

◆ ~CbmFsdDigitize()

virtual CbmFsdDigitize::~CbmFsdDigitize ( )
virtualdefault

Destructor

◆ CbmFsdDigitize() [2/2]

CbmFsdDigitize::CbmFsdDigitize ( const CbmFsdDigitize & )
delete

Member Function Documentation

◆ CheckOutput()

Bool_t CbmDigitize< CbmFsdDigi >::CheckOutput ( )
inlinevirtualinherited

Check the output for being time-sorted.

Implements CbmDigitizeBase.

Definition at line 67 of file CbmDigitize.h.

◆ ClassDef()

CbmFsdDigitize::ClassDef ( CbmFsdDigitize ,
1  )
private

◆ ClearOutput()

void CbmDigitize< CbmFsdDigi >::ClearOutput ( )
inlinevirtualinherited

Clear the output arrays.

Implements CbmDigitizeBase.

Definition at line 96 of file CbmDigitize.h.

◆ Exec()

◆ FillCustomData()

virtual void CbmDigitizeBase::FillCustomData ( Double_t ,
Bool_t = kTRUE )
inlinevirtualinherited

Fill custom data into time slice.

Parameters
fillTimeTime until data can be filled
limitIf kTRUE, only data up to fillTime will be treated; otherwise, all.

This method allows the digitizer to implement additional functionality than writing digis and match objects. It will be called from CbmDaq.

Definition at line 75 of file CbmDigitizeBase.h.

◆ FillTimeSlice() [1/3]

ULong64_t CbmDigitize< CbmFsdDigi >::FillTimeSlice ( CbmTimeSlice * timeSlice)
inlinevirtualinherited

Move data from the DaqBuffer into the current time slice.

Parameters
timeSlicePointer to current time slice object @value Number of digi objects filled into the time slice.

For regular time slices, all data with time stamp within the interval of the current time slice are moved from the buffer to the time slice. For time slices of type kFlexible or kEvent, all data will be moved.

Implements CbmDigitizeBase.

Definition at line 114 of file CbmDigitize.h.

◆ FillTimeSlice() [2/3]

ULong64_t CbmDigitize< CbmFsdDigi >::FillTimeSlice ( CbmTimeSlice * timeSlice,
Bool_t checkLimit,
Double_t fillTime )
inlineprivateinherited

Move data from the DaqBuffer into the current time slice.

Parameters
timeSlicePointer to current time slice object
fillTimeTime up to which data will be moved [ns] @value Number of digi objects filled into the time slice.

For regular time slices, all data with time stamp within the interval of the current time slice are moved from the buffer to the time slice. For time slices of type kFlexible or kEvent, all data will be moved.

If checkLimit is selected, only data with time stamp less than fillTime are moved.

Definition at line 273 of file CbmDigitize.h.

◆ FillTimeSlice() [3/3]

ULong64_t CbmDigitize< CbmFsdDigi >::FillTimeSlice ( CbmTimeSlice * timeSlice,
Double_t fillTime )
inlinevirtualinherited

Move data from the DaqBuffer into the current time slice.

Parameters
timeSlicePointer to current time slice object
fillTimeTime up to which data will be moved [ns] @value Number of digi objects filled into the time slice.

Move data with time stamp up to fillTime from the buffer to the time slice. For regular time slices, only data with time stamp within the time slice interval will be moved. For time slices of type kFlexible or kEvent, all data up to fillTime will be moved.

Implements CbmDigitizeBase.

Definition at line 129 of file CbmDigitize.h.

◆ Finish()

void CbmFsdDigitize::Finish ( )
virtual

End-of-run action.

Definition at line 227 of file CbmFsdDigitize.cxx.

References CbmDigitizeBase::fEventMode, fNumDigis, fNumEvents, fNumPoints, fTimeTot, and ReleaseBuffer().

◆ GetDaqBufferSize()

ULong64_t CbmDigitize< CbmFsdDigi >::GetDaqBufferSize ( ) const
inlinevirtualinherited

Size of DAQ buffer @value Number of data in the DAQ buffer.

Implements CbmDigitizeBase.

Definition at line 140 of file CbmDigitize.h.

◆ GetDaqBufferStatus()

std::string CbmDigitize< CbmFsdDigi >::GetDaqBufferStatus ( ) const
inlinevirtualinherited

Debug output of DAQ buffer status @value String with status of DAQ buffer.

Implements CbmDigitizeBase.

Definition at line 148 of file CbmDigitize.h.

◆ GetDaqBufferTimeFirst()

Double_t CbmDigitize< CbmFsdDigi >::GetDaqBufferTimeFirst ( ) const
inlinevirtualinherited

Time stamp of first data in the DAQ buffer @value Time stamp of first data in the DAQ buffer.

Implements CbmDigitizeBase.

Definition at line 162 of file CbmDigitize.h.

◆ GetDaqBufferTimeLast()

Double_t CbmDigitize< CbmFsdDigi >::GetDaqBufferTimeLast ( ) const
inlinevirtualinherited

Time stamp of last data in the DAQ buffer @value Time stamp of last data in the DAQ buffer.

Implements CbmDigitizeBase.

Definition at line 174 of file CbmDigitize.h.

◆ GetEventInfo()

void CbmDigitizeBase::GetEventInfo ( )
inherited

Get event information.

MC input number, entry number and event time are taken from FairEventHeader and stored in the private data members for convenience. Note that the MC entry number need not coincide with the event number, for instance if the run does not start with the first MC entry, or in the case of mixed MC inputs to digitization.

Definition at line 57 of file CbmDigitizeBase.cxx.

References CbmDigitizeBase::fCurrentEvent, CbmDigitizeBase::fCurrentEventTime, CbmDigitizeBase::fCurrentInput, and CbmDigitizeBase::fCurrentMCEntry.

Referenced by CbmBmonDigitize::Exec(), Exec(), CbmMuchDigitizeGem::Exec(), CbmMvdDigitizer::Exec(), CbmPsdSimpleDigitizer::Exec(), CbmRichDigitizer::Exec(), CbmStsDigitize::Exec(), CbmStsDigitizePixel::Exec(), CbmTofDigitize::Exec(), and CbmTrdDigitizer::Exec().

◆ GetEventTime()

Double_t CbmDigitizeBase::GetEventTime ( ) const
inlineinherited

Current event time @value Start time of current event [ns].

Definition at line 113 of file CbmDigitizeBase.h.

References CbmDigitizeBase::fCurrentEventTime.

◆ GetLatency()

Double_t CbmDigitize< CbmFsdDigi >::GetLatency ( ) const
inlinevirtualinherited

Return the detector specific latency @value latency.

If there is no detector sopecific implementation the return value is 0. which does not change the default value set in CbmDaq.

Implements CbmDigitizeBase.

Definition at line 92 of file CbmDigitize.h.

◆ GetSystemId()

ECbmModuleId CbmFsdDigitize::GetSystemId ( ) const
inlinevirtual

Detector system ID.

Returns
Detector system ID [ECbmModuleId]

Implements CbmDigitizeBase.

Definition at line 39 of file CbmFsdDigitize.h.

References kFsd.

◆ Init()

InitStatus CbmFsdDigitize::Init ( )
virtual

◆ InitParams()

◆ IsChannelActive()

bool CbmDigitize< CbmFsdDigi >::IsChannelActive ( const CbmFsdDigi & digi)
inlineprivateinherited

Test if the channel of a digi object is set active.

Parameters
digiobject
Returns
.true. if the respective channel is active

Definition at line 350 of file CbmDigitize.h.

◆ operator=()

CbmFsdDigitize CbmFsdDigitize::operator= ( const CbmFsdDigitize & )
delete

◆ ReadInactiveChannels()

std::pair< size_t, bool > CbmDigitizeBase::ReadInactiveChannels ( )
protectedvirtualinherited

Set of inactive channels, indicated by CbmAddress.

Read the list of inactive channels from file

Parameters
fileNameFile name
Returns
Number of channels read from file, success of file reading

Reading from the file will stop when a read error occurs. In that case, or when the file could not be opened at all, the success flag will be .false.

Reimplemented in CbmStsDigitize.

Definition at line 80 of file CbmDigitizeBase.cxx.

References CbmDigitizeBase::fInactiveChannelFileName, and CbmDigitizeBase::fInactiveChannels.

Referenced by CbmBmonDigitize::Init(), CbmMuchDigitizeGem::Init(), CbmMvdDigitizer::Init(), CbmPsdSimpleDigitizer::Init(), CbmRichDigitizer::Init(), CbmTofDigitize::Init(), and CbmTrdDigitizer::Init().

◆ RegisterOutput()

void CbmDigitize< CbmFsdDigi >::RegisterOutput ( )
inlineinherited

Register the output arrays.

Arrays for the digis and the match objects will be created and registered as output to the ROOT tree. The current implementation uses std::vector as container.

Definition at line 189 of file CbmDigitize.h.

Referenced by Init().

◆ ReleaseBuffer()

void CbmFsdDigitize::ReleaseBuffer ( Bool_t sendEverything)
private

release digi from local buffer to CbmDaq TIME BASED

  • at the beginning of MCEvent loop over digi buffer and send those digis that are too far from start of current event to be possibly edited free the location of sent digis
  • at the end of whole run do the same only send everything, clear buffer

EVENT BASED

  • at the beginning of MCEvent loop send everything, clear buffer

Definition at line 244 of file CbmFsdDigitize.cxx.

References CbmDigitizeBase::fCreateMatches, CbmDigitizeBase::fCurrentEventTime, fDeadTime, fDigiBuffer, CbmFsdAddress::GetElementId(), CbmFsdDigi::GetTime(), CbmDigitize< CbmFsdDigi >::SendData(), and CbmFsdAddress::Unit.

Referenced by Exec(), and Finish().

◆ SendData()

void CbmDigitize< CbmFsdDigi >::SendData ( Double_t time,
CbmFsdDigi * digi,
CbmMatch * match = nullptr )
inlineinherited

Send a digi and the corresponding match object to the DAQ.

Parameters
timeGlobal time of the digi
digiPointer to digi object (template parameter)
matchPointer to match object

Time is passed as a seperate parameter because the global time might be too large for some digi classes to store internally. So digis are not required to have a valid timestamp at this point. Later on when the time slices are known, the timestamp is overwritten with the relative time to the beginning of the time slice.

TODO: The interface should be unique pointers, meaning that the digitisers have to create objects by unique pointers from the start.

Definition at line 237 of file CbmDigitize.h.

Referenced by Exec(), and ReleaseBuffer().

◆ SetCreateMatches()

void CbmDigitizeBase::SetCreateMatches ( Bool_t choice = kTRUE)
inlineinherited

Set creation of links to MC.

Parameters
ChoiceIf kTRUE, the match objects will be created

Definition at line 154 of file CbmDigitizeBase.h.

References CbmDigitizeBase::fCreateMatches.

Referenced by CbmStsDigitizePixel::Init(), and CbmDigitization::Run().

◆ SetEventMode()

void CbmDigitizeBase::SetEventMode ( Bool_t choice = kTRUE)
inlineinherited

Set event-by-event mode.

Parameters
ChoiceIf kTRUE, the digitizer will run in event-by-event mode

Definition at line 160 of file CbmDigitizeBase.h.

References CbmDigitizeBase::fEventMode.

Referenced by CbmDigitization::Run().

◆ SetInactiveChannelFile()

void CbmDigitizeBase::SetInactiveChannelFile ( const char * fileName)
inlineinherited

Set the file containing the list of inactive channels.

Parameters
fileNameName of file

Channels are identified by their CbmAddress. The file must contain a list of addresses, one per line. Comments after the address are allowed if separated by a blank.

Definition at line 169 of file CbmDigitizeBase.h.

References CbmDigitizeBase::fInactiveChannelFileName.

◆ SetParContainers()

void CbmFsdDigitize::SetParContainers ( )
virtual

Inherited from FairTask.

Definition at line 79 of file CbmFsdDigitize.cxx.

References fDigiPar.

◆ SetProduceNoise()

void CbmDigitizeBase::SetProduceNoise ( Bool_t choice = kTRUE)
inlineinherited

Set production of inter-event noise.

Parameters
ChoiceIf kTRUE, the digitizer will produce noise

Definition at line 175 of file CbmDigitizeBase.h.

References CbmDigitizeBase::fProduceNoise.

Referenced by CbmDigitization::Run().

◆ SetRunStartTime()

void CbmDigitizeBase::SetRunStartTime ( Double_t time)
inlineinherited

Set the run start time.

Parameters
Runstart time [ns]

Definition at line 181 of file CbmDigitizeBase.h.

References CbmDigitizeBase::fRunStartTime.

Referenced by CbmDigitization::Run().

Member Data Documentation

◆ fBranchName

TString CbmDigitize< CbmFsdDigi >::fBranchName
privateinherited

Output branch name.

Definition at line 248 of file CbmDigitize.h.

◆ fCreateMatches

◆ fCurrentEvent

◆ fCurrentEventTime

◆ fCurrentInput

◆ fCurrentMCEntry

◆ fDaqBuffer

std::multimap<double, Data> CbmDigitize< CbmFsdDigi >::fDaqBuffer
privateinherited

Output array (CbmMatch)

DAQ buffer. Here, the digis and matches are buffered until they are filled into the time slice output (ROOT branch). The map key is the digi time.

Definition at line 257 of file CbmDigitize.h.

◆ fDeadTime

TArrayD CbmFsdDigitize::fDeadTime {}
private

Definition at line 67 of file CbmFsdDigitize.h.

Referenced by Exec(), InitParams(), and ReleaseBuffer().

◆ fDigiBuffer

std::map<int32_t, std::pair<CbmFsdDigi*, CbmMatch*> > CbmFsdDigitize::fDigiBuffer
private

Definition at line 78 of file CbmFsdDigitize.h.

Referenced by Exec(), and ReleaseBuffer().

◆ fDigiPar

CbmFsdDigiPar* CbmFsdDigitize::fDigiPar = nullptr
private

Definition at line 61 of file CbmFsdDigitize.h.

Referenced by InitParams(), and SetParContainers().

◆ fDigis

std::vector<CbmFsdDigi>* CbmDigitize< CbmFsdDigi >::fDigis
privateinherited

Definition at line 249 of file CbmDigitize.h.

◆ fEnergyResolution

TArrayD CbmFsdDigitize::fEnergyResolution {}
private

Definition at line 66 of file CbmFsdDigitize.h.

Referenced by Exec(), and InitParams().

◆ fEventMode

◆ fInactiveChannelFileName

◆ fInactiveChannels

std::set<uint32_t> CbmDigitizeBase::fInactiveChannels = {}
protectedinherited

◆ fMatches

std::vector<CbmMatch>* CbmDigitize< CbmFsdDigi >::fMatches
privateinherited

Output array (Digi)

Definition at line 250 of file CbmDigitize.h.

◆ fNumDigis

Double_t CbmFsdDigitize::fNumDigis = 0.
private

Definition at line 71 of file CbmFsdDigitize.h.

Referenced by Exec(), Finish(), and Init().

◆ fNumEvents

Int_t CbmFsdDigitize::fNumEvents = 0
private

Definition at line 69 of file CbmFsdDigitize.h.

Referenced by Exec(), Finish(), and Init().

◆ fNumPhotoDets

Int_t CbmFsdDigitize::fNumPhotoDets = -1
private

Definition at line 63 of file CbmFsdDigitize.h.

Referenced by Exec(), and InitParams().

◆ fNumPoints

Double_t CbmFsdDigitize::fNumPoints = 0.
private

Definition at line 70 of file CbmFsdDigitize.h.

Referenced by Exec(), Finish(), and Init().

◆ fNumUnits

Int_t CbmFsdDigitize::fNumUnits = -1
private

Definition at line 64 of file CbmFsdDigitize.h.

Referenced by InitParams().

◆ fPointArray

TClonesArray* CbmFsdDigitize::fPointArray = nullptr
private

Input array of CbmFsdPoints

Definition at line 75 of file CbmFsdDigitize.h.

Referenced by Exec(), and Init().

◆ fProduceNoise

Bool_t CbmDigitizeBase::fProduceNoise
protectedinherited

◆ fRunStartTime

Double_t CbmDigitizeBase::fRunStartTime = 0
protectedinherited

Flag for creation of links to MC.

Definition at line 188 of file CbmDigitizeBase.h.

Referenced by CbmRichDigitizer::Exec(), CbmStsDigitize::Exec(), and CbmDigitizeBase::SetRunStartTime().

◆ fTimeResolution

TArrayD CbmFsdDigitize::fTimeResolution {}
private

Definition at line 65 of file CbmFsdDigitize.h.

Referenced by Exec(), and InitParams().

◆ fTimeTot

Double_t CbmFsdDigitize::fTimeTot = 0.
private

Definition at line 72 of file CbmFsdDigitize.h.

Referenced by Exec(), Finish(), and Init().


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