emonkak/random

A random number generator library

Emonkak\Random

, _(*1)

This library provides pseudo-random number generators and probability distributions., _(*2)

Requirements

• PHP 7.1 or higher

Licence

MIT Licence, _(*3)

Example

use Emonkak\Random\Engine\MT19937Engine;
use Emonkak\Random\Distribution\NormalDistribution;

$seed = 100;  // Initial seed
$engine = new MT19937Engine($seed);  // 32bit Mersenne Twister engine
$distribution = new NormalDistribution(0, 1);  // Standard normal distribution

// Generate a random number with the normal distribution.
$distribution->generate($engine);

Engine

• KnuthBEngine, _(*4)

• LinearCongruentialEngine, _(*5)

• MinstdRand0Engine, _(*6)

• MinstdRandEngine, _(*7)

• MT19937Engine, _(*8)

  The random generator engine according to Mersenne Twister. It is full-compatible to the built-in mt_rand()., _(*9)

  // Also, the initial seed algorithm is full-compatible to the built-in `mt_srand()`
  $engine = new MT19937Engine(/* $seed */);
  
  // Get a next random number from the current generator state.
  $number = $engine->next();  // as int
  $number = $engine->nextDouble();  // as float
  
  // Get the minimum and maximum number which generate a value by the engine.
  $minimum = $engine->min();
  $maximum = $engine->max();
  
  // Iterate the generator engine.
  foreach (new LimitIterator($engine, 0, 100) as $n) {
  }
  

• MTRandWrapper, _(*10)

  The wrapper for the built-in mt_rand()., _(*11)

• ShuffleOrderEngine, _(*12)

• XorShift128Engine, _(*13)

  The random generator engine according to Xorshift 128 bit algorithm., _(*14)

Distribution

• BernoulliDistribution
• BinomialDistribution
• DiscreteDistribution
• DistributionIterator
• ExponentialDistribution
• GammaDistribution
• GeometricDistribution
• LogNormalDistribution
• NormalDistribution
• PiecewiseConstantDistribution
• PiecewiseLinerDistribution
• UniformIntDistribution
• UniformRealDistribution