[MATH-1335] Factor out RNG implementations

• Type: Sub-task
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 4.0
• Labels: cleanup design modularization refactoring
• Assignee: Gilles Sadowski
• Reporter: Gilles Sadowski
• Created: 10/Mar/16 14:39
• Updated: 17/May/16 16:27
• Resolved: 22/Apr/16 22:31

Description

The package o.a.c.m.random contains a kludge of utilities related to random data generation (cf. section 2 of the userguide).

I propose to factor out the part that is concerned with the generation of uniformly distributed numbers (of the various Java types).
This will consist in deprecating the following classes in o.a.c.m.random:

• JDKRandomGenerator
• AbstractWell
• Well512a
• Well1024a
• Well19937a
• Well19937c
• Well44497a
• Well44497b
• ISAACRandom
• MersenneTwister
• AbstractRandomGenerator
• BitsStreamGenerator
• RandomGeneratorFactory
• RandomGenerator

The RNG functionality is to be defined in its own package.

The new design will make an explicit distinction between

• public (and hopefully stable) API
• internal classes (subject to change "without notice")

Issue Links

• incorporates: MATH-1327 Assessment of the quality of the random number generators
• incorporates: MATH-1336 64-bits based RNG
• is depended upon by: MATH-1158 Factory method to provide sampling from distributions
• relates to: MATH-1360 Replace usage (within CM) of old RNG API
• relates to: MATH-1366 Remove obsolete classes in "o.a.c.m.random"