dump::raw::OpDetWaveformDumper Class Reference

Prints the content of optical detector waveforms on screen. More...

#include <OpDetWaveform.h>

Inheritance diagram for dump::raw::OpDetWaveformDumper:

Classes
struct	TickLabelMaker
	Time label: tick number relative to the waveform. More...
struct	TimeLabelMaker
	Base functor for printing time according to tick number. More...

Public Member Functions
	OpDetWaveformDumper (raw::ADC_Count_t pedestal=0, unsigned int digitsPerLine=0U)
	Constructor: sets waveform dump parameters. More...
void	setTimeLabelMaker (TimeLabelMaker const *timeLabelMaker)
	Chooses which time label maker to use. More...
template<typename Stream >
void	dump (Stream &&stream, raw::OpDetWaveform const &waveform)
	Dumps the content of a waveform into the specified output stream. More...
template<typename Stream >
void	operator() (Stream &&stream, raw::OpDetWaveform const &waveform)
	An alias of dump(). More...
Public Member Functions inherited from dump::DumperBase
	DumperBase ()
	Default constructor: no indentation. More...
	DumperBase (std::string const &indent, std::string const &firstIndent)
	Constructor: sets indentation. More...
	DumperBase (std::string const &indent)
	Constructor: sets indentation. More...
template<typename Stream >
decltype(auto)	indenter (Stream &&out) const
	Returns an Indenter object tied to this dumper and out stream. More...
std::string const &	indent () const
	Returns the indentation string currently configured for all lines. More...
std::string const &	firstIndent () const
	Returns the indentation string currently configured for the first line. More...
void	setIndent (std::string const &indent, std::string const &firstIndent)
	Sets indentation strings to the specified values. More...
void	setIndent (std::string const &indent)
	Sets both indentation strings to the same specified value. More...
template<typename Stream >
Stream &	indented (Stream &&out, bool first=false) const
	Writes the indentation into a stream, and returns it for further output. More...
template<typename Stream >
Stream &	firstIndented (Stream &&out) const
template<typename Stream >
Stream &	newline (Stream &&out) const

Static Public Member Functions
static std::string	padRight (std::string const &s, unsigned int width, std::string padding=" ")
	Pads the specified string to the right, truncating its right if needed. More...
static unsigned int	digitsOf (unsigned int n)
	Pads the specified string to the right, truncating its right if needed. More...

Private Attributes
raw::ADC_Count_t	fPedestal
	ADC pedestal (subtracted from readings). More...
unsigned int	fDigitsPerLine
	ADC readings per line in the output. More...
TimeLabelMaker const *	fTimeLabelMaker = nullptr
	The functor to be used to extract the time label. More...

Additional Inherited Members
Protected Member Functions inherited from dump::DumperBase
IndentSettings &	indentSettings ()
IndentSettings const &	indentSettings () const
IndentSettings &	saveIndentSettings ()
	Stacks a copy of the current settings, and returns the "new" ones. More...
IndentSettings &	restoreIndentSettings ()
	Restores and returns the last saved settings. More...

Detailed Description

Prints the content of optical detector waveforms on screen.

Example of usage:

dump::raw::OpDetWaveformDumper dump;
dump.setIndent("  ");

for (raw::OpDetWaveform const& waveform: waveforms)
  dump(mf::LogVerbatim("dumper"), waveform);

Definition at line 45 of file OpDetWaveform.h.

Constructor & Destructor Documentation

dump::raw::OpDetWaveformDumper::OpDetWaveformDumper ( raw::ADC_Count_t  pedestal = 0, unsigned int  digitsPerLine = 0U  )

inline

Constructor: sets waveform dump parameters.

Parameters

pedestal	(default: 0) the pedestal to be automatically added to all digits
digitsPerLine	(default: 0) how many ADC digits to print per line; 0 disables the digit printing completely

Note that no indentation is set. If some is desired, set it with setIndent() after construction.

Definition at line 92 of file OpDetWaveform.h.

      : fPedestal(pedestal), fDigitsPerLine(digitsPerLine)
      {}

Member Function Documentation

unsigned int dump::raw::OpDetWaveformDumper::digitsOf ( unsigned int  n )

static

Pads the specified string to the right, truncating its right if needed.

Definition at line 299 of file OpDetWaveform.h.

                                                                {
  unsigned int digits = 1U;
  while (n >= 10) {
    ++digits;
    n /= 10;
  }
  return digits;
} // dump::raw::OpDetWaveformDumper::digitsOf()

template<typename Stream >

void dump::raw::OpDetWaveformDumper::dump	(	Stream &&	stream,
		raw::OpDetWaveform const &	waveform
	)

Dumps the content of a waveform into the specified output stream.

Template Parameters

Stream

type of stream to dump data into

Parameters

stream	stream to dump data into
waveform	the object to be dumped

Indentation is regulated via base class methods (see setIndent()).

Definition at line 151 of file OpDetWaveform.h.

