RangedDistributions.cpp

Go to the documentation of this file.

//  ************************************************************************************************
//
//  BornAgain: simulate and fit reflection and scattering
//
//! @file      Param/Distrib/RangedDistributions.cpp
//! @brief     Implements classes representing ranged one-dimensional distributions.
//!
//! @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)
//
//  ************************************************************************************************
 
#include "Param/Distrib/RangedDistributions.h"
#include "Param/Distrib/Distributions.h"
#include "Param/Varia/ParameterSample.h"
#include <limits>
 
namespace {
 
template <class T> std::unique_ptr<T> makeCopy(const T& item)
{
    return std::make_unique<T>(item.nSamples(), item.sigmaFactor(), item.limits());
}
 
const double gate_stddev_factor = 2.0 * std::sqrt(3.0);
 
} // namespace
 
//  ************************************************************************************************
//  interface IRangedDistribution
//  ************************************************************************************************
 
IRangedDistribution::IRangedDistribution()
    : m_n_samples(5), m_sigma_factor(2.0), m_limits(RealLimits::limitless())
{
    checkInitialization();
}
 
IRangedDistribution::IRangedDistribution(size_t n_samples, double sigma_factor,
                                         const RealLimits& limits)
    : m_n_samples(n_samples), m_sigma_factor(sigma_factor), m_limits(limits)
{
    checkInitialization();
}
 
IRangedDistribution::IRangedDistribution(size_t n_samples, double sigma_factor, double min,
                                         double max)
    : m_n_samples(n_samples), m_sigma_factor(sigma_factor), m_limits(RealLimits::limited(min, max))
{
    checkInitialization();
}
 
IRangedDistribution::~IRangedDistribution() = default;
 
std::vector<ParameterSample> IRangedDistribution::generateSamples(double mean, double stddev) const
{
    auto generator = distribution(mean, stddev);
    if (!generator->isDelta())
        return generator->equidistantSamples(m_n_samples, m_sigma_factor, m_limits);
 
    // handling the case of delta distributions
    auto samples = generator->equidistantSamples(m_n_samples, m_sigma_factor, m_limits);
    ParameterSample& sample = samples[0]; // there is only one element in the vector
    sample.weight = 1.0 / m_n_samples;
    return std::vector<ParameterSample>(m_n_samples, sample);
}
 
std::vector<std::vector<ParameterSample>>
IRangedDistribution::generateSamples(const std::vector<double>& mean,
                                     const std::vector<double>& stddev) const
{
    if (mean.size() != stddev.size())
        throw std::runtime_error("Error in IRangedDistribution::generateSamples: mean and variance "
                                 "vectors shall be of the same size");
 
    const size_t size = mean.size();
 
    std::vector<std::vector<ParameterSample>> result;
    result.resize(size);
    for (size_t i = 0; i < size; ++i)
        result[i] = generateSamples(mean[i], stddev[i]);
    return result;
}
 
std::unique_ptr<IDistribution1D> IRangedDistribution::distribution(double mean, double stddev) const
{
    if (stddev < 0.0)
        throw std::runtime_error(
            "Error in IRangedDistribution::distribution: standard deviation is less than zero");
    return distribution_impl(mean, stddev);
}
 
void IRangedDistribution::checkInitialization()
{
    if (m_n_samples < 1u)
        throw std::runtime_error("Error in IRangedDistribution::checkInitialization: number of "
                                 "samples shall be positive");
 
    if (m_sigma_factor < 0.0)
        throw std::runtime_error("Error in IRangedDistribution::checkInitialization: sigma factor "
                                 "shall be non-negative.");
 
    if (!m_limits.hasLowerAndUpperLimits())
        return;
 
    if (m_limits.lowerLimit() >= m_limits.upperLimit())
        throw std::runtime_error("Error in IRangedDistribution::checkInitialization: lower limit "
                                 "shall not exceed the upper one.");
}
 
//  ************************************************************************************************
//  class RangedDistributionGate
//  ************************************************************************************************
 
RangedDistributionGate::RangedDistributionGate() : IRangedDistribution() {}
 
RangedDistributionGate::RangedDistributionGate(size_t n_samples, double sigma_factor,
                                               const RealLimits& limits)
    : IRangedDistribution(n_samples, sigma_factor, limits)
{
}
 
RangedDistributionGate::RangedDistributionGate(size_t n_samples, double sigma_factor, double min,
                                               double max)
    : IRangedDistribution(n_samples, sigma_factor, min, max)
{
}
 
RangedDistributionGate* RangedDistributionGate::clone() const
{
    return makeCopy(*this).release();
}
 
std::string RangedDistributionGate::name() const
{
    return "RangedDistributionGate";
}
 
std::unique_ptr<IDistribution1D> RangedDistributionGate::distribution_impl(double mean,
                                                                           double stddev) const
{
    const double x_min = mean - gate_stddev_factor * stddev;
    const double x_max = mean + gate_stddev_factor * stddev;
    return std::make_unique<DistributionGate>(x_min, x_max);
}
 
