Support methods can be static

Update checkNextInRange to use a LongSupplier

The generic type <T extends Number> was used as a long value. The type
can be dropped to avoid auto-boxing for all generator tests.

Modified methods to static.

Correct isUniformNextByte test

Chi-square critical value should be for 255 degrees of freedom.

This lowers the critical value from 311.56 to 310.46. The test is now
harder to pass.

Consistent error messages for nextInRange test

Port modifications from sampling ContinuousSamplerParametricTest to the
ProvidersCommonParametricTest in core and simple modules.

Updated the precision of the chi-square critical value.

Add failed chi-square values to the message.

Format failed chi-square values to 3 decimal places.

Consolidate Int/LongProvider to use next() as the source of random bits

This removes the mixed use of next and nextLong or nextInt. The next
method is default source of the random bits and should always be used.

RNG-173: BaseProvider static method to extend an input array seed

Correct longAsInt output in the stress test application

RNG-171 changed the cached int source to output a long as two ints using
the low 32-bits, then high 32-bits.

Updated the RngDataOutput to support HiLo or LoHi. Added tests for each
implementation.

Dropped high-bits and low-bits command options. Added source64 option
with enum for high, low, high-Low, low-high, long, int. The default for
stress testing matches the caching implementation.

Update the test documentation to reflect the changes.

RNG-169: Avoid long to int[] that can generate a zero output seed.

This is relevant to small state RNGs with an int[] native seed such as
XoRoShiRo64StarStar.

Add missing <p> tags

Fix trailing whitespace

Document the lack of functional compatibility for derived output types.

Only the reference output type (int/long) from the generator is required
to maintain functional compatibility.

RNG-171: Reduce the memory footprint in cached boolean and int source

This change has a performance improvement on some JDKs.

Add a benchmark to compare the performance with and without the cache.

RNG-172: Support power of 2 by lowering limit by 1

This change has been made for completeness. In practice a different
sampler is used for powers of 2.

RNG-172: Pre-compute rejection threshold

Use Java 1.8 method to compute map value if absent

RNG-169: Track changes

RNG-169: Remove redundant Seed2ArrayConverter implementation

The functionality has been moved to the Conversions class. This removes
unreleased public API methods from legacy convertor classes.

Add tests to ensure coverage for converter classes.

Fix PMD errors

RNG-169: Move array size conversions to Conversions class

RNG-169: Move all conversions to the Conversions class

Remove use of instances of SeedConverter as the conversion is stateless.

RNG-169: Expand primitive input seeds using a SplitMix64

This changes behaviour so that

if int == long:
  int -> array1
  long -> array2
  array1 == array2

int -> array[0] == int -> long

RNG-169: Avoid intermediate arrays during conversions

The following conversions now avoid intermediate arrays:

byte[] -> int
byte[] -> long
int[] -> long

Behaviour change:

int[] is now converted as if to long[] then to long. This avoids loss of
bits and changes the possible output seeds from 2^32 to 2^64.

RNG-169: Update array seed conversion to use optimum seed length

Avoid duplication of the input byte[] to zero fill it to a length
modulus 4 or 8 for conversion by the NumberFactory.

During array to array conversions only convert the minimum of the
required number of bytes for the native seed type, or the number of
input bytes.

Change all array conversions to use little-endian byte order.

RNG-170: Ensure nextBytes is consistent with JDK range checks

Updated to match behaviour of System.arraycopy and JDK 9
Objects.checkFromIndexSize. This now allows:

nextBytes(new byte[0], 0, 0)
nextBytes(new byte[10], 10, 0)

Previously these would throw an exception.

Return the class type of the unrecognised seed.

This avoids creating a message containing the string representation of
an Object. This may be a very large String, for example a BitSet.
fix

Update NumberFactory to use parameterized/repeated tests

Add little-endian test for byte[] conversions.

Check all the test long/int values in nextBoolean.

Documentation typos

Add option to list a range of the RandomSource enum

Add missing generator name to example command

Add TSampler to continuous sampler performance JMH example

Add example histogram of the TSampler output to the userguide.

Add TSampler to example sampling application

RNG-167: Sampling from a t-distribution

Update chi-square test

Increase accuracy of the chi2 critical value.

Use String.format for the assertion message, including the chi2 critical
value.

Compute p-value for the chi square test once.

Use String.format for the assertion message.

Cache another constant in the large mean Poisson sampler

This avoids evaluating a constant sqrt expression in the sampling loop.

Formatting

Correct javadoc for the bounds on the Poisson sampler mean

Correct probability typo.

RNG-166: LogNormalSamplers to allow a negative mean.

Changes:

- LogNormalSampler
- BoxNormalLogNormalSamplers

Also updated the constructor parameters from shape and scale to mu and
sigma. This matches the wikipedia reference and implementations in
Wolfram.

RNG-165: Track changes

RNG-165: Allow a zero exponent in the Zipf sampler

RNG-160: Use ternary operator to sort two long values

This removes a 50:50 branch statement from concave overhang sampling.

Directly test the SamplerBase class

