DistributionHandler.h

Go to the documentation of this file.

//  ************************************************************************************************
//
//  BornAgain: simulate and fit reflection and scattering
//
//! @file      Param/Distrib/DistributionHandler.h
//! @brief     Defines class DistributionHandler.
//!
//! @homepage  http://www.bornagainproject.org
//! @license   GNU General Public License v3 or higher (see COPYING)
//! @copyright Forschungszentrum Jülich GmbH 2018
//! @authors   Scientific Computing Group at MLZ (see CITATION, AUTHORS)
//
//  ************************************************************************************************
 
#ifdef SWIG
#error no need to expose this header to Swig
#endif
 
#ifndef USER_API
#ifndef BORNAGAIN_PARAM_DISTRIB_DISTRIBUTIONHANDLER_H
#define BORNAGAIN_PARAM_DISTRIB_DISTRIBUTIONHANDLER_H
 
#include "Param/Distrib/ParameterDistribution.h"
#include <functional>
#include <map>
#include <vector>
 
//! Provides the functionality to average over parameter distributions with weights.
class DistributionHandler {
public:
    DistributionHandler();
    virtual ~DistributionHandler();
 
    //! add a sampled parameter distribution
    void addParameterDistribution(const std::string& param_name,
                                  const IDistribution1D& distribution, size_t nbr_samples,
                                  double sigma_factor = 0.0,
                                  const RealLimits& limits = RealLimits());
 
    void addParameterDistribution(const ParameterDistribution& par_distr);
 
    //! get the total number of parameter value combinations (product
    //! of the individual sizes of each parameter distribution
    size_t getTotalNumberOfSamples() const;
 
    //! set the parameter values of the simulation object to a specific
    //! combination of values, determined by the index (which must be smaller
    //! than the total number of combinations) and returns the weight
    //! associated with this combination of parameter values.
    //! initParameterLinks() has to be called before this!
    double setParameterValues(size_t index);
 
    const std::vector<ParameterDistribution>& getDistributions() const;
 
    void defineCallbackForDistribution(const ParameterDistribution* distribution,
                                       std::function<void(double)> fn);
 
private:
    size_t m_nbr_combinations;
    std::vector<ParameterDistribution> m_distributions;
    std::map<const ParameterDistribution*, std::function<void(double)>> m_setValueFunctions;
    std::vector<std::vector<ParameterSample>> m_cached_samples;
};
 
#endif // BORNAGAIN_PARAM_DISTRIB_DISTRIBUTIONHANDLER_H
#endif // USER_API