RHistStatBox.hxx

Go to the documentation of this file.

/*************************************************************************
 * Copyright (C) 1995-2020, Rene Brun and Fons Rademakers.               *
 * All rights reserved.                                                  *
 *                                                                       *
 * For the licensing terms see $ROOTSYS/LICENSE.                         *
 * For the list of contributors see $ROOTSYS/README/CREDITS.             *
 *************************************************************************/
 
#ifndef ROOT7_RHistStatBox
#define ROOT7_RHistStatBox
 
#include <ROOT/RPave.hxx>
#include <ROOT/RDrawableRequest.hxx>
#include <ROOT/RPadBase.hxx>
#include <ROOT/RDisplayItem.hxx>
#include <ROOT/RHist.hxx>
#include <ROOT/RHistImpl.hxx>
#include <ROOT/RFrame.hxx>
 
#include <memory>
#include <string>
#include <vector>
 
namespace ROOT {
namespace Experimental {
 
/** \class ROOT::Experimental::RDisplayHistStat
\ingroup GrafROOT7
\brief Object send to client for display of RHistStat, required to avoid sending histogram to the client
\author Sergey Linev <s.linev@gsi.de>
\date 2020-04-17
\warning This is part of the ROOT 7 prototype! It will change without notice. It might trigger earthquakes. Feedback is welcome!
*/
 
class RDisplayHistStat : public RIndirectDisplayItem {
   unsigned fShowMask{0};   ///< initial show mask
   std::vector<std::string> fEntries; ///< names of entries for context menu
   std::vector<std::string> fLines;   ///< filled lines to show in stat box
public:
   RDisplayHistStat() = default;
   RDisplayHistStat(const RDrawable &dr, unsigned mask, const std::vector<std::string> &entries, const std::vector<std::string> &lines) :
         RIndirectDisplayItem(dr), fShowMask(mask), fEntries(entries), fLines(lines) {}
   ~RDisplayHistStat() override = default;
 
   unsigned GetShowMask() const { return fShowMask; }
   const std::vector<std::string> &GetEntries() const { return fEntries; }
};
 
 
/** \class ROOT::Experimental::RHistStatBoxBase
\ingroup GrafROOT7
\brief Base class for histogram statistic box, provides graphics attributes and virtual method for fill statistic
\author Sergey Linev <s.linev@gsi.de>
\date 2020-04-01
\warning This is part of the ROOT 7 prototype! It will change without notice. It might trigger earthquakes. Feedback is welcome!
*/
 
class RHistStatBoxBase : public RPave {
 
   std::string fTitle;                       ///< stat box title
   unsigned fShowMask{0xff};                 ///< show stat box lines
 
protected:
 
   enum EShowBits { kShowTitle = 0x1, kShowEntries = 0x2, kShowMean = 0x4, kShowDev = 0x8, kShowRange = 0x10 };
 
   virtual void FillStatistic(unsigned, const RFrame::RUserRanges &, std::vector<std::string> &) const {}
 
   virtual const std::vector<std::string> &GetEntriesNames() const;
 
   std::unique_ptr<RDisplayItem> Display(const RDisplayContext &) override;
 
public:
 
   class RReply : public RDrawableReply {
      unsigned mask{0};                 ///< mask used to create lines
      std::vector<std::string> lines;   ///< text lines displayed in the stat box
   public:
      std::vector<std::string> &GetLines() { return lines; }
      void SetMask(unsigned _mask) { mask = _mask; }
      // virtual destructor - required to pin vtable
      ~RReply() override = default;
   };
 
   class RRequest : public RDrawableRequest {
      unsigned mask{0xff};      // mask of items to show
   public:
      RRequest() = default;
      unsigned GetMask() const { return mask; }
      std::unique_ptr<RDrawableReply> Process() override
      {
         auto stat = dynamic_cast<RHistStatBoxBase *>(GetContext().GetDrawable());
 
         auto frame = GetContext().GetPad()->GetFrame();
         RFrame::RUserRanges ranges;
         if (frame) frame->GetClientRanges(GetContext().GetConnId(), ranges);
 
         auto reply = std::make_unique<RReply>();
 
         if (stat) {
            stat->fShowMask = GetMask();
 
            reply->SetMask(GetMask());
 
            if (GetMask() & RHistStatBoxBase::kShowTitle)
               reply->GetLines().emplace_back(stat->GetTitle());
 
            stat->FillStatistic(GetMask(), ranges, reply->GetLines());
         }
         return reply;
      }
   };
 
   RHistStatBoxBase() : RPave("stats") {}
 
   void SetTitle(const std::string &title) { fTitle = title; }
   const std::string &GetTitle() const { return fTitle; }
};
 
 
 
/** \class ROOT::Experimental::RHistStatBox
\ingroup GrafROOT7
\brief Template class for statistic box for RHist class
\author Sergey Linev <s.linev@gsi.de>
\date 2020-04-01
\warning This is part of the ROOT 7 prototype! It will change without notice. It might trigger earthquakes. Feedback is welcome!
*/
 
 
template <int DIMENSIONS>
class RHistStatBox : public RHistStatBoxBase {
public:
   using HistImpl_t = Detail::RHistImplPrecisionAgnosticBase<DIMENSIONS>;
 
private:
   Internal::RIOShared<HistImpl_t> fHistImpl;  ///< I/O capable reference on histogram
 
protected:
 
   void CollectShared(Internal::RIOSharedVector_t &vect) override { vect.emplace_back(&fHistImpl); }
 
public:
 
   template <class HIST>
   RHistStatBox(const std::shared_ptr<HIST> &hist, const std::string &title = "")
   {
      fHistImpl = std::shared_ptr<HistImpl_t>(hist, hist->GetImpl());
      SetTitle(title);
   }
 
   std::shared_ptr<HistImpl_t> GetHist() const { return fHistImpl.get_shared(); }
};
 
 
class RHist1StatBox final : public RHistStatBox<1> {
protected:
   void FillStatistic(unsigned, const RFrame::RUserRanges &, std::vector<std::string> &) const override;
public:
   template <class HIST>
   RHist1StatBox(const std::shared_ptr<HIST> &hist, const std::string &title = "") : RHistStatBox<1>(hist, title) {}
};
 
class RHist2StatBox final : public RHistStatBox<2> {
protected:
   void FillStatistic(unsigned, const RFrame::RUserRanges &, std::vector<std::string> &) const override;
public:
   template <class HIST>
   RHist2StatBox(const std::shared_ptr<HIST> &hist, const std::string &title = "") : RHistStatBox<2>(hist, title) {}
};
 
class RHist3StatBox final : public RHistStatBox<3> {
protected:
   void FillStatistic(unsigned, const RFrame::RUserRanges &, std::vector<std::string> &) const override;
public:
   template <class HIST>
   RHist3StatBox(const std::shared_ptr<HIST> &hist, const std::string &title = "") : RHistStatBox<3>(hist, title) {}
};
 
} // namespace Experimental
} // namespace ROOT
 
#endif