Abstract class for the TPG pipeline. More...

#include <TPGPipeline.hpp>

Public Types
using	processor_t = T
	Processor type to use. Generally AVX.

using	signal_t = U
	Signal type to use. Generally __m256i.

Public Member Functions
virtual	~TPGPipeline ()=default

virtual void	configure (const std::vector< std::pair< std::string, nlohmann::json > > configs, const std::vector< std::pair< dunedaq::trgdataformats::channel_t, int16_t > > channel_plane_numbers)
	Configure the pieces to the pipeline.

virtual std::vector< dunedaq::trgdataformats::TriggerPrimitive >	process (const signal_t &signal)
	Process a signal through the pipeline.

virtual bool	check_for_tps (const signal_t &tp_mask)=0
	Pure virtual function that will check if any TPs can be generated.

virtual signal_t	save_state (const signal_t &processed_signal)=0
	Pure virtual function that will save the state of the generation.

virtual std::vector< dunedaq::trgdataformats::TriggerPrimitive >	generate_tps (const signal_t &tp_mask)=0
	Pure virtual function that will generate TPs given a mask to draw from.

virtual std::vector< std::shared_ptr< AbstractProcessor< signal_t > > >	get_all_processor_references ()
	Return reference to all processors in this pipeline.

virtual void	set_sot_minima (const std::vector< uint16_t > &sot_minima)
	Set the samples over threshold minimum values.

Protected Attributes
signal_t	m_adc_integral_lo {}
	The on-going ADC integral for channels that are considered active.

signal_t	m_adc_integral_hi {}

signal_t	m_adc_peak {}
	The ADC peak for channels that are considered active.

signal_t	m_samples_over_threshold {}
	The samples over threshold for channels that are considered active.

signal_t	m_samples_to_peak {}
	The number of samples from `time_start` to the ADC peak.

dunedaq::trgdataformats::channel_t	m_channels [16]
	Detector channel numbers for the 16 channels that are being processed.

int16_t	m_plane_numbers [16]
	Detector plane numbers for the 16 channels that are being processed.

uint16_t	m_sot_minima [3]
	The samples over threshold minimum that a TP from plane `i` must have.

std::shared_ptr< AbstractFactory< processor_t > >	m_factory = AbstractFactory<processor_t>::get_instance()
	Processor factory singleton.

std::shared_ptr< processor_t >	m_processor_head
	Processor head to start from.

Detailed Description

template<typename T, typename U>
class tpglibs::TPGPipeline< T, U >

Abstract class for the TPG pipeline.

Definition at line 29 of file TPGPipeline.hpp.

Member Typedef Documentation

◆ processor_t

template<typename T , typename U >

using tpglibs::TPGPipeline< T, U >::processor_t = T

Processor type to use. Generally AVX.

Definition at line 32 of file TPGPipeline.hpp.

◆ signal_t

template<typename T , typename U >

using tpglibs::TPGPipeline< T, U >::signal_t = U

Signal type to use. Generally __m256i.

Definition at line 34 of file TPGPipeline.hpp.

Constructor & Destructor Documentation

◆ ~TPGPipeline()

template<typename T , typename U >

virtual tpglibs::TPGPipeline< T, U >::~TPGPipeline ( )

virtualdefault

Member Function Documentation

◆ check_for_tps()

template<typename T , typename U >

virtual bool tpglibs::TPGPipeline< T, U >::check_for_tps ( const signal_t & tp_mask )

pure virtual

Pure virtual function that will check if any TPs can be generated.

Implemented in tpglibs::AVXPipeline.

◆ configure()

template<typename T , typename U >

virtual void tpglibs::TPGPipeline< T, U >::configure	(	const std::vector< std::pair< std::string, nlohmann::json > >	configs,
		const std::vector< std::pair< dunedaq::trgdataformats::channel_t, int16_t > >	channel_plane_numbers )

inlinevirtual

Configure the pieces to the pipeline.

Parameters

configs	Vector of processors and configurations to be used.
channel_plane_numbers	Vector of channel numbers and their plane numbers.

Definition at line 44 of file TPGPipeline.hpp.

                                                                                                                                                                               {
      std::shared_ptr<processor_t> prev_processor = nullptr;
 
      for (int i = 0; i < 16; i++) {
        m_channels[i] = channel_plane_numbers[i].first;
        m_plane_numbers[i] = channel_plane_numbers[i].second;
      }
 
      for (const auto& name_config : configs) {
        // Get the requested processor.
        std::shared_ptr<processor_t> processor = m_factory->create_processor(name_config.first);
 
        // Configure it.
        processor->configure(name_config.second, m_plane_numbers);
 
        // If it's the first one, make it the head.
        if (!prev_processor) {
          m_processor_head = processor;
          prev_processor = processor;
          continue;
        }
 
        // Otherwise, start linking the chain.
        prev_processor->set_next_processor(processor);
        prev_processor = processor;
      }
    }

◆ generate_tps()

template<typename T , typename U >

virtual std::vector< dunedaq::trgdataformats::TriggerPrimitive > tpglibs::TPGPipeline< T, U >::generate_tps ( const signal_t & tp_mask )

pure virtual

Pure virtual function that will generate TPs given a mask to draw from.

Implemented in tpglibs::AVXPipeline.

◆ get_all_processor_references()

template<typename T , typename U >

virtual std::vector< std::shared_ptr< AbstractProcessor< signal_t > > > tpglibs::TPGPipeline< T, U >::get_all_processor_references ( )

