#region Copyright & License Information /* * Copyright (c) The OpenRA Developers and Contributors * This file is part of OpenRA, which is free software. It is made * available to you under the terms of the GNU General Public License * as published by the Free Software Foundation, either version 3 of * the License, or (at your option) any later version. For more * information, see COPYING. */ #endregion using System; namespace OpenRA.Support { // Quick & dirty Mersenne Twister [MT19937] implementation public class MersenneTwister { readonly uint[] mt = new uint[624]; int index = 0; public int Last; public int TotalCount = 0; public MersenneTwister() : this(Environment.TickCount) { } public MersenneTwister(int seed) { mt[0] = (uint)seed; for (var i = 1u; i < mt.Length; i++) mt[i] = 1812433253u * (mt[i - 1] ^ (mt[i - 1] >> 30)) + i; } /// /// Produces a random unsigned 32-bit integer. /// public uint NextUint() { if (index == 0) Generate(); var y = mt[index]; y ^= y >> 11; y ^= (y << 7) & 2636928640; y ^= (y << 15) & 4022730752; y ^= y >> 18; index = (index + 1) % 624; TotalCount++; Last = (int)(y % int.MaxValue); return y; } /// /// Produces a random unsigned 64-bit integer. /// public ulong NextUlong() { return (ulong)NextUint() << 32 | NextUint(); } /// /// Produces signed integers between -0x7fffffff and 0x7fffffff inclusive. /// 0 is twice as likely as any other number. /// public int Next() { NextUint(); return Last; } public int Next(int low, int high) { if (high < low) throw new ArgumentOutOfRangeException(nameof(high), "Maximum value is less than the minimum value."); var diff = high - low; if (diff <= 1) return low; return low + Next() % diff; } public int Next(int high) { return Next(0, high); } /// /// Produces random 32-bit floats between 0 inclusive and 1 inclusive. /// Note that whilst floats are 32-bit (23-bit mantissa), the entropy is not. Lower numbers preserve more entropy. /// public float NextFloat() { return Math.Abs(Next() / (float)0x7fffffff); } /// /// Pick a random index from a list of weights. /// public int PickWeighted(ReadOnlySpan weights) { ulong total = 0; for (var i = 0; i < weights.Length; i++) { var weight = weights[i]; if (weight < 0) throw new ArgumentException("Found a negative weight."); total += (ulong)weight; } if (total == 0) return Next(0, weights.Length); var spin = NextUlong() % total; ulong acc = 0; for (var i = 0; i < weights.Length; i++) { acc += (ulong)weights[i]; if (spin < acc) return i; } throw new InvalidOperationException("unreachable"); } /// /// Shuffle a portion of a list in place. Has minor biases. /// public void ShuffleInPlace(Span span, int start, int len) { for (var i = len; i > 1; i--) { var swap = Next(i); (span[start + i - 1], span[start + swap]) = (span[start + swap], span[start + i - 1]); } } void Generate() { unchecked { for (var i = 0u; i < mt.Length; i++) { var y = (mt[i] & 0x80000000) | (mt[(i + 1) % 624] & 0x7fffffff); mt[i] = mt[(i + 397u) % 624u] ^ (y >> 1); if ((y & 1) == 1) mt[i] ^= 2567483615; } } } } }