random-fu

Random number generation

https://github.com/mokus0/random-fu

LTS Haskell 24.18:0.3.0.1
Stackage Nightly 2025-07-14:0.3.0.1
Latest on Hackage:0.3.0.1

See all snapshots random-fu appears in

LicenseRef-PublicDomain licensed by James Cook
Maintained by Dominic Steinitz
This version can be pinned in stack with:random-fu-0.3.0.1@sha256:4fc8f22150fd700afdc016122c5acb8dc004633dc00c1d3826ed07d0913c5182,4510

Module documentation for 0.3.0.1

Used by 3 packages in nightly-2025-07-02(full list with versions):
dice, lambdabot-core, misfortune

Random number generation based on modeling random variables in two complementary ways: first, by the parameters of standard mathematical distributions and, second, by an abstract type (RVar) which can be composed and manipulated monadically and sampled in either monadic or "pure" styles.

The primary purpose of this library is to support defining and sampling a wide variety of high quality random variables. Quality is prioritized over speed, but performance is an important goal too.

In my testing, I have found it capable of speed comparable to other Haskell libraries, but still a fair bit slower than straight C implementations of the same algorithms.

Changes

  • Chnages in 0.3.0.0:

    • Drop usage of random-source in favor of random

  • Changes in 0.2.7.7: Update to random-1.2. Revert 0.2.7.6 changes (which added an extra constraint to Data.Random.Sample.sampleState and Data.Random.Sample.sampleStateT).

  • Changes in 0.2.7.4: Compatibility with ghc 8.8.

  • Changes in 0.2.7.3: Remove dependence on log-domain. Raise lower bound for base to 4.9.

  • Changes in 0.2.7.1: Add PDF instance for Poisson.

  • Changes in 0.2.7.0: Add Simplex, fix logBetaPdf, fix binomialPdf and binomialCdf to actually use the numerically stable method!

  • Changes in 2.6.1: now supports probability density functions and log probability density functions via the PDF class, similar to R and initially just for the Beta, Binomial, Normal and Uniform distributions. The log Binomial probability density function uses Fast and Accurate Computation of Binomial Probabilities by Catherine Loader (this is what is implemented in R and Octave) to minimize the occurrence of underflow.

  • Changes in 0.2.4.0: Added a Lift instance that resolves a common overlapping-instance issue in user code.

  • Changes in 0.2.3.1: Should now build on GHC 7.6

  • Changes in 0.2.3.0: Added stretched exponential distribution, contributed by Ben Gamari.

  • Changes in 0.2.2.0: Bug fixes in Data.Random.Distribution.Categorical.

  • Changes in 0.2.1.1: Changed some one-field data types to newtypes, updated types for GHC 7.4’s removal of Eq and Show from the context of Num, and added RVarT versions of random variables in Data.Random.List