IHisto.hpp

#pragma once
 
#include <opals/IModuleBase.hpp>
#include <opals/Array.hpp>
#include <opals/HistoMode.hpp>
#include <opals/HistoStats.hpp>
#include <opals/OdmOrRasterFile.hpp>
#include <opals/Path.hpp>
#include <opals/String.hpp>
#include <opals/Vector.hpp>
#include <opals/AbsValueOrQuantile.hpp>
 
#if defined(_MSC_VER) && !defined(OPALS_NO_AUTOLINK)
  #if defined _DEBUG && !defined OPALS_NO_DEBUG
      #pragma comment(lib, "opalsHisto_d.lib")
  #else
      #pragma comment(lib, "opalsHisto.lib")
  #endif
#endif
 
namespace opals {
 
  namespace opts
  {
    /// Options of \ref ModuleHisto
    namespace Histo
    {
      /// Options of \ref ModuleHisto
      using Options =
        IGroup< Names::_, false,
          ILeaf< Names::inFile, false, Vector<OdmOrRasterFile>  >,
          ILeaf< Names::attribute, false, Vector<String>  >,
          ILeaf< Names::histogram, true, Vector<HistoStats>  >,
          ILeaf< Names::nBins, false, unsigned  >,
          ILeaf< Names::binWidth, false, float  >,
          ILeaf< Names::sampleRange, false, Array<opals::AbsValueOrQuantile, 2>  >,
          ILeaf< Names::densityRange, false, Array<float, 2>  >,
          ILeaf< Names::limit, false, Array<double, 4>  >,
          ILeaf< Names::filter, false, String  >,
          ILeaf< Names::plotFile, false, Vector<Path>  >,
          ILeaf< Names::probabilities, false, Vector<double>  >,
          ILeaf< Names::procMode, false, HistoMode  >,
          ILeaf< Names::exactComputation, false, bool  >,
          ILeaf< Names::skipEmptyBins, false, bool  >
        >;
    }
  }
 
  /// Derives histograms and descriptive statistics (min, max, mean, r.m.s, etc.) for ODM or grid/raster data sets and stores the results graphically (SVG) and numerically (XML).
  /** The boost::accumulator framework is used to analyze the data, to calculate
      standard statistics (min max, mean, median, quantiles,...) and to create the
      histogram itself. Finally, if requested by the user, a plot file in SVG format
      is generated using boost::svg_plot (not yet part of the boost library). */
  /// \see \ref ModuleHisto
  class OPALS_API IHisto : virtual public IModuleBase
  {
 
  public:
    static IHisto* New();
    static IHisto* New( IControlObject &controlObject );
    static IHisto* New( const IModuleBase &parent );
    static IHisto* New( const IModuleBase &parent, IControlObject &controlObject );
 
    virtual ~IHisto() {}
 
    /// \name Access to module-specific options.
    ///@{
    using Options = opts::Histo::Options;
    virtual       Options& opts()       = 0;
    virtual const Options& opts() const = 0;
    ///@}
 
  };
 
};