rand_mt

KO | EN

gitlite — search

#react #docker #python #app #python3 #deep-learning #machine-learning #csharp #java #mysql #swagger #redux

★ 26 Open GitHub ↗

🌪 Mersenne Twister implementation backed by rand_core

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# rand_mt

[![GitHub Actions](https://github.com/artichoke/rand_mt/workflows/CI/badge.svg)](https://github.com/artichoke/rand_mt/actions)
[![Code Coverage](https://codecov.artichokeruby.org/rand_mt/badges/flat.svg?nocache=2)](https://codecov.artichokeruby.org/rand_mt/index.html)
[![Twitter](https://img.shields.io/twitter/follow/artichokeruby?label=Follow&style=social)](https://twitter.com/artichokeruby)
<br>
[![Crate](https://img.shields.io/crates/v/rand_mt.svg)](https://crates.io/crates/rand_mt)
[![API](https://docs.rs/rand_mt/badge.svg)](https://docs.rs/rand_mt)
[![API trunk](https://img.shields.io/badge/docs-trunk-blue.svg)](https://artichoke.github.io/rand_mt/rand_mt/)

Implements a selection of Mersenne Twister random number generators.

> A very fast random number generator of period 2<sup>19937</sup>-1. (Makoto
> Matsumoto, 1997).

The Mersenne Twister algorithms are not suitable for cryptographic uses, but are
ubiquitous. See the [Mersenne Twister website]. A variant of Mersenne Twister is
the [default PRNG in Ruby].

[mersenne twister website]:
  http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/emt.html
[default prng in ruby]: https://ruby-doc.org/core-3.1.2/Random.html

This crate optionally depends on [`rand_core`] and implements `Rng` on the RNGs
in this crate.

[`rand_core`]: https://crates.io/crates/rand_core

## Usage

Add this to your `Cargo.toml`:

```toml
[dependencies]
rand_mt = "6.0.3"
```

Then create a RNG with an explicit seed:

```rust
use rand_mt::Mt64;

let mut rng = Mt64::new(0x0123_4567_89ab_cdef_u64);
assert_ne!(rng.next_u64(), rng.next_u64());
```

`Mt::new_unseeded()` and `Mt64::new_unseeded()` are deterministic shortcuts for
the reference seed. They are intended for reproducible streams and tests and do
not gather entropy.

## Crate Features

`rand_mt` is `no_std` compatible. `rand_mt` has several optional features that
are enabled by default:

- **rand-traits** - Enables a dependency on [`rand_core`]. Activating this
  feature implements `Rng` and `SeedableRng` on the RNGs in this crate.

Mersenne Twister requires approximately 2.5 kilobytes of internal state. To make
the RNGs implemented in this crate practical to embed in other structs, you may
wish to store the RNG in a `Box`.

### Minimum Supported Rust Version

This crate requires at least Rust 1.85.0. This version can be bumped in minor
releases.

## License

`rand_mt` is distributed under the terms of either the
[MIT License](LICENSE-MIT) or the
[Apache License (Version 2.0)](LICENSE-APACHE).

`rand_mt` is derived from `rust-mersenne-twister` @ [`1.1.1`] which is Copyright
(c) 2015 rust-mersenne-twister developers.

[`1.1.1`]: https://github.com/dcrewi/rust-mersenne-twister/tree/1.1.1

rand_mt

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README