lognormal.hpp

Go to the documentation of this file.

#pragma once
 
#include <algorithm>
#include <random>
#include <string>
 
#include "NumCpp/Core/Internal/Error.hpp"
#include "NumCpp/Core/Internal/StaticAsserts.hpp"
#include "NumCpp/Core/Shape.hpp"
#include "NumCpp/NdArray.hpp"
#include "NumCpp/Random/generator.hpp"
 
namespace nc::random
{
    namespace detail
    {
        //============================================================================
        // Method Description:
        template<typename dtype, typename GeneratorType = std::mt19937>
        dtype lognormal(GeneratorType& generator, dtype inMean = 0, dtype inSigma = 1)
        {
            STATIC_ASSERT_ARITHMETIC(dtype);
 
            if (inSigma <= 0)
            {
                THROW_INVALID_ARGUMENT_ERROR("input sigma must be greater than zero.");
            }
 
            std::lognormal_distribution<dtype> dist(inMean, inSigma);
            return dist(generator);
        }
 
        //============================================================================
        // Method Description:
        template<typename dtype, typename GeneratorType = std::mt19937>
        NdArray<dtype> lognormal(GeneratorType& generator, const Shape& inShape, dtype inMean = 0, dtype inSigma = 1)
        {
            STATIC_ASSERT_ARITHMETIC(dtype);
 
            if (inSigma <= 0)
            {
                THROW_INVALID_ARGUMENT_ERROR("input sigma must be greater than zero.");
            }
 
            NdArray<dtype> returnArray(inShape);
 
            std::lognormal_distribution<dtype> dist(inMean, inSigma);
 
            std::for_each(returnArray.begin(),
                          returnArray.end(),
                          [&generator, &dist](dtype& value) -> void { value = dist(generator); });
 
            return returnArray;
        }
    } // namespace detail
 
    //============================================================================
    // Method Description:
    template<typename dtype>
    dtype lognormal(dtype inMean = 0, dtype inSigma = 1)
    {
        return detail::lognormal(generator_, inMean, inSigma);
    }
 
    //============================================================================
    // Method Description:
    template<typename dtype>
    NdArray<dtype> lognormal(const Shape& inShape, dtype inMean = 0, dtype inSigma = 1)
    {
        return detail::lognormal(generator_, inShape, inMean, inSigma);
    }
} // namespace nc::random