There is no requirement to extend the class to access the pass-through
methods.

Allow ziggurat sampling from only the overhangs in the performance test

Add additional ternary variant for testing.

Fix javadoc mix up between convex and concave regions

Added ternary variations to the ziggurat benchmark

Ensure stream is closed using try-with-resources

Remove badges from examples README.md

The badges do not relate to the examples code.

The build badge is for the main RNG modules. No check is made if the
examples code even builds.

The coverage badge is for the main RNG code. Coverage of the examples is
low to minimal and is not reported on.

Fix links for browsing the examples javadoc

Remove badges and maven dependency from the examples modules.

The examples are no longer released to maven central so badges for the
code or the javadoc are not applicable.

Update Travis CI badge from .org to .com domain.

Update note about sending e-mail from an apache.org account.

Correct javadoc

Update announce subject line in release guide

Change release notes to use new commons tag format

Add note about how to modify the release notes during a release process.

Update release notes following release 1.4

Add release 1.4 javadoc links to the site.xml

Update examples app version to 1.5-SNAPSHOT

Update release and BC version in parent pom

Update README to refer to 1.4 release

Update pom to next development version (1.4 to 1.5)

Retrieve 1.4 release details from the release branch

Update javadoc.

Correct description of new RandomSource.create(...) method where the
enum defines the concrete implementation, not the first argument to
create.

Move description of parallel applications to a sub-section. Add
description of parallel support from the jumpable generators with a code
example.

Place @since tags after @see tags following Oracle's order convension

Add @since tags to new RandomSource.create methods

Do not perform minimal site checkout in pre-site phase

This profile must now be explicitly activated.

Exclude site-content.README from rat check

Use the same excludes in the build and reporting section

Fix changes typo

Update user guide dependencies to require Java 1.8

Format ziggurat tables

The byte[] MAP is now initialized using (byte) casting.

Add ziggurat versions with multiple max epsilon values

Correct exponential epsilon values to use the ceiling of the float value
before rounding to a long integer.

Update grammar for conscious language checker

Update grammar for conscious language checker

Update grammar for conscious language checker

Add more platform results for exp(z)

Fix trailing spaces

Add performance test for exp(x) with x in [-8, 0]

Disable tests in JMH module.

Add a better fixed seed with a note on how to test samplers using a
random seed.

Add performance test for extracting the sign bit

Update tests requiring a fast generator to use a LCG. Only applicable
when the upper bits are required.

Remove branch frequencies from performance variations

The branch frequencies are the same as the main sampler. This eliminates
duplication and eases maintenance.

Parameterise the ziggurat sampler test

Duplicate the test in the JMH module. This ensures all variations
correctly sample the distribution, i.e. changes do not introduce errors
in the algorithm.

This identified an error in ModifiedZigguratExponentialSamplerRecursion.

Update ziggurat performance benchmark to match main code

Naming conventions and comments have been updated to match those in the
main sampling package. This is for ease of maintenance.

Comment typo

Change another mask operation to a bit shift.

Update ziggurat sampler using result of the performance tests

Use a single method to interpolate x and y. This avoids a subtraction in
the interpolation of y.

Avoid recursion in the exponential sampler.

Use shifts to generate unsigned longs. This favours the upper bits of
the uniform deviate.

Each change is either mute or may have a marginal benefit depending on
the platform. Together the sampler should be consistently performant
across JDKs and platforms.

Update tests that manipulate the output from the exponential sampler:
stable sampler test
ziggurat sampler test

Disable interpolation test method

Update ziggurat test to target regions of the ziggurat.

This targets concave, inflection, and convex overhangs and the tail of
the Gaussian.

This targets concave overhangs, and the tail of the exponential.

Note: This test is still not able to identify minor errors in the sampling algorithm. The test cannot detect the difference between a concave region sampled correctly or sampled using a uniform sample from the lower-left triangle.

PMD: Allow long class for ZigguratSampler

Update ziggurat performance benchmark with more methods

Use only bit shifts for random positive longs.

Use a different method to sample y.

Benchmark methods to interpolate X or Y

Update observed frequencies with expected where appropriate.

The expected frequencies are obtained during the table construction.
They closely match the previously measured observed frequencies.

Add description of sampling method to the ziggurat sampler.

Update the javadoc for all values and methods to be consistent with the
summary description.

Ensure same samplers are tested in single and sequential

Use a base class to define the samplers.

Benchmark using a long to get an index, compare it, and return the index

Add ziggurat exponential sampler with no recursion to the benchmark

Update ZigguaratSampler branch frequencies

Update ZigguaratSampler point of inflection for the Gaussian.

The point of inflection is the largest x value below 1. When x=1 the
second derivative of the Gaussian is zero (i.e. the point of
inflection).

Update ZigguaratSampler concave epsilon for the exponential.

This should be equal to approximately 9.2%. The previous value was
approximately 5.6% resulting in fast acceptance too often for overhangs.

RNG-163: Track changes

Update release howto

Change testing mvn command to 'verify' in place of 'package' to ensure
checks are run.

Separate site generation from the release build of the binary artifacts.