README

Quick example

Pick a random number between 0 and 10, but 7 is 50x more likely than any other number to occur.

iex> outcomes = 0..10
iex> weights = [ %{target: 7, weight: 50} ]
iex> WeightedRandom.rand(outcomes, weights)
7

Current state of the project

Version 1.0.0: In alpha. Actively being developed.

Version 0.4.x: Stable.

Improvements in v1.0.0:

• Significant performance Improvements
• Support for probabilities, not just weights
• Better user experience and quality of life improvements
• Polished docs and a livebook tutorial
• swappable backends, not locked into any particular algorithm.

Docs

See Hex docs. I will not keep documentation in the README.