#random #distribution #numbers #generator

zipf

A fast generator of discrete, bounded Zipf-distributed random numbers

13 stable releases (7 major)

7.0.1 Aug 13, 2023
7.0.0 Dec 25, 2020
6.1.0 Oct 22, 2019
6.0.0 Jun 28, 2019
0.2.0 Jan 23, 2017

#53 in Algorithms

Download history 10844/week @ 2024-07-20 9256/week @ 2024-07-27 12479/week @ 2024-08-03 13352/week @ 2024-08-10 16089/week @ 2024-08-17 19010/week @ 2024-08-24 10849/week @ 2024-08-31 9016/week @ 2024-09-07 8723/week @ 2024-09-14 9406/week @ 2024-09-21 8492/week @ 2024-09-28 9376/week @ 2024-10-05 6507/week @ 2024-10-12 8167/week @ 2024-10-19 6170/week @ 2024-10-26 4867/week @ 2024-11-02

26,938 downloads per month
Used in 19 crates (15 directly)

Apache-2.0

15KB
152 lines

rust-zipf

Crates.io Documentation Codecov Dependency status

Rust implementation of a fast, discrete, bounded, Zipf-distributed random number generator. Compared to the implementation provided by randomkit (which binds to NumPy's fork of RandomKit), this crate is approximately twice as fast:

$ cargo +nightly bench
test tests::bench_randomkit ... bench:         339 ns/iter (+/- 18)
test tests::bench_us        ... bench:          68 ns/iter (+/- 1)
test tests::bench_threadrng ... bench:          11 ns/iter (+/- 0)

It is also both driven by, and provides, a Rust random number generator.

This implementation is effectively a direct port of Apache Common's RejectionInversionZipfSampler, written in Java. It is based on the method described by Wolfgang Hörmann and Gerhard Derflinger in Rejection-inversion to generate variates from monotone discrete distributions from ACM Transactions on Modeling and Computer Simulation (TOMACS) 6.3 (1996).

Dependencies

~310KB