daq::details Namespace Reference

Classes
struct	BoardSetup_t
	Information of the setup of a V1730 readout board. More...
struct	BoardFacts_t
	Derivative information of a V1730 readout board. More...
struct	CompareWithKey
class	BoardInfoLookup
	Utility class for fast lookup of board data by fragment ID. More...

Functions
std::ostream &	operator<< (std::ostream &, BoardSetup_t::ChannelSetup_t const &)
std::ostream &	operator<< (std::ostream &, BoardInfoLookup const &)
template<typename Coll , typename Key , typename KeyExtractor >
Coll::value_type const *	binarySearch (Coll const &coll, Key const &key, KeyExtractor &&extractKey)
template<std::size_t KeyIndex = 0U, typename Coll , typename Key >
Coll::value_type const *	binarySearch (Coll const &coll, Key const &key)

Function Documentation

template<typename Coll , typename Key , typename KeyExtractor >

Coll::value_type const * daq::details::binarySearch	(	Coll const &	coll,
		Key const &	key,
		KeyExtractor &&	extractKey
	)

Definition at line 218 of file PMTDecoderUtils.h.

{
  using std::begin, std::end;
  auto const b = begin(coll);
  auto const e = end(coll);
  auto it = std::lower_bound(
    b, e, key,
    [&extractKey](auto const& a, Key const& key){ return extractKey(a) < key; }
    );
  return ((it != e) && (extractKey(*it) == key))? &*it: nullptr;
} // daq::details::binarySearch()

template<std::size_t KeyIndex = 0U, typename Coll , typename Key >

Coll::value_type const * daq::details::binarySearch	(	Coll const &	coll,
		Key const &	key
	)

Finds the element in coll with the item KeyIndex equal to key.

Returns

a pointer to the item found, or nullptr if none

Definition at line 234 of file PMTDecoderUtils.h.

{
  return binarySearch
    (coll, key, [](auto const& a){ return std::get<KeyIndex>(a); });
} // daq::details::binarySearch()

std::ostream & daq::details::operator<<	(	std::ostream &	out,
		BoardSetup_t::ChannelSetup_t const &	chSetup
	)

Definition at line 22 of file PMTDecoderUtils.cxx.

{
  out << "channel ";
  if (chSetup.hasChannel()) {
    if (chSetup.category.empty()) out << chSetup.channelID;
    else out << "0x" << std::hex << chSetup.channelID << std::dec;
  }
  else out << "from channel DB";
  
  if (chSetup.mustSkip()) out << ", always skipped";
  else {
    if (chSetup.mustSave() || chSetup.hasChannel()) {
      if (chSetup.mustSave() || (chSetup.minSpan == 0))
        out << ", always saved";
      else
        out << ", saved if span larger than " << chSetup.minSpan << " ADC";
    }
    else {
      out << ", saved if in channel DB";
      if (chSetup.minSpan > 0)
        out << " and if span larger than " << chSetup.minSpan << " ADC";
    }
    
    if (chSetup.onGlobalOnly) out << " only if on global trigger";
    
    if (!chSetup.category.empty())
      out << " in special category '" << chSetup.category << "'";
    
  } // if not forced to skip
  
  return out;
} // daq::details::operator<< (daq::details::BoardSetup_t::ChannelSetup_t)

std::ostream & daq::details::operator<<	(	std::ostream &	out,
		BoardInfoLookup const &	db
	)

Definition at line 58 of file PMTDecoderUtils.cxx.

{
  
  out << "Information on " << db.nBoardInfo() << " boards recorded:";
  for (BoardInfoLookup::BoardInfo_t const& boardInfo: db.allBoardInfo()) {
    assert(boardInfo.setup);
    out << "\n  board \"" << boardInfo.setup->name
      << "\" (fragment ID " << std::hex << boardInfo.fragmentID << std::dec
      << "): trigger delay " << boardInfo.setup->triggerDelay
      << ", TTT reset delay " << boardInfo.setup->TTTresetDelay
      << ", pre-trigger buffer length " << boardInfo.facts.preTriggerTime;
    if (boardInfo.config) {
      out << ", buffer " << boardInfo.config->bufferLength
        << " tick long, board ID " << boardInfo.config->boardID
        << " with " << boardInfo.config->nChannels << " channels";
    }
    else {
      out << " (no PMT configuration)";
    }
    
    std::vector<std::size_t> specialChannels;
    for (auto const& [ iChannel, chSetup ]
      : util::enumerate(boardInfo.setup->channelSettings)
    ) {
      if (!chSetup.isDefault()) specialChannels.push_back(iChannel);
    }
    if (specialChannels.empty()) continue;
    out << "; " << specialChannels.size() << " special channel configurations:";
    for (std::size_t const iCh: specialChannels) {
      out << "\n    ch.number " << iCh << ": "
        << boardInfo.setup->channelSettings[iCh];
    }
    
  } // for board info
  out << '\n';
  return out;
} // daq::details::operator<< (daq::details::BoardInfoLookup)