#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;
using System.Collections.Generic;
using System.Linq;
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 an unsigned integer between -0x80000000 and 0x7fffffff inclusive.
///
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 an unsigned integer between -0x80000000 and 0x7fffffff inclusive.
///
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);
}
///
/// Produces uniformally distributed random floats between 0 inclusive and 1 exclusive.
/// Note that whilst floats are 32-bit (23-bit mantissa), each output contains exactly 23 bits of entropy.
///
public float NextFloatExclusive()
{
return (NextUint() & 0x7fffff) / (float)0x800000;
}
///
/// Produces uniformally distributed random doubles between 0 inclusive and 1 exclusive.
/// Note that whilst doubles are 64-bit (52-bit mantissa), each output contains exactly 52 bits of entropy.
///
public double NextDoubleExclusive()
{
return (NextUlong() & 0xfffffffffffffL) / (double)0x10000000000000L;
}
///
/// Pick a random an index from a list of weights.
///
public int PickWeighted(IReadOnlyList weights)
{
var total = weights.Sum();
var spin = NextFloatExclusive() * total;
int i;
float acc = 0;
for (i = 0; i < weights.Count; i++)
{
acc += weights[i];
if (spin < acc)
return i;
}
// This might be possible due to floating point precision loss
// (in rare cases). Or we might have been given rubbish
// weights. Return anything > 0.
for (i = 0; i < weights.Count; i++)
if (weights[i] > 0)
return i;
// All <= 0!
return Next(0, weights.Count);
}
///
/// Shuffle a portion of a list list in place. Has minor biases.
///
public void ShuffleInPlace(IList list, int start, int len)
{
for (var i = len; i > 1; i--)
{
var swap = Next(i);
(list[start + i - 1], list[start + swap]) =
(list[start + swap], list[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;
}
}
}
}
}