/* * 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-2018 Danny Robson */ #pragma once #include "coord/traits.hpp" #include #include #include #include #include namespace cruft::random { /// A trait describing the internal state size of a given Generator. /// /// The structure must be specialised. /// /// \tparam GeneratorT The generator to query template struct state_size; //------------------------------------------------------------------------- template < class UIntType, size_t w, size_t n, size_t m, size_t r, UIntType a, size_t u, UIntType d, size_t s, UIntType b, size_t t, UIntType c, size_t l, UIntType f > struct state_size> { static constexpr auto value = n * sizeof (UIntType); }; //------------------------------------------------------------------------- template struct state_size> { static constexpr auto value = sizeof (UIntType); }; //------------------------------------------------------------------------- template constexpr auto state_size_v = state_size::value; /////////////////////////////////////////////////////////////////////////// /// 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::default_random_engine; static thread_local generator_t gen = [] () { std::array / 4> seed; std::generate (seed.begin (), seed.end (), std::random_device ()); std::seed_seq seq (seed.begin (), seed.end ()); return generator_t (seq); } (); 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. 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 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 {}; std::fill (res.begin (), res.end (), 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 ())]; } };