//  ************************************************************************************************
//  class RangedDistributionLorentz
//  ************************************************************************************************
 
RangedDistributionLorentz::RangedDistributionLorentz() : IRangedDistribution() {}
 
RangedDistributionLorentz::RangedDistributionLorentz(size_t n_samples, double hwhm_factor,
                                                     const RealLimits& limits)
    : IRangedDistribution(n_samples, hwhm_factor, limits)
{
}
 
RangedDistributionLorentz::RangedDistributionLorentz(size_t n_samples, double hwhm_factor,
                                                     double min, double max)
    : IRangedDistribution(n_samples, hwhm_factor, min, max)
{
}
 
RangedDistributionLorentz* RangedDistributionLorentz::clone() const
{
    return makeCopy(*this).release();
}
 
std::string RangedDistributionLorentz::name() const
{
    return "RangedDistributionLorentz";
}
 
std::unique_ptr<IDistribution1D> RangedDistributionLorentz::distribution_impl(double median,
                                                                              double hwhm) const
{
    return std::make_unique<DistributionLorentz>(median, hwhm);
}
 
//  ************************************************************************************************
//  class RangedDistributionGaussian
//  ************************************************************************************************
 
RangedDistributionGaussian::RangedDistributionGaussian() : IRangedDistribution() {}
 
RangedDistributionGaussian::RangedDistributionGaussian(size_t n_samples, double sigma_factor,
                                                       const RealLimits& limits)
    : IRangedDistribution(n_samples, sigma_factor, limits)
{
}
 
RangedDistributionGaussian::RangedDistributionGaussian(size_t n_samples, double sigma_factor,
                                                       double min, double max)
    : IRangedDistribution(n_samples, sigma_factor, min, max)
{
}
 
RangedDistributionGaussian* RangedDistributionGaussian::clone() const
{
    return makeCopy(*this).release();
}
 
std::string RangedDistributionGaussian::name() const
{
    return "RangedDistributionGaussian";
}
 
std::unique_ptr<IDistribution1D> RangedDistributionGaussian::distribution_impl(double mean,
                                                                               double stddev) const
{
    return std::make_unique<DistributionGaussian>(mean, stddev);
}
 
//  ************************************************************************************************
//  class RangedDistributionLogNormal
//  ************************************************************************************************
 
RangedDistributionLogNormal::RangedDistributionLogNormal() : IRangedDistribution() {}
 
RangedDistributionLogNormal::RangedDistributionLogNormal(size_t n_samples, double sigma_factor,
                                                         const RealLimits& limits)
    : IRangedDistribution(n_samples, sigma_factor, limits)
{
}
 
RangedDistributionLogNormal::RangedDistributionLogNormal(size_t n_samples, double sigma_factor,
                                                         double min, double max)
    : IRangedDistribution(n_samples, sigma_factor, min, max)
{
}
 
RangedDistributionLogNormal* RangedDistributionLogNormal::clone() const
{
    return makeCopy(*this).release();
}
 
std::string RangedDistributionLogNormal::name() const
{
    return "RangedDistributionLogNormal";
}
 
std::unique_ptr<IDistribution1D> RangedDistributionLogNormal::distribution_impl(double mean,
                                                                                double stddev) const
{
    const double mean_2 = mean * mean;
    if (mean_2 <= std::numeric_limits<double>::min())
        throw std::runtime_error("Error in DistributionLogNormal::distribution: mean square value "
                                 "is less or indistinguishable from zero.");
 
    const double scale = std::sqrt(std::log(stddev * stddev / mean_2 + 1.0));
    const double median = mean * std::exp(-scale * scale / 2.0);
    return std::make_unique<DistributionLogNormal>(median, scale);
}
 
//  ************************************************************************************************
//  class RangedDistributionCosine
//  ************************************************************************************************
 
RangedDistributionCosine::RangedDistributionCosine() : IRangedDistribution() {}
 
RangedDistributionCosine::RangedDistributionCosine(size_t n_samples, double sigma_factor,
                                                   const RealLimits& limits)
    : IRangedDistribution(n_samples, sigma_factor, limits)
{
}
 
RangedDistributionCosine::RangedDistributionCosine(size_t n_samples, double sigma_factor,
                                                   double min, double max)
    : IRangedDistribution(n_samples, sigma_factor, min, max)
{
}
 
RangedDistributionCosine* RangedDistributionCosine::clone() const
{
    return makeCopy(*this).release();
}
 
std::string RangedDistributionCosine::name() const
{
    return "RangedDistributionCosine";
}
 
std::unique_ptr<IDistribution1D> RangedDistributionCosine::distribution_impl(double mean,
                                                                             double stddev) const
{
    return std::make_unique<DistributionCosine>(mean, stddev);
}