Package org.apache.commons.rng

package org.apache.commons.rng

This package contains the library's interface to be used by client code that needs a generator of sequences of pseudo-random numbers that are uniformly distributed in a specified range.

Jumpable Generators

Interfaces are specified for generators that are capable of advancing forward a large number of steps in the output period of the generator in a single jump. This can be used to create a series of non-overlapping generators for use in multithreaded applications.

Note that there is not a one-to-one relationship between the number of output random values from a provider and the number of steps from the underlying state cycle. This is due to:

1. Possible use of rejection algorithms to output a random value using multiple values from the state cycle.
2. The number of bits required to generate a random value differing from the number of bits generated by the underlying source of randomness. For example generation of a 64-bit long value using a 32-bit source of randomness.

Users are advised to use jumping generators with care to avoid overlapping output of multiple generators in parallel computations. A cautious approach is to use a jump distance far larger than the expected output length used by each generator.

Related Packages

Package	Description
org.apache.commons.rng.core	Base classes for the generation of uniformly distributed random numbers.
org.apache.commons.rng.sampling	This package provides sampling utilities.
org.apache.commons.rng.simple	This package provides factory methods by which low-level classes implemented in module "commons-rng-core" are instantiated.

Interfaces

Class	Description
ArbitrarilyJumpableUniformRandomProvider	Applies to generators that can be advanced an arbitrary number of steps of the output sequence in a single operation.
JumpableUniformRandomProvider	Applies to generators that can be advanced a large number of steps of the output sequence in a single operation.
LongJumpableUniformRandomProvider	Applies to generators that can be advanced a very large number of steps of the output sequence in a single operation.
RandomProviderState	Marker interface for objects that represents the state of a random generator.
RestorableUniformRandomProvider	Applies to generators whose internal state can be saved and restored.
SplittableUniformRandomProvider	Applies to generators that can be split into two objects (the original and a new instance) each of which implements the same interface (and can be recursively split indefinitely).
UniformRandomProvider	Applies to generators of random number sequences that follow a uniform distribution.