commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bar...@apache.org
Subject [48/51] [partial] commons-rng git commit: Multimodule support
Date Tue, 25 Oct 2016 22:37:46 GMT
http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/main/java/org/apache/commons/rng/package-info.java
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/main/java/org/apache/commons/rng/package-info.java b/commons-rng-core/src/main/java/org/apache/commons/rng/package-info.java
new file mode 100644
index 0000000..7218099
--- /dev/null
+++ b/commons-rng-core/src/main/java/org/apache/commons/rng/package-info.java
@@ -0,0 +1,95 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * <h3>Randomness Providers</h3>
+ *
+ * <p>
+ * This package contains the public API for generating sequences of
+ * pseudo-random numbers that are <i>uniformly distributed</i> in a
+ * specified range.
+ * <br>
+ * All implemented generators can be instantiated through
+ * {@link org.apache.commons.rng.RandomSource factory methods}.
+ * The low-level classes, that define how the randomness is produced,
+ * are implemented in package {@link org.apache.commons.rng.internal}
+ * and its sub-packages, but should not be used directly.
+ * <br>
+ * The generators are <i>not</i> thread-safe: Parallel applications must
+ * use different generator instances in different threads.
+ * </p>
+ *
+ * <p>
+ * In the case of pseudo-random generators, the source of randomness is
+ * usually a set of numbers whose bits representation are scrambled in such
+ * a way as to produce a random-looking sequence.
+ * <br>
+ * The main property of the sequence is that the numbers must be uniformly
+ * distributed within their allowed range.
+ * <br>
+ * Classes in this package do not provide any further processing of the
+ * number generation such as to match other types of distribution.
+ * </p>
+ *
+ * <p>
+ * Which source of randomness to choose may depend on which properties
+ * are more important.
+ * Considerations can include speed of generation, memory usage, period
+ * size, equidistribution, correlation, etc.
+ * <br>
+ * For some of the generators, interesting properties (of the reference
+ * implementations) are proven in scientific papers.
+ * Some generators can also suffer from potential weaknesses.
+ * </p>
+ *
+ * <p>
+ * For simple sampling, any of the generators implemented in this library
+ * may be sufficient.
+ * <br>
+ * For Monte-Carlo simulations that require generating high-dimensional
+ * vectors), equidistribution and non-correlation are crucial.
+ * The <i>Mersenne Twister</i> and <i>Well</i> generators have
+ * equidistribution properties proven according to their bits pool size
+ * which is directly related to their period (all of them have maximal
+ * period, i.e. a generator with size {@code n} pool has a period
+ * <code>2<sup>n</sup>-1</code>).
+ * They also have equidistribution properties for 32 bits blocks up to
+ * {@code s/32} dimension where {@code s} is their pool size.
+ * <br>
+ * For example, {@code Well19937c} is equidistributed up to dimension 623
+ * (i.e. 19937 divided by 32).
+ * It means that a Monte-Carlo simulation generating vectors of {@code n}
+ * (32-bits integer) variables at each iteration has some guarantee on the
+ * properties of its components as long as {@code n < 623}.
+ * Note that if the variables are of type {@code double}, the limit is
+ * divided by two (since 64 bits are needed to create a {@code double}).
+ * <br>
+ * Reference to the relevant publications are listed in the specific
+ * documentation of each class.
+ * </p>
+ *
+ * <p>
+ * Memory usage can vary a lot between providers.
+ * The state of {@code MersenneTwister} is composed of 624 integers,
+ * using about 2.5 kB.
+ * The <i>Well</i> generators use 6 integer arrays, the length of each
+ * being equal to the pool size; thus, for example, {@code Well44497b}
+ * uses about 33 kB.
+ * </p>
+ */
+
+package org.apache.commons.rng;

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/site/apt/userguide/rng.apt
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/site/apt/userguide/rng.apt b/commons-rng-core/src/site/apt/userguide/rng.apt
new file mode 100644
index 0000000..e9128bf
--- /dev/null
+++ b/commons-rng-core/src/site/apt/userguide/rng.apt
@@ -0,0 +1,510 @@
+~~
+~~ Licensed to the Apache Software Foundation (ASF) under one or more
+~~ contributor license agreements.  See the NOTICE file distributed with
+~~ this work for additional information regarding copyright ownership.
+~~ The ASF licenses this file to You under the Apache License, Version 2.0
+~~ (the "License"); you may not use this file except in compliance with
+~~ the License.  You may obtain a copy of the License at
+~~
+~~      http://www.apache.org/licenses/LICENSE-2.0
+~~
+~~ Unless required by applicable law or agreed to in writing, software
+~~ distributed under the License is distributed on an "AS IS" BASIS,
+~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+~~ See the License for the specific language governing permissions and
+~~ limitations under the License.
+~~
+
+  -----------------------------
+  The Apache Commons RNG User Guide
+  -----------------------------
+
+1. Usage overview
+
+  <<<Commons RNG>>> provides generators of random sequences of numbers.
+  Please refer to the {{{../apidocs/index.html}Javadoc}} for details on
+  the API illustrated by the following examples.
+
+
+  * The public API is defined in package <<<org.apache.commons.rng>>>.
+
++--------------------------+
+import org.apache.commons.rng.UniformRandomProvider;
+import org.apache.commons.rng.RandomSource;
++--------------------------+
+
+
+  * Random number generator objects are instantiated through factory
+    methods defined in <<<RandomSource>>>, an <<<enum>>> that declares
+    {{{../apidocs/org/apache/commons/rng/RandomSource.html#enum.constant.detail}all the available implementations}}.
+
++--------------------------+
+UniformRandomProvider rng = RandomSource.create(RandomSource.MT);
++--------------------------+
+
+
+  * A generator will return a randomly selected element from a range
+    of possible values of some Java (primitive) type.
+
++--------------------------+
+boolean isOn = rng.nextBoolean(); // "true" or "false".
++--------------------------+
++--------------------------+
+int n = rng.nextInt(); // Integer.MIN_VALUE <= n <= Integer.MAX_VALUE.
+int m = rng.nextInt(max); // 0 <= m < max.
++--------------------------+
++--------------------------+
+long n = rng.nextLong(); // Long.MIN_VALUE <= n <= Long.MAX_VALUE.
+long m = rng.nextLong(max); // 0 <= m < max.
++--------------------------+
++--------------------------+
+float x = rng.nextFloat(); // 0 <= x < 1.
++--------------------------+
++--------------------------+
+double x = rng.nextDouble(); // 0 <= x < 1.
++--------------------------+
+
+
+  * A generator will fill a given <<<byte>>> array with random values.
+
++--------------------------+
+bytes[] a = new bytes[47];
+// The elements of "a" are replaced with random values from the interval [-128, 127].
+rng.nextBytes(a);
++--------------------------+
++--------------------------+
+bytes[] a = new bytes[47];
+// Replace 3 elements of the array (at indices 15, 16 and 17) with random values.
+rng.nextBytes(a, 15, 3);
++--------------------------+
+
+
+  * In order to generate reproducible sequences, generators must be instantiated with a user-defined seed.
+
++--------------------------+
+UniformRandomProvider rng = RandomSource.create(RandomSource.SPLIT_MIX_64, 5776);
++--------------------------+
+
+    If no seed is passed, a random seed is generated implicitly.
+
+    Convenience methods are provided for explicitly generating random seeds of the various types.
+
++--------------------------+
+int seed = RandomSource.createInt();
++--------------------------+
++--------------------------+
+long seed = RandomSource.createLong();
++--------------------------+
++--------------------------+
+int[] seed = RandomSource.createIntArray(128); // Length of returned array is 128.
++--------------------------+
++--------------------------+
+long[] seed = RandomSource.createLongArray(128); // Length of returned array is 128.
++--------------------------+
+
+
+  * Any of the following types can be passed to the <<<create>>> method as the "seed" argument:
+
+    ** <<<int>>> or <<<Integer>>>
+
+    ** <<<long>>> or <<<Long>>>
+
+    ** <<<int[]>>>
+
+    ** <<<long[]>>>
+
+    ** <<<byte[]>>>
+
+    []
+
++--------------------------+
+UniformRandomProvider rng = RandomSource.create(RandomSource.ISAAC, 5776);
++--------------------------+
++--------------------------+
+UniformRandomProvider rng = RandomSource.create(RandomSource.ISAAC, new int[] { 6, 7, 7, 5, 6, 1, 0, 2 });
++--------------------------+
++--------------------------+
+UniformRandomProvider rng = RandomSource.create(RandomSource.ISAAC, new long[] { 0x638a3fd83bc0e851L, 0x9730fd12c75ae247L });
++--------------------------+
+
+    Note however that, upon initialization, the underlying generation algorithm
+
+    ** may not use all the information contents of the seed,
+
+    ** may use a procedure (using the given seed as input) for further filling its internal state
+       (in order to avoid a too uniform initial state).
+
+    []
+
+    In both cases, the behaviour is not standard but should not change between releases of the library
+    (bugs notwithstanding).
+
+    Each RNG implementation has a single "native" seed; when the seed argument passed
+    to the <<<create>>> method is not of the native type, it is automatically converted.
+    The conversion preserves the information contents but is otherwise not specified (i.e.
+    different releases of the library may use different conversion procedures).
+
+    Hence, if reproducibility of the generated sequences across successive releases of the
+    library is necessary, users should ensure that they use native seeds.
+
++--------------------------+
+long seed = 9246234616L;
+if (!RandomSource.TWO_CMRES.isNativeSeed(seed)) {
+    throw new IllegalArgumentException("Seed is not native");
+}
++--------------------------+
+
+    For each available implementation, the native seed type is specified in the
+    {{{../apidocs/org/apache/commons/rng/RandomSource.html#enum.constant.detail}Javadoc}}.
+
+
+  * Whenever a random source implementation is parameterized, the custom arguments
+    are passed after the seed.
+
++--------------------------+
+int seed = 96912062;
+int first = 7; // Subcycle identifier.
+int second = 4; // Subcycle identifier.
+UniformRandomProvider rng = RandomSource.create(RandomSource.TWO_CMRES_SELECT, seed, first, second);
++--------------------------+
+
+    In the above example, valid "subcycle identifiers" are in the interval [0, 13].
+
+
+  * The current state of a generator can be
+    {{{../apidocs/org/apache/commons/rng/RestorableUniformRandomProvider.html#saveState}saved}}
+    and
+    {{{../apidocs/org/apache/commons/rng/RestorableUniformRandomProvider.html#restoreState-org.apache.commons.rng.RandomProviderState-}restored}}
+    later on.
+
++--------------------------+
+import org.apache.commons.rng.RestorableUniformRandomProvider;
+import org.apache.commons.rng.RandomProviderState;
+
+RestorableUniformRandomProvider rng = RandomSource.create(RandomSource.WELL_512_A);
+RandomProviderState state = rng.saveState();
+double x = rng.nextDouble();
+rng.restoreState(state);
+double y = rng.nextDouble(); // x == y.
++--------------------------+
+
+
+  * The <<<UniformRandomProvider>>> objects returned from the <<<create>>> methods do not
+    implement the <<<java.io.Serializable>>> interface.
+
+    However, users can easily set up a custom serialization scheme if the random source
+    is known at both ends of the communication channel.
+    This would be useful namely to save the state to persistent storage, and restore it
+    such that the sequence will continue from where it left off.
+
++--------------------------+
+RandomSource source = RandomSource.MT_64; // Known source identifier.
+
+RestorableUniformRandomProvider rngOrig = RandomSource.create(source); // Original RNG instance.
+
+// Save and serialize state.
+RandomProviderState stateOrig = rngOrig.saveState(rngOrig);
+ByteArrayOutputStream bos = new ByteArrayOutputStream();
+ObjectOutputStream oos = new ObjectOutputStream(bos);
+oos.writeObject(((RandomSource.State) stateOrig).getState());
+
+// Deserialize state.
+ByteArrayInputStream bis = new ByteArrayInputStream(bos.toByteArray());
+ObjectInputStream ois = new ObjectInputStream(bis);
+RandomProviderState stateNew = new RandomSource.State((byte[]) ois.readObject());
+
+RestorableUniformRandomProvider rngNew = RandomSource.create(source); // New RNG instance from the same "source".
+
+// Restore original state on the new instance.
+rngNew.restoreState(stateNew);
++--------------------------+
+
+
+  []
+
+
+2. Library layout
+
+  The library's public API consists of classes and interfaces defined in package
+  <<<org.apache.commons.rng>>>.
+
+  * Interface <<<UniformRandomProvider>>> provides access to a sequence of
+    random values uniformly distributed within some range.
+
+  * Enum <<<RandomSource>>> determines which algorithm to use for generating the
+    sequence of random values.
+
+  * Interfaces <<<RestorableUniformRandomProvider>>> and <<<RandomProviderState>>>
+    provide the "save/restore" API.
+
+  * Class <<<RandomSource.State>>> implements the <<<RandomProviderState>>>
+    interface to enable "save/restore" for all <<<RestorableUniformRandomProvider>>>
+    instances created through the <<<RandomSource>>> factory methods.
+
+  []
+
+  The <<<org.apache.commons.rng.internal>>> package and packages below it
+  contain classes for supporting the above API.
+  None of those classes should be used directly in applications.
+
+  The rest of this section briefly describes the internal classes.
+  More information is available in the {{{../apidocs/index.html}Javadoc}}.
+
+  * <<<ProviderBuilder>>>: contains methods for instantiating the concrete
+    RNG implementations based on the source identifier; it also takes care
+    of calling the appropriate classes for seed type conversion.
+
+  * <<<BaseProvider>>>: base class for all concrete RNG implementations;
+    it contains higher-level algorithms <<<nextInt(int n)>>> and <<<nextLong(long n)>>>
+    common to all implementations.
+
+  * <<<org.apache.commons.rng.internal.util>>>
+
+    ** <<<NumberFactory>>>: contains utilities for interpreting and combining
+       the output (<<<int>>> or <<<long>>>) of the underlying source of
+       randomness into the requested output, i.e. one of the Java primitive
+       types supported by <<<UniformRandomProvider>>>.
+
+    ** <<<SeedFactory>>>: contains factory methods for generating random seeds.
+
+    ** <<<SeedConverter>>>: interface for classes that transform between
+       supported seed types.
+
+    ** Various classes that implement <<<SeedConverter>>> in order to transform
+       from caller's seed to "native" seed.
+
+    []
+
+  * <<<org.apache.commons.rng.internal.source32>>>
+
+    ** <<<RandomIntSource>>>: describes an algorithm that generates randomness in
+       32-bits chunks (a.k.a Java <<<int>>>).
+
+    ** <<<IntProvider>>>: base class for concrete classes that implement <<<RandomIntSource>>>.
+
+    ** Concrete RNG algorithms that are subclasses of <<<IntProvider>>>.
+
+    []
+
+  * <<<org.apache.commons.rng.internal.source64>>>
+
+    ** <<<RandomLongSource>>>: describes an algorithm that generates randomness in
+       64-bits chunks (a.k.a Java <<<long>>>).
+
+    ** <<<LongProvider>>>: base class for concrete classes that implement <<<RandomLongSource>>>.
+
+    ** Concrete RNG algorithms that are subclasses of <<<LongProvider>>>.
+
+    []
+
+  []
+
+
+3. Performance
+
+  This section reports benchmarks of the RNG implementations.
+  All runs were performed on a platform with the following characteristics:
+
+  * CPU: Intel(R) Core(TM) i7-3770 CPU @ 3.40GHz
+
+  * Java runtime: 1.7.0_95-b00
+
+  * JVM: OpenJDK 64-Bit Server VM 24.95-b01
+
+  []
+
+  The following tables indicate the performance (as measured by
+  {{{http://openjdk.java.net/projects/code-tools/jmh/}JMH}}) for generating
+
+  * a sequence of 32-bits integers (a.k.a. Java type <<<int>>>)
+
+  * a sequence of 64-bits integers (a.k.a. Java type <<<long>>>)
+
+  * a sequence of 64-bits floating point numbers (a.k.a. Java type <<<double>>>)
+
+  []
+
+  The benchmark code is available in the "src/test" part of the source
+  code repository (in class <<<GenerationTestPerformance>>>).
+
+  The first column is the RNG identifier (see {{{../apidocs/org/apache/commons/rng/RandomSource.html}RandomSource}});
+  the performance value is the ratio of the (JMH) score with respect
+  to the score of <<<RandomSource.JDK>>>.
+
+  In these tables, <lower> is <better>.
+
+
+  ** Generating <<<int>>> values
+
+*--------------------------*----------------+
+|| RNG identifier          ||   Score ratio |
+*--------------------------*----------------+
+| MWC_256                  |        0.42168 |
+*--------------------------*----------------+
+| SPLIT_MIX_64             |        0.42845 |
+*--------------------------*----------------+
+| TWO_CMRES                |        0.46360 |
+*--------------------------*----------------+
+| XOR_SHIFT_1024_S         |        0.48818 |
+*--------------------------*----------------+
+| ISAAC                    |        0.56263 |
+*--------------------------*----------------+
+| KISS                     |        0.56340 |
+*--------------------------*----------------+
+| MT_64                    |        0.62591 |
+*--------------------------*----------------+
+| MT                       |        0.65198 |
+*--------------------------*----------------+
+| WELL_512_A               |        0.83364 |
+*--------------------------*----------------+
+| WELL_1024_A              |        0.88204 |
+*--------------------------*----------------+
+| WELL_44497_A             |        0.99618 |
+*--------------------------*----------------+
+| JDK                      |        1.00000 |
+*--------------------------*----------------+
+| WELL_44497_B             |        1.00641 |
+*--------------------------*----------------+
+| WELL_19937_A             |        1.09770 |
+*--------------------------*----------------+
+| WELL_19937_C             |        1.13420 |
+*--------------------------*----------------+
+
+
+  ** Generating <<<long>>> values
+
+*--------------------------*----------------+
+|| RNG identifier          ||   Score ratio |
+*--------------------------*----------------+
+| SPLIT_MIX_64             |        0.23505 |
+*--------------------------*----------------+
+| XOR_SHIFT_1024_S         |        0.26918 |
+*--------------------------*----------------+
+| TWO_CMRES                |        0.28069 |
+*--------------------------*----------------+
+| MT_64                    |        0.34193 |
+*--------------------------*----------------+
+| MWC_256                  |        0.40359 |
+*--------------------------*----------------+
+| KISS                     |        0.55043 |
+*--------------------------*----------------+
+| MT                       |        0.63092 |
+*--------------------------*----------------+
+| ISAAC                    |        0.63944 |
+*--------------------------*----------------+
+| WELL_512_A               |        0.65085 |
+*--------------------------*----------------+
+| WELL_1024_A              |        0.71561 |
+*--------------------------*----------------+
+| JDK                      |        1.00000 |
+*--------------------------*----------------+
+| WELL_19937_A             |        1.03761 |
+*--------------------------*----------------+
+| WELL_44497_A             |        1.06495 |
+*--------------------------*----------------+
+| WELL_44497_B             |        1.14565 |
+*--------------------------*----------------+
+| WELL_19937_C             |        1.23338 |
+*--------------------------*----------------+
+
+
+  ** Generating <<<double>>> values
+
+*--------------------------*----------------+
+|| RNG identifier          ||   Score ratio |
+*--------------------------*----------------+
+| SPLIT_MIX_64             |        0.28609 |
+*--------------------------*----------------+
+| XOR_SHIFT_1024_S         |        0.32866 |
+*--------------------------*----------------+
+| TWO_CMRES                |        0.34069 |
+*--------------------------*----------------+
+| MWC_256                  |        0.39083 |
+*--------------------------*----------------+
+| MT_64                    |        0.39368 |
+*--------------------------*----------------+
+| KISS                     |        0.60581 |
+*--------------------------*----------------+
+| ISAAC                    |        0.64429 |
+*--------------------------*----------------+
+| MT                       |        0.67086 |
+*--------------------------*----------------+
+| WELL_1024_A              |        0.73629 |
+*--------------------------*----------------+
+| WELL_512_A               |        0.78037 |
+*--------------------------*----------------+
+| JDK                      |        1.00000 |
+*--------------------------*----------------+
+| WELL_19937_A             |        1.11497 |
+*--------------------------*----------------+
+| WELL_44497_A             |        1.13362 |
+*--------------------------*----------------+
+| WELL_19937_C             |        1.15334 |
+*--------------------------*----------------+
+| WELL_44497_B             |        1.22613 |
+*--------------------------*----------------+
+
+
+
+4. Quality
+
+  This section reports results of performing "stress tests" that aim at detecting failures
+  of an implementation to produce sequences of numbers that follow a uniform distribution.
+
+  Two different test suites were used:
+
+  * {{{http://www.phy.duke.edu/~rgb/General/dieharder.php}Dieharder}}
+
+  * {{{http://simul.iro.umontreal.ca/testu01/tu01.html}TestU01}}
+
+  []
+
+  The first column is the RNG identifier (see {{{../apidocs/org/apache/commons/rng/RandomSource.html}RandomSource}}).
+  The second and third columns contain the number of tests which <Dieharder> and <TestU01>
+  respectively reported as below the accepted threshold for considering the sequence as
+  uniformly random; hence, in this table, <lower> is <better>.
+
+  For each the two test suites, three runs were performed (using random seeds): Click on one
+  of the numbers of the comma-separated list in order to see the text report of the
+  corresponding run.
+  Note: For <Dieharder>, a failure on the "Diehard Sums Test" can be {{{http://www.phy.duke.edu/~rgb/General/dieharder.php}ignored}}.
+
+
+*---------------------------------*----------------*---------------------*
+|| RNG identifier             || Dieharder     || TestU01 (BigCrush) |
+*----------------*----------------*----------------*---------------------*
+| JDK         | {{{../txt/userguide/stress/dh/run_1/dh_1}15}}, {{{../txt/userguide/stress/dh/run_2/dh_1}15}}, {{{../txt/userguide/stress/dh/run_3/dh_1}14}} | {{{../txt/userguide/stress/tu/run_1/tu_1}74}}, {{{../txt/userguide/stress/tu/run_2/tu_1}75}}, {{{../txt/userguide/stress/tu/run_3/tu_1}74}} |
+*---------------------------------*----------------*----------------*
+| MT   | {{{../txt/userguide/stress/dh/run_1/dh_2}0}}, {{{../txt/userguide/stress/dh/run_2/dh_2}0}}, {{{../txt/userguide/stress/dh/run_3/dh_2}0}} | {{{../txt/userguide/stress/tu/run_1/tu_2}2}}, {{{../txt/userguide/stress/tu/run_2/tu_2}2}}, {{{../txt/userguide/stress/tu/run_3/tu_2}2}} |
+*---------------------------------*----------------*----------------*
+| WELL_512_A          | {{{../txt/userguide/stress/dh/run_1/dh_3}0}}, {{{../txt/userguide/stress/dh/run_2/dh_3}1}}, {{{../txt/userguide/stress/dh/run_3/dh_3}0}} | {{{../txt/userguide/stress/tu/run_1/tu_3}6}}, {{{../txt/userguide/stress/tu/run_2/tu_3}6}}, {{{../txt/userguide/stress/tu/run_3/tu_3}7}} |
+*---------------------------------*----------------*----------------*
+| WELL_1024_A         | {{{../txt/userguide/stress/dh/run_1/dh_4}0}}, {{{../txt/userguide/stress/dh/run_2/dh_4}1}} , {{{../txt/userguide/stress/dh/run_3/dh_4}0}}| {{{../txt/userguide/stress/tu/run_1/tu_4}4}}, {{{../txt/userguide/stress/tu/run_2/tu_4}6}}, {{{../txt/userguide/stress/tu/run_3/tu_4}4}} |
+*---------------------------------*----------------*----------------*
+| WELL_19937_A        | {{{../txt/userguide/stress/dh/run_1/dh_5}0}}, {{{../txt/userguide/stress/dh/run_2/dh_5}0}}, {{{../txt/userguide/stress/dh/run_3/dh_5}0}} | {{{../txt/userguide/stress/tu/run_1/tu_5}2}}, {{{../txt/userguide/stress/tu/run_2/tu_5}2}}, {{{../txt/userguide/stress/tu/run_3/tu_5}2}} |
+*---------------------------------*----------------*----------------*
+| WELL_19937_C        | {{{../txt/userguide/stress/dh/run_1/dh_6}0}}, {{{../txt/userguide/stress/dh/run_2/dh_6}0}}, {{{../txt/userguide/stress/dh/run_3/dh_6}0}} | {{{../txt/userguide/stress/tu/run_1/tu_6}2}}, {{{../txt/userguide/stress/tu/run_2/tu_6}3}}, {{{../txt/userguide/stress/tu/run_3/tu_6}3}} |
+*---------------------------------*----------------*----------------*
+| WELL_44497_A        | {{{../txt/userguide/stress/dh/run_1/dh_7}0}}, {{{../txt/userguide/stress/dh/run_2/dh_7}0}}, {{{../txt/userguide/stress/dh/run_3/dh_7}0}} | {{{../txt/userguide/stress/tu/run_1/tu_7}3}}, {{{../txt/userguide/stress/tu/run_2/tu_7}3}}, {{{../txt/userguide/stress/tu/run_3/tu_7}2}} |
+*---------------------------------*----------------*----------------*
+| WELL_44497_B        | {{{../txt/userguide/stress/dh/run_1/dh_8}0}}, {{{../txt/userguide/stress/dh/run_2/dh_8}0}}, {{{../txt/userguide/stress/dh/run_3/dh_8}0}} | {{{../txt/userguide/stress/tu/run_1/tu_8}2}}, {{{../txt/userguide/stress/tu/run_2/tu_8}2}}, {{{../txt/userguide/stress/tu/run_3/tu_8}2}} |
+*---------------------------------*----------------*----------------*
+| ISAAC       | {{{../txt/userguide/stress/dh/run_1/dh_9}0}}, {{{../txt/userguide/stress/dh/run_2/dh_9}0}}, {{{../txt/userguide/stress/dh/run_3/dh_9}0}} | {{{../txt/userguide/stress/tu/run_1/tu_9}0}}, {{{../txt/userguide/stress/tu/run_2/tu_9}0}}, {{{../txt/userguide/stress/tu/run_3/tu_9}1}} |
+*---------------------------------*----------------*----------------*
+| MT_64 | {{{../txt/userguide/stress/dh/run_1/dh_10}1}}, {{{../txt/userguide/stress/dh/run_2/dh_10}0}}, {{{../txt/userguide/stress/dh/run_3/dh_10}0}} | {{{../txt/userguide/stress/tu/run_1/tu_10}2}}, {{{../txt/userguide/stress/tu/run_2/tu_10}2}}, {{{../txt/userguide/stress/tu/run_3/tu_10}2}} |
+*---------------------------------*----------------*----------------*
+| SPLIT_MIX_64        | {{{../txt/userguide/stress/dh/run_1/dh_11}0}}, {{{../txt/userguide/stress/dh/run_2/dh_11}0}}, {{{../txt/userguide/stress/dh/run_3/dh_11}0}} | {{{../txt/userguide/stress/tu/run_1/tu_11}2}}, {{{../txt/userguide/stress/tu/run_2/tu_11}0}}, {{{../txt/userguide/stress/tu/run_3/tu_11}1}} |
+*---------------------------------*----------------*----------------*
+| XOR_SHIFT_1024_S  | {{{../txt/userguide/stress/dh/run_1/dh_12}0}}, {{{../txt/userguide/stress/dh/run_2/dh_12}0}}, {{{../txt/userguide/stress/dh/run_3/dh_12}0}} | {{{../txt/userguide/stress/tu/run_1/tu_12}0}}, {{{../txt/userguide/stress/tu/run_2/tu_12}0}}, {{{../txt/userguide/stress/tu/run_3/tu_12}0}} |
+*---------------------------------*----------------*----------------*
+| TWO_CMRES          | {{{../txt/userguide/stress/dh/run_1/dh_13}0}}, {{{../txt/userguide/stress/dh/run_2/dh_13}0}}, {{{../txt/userguide/stress/dh/run_3/dh_13}0}} | {{{../txt/userguide/stress/tu/run_1/tu_13}0}}, {{{../txt/userguide/stress/tu/run_2/tu_13}0}}, {{{../txt/userguide/stress/tu/run_3/tu_13}1}} |
+*---------------------------------*----------------*----------------*
+| MWC_256          | {{{../txt/userguide/stress/dh/run_1/dh_14}0}}, {{{../txt/userguide/stress/dh/run_2/dh_14}0}}, {{{../txt/userguide/stress/dh/run_3/dh_14}0}} | {{{../txt/userguide/stress/tu/run_1/tu_14}0}}, {{{../txt/userguide/stress/tu/run_2/tu_14}0}}, {{{../txt/userguide/stress/tu/run_3/tu_14}1}} |
+*---------------------------------*----------------*----------------*
+| KISS          | {{{../txt/userguide/stress/dh/run_1/dh_15}0}}, {{{../txt/userguide/stress/dh/run_2/dh_15}0}}, {{{../txt/userguide/stress/dh/run_3/dh_15}0}} | {{{../txt/userguide/stress/tu/run_1/tu_15}0}}, {{{../txt/userguide/stress/tu/run_2/tu_15}1}}, {{{../txt/userguide/stress/tu/run_3/tu_15}0}} |
+*---------------------------------*----------------*----------------*
+
+
+5. Dependencies
+
+  Apache Commons RNG requires JDK 1.6+ and has no runtime dependencies.

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/site/resources/images/commons_rng.small.png
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/site/resources/images/commons_rng.small.png b/commons-rng-core/src/site/resources/images/commons_rng.small.png
new file mode 100644
index 0000000..da723e6
Binary files /dev/null and b/commons-rng-core/src/site/resources/images/commons_rng.small.png differ

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/site/resources/profile.jacoco
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/site/resources/profile.jacoco b/commons-rng-core/src/site/resources/profile.jacoco
new file mode 100644
index 0000000..a12755f
--- /dev/null
+++ b/commons-rng-core/src/site/resources/profile.jacoco
@@ -0,0 +1,17 @@
+# Licensed to the Apache Software Foundation (ASF) under one or more
+# contributor license agreements.  See the NOTICE file distributed with
+# this work for additional information regarding copyright ownership.
+# The ASF licenses this file to You under the Apache License, Version 2.0
+# (the "License"); you may not use this file except in compliance with
+# the License.  You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# -----------------------------------------------------------------------------
+#
+# Empty file used to automatically trigger JaCoCo profile from commons parent pom

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/site/resources/style/project.css
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/site/resources/style/project.css b/commons-rng-core/src/site/resources/style/project.css
new file mode 100644
index 0000000..bd137e4
--- /dev/null
+++ b/commons-rng-core/src/site/resources/style/project.css
@@ -0,0 +1,18 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+@import url("http://commons.apache.org/style/commons-maven.css");

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_1
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_1 b/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_1
new file mode 100644
index 0000000..26661c4
--- /dev/null
+++ b/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_1
@@ -0,0 +1,154 @@
+# 
+# RNG: org.apache.commons.rng.internal.source32.JDKRandom
+# 
+# Java: 1.8.0_66
+# Runtime: 1.8.0_66-b17
+# JVM: Java HotSpot(TM) 64-Bit Server VM 25.66-b17
+# OS: Linux 3.16.0-4-amd64 amd64
+# 
+# Analyzer: /usr/bin/dieharder -a -g 200 -Y 1 -k 2 
+# 
+#=============================================================================#
+#            dieharder version 3.31.1 Copyright 2003 Robert G. Brown          #
+#=============================================================================#
+   rng_name    |rands/second|   Seed   |
+stdin_input_raw|  5.67e+06  |2840506865|
+#=============================================================================#
+        test_name   |ntup| tsamples |psamples|  p-value |Assessment
+#=============================================================================#
+   diehard_birthdays|   0|       100|     100|0.57621219|  PASSED  
+      diehard_operm5|   0|   1000000|     100|0.00055306|   WEAK   
+      diehard_operm5|   0|   1000000|     200|0.00000071|  FAILED  
+  diehard_rank_32x32|   0|     40000|     100|0.95731462|  PASSED  
+    diehard_rank_6x8|   0|    100000|     100|0.32898409|  PASSED  
+   diehard_bitstream|   0|   2097152|     100|0.67921776|  PASSED  
+        diehard_opso|   0|   2097152|     100|0.86566812|  PASSED  
+        diehard_oqso|   0|   2097152|     100|0.00000000|  FAILED  
+         diehard_dna|   0|   2097152|     100|0.00001296|   WEAK   
+         diehard_dna|   0|   2097152|     200|0.00000000|  FAILED  
+diehard_count_1s_str|   0|    256000|     100|0.23694955|  PASSED  
+diehard_count_1s_byt|   0|    256000|     100|0.23013143|  PASSED  
+ diehard_parking_lot|   0|     12000|     100|0.00533504|  PASSED  
+    diehard_2dsphere|   2|      8000|     100|0.87763186|  PASSED  
+    diehard_3dsphere|   3|      4000|     100|0.43699837|  PASSED  
+     diehard_squeeze|   0|    100000|     100|0.00289936|   WEAK   
+     diehard_squeeze|   0|    100000|     200|0.00014286|   WEAK   
+     diehard_squeeze|   0|    100000|     300|0.00000240|   WEAK   
+     diehard_squeeze|   0|    100000|     400|0.00000004|  FAILED  
+        diehard_sums|   0|       100|     100|0.59180276|  PASSED  
+        diehard_runs|   0|    100000|     100|0.08316391|  PASSED  
+        diehard_runs|   0|    100000|     100|0.49800851|  PASSED  
+       diehard_craps|   0|    200000|     100|0.01569415|  PASSED  
+       diehard_craps|   0|    200000|     100|0.00048619|   WEAK   
+       diehard_craps|   0|    200000|     200|0.00136532|   WEAK   
+       diehard_craps|   0|    200000|     200|0.00000968|   WEAK   
+       diehard_craps|   0|    200000|     300|0.00007453|   WEAK   
+       diehard_craps|   0|    200000|     300|0.00000003|  FAILED  
+ marsaglia_tsang_gcd|   0|  10000000|     100|0.79874019|  PASSED  
+ marsaglia_tsang_gcd|   0|  10000000|     100|0.62099082|  PASSED  
+         sts_monobit|   1|    100000|     100|0.14392322|  PASSED  
+            sts_runs|   2|    100000|     100|0.30294306|  PASSED  
+          sts_serial|   1|    100000|     100|0.09623510|  PASSED  
+          sts_serial|   2|    100000|     100|0.94743592|  PASSED  
+          sts_serial|   3|    100000|     100|0.18980368|  PASSED  
+          sts_serial|   3|    100000|     100|0.87906570|  PASSED  
+          sts_serial|   4|    100000|     100|0.80920335|  PASSED  
+          sts_serial|   4|    100000|     100|0.19556675|  PASSED  
+          sts_serial|   5|    100000|     100|0.88559814|  PASSED  
+          sts_serial|   5|    100000|     100|0.63960062|  PASSED  
+          sts_serial|   6|    100000|     100|0.86702314|  PASSED  
+          sts_serial|   6|    100000|     100|0.82409716|  PASSED  
+          sts_serial|   7|    100000|     100|0.43279094|  PASSED  
+          sts_serial|   7|    100000|     100|0.46166474|  PASSED  
+          sts_serial|   8|    100000|     100|0.74562916|  PASSED  
+          sts_serial|   8|    100000|     100|0.60497789|  PASSED  
+          sts_serial|   9|    100000|     100|0.84280720|  PASSED  
+          sts_serial|   9|    100000|     100|0.39584344|  PASSED  
+          sts_serial|  10|    100000|     100|0.66325339|  PASSED  
+          sts_serial|  10|    100000|     100|0.32915214|  PASSED  
+          sts_serial|  11|    100000|     100|0.55046785|  PASSED  
+          sts_serial|  11|    100000|     100|0.91160568|  PASSED  
+          sts_serial|  12|    100000|     100|0.23658355|  PASSED  
+          sts_serial|  12|    100000|     100|0.35865223|  PASSED  
+          sts_serial|  13|    100000|     100|0.14455770|  PASSED  
+          sts_serial|  13|    100000|     100|0.09446869|  PASSED  
+          sts_serial|  14|    100000|     100|0.06963052|  PASSED  
+          sts_serial|  14|    100000|     100|0.51460272|  PASSED  
+          sts_serial|  15|    100000|     100|0.44018228|  PASSED  
+          sts_serial|  15|    100000|     100|0.98355374|  PASSED  
+          sts_serial|  16|    100000|     100|0.37583986|  PASSED  
+          sts_serial|  16|    100000|     100|0.30459422|  PASSED  
+         rgb_bitdist|   1|    100000|     100|0.91347086|  PASSED  
+         rgb_bitdist|   2|    100000|     100|0.74586617|  PASSED  
+         rgb_bitdist|   3|    100000|     100|0.65170123|  PASSED  
+         rgb_bitdist|   4|    100000|     100|0.97548455|  PASSED  
+         rgb_bitdist|   5|    100000|     100|0.08431429|  PASSED  
+         rgb_bitdist|   6|    100000|     100|0.80389916|  PASSED  
+         rgb_bitdist|   7|    100000|     100|0.22577815|  PASSED  
+         rgb_bitdist|   8|    100000|     100|0.99589982|   WEAK   
+         rgb_bitdist|   8|    100000|     200|0.41124448|  PASSED  
+         rgb_bitdist|   9|    100000|     100|0.57708945|  PASSED  
+         rgb_bitdist|  10|    100000|     100|0.48489918|  PASSED  
+         rgb_bitdist|  11|    100000|     100|0.96725584|  PASSED  
+         rgb_bitdist|  12|    100000|     100|0.87270516|  PASSED  
+rgb_minimum_distance|   2|     10000|    1000|0.03673180|  PASSED  
+rgb_minimum_distance|   3|     10000|    1000|0.00000000|  FAILED  
+rgb_minimum_distance|   4|     10000|    1000|0.00000000|  FAILED  
+rgb_minimum_distance|   5|     10000|    1000|0.00000000|  FAILED  
+    rgb_permutations|   2|    100000|     100|0.37952348|  PASSED  
+    rgb_permutations|   3|    100000|     100|0.51709788|  PASSED  
+    rgb_permutations|   4|    100000|     100|0.24627971|  PASSED  
+    rgb_permutations|   5|    100000|     100|0.67405928|  PASSED  
+      rgb_lagged_sum|   0|   1000000|     100|0.26053241|  PASSED  
+      rgb_lagged_sum|   1|   1000000|     100|0.67723203|  PASSED  
+      rgb_lagged_sum|   2|   1000000|     100|0.85183086|  PASSED  
+      rgb_lagged_sum|   3|   1000000|     100|0.00074092|   WEAK   
+      rgb_lagged_sum|   3|   1000000|     200|0.00000015|  FAILED  
+      rgb_lagged_sum|   4|   1000000|     100|0.66992032|  PASSED  
+      rgb_lagged_sum|   5|   1000000|     100|0.82428650|  PASSED  
+      rgb_lagged_sum|   6|   1000000|     100|0.83834106|  PASSED  
+      rgb_lagged_sum|   7|   1000000|     100|0.00000000|  FAILED  
+      rgb_lagged_sum|   8|   1000000|     100|0.58010627|  PASSED  
+      rgb_lagged_sum|   9|   1000000|     100|0.99648569|   WEAK   
+      rgb_lagged_sum|   9|   1000000|     200|0.86550749|  PASSED  
+      rgb_lagged_sum|  10|   1000000|     100|0.99362172|  PASSED  
+      rgb_lagged_sum|  11|   1000000|     100|0.37038623|  PASSED  
+      rgb_lagged_sum|  12|   1000000|     100|0.53452677|  PASSED  
+      rgb_lagged_sum|  13|   1000000|     100|0.00101290|   WEAK   
+      rgb_lagged_sum|  13|   1000000|     200|0.00002106|   WEAK   
+      rgb_lagged_sum|  13|   1000000|     300|0.00000046|  FAILED  
+      rgb_lagged_sum|  14|   1000000|     100|0.94326371|  PASSED  
+      rgb_lagged_sum|  15|   1000000|     100|0.00000000|  FAILED  
+      rgb_lagged_sum|  16|   1000000|     100|0.99558389|   WEAK   
+      rgb_lagged_sum|  16|   1000000|     200|0.66806201|  PASSED  
+      rgb_lagged_sum|  17|   1000000|     100|0.02891790|  PASSED  
+      rgb_lagged_sum|  18|   1000000|     100|0.72583167|  PASSED  
+      rgb_lagged_sum|  19|   1000000|     100|0.16450807|  PASSED  
+      rgb_lagged_sum|  20|   1000000|     100|0.57156434|  PASSED  
+      rgb_lagged_sum|  21|   1000000|     100|0.95197189|  PASSED  
+      rgb_lagged_sum|  22|   1000000|     100|0.50120259|  PASSED  
+      rgb_lagged_sum|  23|   1000000|     100|0.01648373|  PASSED  
+      rgb_lagged_sum|  24|   1000000|     100|0.33233530|  PASSED  
+      rgb_lagged_sum|  25|   1000000|     100|0.65249923|  PASSED  
+      rgb_lagged_sum|  26|   1000000|     100|0.33566809|  PASSED  
+      rgb_lagged_sum|  27|   1000000|     100|0.01296223|  PASSED  
+      rgb_lagged_sum|  28|   1000000|     100|0.21014986|  PASSED  
+      rgb_lagged_sum|  29|   1000000|     100|0.05841657|  PASSED  
+      rgb_lagged_sum|  30|   1000000|     100|0.99986818|   WEAK   
+      rgb_lagged_sum|  30|   1000000|     200|0.97195607|  PASSED  
+      rgb_lagged_sum|  31|   1000000|     100|0.00000000|  FAILED  
+      rgb_lagged_sum|  32|   1000000|     100|0.88755977|  PASSED  
+     rgb_kstest_test|   0|     10000|    1000|0.58410008|  PASSED  
+     dab_bytedistrib|   0|  51200000|       1|1.00000000|  FAILED  
+             dab_dct| 256|     50000|       1|0.78350196|  PASSED  
+Preparing to run test 207.  ntuple = 0
+        dab_filltree|  32|  15000000|       1|0.00000007|  FAILED  
+        dab_filltree|  32|  15000000|       1|0.00004853|   WEAK   
+Preparing to run test 208.  ntuple = 0
+       dab_filltree2|   0|   5000000|       1|0.77148308|  PASSED  
+       dab_filltree2|   1|   5000000|       1|0.56025175|  PASSED  
+Preparing to run test 209.  ntuple = 0
+        dab_monobit2|  12|  65000000|       1|0.59097214|  PASSED  
+# 
+# Test duration: 235.37197848473335 minutes
+# 

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_10
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_10 b/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_10
new file mode 100644
index 0000000..05a28df
--- /dev/null
+++ b/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_10
@@ -0,0 +1,178 @@
+# 
+# RNG: org.apache.commons.rng.internal.source64.MersenneTwister64
+# 
+# Java: 1.8.0_66
+# Runtime: 1.8.0_66-b17
+# JVM: Java HotSpot(TM) 64-Bit Server VM 25.66-b17
+# OS: Linux 3.16.0-4-amd64 amd64
+# 
+# Analyzer: /usr/bin/dieharder -a -g 200 -Y 1 -k 2 
+# 
+#=============================================================================#
+#            dieharder version 3.31.1 Copyright 2003 Robert G. Brown          #
+#=============================================================================#
+   rng_name    |rands/second|   Seed   |
+stdin_input_raw|  1.58e+07  |2125837889|
+#=============================================================================#
+        test_name   |ntup| tsamples |psamples|  p-value |Assessment
+#=============================================================================#
+   diehard_birthdays|   0|       100|     100|0.66447685|  PASSED  
+      diehard_operm5|   0|   1000000|     100|0.82679717|  PASSED  
+  diehard_rank_32x32|   0|     40000|     100|0.67457080|  PASSED  
+    diehard_rank_6x8|   0|    100000|     100|0.23591542|  PASSED  
+   diehard_bitstream|   0|   2097152|     100|0.31065992|  PASSED  
+        diehard_opso|   0|   2097152|     100|0.20739109|  PASSED  
+        diehard_oqso|   0|   2097152|     100|0.08657999|  PASSED  
+         diehard_dna|   0|   2097152|     100|0.20585631|  PASSED  
+diehard_count_1s_str|   0|    256000|     100|0.15219633|  PASSED  
+diehard_count_1s_byt|   0|    256000|     100|0.53516988|  PASSED  
+ diehard_parking_lot|   0|     12000|     100|0.37143226|  PASSED  
+    diehard_2dsphere|   2|      8000|     100|0.80952547|  PASSED  
+    diehard_3dsphere|   3|      4000|     100|0.00679068|  PASSED  
+     diehard_squeeze|   0|    100000|     100|0.78601541|  PASSED  
+        diehard_sums|   0|       100|     100|0.00115759|   WEAK   
+        diehard_sums|   0|       100|     200|0.00000606|   WEAK   
+        diehard_sums|   0|       100|     300|0.00016788|   WEAK   
+        diehard_sums|   0|       100|     400|0.00073854|   WEAK   
+        diehard_sums|   0|       100|     500|0.00004989|   WEAK   
+        diehard_sums|   0|       100|     600|0.00005389|   WEAK   
+        diehard_sums|   0|       100|     700|0.00000157|   WEAK   
+        diehard_sums|   0|       100|     800|0.00000052|  FAILED  
+        diehard_runs|   0|    100000|     100|0.63756488|  PASSED  
+        diehard_runs|   0|    100000|     100|0.59138116|  PASSED  
+       diehard_craps|   0|    200000|     100|0.97102396|  PASSED  
+       diehard_craps|   0|    200000|     100|0.79653458|  PASSED  
+ marsaglia_tsang_gcd|   0|  10000000|     100|0.18120360|  PASSED  
+ marsaglia_tsang_gcd|   0|  10000000|     100|0.18190481|  PASSED  
+         sts_monobit|   1|    100000|     100|0.79873945|  PASSED  
+            sts_runs|   2|    100000|     100|0.54821034|  PASSED  
+          sts_serial|   1|    100000|     100|0.50956268|  PASSED  
+          sts_serial|   2|    100000|     100|0.47472795|  PASSED  
+          sts_serial|   3|    100000|     100|0.81833075|  PASSED  
+          sts_serial|   3|    100000|     100|0.45500403|  PASSED  
+          sts_serial|   4|    100000|     100|0.96649001|  PASSED  
+          sts_serial|   4|    100000|     100|0.91571527|  PASSED  
+          sts_serial|   5|    100000|     100|0.99696203|   WEAK   
+          sts_serial|   5|    100000|     100|0.85706444|  PASSED  
+          sts_serial|   6|    100000|     100|0.69543459|  PASSED  
+          sts_serial|   6|    100000|     100|0.59864863|  PASSED  
+          sts_serial|   7|    100000|     100|0.82894537|  PASSED  
+          sts_serial|   7|    100000|     100|0.38269381|  PASSED  
+          sts_serial|   8|    100000|     100|0.58128565|  PASSED  
+          sts_serial|   8|    100000|     100|0.35503423|  PASSED  
+          sts_serial|   9|    100000|     100|0.44812561|  PASSED  
+          sts_serial|   9|    100000|     100|0.18747738|  PASSED  
+          sts_serial|  10|    100000|     100|0.76279505|  PASSED  
+          sts_serial|  10|    100000|     100|0.97949964|  PASSED  
+          sts_serial|  11|    100000|     100|0.86677019|  PASSED  
+          sts_serial|  11|    100000|     100|0.62735272|  PASSED  
+          sts_serial|  12|    100000|     100|0.96498152|  PASSED  
+          sts_serial|  12|    100000|     100|0.82919474|  PASSED  
+          sts_serial|  13|    100000|     100|0.54933778|  PASSED  
+          sts_serial|  13|    100000|     100|0.93779768|  PASSED  
+          sts_serial|  14|    100000|     100|0.80737509|  PASSED  
+          sts_serial|  14|    100000|     100|0.92048410|  PASSED  
+          sts_serial|  15|    100000|     100|0.81291720|  PASSED  
+          sts_serial|  15|    100000|     100|0.18753763|  PASSED  
+          sts_serial|  16|    100000|     100|0.10502142|  PASSED  
+          sts_serial|  16|    100000|     100|0.31515720|  PASSED  
+          sts_serial|   1|    100000|     200|0.93119672|  PASSED  
+          sts_serial|   2|    100000|     200|0.19415363|  PASSED  
+          sts_serial|   3|    100000|     200|0.93621841|  PASSED  
+          sts_serial|   3|    100000|     200|0.38954926|  PASSED  
+          sts_serial|   4|    100000|     200|0.52482271|  PASSED  
+          sts_serial|   4|    100000|     200|0.21944730|  PASSED  
+          sts_serial|   5|    100000|     200|0.63857617|  PASSED  
+          sts_serial|   5|    100000|     200|0.49705739|  PASSED  
+          sts_serial|   6|    100000|     200|0.80419687|  PASSED  
+          sts_serial|   6|    100000|     200|0.60132697|  PASSED  
+          sts_serial|   7|    100000|     200|0.86975381|  PASSED  
+          sts_serial|   7|    100000|     200|0.48421767|  PASSED  
+          sts_serial|   8|    100000|     200|0.90198898|  PASSED  
+          sts_serial|   8|    100000|     200|0.79401040|  PASSED  
+          sts_serial|   9|    100000|     200|0.48128220|  PASSED  
+          sts_serial|   9|    100000|     200|0.40643235|  PASSED  
+          sts_serial|  10|    100000|     200|0.34246845|  PASSED  
+          sts_serial|  10|    100000|     200|0.95350599|  PASSED  
+          sts_serial|  11|    100000|     200|0.89286891|  PASSED  
+          sts_serial|  11|    100000|     200|0.96545164|  PASSED  
+          sts_serial|  12|    100000|     200|0.81467317|  PASSED  
+          sts_serial|  12|    100000|     200|0.47986677|  PASSED  
+          sts_serial|  13|    100000|     200|0.74489807|  PASSED  
+          sts_serial|  13|    100000|     200|0.78315805|  PASSED  
+          sts_serial|  14|    100000|     200|0.81467426|  PASSED  
+          sts_serial|  14|    100000|     200|0.69026593|  PASSED  
+          sts_serial|  15|    100000|     200|0.21191025|  PASSED  
+          sts_serial|  15|    100000|     200|0.31264772|  PASSED  
+          sts_serial|  16|    100000|     200|0.00810136|  PASSED  
+          sts_serial|  16|    100000|     200|0.32011702|  PASSED  
+         rgb_bitdist|   1|    100000|     100|0.70831061|  PASSED  
+         rgb_bitdist|   2|    100000|     100|0.79173288|  PASSED  
+         rgb_bitdist|   3|    100000|     100|0.86130616|  PASSED  
+         rgb_bitdist|   4|    100000|     100|0.41471227|  PASSED  
+         rgb_bitdist|   5|    100000|     100|0.34721916|  PASSED  
+         rgb_bitdist|   6|    100000|     100|0.98293638|  PASSED  
+         rgb_bitdist|   7|    100000|     100|0.99112809|  PASSED  
+         rgb_bitdist|   8|    100000|     100|0.12858751|  PASSED  
+         rgb_bitdist|   9|    100000|     100|0.71940835|  PASSED  
+         rgb_bitdist|  10|    100000|     100|0.89847022|  PASSED  
+         rgb_bitdist|  11|    100000|     100|0.60176950|  PASSED  
+         rgb_bitdist|  12|    100000|     100|0.94110631|  PASSED  
+rgb_minimum_distance|   2|     10000|    1000|0.23464869|  PASSED  
+rgb_minimum_distance|   3|     10000|    1000|0.99600099|   WEAK   
+rgb_minimum_distance|   3|     10000|    1100|0.98331242|  PASSED  
+rgb_minimum_distance|   4|     10000|    1000|0.71412405|  PASSED  
+rgb_minimum_distance|   5|     10000|    1000|0.15693103|  PASSED  
+    rgb_permutations|   2|    100000|     100|0.26802939|  PASSED  
+    rgb_permutations|   3|    100000|     100|0.29282240|  PASSED  
+    rgb_permutations|   4|    100000|     100|0.65159602|  PASSED  
+    rgb_permutations|   5|    100000|     100|0.30286911|  PASSED  
+      rgb_lagged_sum|   0|   1000000|     100|0.97810746|  PASSED  
+      rgb_lagged_sum|   1|   1000000|     100|0.70647265|  PASSED  
+      rgb_lagged_sum|   2|   1000000|     100|0.79909770|  PASSED  
+      rgb_lagged_sum|   3|   1000000|     100|0.55465437|  PASSED  
+      rgb_lagged_sum|   4|   1000000|     100|0.75192106|  PASSED  
+      rgb_lagged_sum|   5|   1000000|     100|0.88164760|  PASSED  
+      rgb_lagged_sum|   6|   1000000|     100|0.95793854|  PASSED  
+      rgb_lagged_sum|   7|   1000000|     100|0.16472896|  PASSED  
+      rgb_lagged_sum|   8|   1000000|     100|0.94704147|  PASSED  
+      rgb_lagged_sum|   9|   1000000|     100|0.56074612|  PASSED  
+      rgb_lagged_sum|  10|   1000000|     100|0.18399720|  PASSED  
+      rgb_lagged_sum|  11|   1000000|     100|0.00915093|  PASSED  
+      rgb_lagged_sum|  12|   1000000|     100|0.72953083|  PASSED  
+      rgb_lagged_sum|  13|   1000000|     100|0.86705150|  PASSED  
+      rgb_lagged_sum|  14|   1000000|     100|0.43457918|  PASSED  
+      rgb_lagged_sum|  15|   1000000|     100|0.24003861|  PASSED  
+      rgb_lagged_sum|  16|   1000000|     100|0.86162754|  PASSED  
+      rgb_lagged_sum|  17|   1000000|     100|0.71854990|  PASSED  
+      rgb_lagged_sum|  18|   1000000|     100|0.98889047|  PASSED  
+      rgb_lagged_sum|  19|   1000000|     100|0.98825635|  PASSED  
+      rgb_lagged_sum|  20|   1000000|     100|0.64862010|  PASSED  
+      rgb_lagged_sum|  21|   1000000|     100|0.53809528|  PASSED  
+      rgb_lagged_sum|  22|   1000000|     100|0.82986629|  PASSED  
+      rgb_lagged_sum|  23|   1000000|     100|0.99925259|   WEAK   
+      rgb_lagged_sum|  23|   1000000|     200|0.76699548|  PASSED  
+      rgb_lagged_sum|  24|   1000000|     100|0.84576968|  PASSED  
+      rgb_lagged_sum|  25|   1000000|     100|0.83247258|  PASSED  
+      rgb_lagged_sum|  26|   1000000|     100|0.04118486|  PASSED  
+      rgb_lagged_sum|  27|   1000000|     100|0.49354854|  PASSED  
+      rgb_lagged_sum|  28|   1000000|     100|0.28868083|  PASSED  
+      rgb_lagged_sum|  29|   1000000|     100|0.63907060|  PASSED  
+      rgb_lagged_sum|  30|   1000000|     100|0.89343942|  PASSED  
+      rgb_lagged_sum|  31|   1000000|     100|0.98944019|  PASSED  
+      rgb_lagged_sum|  32|   1000000|     100|0.74546954|  PASSED  
+     rgb_kstest_test|   0|     10000|    1000|0.45969423|  PASSED  
+     dab_bytedistrib|   0|  51200000|       1|0.64304812|  PASSED  
+             dab_dct| 256|     50000|       1|0.99658329|   WEAK   
+             dab_dct| 256|     50000|     101|0.78757917|  PASSED  
+Preparing to run test 207.  ntuple = 0
+        dab_filltree|  32|  15000000|       1|0.99169487|  PASSED  
+        dab_filltree|  32|  15000000|       1|0.19754577|  PASSED  
+Preparing to run test 208.  ntuple = 0
+       dab_filltree2|   0|   5000000|       1|0.29225602|  PASSED  
+       dab_filltree2|   1|   5000000|       1|0.63463955|  PASSED  
+Preparing to run test 209.  ntuple = 0
+        dab_monobit2|  12|  65000000|       1|0.33004890|  PASSED  
+# 
+# Test duration: 90.80529028096666 minutes
+# 

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_11
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_11 b/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_11
new file mode 100644
index 0000000..e3fd759
--- /dev/null
+++ b/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_11
@@ -0,0 +1,140 @@
+# 
+# RNG: org.apache.commons.rng.internal.source64.SplitMix64
+# 
+# Java: 1.8.0_66
+# Runtime: 1.8.0_66-b17
+# JVM: Java HotSpot(TM) 64-Bit Server VM 25.66-b17
+# OS: Linux 3.16.0-4-amd64 amd64
+# 
+# Analyzer: /usr/bin/dieharder -a -g 200 -Y 1 -k 2 
+# 
+#=============================================================================#
+#            dieharder version 3.31.1 Copyright 2003 Robert G. Brown          #
+#=============================================================================#
+   rng_name    |rands/second|   Seed   |
+stdin_input_raw|  1.69e+07  |2681110017|
+#=============================================================================#
+        test_name   |ntup| tsamples |psamples|  p-value |Assessment
+#=============================================================================#
+   diehard_birthdays|   0|       100|     100|0.37865772|  PASSED  
+      diehard_operm5|   0|   1000000|     100|0.19969152|  PASSED  
+  diehard_rank_32x32|   0|     40000|     100|0.72988492|  PASSED  
+    diehard_rank_6x8|   0|    100000|     100|0.71488954|  PASSED  
+   diehard_bitstream|   0|   2097152|     100|0.43460535|  PASSED  
+        diehard_opso|   0|   2097152|     100|0.39682353|  PASSED  
+        diehard_oqso|   0|   2097152|     100|0.68331508|  PASSED  
+         diehard_dna|   0|   2097152|     100|0.19905537|  PASSED  
+diehard_count_1s_str|   0|    256000|     100|0.40869561|  PASSED  
+diehard_count_1s_byt|   0|    256000|     100|0.06260798|  PASSED  
+ diehard_parking_lot|   0|     12000|     100|0.02655079|  PASSED  
+    diehard_2dsphere|   2|      8000|     100|0.08326507|  PASSED  
+    diehard_3dsphere|   3|      4000|     100|0.33962462|  PASSED  
+     diehard_squeeze|   0|    100000|     100|0.23712448|  PASSED  
+        diehard_sums|   0|       100|     100|0.06349572|  PASSED  
+        diehard_runs|   0|    100000|     100|0.61648721|  PASSED  
+        diehard_runs|   0|    100000|     100|0.63179632|  PASSED  
+       diehard_craps|   0|    200000|     100|0.87587953|  PASSED  
+       diehard_craps|   0|    200000|     100|0.19293996|  PASSED  
+ marsaglia_tsang_gcd|   0|  10000000|     100|0.34241119|  PASSED  
+ marsaglia_tsang_gcd|   0|  10000000|     100|0.30512372|  PASSED  
+         sts_monobit|   1|    100000|     100|0.72378001|  PASSED  
+            sts_runs|   2|    100000|     100|0.41586966|  PASSED  
+          sts_serial|   1|    100000|     100|0.01230615|  PASSED  
+          sts_serial|   2|    100000|     100|0.12882421|  PASSED  
+          sts_serial|   3|    100000|     100|0.60076942|  PASSED  
+          sts_serial|   3|    100000|     100|0.55370658|  PASSED  
+          sts_serial|   4|    100000|     100|0.62019925|  PASSED  
+          sts_serial|   4|    100000|     100|0.61837211|  PASSED  
+          sts_serial|   5|    100000|     100|0.52048221|  PASSED  
+          sts_serial|   5|    100000|     100|0.78498672|  PASSED  
+          sts_serial|   6|    100000|     100|0.77024127|  PASSED  
+          sts_serial|   6|    100000|     100|0.81837352|  PASSED  
+          sts_serial|   7|    100000|     100|0.40549929|  PASSED  
+          sts_serial|   7|    100000|     100|0.62024610|  PASSED  
+          sts_serial|   8|    100000|     100|0.89934140|  PASSED  
+          sts_serial|   8|    100000|     100|0.62934461|  PASSED  
+          sts_serial|   9|    100000|     100|0.47310774|  PASSED  
+          sts_serial|   9|    100000|     100|0.68539113|  PASSED  
+          sts_serial|  10|    100000|     100|0.79929877|  PASSED  
+          sts_serial|  10|    100000|     100|0.41351163|  PASSED  
+          sts_serial|  11|    100000|     100|0.89312465|  PASSED  
+          sts_serial|  11|    100000|     100|0.93755784|  PASSED  
+          sts_serial|  12|    100000|     100|0.75386466|  PASSED  
+          sts_serial|  12|    100000|     100|0.40022300|  PASSED  
+          sts_serial|  13|    100000|     100|0.26740850|  PASSED  
+          sts_serial|  13|    100000|     100|0.94749551|  PASSED  
+          sts_serial|  14|    100000|     100|0.24538811|  PASSED  
+          sts_serial|  14|    100000|     100|0.99470565|  PASSED  
+          sts_serial|  15|    100000|     100|0.33023751|  PASSED  
+          sts_serial|  15|    100000|     100|0.53747783|  PASSED  
+          sts_serial|  16|    100000|     100|0.72741236|  PASSED  
+          sts_serial|  16|    100000|     100|0.31571142|  PASSED  
+         rgb_bitdist|   1|    100000|     100|0.37399645|  PASSED  
+         rgb_bitdist|   2|    100000|     100|0.15917314|  PASSED  
+         rgb_bitdist|   3|    100000|     100|0.96183656|  PASSED  
+         rgb_bitdist|   4|    100000|     100|0.53800111|  PASSED  
+         rgb_bitdist|   5|    100000|     100|0.99202083|  PASSED  
+         rgb_bitdist|   6|    100000|     100|0.08137220|  PASSED  
+         rgb_bitdist|   7|    100000|     100|0.96302027|  PASSED  
+         rgb_bitdist|   8|    100000|     100|0.64473150|  PASSED  
+         rgb_bitdist|   9|    100000|     100|0.65339275|  PASSED  
+         rgb_bitdist|  10|    100000|     100|0.00249814|   WEAK   
+         rgb_bitdist|  10|    100000|     200|0.29180684|  PASSED  
+         rgb_bitdist|  11|    100000|     100|0.89861985|  PASSED  
+         rgb_bitdist|  12|    100000|     100|0.19755732|  PASSED  
+rgb_minimum_distance|   2|     10000|    1000|0.28156374|  PASSED  
+rgb_minimum_distance|   3|     10000|    1000|0.18608023|  PASSED  
+rgb_minimum_distance|   4|     10000|    1000|0.59841866|  PASSED  
+rgb_minimum_distance|   5|     10000|    1000|0.99460553|  PASSED  
+    rgb_permutations|   2|    100000|     100|0.30058820|  PASSED  
+    rgb_permutations|   3|    100000|     100|0.41494615|  PASSED  
+    rgb_permutations|   4|    100000|     100|0.30183779|  PASSED  
+    rgb_permutations|   5|    100000|     100|0.98484745|  PASSED  
+      rgb_lagged_sum|   0|   1000000|     100|0.80657650|  PASSED  
+      rgb_lagged_sum|   1|   1000000|     100|0.93305440|  PASSED  
+      rgb_lagged_sum|   2|   1000000|     100|0.16426148|  PASSED  
+      rgb_lagged_sum|   3|   1000000|     100|0.60760780|  PASSED  
+      rgb_lagged_sum|   4|   1000000|     100|0.49464569|  PASSED  
+      rgb_lagged_sum|   5|   1000000|     100|0.05522058|  PASSED  
+      rgb_lagged_sum|   6|   1000000|     100|0.71332645|  PASSED  
+      rgb_lagged_sum|   7|   1000000|     100|0.44637602|  PASSED  
+      rgb_lagged_sum|   8|   1000000|     100|0.98853393|  PASSED  
+      rgb_lagged_sum|   9|   1000000|     100|0.74823114|  PASSED  
+      rgb_lagged_sum|  10|   1000000|     100|0.79356969|  PASSED  
+      rgb_lagged_sum|  11|   1000000|     100|0.62715197|  PASSED  
+      rgb_lagged_sum|  12|   1000000|     100|0.59625870|  PASSED  
+      rgb_lagged_sum|  13|   1000000|     100|0.35397662|  PASSED  
+      rgb_lagged_sum|  14|   1000000|     100|0.44290472|  PASSED  
+      rgb_lagged_sum|  15|   1000000|     100|0.99901248|   WEAK   
+      rgb_lagged_sum|  15|   1000000|     200|0.89648283|  PASSED  
+      rgb_lagged_sum|  16|   1000000|     100|0.18883987|  PASSED  
+      rgb_lagged_sum|  17|   1000000|     100|0.99351872|  PASSED  
+      rgb_lagged_sum|  18|   1000000|     100|0.04716924|  PASSED  
+      rgb_lagged_sum|  19|   1000000|     100|0.13755774|  PASSED  
+      rgb_lagged_sum|  20|   1000000|     100|0.77375672|  PASSED  
+      rgb_lagged_sum|  21|   1000000|     100|0.50540930|  PASSED  
+      rgb_lagged_sum|  22|   1000000|     100|0.89324517|  PASSED  
+      rgb_lagged_sum|  23|   1000000|     100|0.33487074|  PASSED  
+      rgb_lagged_sum|  24|   1000000|     100|0.23431970|  PASSED  
+      rgb_lagged_sum|  25|   1000000|     100|0.02925473|  PASSED  
+      rgb_lagged_sum|  26|   1000000|     100|0.50051577|  PASSED  
+      rgb_lagged_sum|  27|   1000000|     100|0.59992149|  PASSED  
+      rgb_lagged_sum|  28|   1000000|     100|0.51015433|  PASSED  
+      rgb_lagged_sum|  29|   1000000|     100|0.31152954|  PASSED  
+      rgb_lagged_sum|  30|   1000000|     100|0.87982561|  PASSED  
+      rgb_lagged_sum|  31|   1000000|     100|0.65490827|  PASSED  
+      rgb_lagged_sum|  32|   1000000|     100|0.83045165|  PASSED  
+     rgb_kstest_test|   0|     10000|    1000|0.92858748|  PASSED  
+     dab_bytedistrib|   0|  51200000|       1|0.63731545|  PASSED  
+             dab_dct| 256|     50000|       1|0.51990821|  PASSED  
+Preparing to run test 207.  ntuple = 0
+        dab_filltree|  32|  15000000|       1|0.69117436|  PASSED  
+        dab_filltree|  32|  15000000|       1|0.83583501|  PASSED  
+Preparing to run test 208.  ntuple = 0
+       dab_filltree2|   0|   5000000|       1|0.80042934|  PASSED  
+       dab_filltree2|   1|   5000000|       1|0.36321791|  PASSED  
+Preparing to run test 209.  ntuple = 0
+        dab_monobit2|  12|  65000000|       1|0.39155173|  PASSED  
+# 
+# Test duration: 83.19160587438334 minutes
+# 

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_12
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_12 b/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_12
new file mode 100644
index 0000000..c444cd8
--- /dev/null
+++ b/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_12
@@ -0,0 +1,172 @@
+# 
+# RNG: org.apache.commons.rng.internal.source64.XorShift1024Star
+# 
+# Java: 1.8.0_66
+# Runtime: 1.8.0_66-b17
+# JVM: Java HotSpot(TM) 64-Bit Server VM 25.66-b17
+# OS: Linux 3.16.0-4-amd64 amd64
+# 
+# Analyzer: /usr/bin/dieharder -a -g 200 -Y 1 -k 2 
+# 
+#=============================================================================#
+#            dieharder version 3.31.1 Copyright 2003 Robert G. Brown          #
+#=============================================================================#
+   rng_name    |rands/second|   Seed   |
+stdin_input_raw|  1.17e+07  |3917349170|
+#=============================================================================#
+        test_name   |ntup| tsamples |psamples|  p-value |Assessment
+#=============================================================================#
+   diehard_birthdays|   0|       100|     100|0.87249468|  PASSED  
+      diehard_operm5|   0|   1000000|     100|0.64795392|  PASSED  
+  diehard_rank_32x32|   0|     40000|     100|0.32580041|  PASSED  
+    diehard_rank_6x8|   0|    100000|     100|0.21930205|  PASSED  
+   diehard_bitstream|   0|   2097152|     100|0.85361408|  PASSED  
+        diehard_opso|   0|   2097152|     100|0.53311849|  PASSED  
+        diehard_oqso|   0|   2097152|     100|0.74946276|  PASSED  
+         diehard_dna|   0|   2097152|     100|0.91162509|  PASSED  
+diehard_count_1s_str|   0|    256000|     100|0.95881254|  PASSED  
+diehard_count_1s_byt|   0|    256000|     100|0.94360369|  PASSED  
+ diehard_parking_lot|   0|     12000|     100|0.54683180|  PASSED  
+    diehard_2dsphere|   2|      8000|     100|0.51270261|  PASSED  
+    diehard_3dsphere|   3|      4000|     100|0.41377389|  PASSED  
+     diehard_squeeze|   0|    100000|     100|0.37488397|  PASSED  
+        diehard_sums|   0|       100|     100|0.78534421|  PASSED  
+        diehard_runs|   0|    100000|     100|0.89353940|  PASSED  
+        diehard_runs|   0|    100000|     100|0.98641843|  PASSED  
+       diehard_craps|   0|    200000|     100|0.11208085|  PASSED  
+       diehard_craps|   0|    200000|     100|0.04266083|  PASSED  
+ marsaglia_tsang_gcd|   0|  10000000|     100|0.30361775|  PASSED  
+ marsaglia_tsang_gcd|   0|  10000000|     100|0.00451379|   WEAK   
+ marsaglia_tsang_gcd|   0|  10000000|     200|0.17196695|  PASSED  
+ marsaglia_tsang_gcd|   0|  10000000|     200|0.01329904|  PASSED  
+         sts_monobit|   1|    100000|     100|0.35798674|  PASSED  
+            sts_runs|   2|    100000|     100|0.98753274|  PASSED  
+          sts_serial|   1|    100000|     100|0.85095917|  PASSED  
+          sts_serial|   2|    100000|     100|0.23790606|  PASSED  
+          sts_serial|   3|    100000|     100|0.73113126|  PASSED  
+          sts_serial|   3|    100000|     100|0.09867390|  PASSED  
+          sts_serial|   4|    100000|     100|0.59599569|  PASSED  
+          sts_serial|   4|    100000|     100|0.33486098|  PASSED  
+          sts_serial|   5|    100000|     100|0.91972947|  PASSED  
+          sts_serial|   5|    100000|     100|0.47395016|  PASSED  
+          sts_serial|   6|    100000|     100|0.28533891|  PASSED  
+          sts_serial|   6|    100000|     100|0.94074616|  PASSED  
+          sts_serial|   7|    100000|     100|0.89807275|  PASSED  
+          sts_serial|   7|    100000|     100|0.99619626|   WEAK   
+          sts_serial|   8|    100000|     100|0.25144325|  PASSED  
+          sts_serial|   8|    100000|     100|0.07445204|  PASSED  
+          sts_serial|   9|    100000|     100|0.99893027|   WEAK   
+          sts_serial|   9|    100000|     100|0.18256088|  PASSED  
+          sts_serial|  10|    100000|     100|0.96399673|  PASSED  
+          sts_serial|  10|    100000|     100|0.39966220|  PASSED  
+          sts_serial|  11|    100000|     100|0.86716402|  PASSED  
+          sts_serial|  11|    100000|     100|0.78881809|  PASSED  
+          sts_serial|  12|    100000|     100|0.92298916|  PASSED  
+          sts_serial|  12|    100000|     100|0.95339239|  PASSED  
+          sts_serial|  13|    100000|     100|0.94653668|  PASSED  
+          sts_serial|  13|    100000|     100|0.74075166|  PASSED  
+          sts_serial|  14|    100000|     100|0.96641942|  PASSED  
+          sts_serial|  14|    100000|     100|0.45861397|  PASSED  
+          sts_serial|  15|    100000|     100|0.99339382|  PASSED  
+          sts_serial|  15|    100000|     100|0.85852936|  PASSED  
+          sts_serial|  16|    100000|     100|0.82647255|  PASSED  
+          sts_serial|  16|    100000|     100|0.42142196|  PASSED  
+          sts_serial|   1|    100000|     200|0.19684548|  PASSED  
+          sts_serial|   2|    100000|     200|0.08132618|  PASSED  
+          sts_serial|   3|    100000|     200|0.94605676|  PASSED  
+          sts_serial|   3|    100000|     200|0.15992877|  PASSED  
+          sts_serial|   4|    100000|     200|0.69679088|  PASSED  
+          sts_serial|   4|    100000|     200|0.96210648|  PASSED  
+          sts_serial|   5|    100000|     200|0.67536552|  PASSED  
+          sts_serial|   5|    100000|     200|0.32128051|  PASSED  
+          sts_serial|   6|    100000|     200|0.03961926|  PASSED  
+          sts_serial|   6|    100000|     200|0.43339534|  PASSED  
+          sts_serial|   7|    100000|     200|0.46602281|  PASSED  
+          sts_serial|   7|    100000|     200|0.49797595|  PASSED  
+          sts_serial|   8|    100000|     200|0.15683994|  PASSED  
+          sts_serial|   8|    100000|     200|0.05938336|  PASSED  
+          sts_serial|   9|    100000|     200|0.93225252|  PASSED  
+          sts_serial|   9|    100000|     200|0.10272717|  PASSED  
+          sts_serial|  10|    100000|     200|0.83243027|  PASSED  
+          sts_serial|  10|    100000|     200|0.38572650|  PASSED  
+          sts_serial|  11|    100000|     200|0.89668459|  PASSED  
+          sts_serial|  11|    100000|     200|0.84003911|  PASSED  
+          sts_serial|  12|    100000|     200|0.77510264|  PASSED  
+          sts_serial|  12|    100000|     200|0.49941620|  PASSED  
+          sts_serial|  13|    100000|     200|0.69696358|  PASSED  
+          sts_serial|  13|    100000|     200|0.71758799|  PASSED  
+          sts_serial|  14|    100000|     200|0.31813306|  PASSED  
+          sts_serial|  14|    100000|     200|0.56487268|  PASSED  
+          sts_serial|  15|    100000|     200|0.80365032|  PASSED  
+          sts_serial|  15|    100000|     200|0.71004560|  PASSED  
+          sts_serial|  16|    100000|     200|0.45479973|  PASSED  
+          sts_serial|  16|    100000|     200|0.72190909|  PASSED  
+         rgb_bitdist|   1|    100000|     100|0.90979102|  PASSED  
+         rgb_bitdist|   2|    100000|     100|0.23317983|  PASSED  
+         rgb_bitdist|   3|    100000|     100|0.93171398|  PASSED  
+         rgb_bitdist|   4|    100000|     100|0.74424358|  PASSED  
+         rgb_bitdist|   5|    100000|     100|0.26101486|  PASSED  
+         rgb_bitdist|   6|    100000|     100|0.82653351|  PASSED  
+         rgb_bitdist|   7|    100000|     100|0.12337379|  PASSED  
+         rgb_bitdist|   8|    100000|     100|0.35717674|  PASSED  
+         rgb_bitdist|   9|    100000|     100|0.53378365|  PASSED  
+         rgb_bitdist|  10|    100000|     100|0.45442664|  PASSED  
+         rgb_bitdist|  11|    100000|     100|0.46516052|  PASSED  
+         rgb_bitdist|  12|    100000|     100|0.54767283|  PASSED  
+rgb_minimum_distance|   2|     10000|    1000|0.65556049|  PASSED  
+rgb_minimum_distance|   3|     10000|    1000|0.57176682|  PASSED  
+rgb_minimum_distance|   4|     10000|    1000|0.20408828|  PASSED  
+rgb_minimum_distance|   5|     10000|    1000|0.77809111|  PASSED  
+    rgb_permutations|   2|    100000|     100|0.07443529|  PASSED  
+    rgb_permutations|   3|    100000|     100|0.76914043|  PASSED  
+    rgb_permutations|   4|    100000|     100|0.96425213|  PASSED  
+    rgb_permutations|   5|    100000|     100|0.64596924|  PASSED  
+      rgb_lagged_sum|   0|   1000000|     100|0.87424805|  PASSED  
+      rgb_lagged_sum|   1|   1000000|     100|0.17694947|  PASSED  
+      rgb_lagged_sum|   2|   1000000|     100|0.14501253|  PASSED  
+      rgb_lagged_sum|   3|   1000000|     100|0.74273797|  PASSED  
+      rgb_lagged_sum|   4|   1000000|     100|0.22442707|  PASSED  
+      rgb_lagged_sum|   5|   1000000|     100|0.96443315|  PASSED  
+      rgb_lagged_sum|   6|   1000000|     100|0.63113448|  PASSED  
+      rgb_lagged_sum|   7|   1000000|     100|0.82382791|  PASSED  
+      rgb_lagged_sum|   8|   1000000|     100|0.99992561|   WEAK   
+      rgb_lagged_sum|   8|   1000000|     200|0.97770154|  PASSED  
+      rgb_lagged_sum|   9|   1000000|     100|0.06620287|  PASSED  
+      rgb_lagged_sum|  10|   1000000|     100|0.33899740|  PASSED  
+      rgb_lagged_sum|  11|   1000000|     100|0.76926792|  PASSED  
+      rgb_lagged_sum|  12|   1000000|     100|0.99663744|   WEAK   
+      rgb_lagged_sum|  12|   1000000|     200|0.63699344|  PASSED  
+      rgb_lagged_sum|  13|   1000000|     100|0.05853665|  PASSED  
+      rgb_lagged_sum|  14|   1000000|     100|0.98806724|  PASSED  
+      rgb_lagged_sum|  15|   1000000|     100|0.70491707|  PASSED  
+      rgb_lagged_sum|  16|   1000000|     100|0.74487921|  PASSED  
+      rgb_lagged_sum|  17|   1000000|     100|0.05877550|  PASSED  
+      rgb_lagged_sum|  18|   1000000|     100|0.54328930|  PASSED  
+      rgb_lagged_sum|  19|   1000000|     100|0.97668890|  PASSED  
+      rgb_lagged_sum|  20|   1000000|     100|0.80423074|  PASSED  
+      rgb_lagged_sum|  21|   1000000|     100|0.29059861|  PASSED  
+      rgb_lagged_sum|  22|   1000000|     100|0.78904016|  PASSED  
+      rgb_lagged_sum|  23|   1000000|     100|0.55867179|  PASSED  
+      rgb_lagged_sum|  24|   1000000|     100|0.72935868|  PASSED  
+      rgb_lagged_sum|  25|   1000000|     100|0.70542965|  PASSED  
+      rgb_lagged_sum|  26|   1000000|     100|0.10021928|  PASSED  
+      rgb_lagged_sum|  27|   1000000|     100|0.72056898|  PASSED  
+      rgb_lagged_sum|  28|   1000000|     100|0.30805539|  PASSED  
+      rgb_lagged_sum|  29|   1000000|     100|0.88311383|  PASSED  
+      rgb_lagged_sum|  30|   1000000|     100|0.58824711|  PASSED  
+      rgb_lagged_sum|  31|   1000000|     100|0.33994611|  PASSED  
+      rgb_lagged_sum|  32|   1000000|     100|0.14441029|  PASSED  
+     rgb_kstest_test|   0|     10000|    1000|0.78587903|  PASSED  
+     dab_bytedistrib|   0|  51200000|       1|0.39715557|  PASSED  
+             dab_dct| 256|     50000|       1|0.89264015|  PASSED  
+Preparing to run test 207.  ntuple = 0
+        dab_filltree|  32|  15000000|       1|0.77248885|  PASSED  
+        dab_filltree|  32|  15000000|       1|0.30965288|  PASSED  
+Preparing to run test 208.  ntuple = 0
+       dab_filltree2|   0|   5000000|       1|0.44470352|  PASSED  
+       dab_filltree2|   1|   5000000|       1|0.75926430|  PASSED  
+Preparing to run test 209.  ntuple = 0
+        dab_monobit2|  12|  65000000|       1|0.85167382|  PASSED  
+# 
+# Test duration: 87.63525838096668 minutes
+# 

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_13
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_13 b/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_13
new file mode 100644
index 0000000..7c4287c
--- /dev/null
+++ b/commons-rng-core/src/site/resources/txt/userguide/stress/dh/run_1/dh_13
@@ -0,0 +1,138 @@
+# 
+# RNG: org.apache.commons.rng.internal.source64.TwoCmres (Cmres: [0xedce446814d3b3d9L, 33, 330658535] + Cmres: [0xc5b3cf786c806df7L, 33, 331932042])
+# 
+# Java: 1.8.0_66
+# Runtime: 1.8.0_66-b17
+# JVM: Java HotSpot(TM) 64-Bit Server VM 25.66-b17
+# OS: Linux 3.16.0-4-amd64 amd64
+# 
+# Analyzer: /usr/bin/dieharder -a -g 200 -Y 1 -k 2 
+# 
+#=============================================================================#
+#            dieharder version 3.31.1 Copyright 2003 Robert G. Brown          #
+#=============================================================================#
+   rng_name    |rands/second|   Seed   |
+stdin_input_raw|  1.92e+07  |2911063168|
+#=============================================================================#
+        test_name   |ntup| tsamples |psamples|  p-value |Assessment
+#=============================================================================#
+   diehard_birthdays|   0|       100|     100|0.94319254|  PASSED  
+      diehard_operm5|   0|   1000000|     100|0.69985193|  PASSED  
+  diehard_rank_32x32|   0|     40000|     100|0.87709994|  PASSED  
+    diehard_rank_6x8|   0|    100000|     100|0.62701470|  PASSED  
+   diehard_bitstream|   0|   2097152|     100|0.69730734|  PASSED  
+        diehard_opso|   0|   2097152|     100|0.96910146|  PASSED  
+        diehard_oqso|   0|   2097152|     100|0.52632260|  PASSED  
+         diehard_dna|   0|   2097152|     100|0.85820731|  PASSED  
+diehard_count_1s_str|   0|    256000|     100|0.83992121|  PASSED  
+diehard_count_1s_byt|   0|    256000|     100|0.88759072|  PASSED  
+ diehard_parking_lot|   0|     12000|     100|0.77743129|  PASSED  
+    diehard_2dsphere|   2|      8000|     100|0.76870013|  PASSED  
+    diehard_3dsphere|   3|      4000|     100|0.26665719|  PASSED  
+     diehard_squeeze|   0|    100000|     100|0.72247634|  PASSED  
+        diehard_sums|   0|       100|     100|0.32609997|  PASSED  
+        diehard_runs|   0|    100000|     100|0.94970491|  PASSED  
+        diehard_runs|   0|    100000|     100|0.50726357|  PASSED  
+       diehard_craps|   0|    200000|     100|0.22479247|  PASSED  
+       diehard_craps|   0|    200000|     100|0.32942899|  PASSED  
+ marsaglia_tsang_gcd|   0|  10000000|     100|0.70870757|  PASSED  
+ marsaglia_tsang_gcd|   0|  10000000|     100|0.64757276|  PASSED  
+         sts_monobit|   1|    100000|     100|0.77384565|  PASSED  
+            sts_runs|   2|    100000|     100|0.40649603|  PASSED  
+          sts_serial|   1|    100000|     100|0.00688529|  PASSED  
+          sts_serial|   2|    100000|     100|0.64001725|  PASSED  
+          sts_serial|   3|    100000|     100|0.32404203|  PASSED  
+          sts_serial|   3|    100000|     100|0.54674284|  PASSED  
+          sts_serial|   4|    100000|     100|0.97574833|  PASSED  
+          sts_serial|   4|    100000|     100|0.12057935|  PASSED  
+          sts_serial|   5|    100000|     100|0.49008191|  PASSED  
+          sts_serial|   5|    100000|     100|0.94856483|  PASSED  
+          sts_serial|   6|    100000|     100|0.85481419|  PASSED  
+          sts_serial|   6|    100000|     100|0.92042337|  PASSED  
+          sts_serial|   7|    100000|     100|0.08830240|  PASSED  
+          sts_serial|   7|    100000|     100|0.08148131|  PASSED  
+          sts_serial|   8|    100000|     100|0.07583982|  PASSED  
+          sts_serial|   8|    100000|     100|0.64855877|  PASSED  
+          sts_serial|   9|    100000|     100|0.65524691|  PASSED  
+          sts_serial|   9|    100000|     100|0.60368356|  PASSED  
+          sts_serial|  10|    100000|     100|0.47864477|  PASSED  
+          sts_serial|  10|    100000|     100|0.50433066|  PASSED  
+          sts_serial|  11|    100000|     100|0.53398008|  PASSED  
+          sts_serial|  11|    100000|     100|0.49445562|  PASSED  
+          sts_serial|  12|    100000|     100|0.33421936|  PASSED  
+          sts_serial|  12|    100000|     100|0.73734873|  PASSED  
+          sts_serial|  13|    100000|     100|0.13980484|  PASSED  
+          sts_serial|  13|    100000|     100|0.11066094|  PASSED  
+          sts_serial|  14|    100000|     100|0.57465938|  PASSED  
+          sts_serial|  14|    100000|     100|0.78917939|  PASSED  
+          sts_serial|  15|    100000|     100|0.10986383|  PASSED  
+          sts_serial|  15|    100000|     100|0.05731819|  PASSED  
+          sts_serial|  16|    100000|     100|0.74530853|  PASSED  
+          sts_serial|  16|    100000|     100|0.12299296|  PASSED  
+         rgb_bitdist|   1|    100000|     100|0.96220189|  PASSED  
+         rgb_bitdist|   2|    100000|     100|0.70880020|  PASSED  
+         rgb_bitdist|   3|    100000|     100|0.90494418|  PASSED  
+         rgb_bitdist|   4|    100000|     100|0.26540767|  PASSED  
+         rgb_bitdist|   5|    100000|     100|0.46667805|  PASSED  
+         rgb_bitdist|   6|    100000|     100|0.68338418|  PASSED  
+         rgb_bitdist|   7|    100000|     100|0.48454329|  PASSED  
+         rgb_bitdist|   8|    100000|     100|0.04766154|  PASSED  
+         rgb_bitdist|   9|    100000|     100|0.33651159|  PASSED  
+         rgb_bitdist|  10|    100000|     100|0.73490567|  PASSED  
+         rgb_bitdist|  11|    100000|     100|0.11393074|  PASSED  
+         rgb_bitdist|  12|    100000|     100|0.29667118|  PASSED  
+rgb_minimum_distance|   2|     10000|    1000|0.95130996|  PASSED  
+rgb_minimum_distance|   3|     10000|    1000|0.65657887|  PASSED  
+rgb_minimum_distance|   4|     10000|    1000|0.54511399|  PASSED  
+rgb_minimum_distance|   5|     10000|    1000|0.02268298|  PASSED  
+    rgb_permutations|   2|    100000|     100|0.49451746|  PASSED  
+    rgb_permutations|   3|    100000|     100|0.30929215|  PASSED  
+    rgb_permutations|   4|    100000|     100|0.64835126|  PASSED  
+    rgb_permutations|   5|    100000|     100|0.24582572|  PASSED  
+      rgb_lagged_sum|   0|   1000000|     100|0.80945058|  PASSED  
+      rgb_lagged_sum|   1|   1000000|     100|0.93132705|  PASSED  
+      rgb_lagged_sum|   2|   1000000|     100|0.30299555|  PASSED  
+      rgb_lagged_sum|   3|   1000000|     100|0.76635476|  PASSED  
+      rgb_lagged_sum|   4|   1000000|     100|0.24917437|  PASSED  
+      rgb_lagged_sum|   5|   1000000|     100|0.12625999|  PASSED  
+      rgb_lagged_sum|   6|   1000000|     100|0.93045613|  PASSED  
+      rgb_lagged_sum|   7|   1000000|     100|0.35822251|  PASSED  
+      rgb_lagged_sum|   8|   1000000|     100|0.37755080|  PASSED  
+      rgb_lagged_sum|   9|   1000000|     100|0.58225106|  PASSED  
+      rgb_lagged_sum|  10|   1000000|     100|0.19141926|  PASSED  
+      rgb_lagged_sum|  11|   1000000|     100|0.78436920|  PASSED  
+      rgb_lagged_sum|  12|   1000000|     100|0.43540142|  PASSED  
+      rgb_lagged_sum|  13|   1000000|     100|0.32801467|  PASSED  
+      rgb_lagged_sum|  14|   1000000|     100|0.99114803|  PASSED  
+      rgb_lagged_sum|  15|   1000000|     100|0.47440202|  PASSED  
+      rgb_lagged_sum|  16|   1000000|     100|0.76300988|  PASSED  
+      rgb_lagged_sum|  17|   1000000|     100|0.65088286|  PASSED  
+      rgb_lagged_sum|  18|   1000000|     100|0.51885691|  PASSED  
+      rgb_lagged_sum|  19|   1000000|     100|0.03253548|  PASSED  
+      rgb_lagged_sum|  20|   1000000|     100|0.00934014|  PASSED  
+      rgb_lagged_sum|  21|   1000000|     100|0.15006058|  PASSED  
+      rgb_lagged_sum|  22|   1000000|     100|0.99400315|  PASSED  
+      rgb_lagged_sum|  23|   1000000|     100|0.92296924|  PASSED  
+      rgb_lagged_sum|  24|   1000000|     100|0.48689526|  PASSED  
+      rgb_lagged_sum|  25|   1000000|     100|0.88664710|  PASSED  
+      rgb_lagged_sum|  26|   1000000|     100|0.27332601|  PASSED  
+      rgb_lagged_sum|  27|   1000000|     100|0.19180099|  PASSED  
+      rgb_lagged_sum|  28|   1000000|     100|0.98905521|  PASSED  
+      rgb_lagged_sum|  29|   1000000|     100|0.74611377|  PASSED  
+      rgb_lagged_sum|  30|   1000000|     100|0.82198747|  PASSED  
+      rgb_lagged_sum|  31|   1000000|     100|0.18944862|  PASSED  
+      rgb_lagged_sum|  32|   1000000|     100|0.56287822|  PASSED  
+     rgb_kstest_test|   0|     10000|    1000|0.15832651|  PASSED  
+     dab_bytedistrib|   0|  51200000|       1|0.80642219|  PASSED  
+             dab_dct| 256|     50000|       1|0.09250390|  PASSED  
+Preparing to run test 207.  ntuple = 0
+        dab_filltree|  32|  15000000|       1|0.00641698|  PASSED  
+        dab_filltree|  32|  15000000|       1|0.65942686|  PASSED  
+Preparing to run test 208.  ntuple = 0
+       dab_filltree2|   0|   5000000|       1|0.77562361|  PASSED  
+       dab_filltree2|   1|   5000000|       1|0.39311181|  PASSED  
+Preparing to run test 209.  ntuple = 0
+        dab_monobit2|  12|  65000000|       1|0.66756711|  PASSED  
+# 
+# Test duration: 76.01533600078334 minutes
+# 


Mime
View raw message