parser.h

Go to the documentation of this file.

#ifndef KM3NET_ADF_CONFIG_PARSER_H
#define KM3NET_ADF_CONFIG_PARSER_H
 
#include <map>
#include <string>
#include <vector>
#include <optional>
#include <iostream>
 
class Parser
{
public:
 
  Parser(const std::string& d, char t);
 
  std::vector<std::string> Find(const std::string& tag);
 
  std::string Find(const std::string& tag, size_t index,
                   std::string value = "");
 
private:
 
  std::multimap<std::string, std::string> mmap;
};
 
template<typename T>
struct Waveform
{
  int            id;
  std::vector<T> samples;
 
  bool operator==(const Waveform<T>& rhs) const
  {
    return rhs.id == id && samples == rhs.samples;
  }
  bool operator!=(const Waveform<T>& rhs) const
  {
    return !(*this == rhs);
  }
 
  friend std::ostream& operator<<(std::ostream& out, const Waveform<T>& waveform)
  {
    out << waveform.id << " " << waveform.samples.size() << " ";
    for (const auto& sample : waveform.samples) {
      out << sample << " ";
    }
    return out;
  }
};
 
 
template<typename T>
std::optional<Waveform<T>> parseWaveformSamples(const std::string& adf_waveform_line);
 
/** A pair (id,threshold) representing basic information about one probe
 */
struct ProbeConfig
{
  int id;         // id of the probe (aka waveform)
  int threshold;  // quality threshold to apply to the cross correlation for that probe
};
 
/** The configuration information for one DOM
 */
struct DOMConfig
{
  int                      dom_id;               // dom identifier
  std::vector<ProbeConfig> probe_configs;        // list of probe configurations
  int                      write_to_debug_flag;  // whether or not this DOM acoustics data should be output to a debug file
};
 
/** Parse a line that should contain the ADF configuration for a single DOM.
 *
 * @param dom_configuration_line: the DOM configuration for a single DOM, which
 * should be of the form :
 *
 * DOMID N id_0 threshold_0 ... id_(N-1) threshold_(N-1) debug_write
 *
 * where N is the number of (id,threshold) pairs to be found on the line
 * (id = probe id, threshold = where to cut the signal)
 *
 * write_to_debug_flag is an integer that indicate (if non zero)
 * to write the acoustic data from this DOM should be written to a debug file
 *
 * @returns a DOMConfig object if the line is valid DOM configuration,
 * otherwise std::nullopt
 *
 */
std::optional<DOMConfig> parseDOMConfiguration(const std::string& dom_configuration_line);
 
#endif