pflib::packing::MultiSampleECONDEventPacket Class Reference

Unpack an event that has potentially more than one sample collected from a single ECOND. More...

#include <MultiSampleECONDEventPacket.h>

Collaboration diagram for pflib::packing::MultiSampleECONDEventPacket:

Public Member Functions
const ECONDEventPacket &	soi () const
	get the sample of interest
	MultiSampleECONDEventPacket (int n_links)
	constructor defining how many links are connected to this ECOND
void	from (std::span< uint32_t > data, bool expect_ldmx_ror_header=false)
	unpack the given data into this structure
Reader &	read (Reader &r)
	read into this structure from the input Reader
void	to_csv (std::ofstream &f, const SingleECONDRocErxMapping *mapping=nullptr) const
	write out all of the samples into the input CSV file

Public Attributes
std::size_t	i_soi
	index of the sample of interest (SOI)
int	econd_id
	ID for this econ.
int	contrib_id
	contributor ID
int	subsys_id
	subsystem ID
uint64_t	timestamp
	timestamp from RoR
std::vector< ECONDEventPacket >	samples
	samples from ECOND stored in order of transmission

Static Public Attributes
static const std::string	to_csv_header
	header string if using MultiSampleECONDEventPacket::to_csv
static const std::string	to_csv_header_with_mapping
	header string if using MultiSampleECONDEventPacket::to_csv with an input mapping

Private Attributes
mutable::pflib::logging::logger	the_log_ {::pflib::logging::get("decoding")}
	handle to logging source
int	n_links_
	number of links connected to the ECOND

Detailed Description

Unpack an event that has potentially more than one sample collected from a single ECOND.

See also

ECONDEventPacket for how a single sample from a single ECOND is unpacked.

Note

This unpacking is not well tested and may change depending on how the firmware/software progresses. The current draft was written using TargetFiberless::read_event as a reference.

Member Function Documentation

from()

void pflib::packing::MultiSampleECONDEventPacket::from	(	std::span< uint32_t >	data,
		bool	expect_ldmx_ror_header = false )

unpack the given data into this structure

the ldmx ror header inserts 4 32-bit words (16 bytes) of the form

0xA5 | 8b contrib | 8b subsys | 8b VERS = 0 32b 0 64b timestamp

read()

Reader & pflib::packing::MultiSampleECONDEventPacket::read

(

Reader &

r

)

read into this structure from the input Reader

DANGER Without signal header/trailer words, this assumes that the data stream is word aligned and we aren't starting on the wrong word.

to_csv()

void pflib::packing::MultiSampleECONDEventPacket::to_csv	(	std::ofstream &	f,
		const SingleECONDRocErxMapping *	mapping = nullptr ) const

write out all of the samples into the input CSV file

Parameters

[in]	f	output file stream to write rows into
[in]	mapping	if provided, use the input mapping to convert the (i_erx, i_ch) indices into (i_roc, ch indices)

Note

This changes the channel-labeling columns and so the MultiSampleECONDEventPacket::to_csv_header_with_mapping should be used instead of MultiSampleECONDEventPacket::to_csv_header when writing the column header row in the output CSV file

The columns of the output CSV are

timestamp,orbit,bx,event,i_sample,i_link,channel,Tp,Tc,adc_tm1,adc,tot,toa

where i_link is the index of the active eRx being read out and channel ranges from 0 to 35 or is "calib" if a mapping is not provided (mapping == nullptr) and

timestamp,orbit,bx,event,i_sample,i_roc,channel,Tp,Tc,adc_tm1,adc,tot,toa

where i_roc is the index of the ROC that is read out and channel ranges from 0 to 71 or is "calib_<half>". if a mapping is provided (mapping != nullptr).

Member Data Documentation

to_csv_header

const std::string pflib::packing::MultiSampleECONDEventPacket::to_csv_header

static

Initial value:

=
    "timestamp,orbit,bx,event,i_sample,i_link,channel,Tp,Tc,adc_tm1,adc,tot,"
    "toa"

header string if using MultiSampleECONDEventPacket::to_csv

to_csv_header_with_mapping

const std::string pflib::packing::MultiSampleECONDEventPacket::to_csv_header_with_mapping

static

Initial value:

=
    "timestamp,orbit,bx,event,i_sample,i_roc,channel,Tp,Tc,adc_tm1,adc,tot,"
    "toa"

header string if using MultiSampleECONDEventPacket::to_csv with an input mapping

---

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

• include/pflib/packing/MultiSampleECONDEventPacket.h
• src/pflib/packing/MultiSampleECONDEventPacket.cxx