gstreamer
Loading...
Searching...
No Matches
Public Member Functions
GstreamerRootFactory Class Reference
gstreamer module » ROOT streamer plugin

ROOT plugin writing event and run content into TTree objects stored in one TFile. More...

#include <gstreamerROOTFactory.h>

Public Member Functions

 GStreamer (const std::shared_ptr< GOptions > &g)
 Inherit the constructor taking the parsed options container.
 
- Public Member Functions inherited from GStreamer
 GStreamer (const std::shared_ptr< GOptions > &g)
 Construct the streamer base and initialize module logging.
 
virtual ~GStreamer ()=default
 Virtual destructor.
 
bool closeConnection ()
 Close the output medium after flushing buffered events.
 
void publishEventData (const std::shared_ptr< GEventDataCollection > &event_data)
 Queue one event for publication.
 
void publishRunData (const std::shared_ptr< GRunDataCollection > &run_data)
 Publish one run-level data collection immediately.
 
std::string getStreamType () const
 Return the semantic stream type associated with this streamer instance.
 
void define_gstreamer (const GStreamerDefinition &gstreamerDefinition, int tid=-1)
 Assign the output definition used by this streamer instance.
 
void set_loggers (const std::shared_ptr< GOptions > &g)
 Load streamer runtime settings from the parsed options container.
 
- Public Member Functions inherited from GBase< GStreamer >
 GBase (const std::shared_ptr< GOptions > &gopt, std::string logger_name="")
 
 GBase (const std::shared_ptr< GLogger > &logger)
 
 GBase (const GBase &)=default
 
 GBase (GBase &&) noexcept=default
 
virtual ~GBase ()
 
GBase & operator= (const GBase &)=default
 
GBase & operator= (GBase &&) noexcept=default
 

Additional Inherited Members

- Static Public Member Functions inherited from GStreamer
static const std::vector< std::string > & supported_formats ()
 Return the list of output format tokens supported by the module.
 
static bool is_valid_format (const std::string &format)
 Validate whether a format token is supported.
 
static GStreamer * instantiate (const dlhandle h, std::shared_ptr< GOptions > g)
 Instantiate a streamer plugin from a dynamic library handle.
 
- Protected Member Functions inherited from GStreamer
bool startEvent (const std::shared_ptr< GEventDataCollection > &event_data)
 Begin publishing one buffered event.
 
bool endEvent (const std::shared_ptr< GEventDataCollection > &event_data)
 End publishing one buffered event.
 
bool publishEventHeader (const std::unique_ptr< GEventHeader > &gevent_header)
 Publish the event header for the current event sequence.
 
bool publishEventTrueInfoData (const std::string &detectorName, const std::vector< const GTrueInfoData * > &trueInfoData)
 Publish the true-information hit bank for one detector.
 
bool publishEventDigitizedData (const std::string &detectorName, const std::vector< const GDigitizedData * > &digitizedData)
 Publish the digitized hit bank for one detector.
 
bool startRun (const std::shared_ptr< GRunDataCollection > &run_data)
 Begin publishing one run-level collection.
 
bool endRun (const std::shared_ptr< GRunDataCollection > &run_data)
 End publishing one run-level collection.
 
bool publishRunHeader (const std::unique_ptr< GRunHeader > &run_header)
 Publish the run header for the current run sequence.
 
bool publishRunDigitizedData (const std::string &detectorName, const std::vector< const GDigitizedData * > &digitizedData)
 Publish run-level digitized data for one detector.
 
bool startStream (const GFrameDataCollection *frameRunData)
 Begin publishing one frame stream record.
 
bool publishFrameHeader (const GFrameHeader *gframeHeader)
 Publish one frame header.
 
bool publishPayload (const std::vector< GIntegralPayload * > *payload)
 Publish one frame payload.
 
bool endStream (const GFrameDataCollection *frameRunData)
 End publishing one frame stream record.
 
void flushEventBuffer ()
 Flush all buffered events to the backend in publish order.
 
- Protected Attributes inherited from GStreamer
GStreamerDefinition gstreamer_definitions
 Output definition currently bound to this streamer instance.
 
- Protected Attributes inherited from GBase< GStreamer >
std::shared_ptr< GLogger > log
 

Detailed Description

Output model:

  • one ROOT file is produced per plugin instance
  • one header tree is created for event headers
  • one header tree is created for run headers
  • one true-information tree is created lazily per detector
  • one digitized tree is created lazily per detector

Tree creation is demand-driven. The first hit seen for a detector determines the variable schema used to build the corresponding TTree via GRootTree.

Threading model:

  • one plugin instance per worker thread is the intended usage
  • the plugin enables ROOT thread safety at library load time

Definition at line 35 of file gstreamerROOTFactory.h.

Member Function Documentation

◆ GStreamer()

GStreamer::GStreamer ( const std::shared_ptr< GOptions > & g)
inlineexplicit

Definition at line 84 of file gstreamer.h.

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