SampleHandler.h

Go to the documentation of this file.

/*
  Copyright (C) 2002-2024 CERN for the benefit of the ATLAS collaboration
*/
 
#ifndef SAMPLE_HANDLER_SAMPLE_HANDLER_HH
#define SAMPLE_HANDLER_SAMPLE_HANDLER_HH
 
//
// Distributed under the Boost Software License, Version 1.0.
//    (See accompanying file LICENSE_1_0.txt or copy at
//          http://www.boost.org/LICENSE_1_0.txt)
 
// Please feel free to contact me (krumnack@iastate.edu) for bug
// reports, feature suggestions, praise and complaints.
 
 
 
#include <SampleHandler/Global.h>
 
#include <boost/iterator/transform_iterator.hpp>
#include <memory>
#include <iosfwd>
#include <map>
#include <span>
#include <vector>
#include <TObject.h>
 
namespace SH
{
  std::string dbg (const SampleHandler& obj, unsigned verbosity = 0);
 

  void swap (SampleHandler& a, SampleHandler& b);
 
 

  class SampleHandler : public TObject
  {
    //
    // public interface
    //

  public:
    void testInvariant () const;
 

  public:
    SampleHandler ();
 

  public:
    SampleHandler (const SampleHandler& that);
 

  public:
    ~SampleHandler ();
 

  public:
    SampleHandler& operator = (const SampleHandler& that);
 

  public:
    void add (const Sample& sample);
 

  public:
    void add (std::shared_ptr<Sample> sample);
 

  public:
    void add (const SampleHandler& sh);
 

  public:
    void addWithPrefix (const SampleHandler& sh, const std::string& prefix);
 

  public:
    void remove (const std::string& name);
 

  public:
    void remove (const Sample *sample);
 

  public:
    Sample *get (const std::string& name);
 

  public:
    const Sample *get (const std::string& name) const;
 

  public:
    SampleHandler find (const TagList& tags) const;
 

  public:
    SampleHandler find (const std::string& tags) const;
 

  public:
    Sample *findBySource (const std::string& name) const;
 

  public:
    SampleHandler findByName (const std::string& pattern) const;
 

  public:
    void print () const;
 

  public:
    void printContent () const;
 

  public:
    void save (const std::string& directory) const;
 

  public:
    void load (const std::string& directory);
 

  public:
    void updateLocation (const std::string& from, const std::string& to);
 

  public:
    void fetch (const SampleHandler& source);
 

  public:
    void fetchDefaults (const SampleHandler& source);
 

  public:
    bool check_complete (const SampleHandler& source) const;
 

  public:
    void setMetaDouble (const std::string& name, double value);
 

  public:
    void setMetaString (const std::string& name, const std::string& value);
 

  public:
    void setMetaDouble (const std::string& pattern, const std::string& name,
            double value);
 

  public:
    void setMetaString (const std::string& pattern, const std::string& name,
            const std::string& value);
 

  private:
    struct SamplePtrToRawSample
    {
      Sample *operator () (const std::shared_ptr<Sample>& p) const;
    };
 

  public:
    typedef boost::transform_iterator<
      SamplePtrToRawSample,
      std::vector<std::shared_ptr<Sample>>::const_iterator> iterator;
 

  public:
    iterator begin () const;
 

  public:
    iterator end () const;
 

  public:
    std::size_t size () const;
 

  public:
    Sample *operator [] (std::size_t index) const;
 

  public:
    Sample *at (std::size_t index) const;
 

  public:
    std::span<std::shared_ptr<Sample>> samples ();
 
 
 
    //
    // private interface
    //
 
    friend void swap (SampleHandler& a, SampleHandler& b);

  private:
    std::vector<std::shared_ptr<Sample>> m_samples;

  private:
    std::map<std::string,std::shared_ptr<Sample>> m_named;
 
    ClassDef (SampleHandler, 1)
  };
}
 
#endif