Tavenem.Randomize 2.1.0-preview.1

Tavenem.Randomize

Tavenem.Randomize provides pseudo-random number generation in various distributions.

For example, to print a single value from a normal distribution:

Console.WriteLine(Randomizer.Instance.NormalDistributionSample());

To print 10,000 values:

foreach (var value in Randomizer.Instance.NormalDistributionSamples(10000))
{
    Console.WriteLine(value);
}

Supported distributions:

• Binomial
• Categorical
• Exponential
• Logistic
• Log-normal
• Normal
• "Positive" normal (one half of a normal distribution, giving only values >= mean)

Tavenem.Randomize utilizes a Mersenne Twister by default, but also provides a mechanism for replacing the underlying generator with your own, provided it implements the library's IGenerator interface.

The library also provides a serializable RandomParameters struct, which can be used to persist or transport the parameters used to obtain a random value.

Tavenem.Randomize also provides a Rehydrator class that allows a deterministic set of random values to be recreated from the same seed, even if those values are requested out of order.

Installation

Tavenem.Randomize is available as a NuGet package.

Roadmap

Tavenem.Randomize' latest preview release targets .NET 7, which is also in preview. When a stable release of .NET 7 is published, a new stable release of Tavenem.Randomize will follow shortly.

Contributing

Contributions are always welcome. Please carefully read the contributing document to learn more before submitting issues or pull requests.

Code of conduct

Please read the code of conduct before engaging with our community, including but not limited to submitting or replying to an issue or pull request.