/* * This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. * * Copyright 2016-2019 Danny Robson */ #pragma once #include "coord/traits.hpp" #include #include #include #include #include namespace cruft::random { /////////////////////////////////////////////////////////////////////////// /// Initialise and return a generator using random_device. template GeneratorT initialise (void) { // Approximate the state size of the generator by its size in bytes. std::array seed; std::generate (seed.begin (), seed.end (), std::random_device ()); std::seed_seq seq (seed.begin (), seed.end ()); return GeneratorT (seq); } /////////////////////////////////////////////////////////////////////////// /// Returns a correctly pre-initialised reference to a thread-local /// generator of an unspecified (but not entirely useless) type. /// /// ie, not LCG. inline auto& generator (void) { using generator_t = std::mt19937_64; static thread_local auto gen = initialise (); return gen; } /////////////////////////////////////////////////////////////////////////// /// A convenience typedef that selects between /// std::uniform_real_distribution and std::uniform_int_distribution /// depending on the supplied value type. template using uniform_distribution = std::conditional_t< std::is_floating_point::value, std::uniform_real_distribution, std::uniform_int_distribution >; /////////////////////////////////////////////////////////////////////////// /// Returns a value chosen uniformly at random the supplied range. /// /// This is primarily a convenience helper around the uniform_distribution /// type. As such, the interval is the same as the std library; ie, closed /// for integers, half-open for reals. template decltype(auto) uniform (ValueT lo, ValueT hi, GeneratorT &&gen) { return uniform_distribution { lo, hi } ( std::forward (gen) ); } ///------------------------------------------------------------------------ /// Return a value uniformly random chosen value between lo and hi. /// /// Interval bounds are treated as per the standard Generator /// implementations; ie, inclusive for integers, exclusive upper for reals. template decltype(auto) uniform (T lo, T hi) { return uniform (lo, hi, generator ()); } ///------------------------------------------------------------------------ /// Return a value uniformly chosen between 0 and the given value. /// /// Interval bounds are treated as per the standard Generator /// implementations; ie, inclusive for integers, exclusive upper for reals. template decltype(auto) uniform (T hi) { return uniform (T{0}, hi); } ///------------------------------------------------------------------------ /// Return a uniformly random value chosen on the interval [0,1) template < typename ValueT, typename GeneratorT, typename = std::enable_if_t> > decltype(auto) uniform (GeneratorT &&gen) { return uniform (ValueT{0}, ValueT{1}, std::forward (gen)); } ///------------------------------------------------------------------------ /// Return a uniformly random chosen value on the interval [0.f, 1.f) template < typename ValueT, typename = std::enable_if_t> > decltype(auto) uniform (void) { return uniform (ValueT{0}, ValueT{1}, generator ()); } ///------------------------------------------------------------------------ /// Return a uniformly random chosen value on the interval [0, 1] template std::enable_if_t,T> uniform (void) { return uniform ( std::numeric_limits::min (), std::numeric_limits::max () ); } ///------------------------------------------------------------------------ /// Returns a uniformly random initialised coordinate type by value. template < typename ValueT, typename = std::enable_if_t< is_coord_v && std::is_floating_point_v > > ValueT uniform (void) { ValueT res; for (auto &v: res) v = uniform (); return res; } /////////////////////////////////////////////////////////////////////////// /// choose a value at random from an array template T& choose (T (&t)[N]) { std::uniform_int_distribution dist (0, N - 1); return t[dist (generator ())]; } //------------------------------------------------------------------------- template auto choose (ContainerT &data, GeneratorT &&gen) { if (data.empty ()) return data.end (); auto const offset = uniform ( typename ContainerT::size_type {0}, data.size () - 1, gen ); return std::next (data.begin (), offset); } //------------------------------------------------------------------------- template auto choose (ContainerT &data) { return choose (data, generator ()); } }