{
  static std::string const headerSep = " | ";
  
  auto const& data = waveform;
  using Count_t = raw::ADC_Count_t;

  auto out = indenter(std::forward<Stream>(stream));
  
  // print a header for the raw digits
  out.start()
    << "on channel #" << waveform.ChannelNumber() << " (time stamp: "
    << waveform.TimeStamp() << "): " << data.size() << " time ticks";
  
  // print the content of the channel
  if (fDigitsPerLine == 0) return;

  // save and change indentation
  saveIndentSettings().set(indent() + "  ");
  
  unsigned int repeat_count = 0U; // additional lines like the last one
  unsigned int index = 0U;
  unsigned int firstLineTick = 0U;
  
  // local function for printing and resetting the repeat count
  auto flushRepeatCount
    = [this, &out, &waveform, &firstLineTick](unsigned int& count)
    -> decltype(auto)
    {
      if (count > 0) {
        out.newline();
        if (fTimeLabelMaker) {
          out
            << padRight("", fTimeLabelMaker->labelWidth(waveform, firstLineTick))
            << headerSep
            ;
        }
        out << " [ ... repeated " << count << " more times ]";
        count = 0;
      }
      return out;
    };

  std::vector<Count_t> DigitBuffer(fDigitsPerLine), LastBuffer;

  lar::util::MinMaxCollector<Count_t> Extrema;
  out.newline()
    << "content of the channel (" << fDigitsPerLine << " ticks per line):";
  auto iTick = data.cbegin(), tend = data.cend(); // const iterators
  while (iTick != tend) {
    // the next line will show at most fDigitsPerLine ticks
    unsigned int line_size
      = std::min(fDigitsPerLine, (unsigned int) data.size() - index);
    if (line_size == 0) break; // no more ticks

    // fill the new buffer (iTick will move forward)
    DigitBuffer.resize(line_size);
    auto iBuf = DigitBuffer.begin(), bend = DigitBuffer.end();
    while ((iBuf != bend) && (iTick != tend))
      Extrema.add(*(iBuf++) = *(iTick++) - fPedestal);
    firstLineTick = index;
    index += line_size;

    // if the new buffer is the same as the old one, just mark it
    if (DigitBuffer == LastBuffer) {
      repeat_count += 1;
      continue;
    }
    
    // if there are previous repeats, write that on screen
    // before the new, different line
    flushRepeatCount(repeat_count);

    // dump the new line of ticks
    out.newline();
    if (fTimeLabelMaker) {
      out << padRight(
          fTimeLabelMaker->label(waveform, firstLineTick),
          fTimeLabelMaker->labelWidth(waveform, firstLineTick)
        )
        << headerSep
        ;
    }
    for (auto digit: DigitBuffer)
      out << " " << std::setw(4) << digit;
    
    
    // quick way to assign DigitBuffer to LastBuffer
    // (we don't care we lose the former)
    std::swap(LastBuffer, DigitBuffer);
    
  } // while
  flushRepeatCount(repeat_count);
  if (Extrema.min() != Extrema.max()) {
    out.newline()
      << "  range of " << data.size()
      << " samples: [" << Extrema.min() << ";" << Extrema.max() << "] (span: "
      << (Extrema.max() - Extrema.min());
    if (fPedestal != 0) {
      out << ", absolute: ["
        << (Extrema.min() + fPedestal) << ";"
        << (Extrema.max() + fPedestal) << "]";
    }
    out << ")";
  }
  
  restoreIndentSettings();
  
} // dump::raw::OpDetWaveformDumper::dump()

template<typename Stream >

void dump::raw::OpDetWaveformDumper::operator() ( Stream &&  stream, raw::OpDetWaveform const &  waveform  )

inline

An alias of dump().

Definition at line 122 of file OpDetWaveform.h.

      { dump(stream, waveform); }

std::string dump::raw::OpDetWaveformDumper::padRight ( std::string const &  s, unsigned int  width, std::string  padding = " "  )

static

Pads the specified string to the right, truncating its right if needed.

Definition at line 264 of file OpDetWaveform.h.

{

  if (s.length() > width) { // too long already?
    // truncate on the right
    return { s, 0U, width }; // { string, start index, character count }
  }

  std::string padded;
  padded.reserve(width);
  
  // this is how many full padding strings we need to prepend
  unsigned int nPadding
    = (s.length() >= width)? 0U: (width - s.length()) / padding.length();
  
  // if there is need for some more partial padding beyond that:
  if (nPadding * padding.length() + s.length() < width) {
    // immediately prepend from the rightmost part of the padding string
    padded.append(
      padding.end() - (width - (nPadding * padding.length() + s.length())),
      padding.end()
      );
  }
  
  // add the rest of the padding and the string, and then we are done
  while (nPadding-- > 0) padded += padding;
  padded += s;
  
  assert(padded.length() == width);
  
  return padded;
} // dump::raw::OpDetWaveformDumper::padRight()

void dump::raw::OpDetWaveformDumper::setTimeLabelMaker ( TimeLabelMaker const *  timeLabelMaker )

inline

Chooses which time label maker to use.

Parameters

timeLabelMaker

a pointer to the external time label maker

A time label maker is an object derived from TimeLabelMaker which can convert a waveform and tick into a string representing that tick within the waveform. If never specified or if nullptr, no time label will be printed at all.

Definition at line 105 of file OpDetWaveform.h.

      { fTimeLabelMaker = timeLabelMaker; }

Member Data Documentation

unsigned int dump::raw::OpDetWaveformDumper::fDigitsPerLine

private

ADC readings per line in the output.

Definition at line 136 of file OpDetWaveform.h.

raw::ADC_Count_t dump::raw::OpDetWaveformDumper::fPedestal

private

ADC pedestal (subtracted from readings).

Definition at line 135 of file OpDetWaveform.h.

TimeLabelMaker const* dump::raw::OpDetWaveformDumper::fTimeLabelMaker = nullptr

private

The functor to be used to extract the time label.

Definition at line 139 of file OpDetWaveform.h.

---

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

• lardataalg/lardataalg/Dumpers/RawData/OpDetWaveform.h