...one of the most highly
regarded and expertly designed C++ library projects in the
world.
— Herb Sutter and Andrei
Alexandrescu, C++
Coding Standards
boost::compute::normal_distribution — Produces random, normally-distributed floating-point numbers.
// In header: <boost/compute/random/normal_distribution.hpp> template<typename RealType = float> class normal_distribution { public: // types typedef RealType result_type; // construct/copy/destruct normal_distribution(RealType = 0.f, RealType = 1.f); ~normal_distribution(); // public member functions result_type mean() const; result_type stddev() const; result_type min BOOST_PREVENT_MACRO_SUBSTITUTION() const; result_type max BOOST_PREVENT_MACRO_SUBSTITUTION() const; template<typename OutputIterator, typename Generator> void generate(OutputIterator, OutputIterator, Generator &, command_queue &); // private member functions BOOST_STATIC_ASSERT_MSG(boost::is_floating_point< RealType >::value, "Template argument must be a floating point type"); };
The following example shows how to setup a normal distribution to produce random float
values centered at 5
:
See Also:
default_random_engine, uniform_real_distribution
normal_distribution
public member functionsresult_type mean() const;Returns the mean value of the distribution.
result_type stddev() const;Returns the standard-deviation of the distribution.
result_type min BOOST_PREVENT_MACRO_SUBSTITUTION() const;Returns the minimum value of the distribution.
result_type max BOOST_PREVENT_MACRO_SUBSTITUTION() const;Returns the maximum value of the distribution.
template<typename OutputIterator, typename Generator> void generate(OutputIterator first, OutputIterator last, Generator & generator, command_queue & queue);
Generates normally-distributed floating-point numbers and stores them to the range [first
, last
).