Versions Compared

Old Version 82

changes.mady.by.user Mark Arndt

Saved on

compared with

New Version 83

changes.mady.by.user Mark Arndt

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

Draft, in work.

Table of Contents

Include Page
Xtc Topic Map
Xtc Topic Map

Generating Xtc

For tutorial purposes, the following streamlined example shows XXX. For an example involving more detectors, formats and algorithms, see xtcdata/xtcdata/app/xtcwriter.cc.

A Notional DAQ Harness

Let's motivate the example. Assume we're developing a an Xtc writer class to output CSPAD data. This class will get plugged in to a (notional) DAQ framework.

Code Block
languagecpp
linenumberstrue
# Assume some totally made-up data acquisition callback framework named DAQFramework
# Developers of the psdaq package are welcome to come in and change this toy example
# to match the real DAQ API.

CSPADXtcWriter padwriter()

DAQFramework.registerHandler("configure", padwriter.setup)
DAQFramework.registerHandler("runstart", padwriter.setup)
DAQFramework.registerHandler("readout", padwriter.writeImage)
DAQFramework.registerHandler("runend", padwriter.writeFile)

"setup" Method: Set Up The Names Structure

Deck of Cards
idsetup
Card
defaulttrue
labelCoding Steps

Register the algorithms and "shape" of the data associated with detector elements to tell the processing pipeline how to process the data.

  1. First some plumbing...
    1. Create an XtcData:Dgram as the root container.
  2. Next code sample description.

 

Card
idsetuptldr
labelTL;DR
Panel

At some initialization step, for example in response to a DAQ configure signal:

  • Subclass XtcData::VarDef to build a data structure specific to the detector in question.

 

 

"writeImage" Method: Add Readout Data

 

 

Parsing Whole Xtc Files

xtcreader.cc and XtcIterator.hh

 

Use of Xtc Small Data Files

this might be duplicate of what's on top page

Notes for Real-World Code

Xtc Writers in the Wild

  • (You'll likely need to sub-class from XYZ in order to ABC)

Xtc Readers in the Wild

  • (You'll likely need to sub-class from XYZ in order to ABC)

Full "Hello Xtc" Code Listing, CSPADXtcWriter Example

Code Block
languagecpp
linenumberstrue
CSPADXtcWriter::CSPADXtcWriter()
{

	#// Squirrel away algorithm definitions in a VarDef
	class PadDef:public VarDef
	{
		enum index
			{
				arrayRaw
			};

		PadDef()
			{
				Alg segmentAlg("caspadseg",2,3,42); // alg name, major, minor, patch)	
				#// We get a NameVec by subclassing from VarDef
				NameVec.push_back({"arrayRaw", segmentAlg});
			}
	
	} PadDef;
}



void CSPADXtcWriter::setup()
{

}

void CSPADXtcWriter::writeImage()
{


}

void CSPADXtcWriter::writeFile()
{


}