inlinevirtual

Return reference to all processors in this pipeline.

Returns: A vector of all processor references.

Definition at line 99 of file TPGPipeline.hpp.

                                                                                                 {
      std::vector<std::shared_ptr<AbstractProcessor<signal_t>>> processor_references;
      if (m_processor_head == nullptr) return processor_references;
 
      auto current_processor = std::static_pointer_cast<AbstractProcessor<signal_t>>(m_processor_head);
      while (current_processor != nullptr) {
        processor_references.push_back(current_processor);
        current_processor = current_processor->get_next_processor();
      }
      return processor_references;
    }

◆ process()

template<typename T , typename U >

virtual std::vector< dunedaq::trgdataformats::TriggerPrimitive > tpglibs::TPGPipeline< T, U >::process ( const signal_t & signal )

inlinevirtual

Process a signal through the pipeline.

Definition at line 75 of file TPGPipeline.hpp.

                                                                                             {
      signal_t tp_mask = save_state(m_processor_head->process(signal));
 
      std::vector<dunedaq::trgdataformats::TriggerPrimitive> tps;
      if (check_for_tps(tp_mask))
        tps = generate_tps(tp_mask);
 
      return tps;
    }

◆ save_state()

template<typename T , typename U >

virtual signal_t tpglibs::TPGPipeline< T, U >::save_state ( const signal_t & processed_signal )

pure virtual

Pure virtual function that will save the state of the generation.

Implemented in tpglibs::AVXPipeline.

◆ set_sot_minima()

template<typename T , typename U >

virtual void tpglibs::TPGPipeline< T, U >::set_sot_minima ( const std::vector< uint16_t > & sot_minima )

inlinevirtual

Set the samples over threshold minimum values.

Definition at line 112 of file TPGPipeline.hpp.

                                                                       {
      int idx = 0;
      for (auto sot_minimum : sot_minima) {
        m_sot_minima[idx++] = sot_minimum;
      }
    }

Member Data Documentation

◆ m_adc_integral_hi

template<typename T , typename U >

signal_t tpglibs::TPGPipeline< T, U >::m_adc_integral_hi {}

protected

Definition at line 122 of file TPGPipeline.hpp.

122{};

◆ m_adc_integral_lo

template<typename T , typename U >

signal_t tpglibs::TPGPipeline< T, U >::m_adc_integral_lo {}

protected

The on-going ADC integral for channels that are considered active.

Definition at line 121 of file TPGPipeline.hpp.

121{};

◆ m_adc_peak

template<typename T , typename U >

signal_t tpglibs::TPGPipeline< T, U >::m_adc_peak {}

protected

The ADC peak for channels that are considered active.

Definition at line 124 of file TPGPipeline.hpp.

124{};

◆ m_channels

template<typename T , typename U >

dunedaq::trgdataformats::channel_t tpglibs::TPGPipeline< T, U >::m_channels[16]

protected

Detector channel numbers for the 16 channels that are being processed.

Definition at line 130 of file TPGPipeline.hpp.

◆ m_factory

template<typename T , typename U >

std::shared_ptr<AbstractFactory<processor_t> > tpglibs::TPGPipeline< T, U >::m_factory = AbstractFactory<processor_t>::get_instance()

protected

Processor factory singleton.

Definition at line 136 of file TPGPipeline.hpp.

◆ m_plane_numbers

template<typename T , typename U >

int16_t tpglibs::TPGPipeline< T, U >::m_plane_numbers[16]

protected

Detector plane numbers for the 16 channels that are being processed.

Definition at line 132 of file TPGPipeline.hpp.

◆ m_processor_head

template<typename T , typename U >

std::shared_ptr<processor_t> tpglibs::TPGPipeline< T, U >::m_processor_head

protected

Processor head to start from.

Definition at line 138 of file TPGPipeline.hpp.

◆ m_samples_over_threshold

template<typename T , typename U >

signal_t tpglibs::TPGPipeline< T, U >::m_samples_over_threshold {}

protected

The samples over threshold for channels that are considered active.

Definition at line 126 of file TPGPipeline.hpp.

126{};

◆ m_samples_to_peak

template<typename T , typename U >

signal_t tpglibs::TPGPipeline< T, U >::m_samples_to_peak {}

protected

The number of samples from time_start to the ADC peak.

Definition at line 128 of file TPGPipeline.hpp.

128{};

◆ m_sot_minima

template<typename T , typename U >

uint16_t tpglibs::TPGPipeline< T, U >::m_sot_minima[3]

protected

The samples over threshold minimum that a TP from plane i must have.

Definition at line 134 of file TPGPipeline.hpp.

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

/github/workspace/dunedaq/sourcecode/tpglibs/include/tpglibs/TPGPipeline.hpp

Public Types

Public Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

◆ processor_t

◆ signal_t

Constructor & Destructor Documentation

◆ ~TPGPipeline()

Member Function Documentation

◆ check_for_tps()

◆ configure()

◆ generate_tps()

◆ get_all_processor_references()

◆ process()

◆ save_state()

◆ set_sot_minima()

Member Data Documentation

◆ m_adc_integral_hi

◆ m_adc_integral_lo

◆ m_adc_peak

◆ m_channels

◆ m_factory

◆ m_plane_numbers

◆ m_processor_head

◆ m_samples_over_threshold

◆ m_samples_to_peak

◆ m_sot_minima