You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by ah...@apache.org on 2021/09/02 17:01:26 UTC
[commons-rng] branch 1.4-release updated: Release candidate.
This is an automated email from the ASF dual-hosted git repository.
aherbert pushed a commit to branch 1.4-release
in repository https://gitbox.apache.org/repos/asf/commons-rng.git
The following commit(s) were added to refs/heads/1.4-release by this push:
new 6f2e939 Release candidate.
6f2e939 is described below
commit 6f2e939bc1ae5d7c1317d4fb1af9ef3ac8d45e54
Author: aherbert <ah...@apache.org>
AuthorDate: Thu Sep 2 16:05:03 2021 +0100
Release candidate.
---
RELEASE-NOTES.txt | 105 +++++++++++++++++++++
commons-rng-client-api/pom.xml | 4 +-
commons-rng-client-api/src/site/site.xml | 2 +
commons-rng-core/pom.xml | 6 +-
commons-rng-core/src/site/site.xml | 2 +
commons-rng-examples/examples-jmh/pom.xml | 4 +-
.../examples-jpms/jpms-app/pom.xml | 6 +-
.../examples-jpms/jpms-lib/pom.xml | 4 +-
commons-rng-examples/examples-jpms/pom.xml | 4 +-
commons-rng-examples/examples-quadrature/pom.xml | 4 +-
commons-rng-examples/examples-sampling/pom.xml | 4 +-
commons-rng-examples/examples-stress/pom.xml | 4 +-
commons-rng-examples/pom.xml | 10 +-
commons-rng-sampling/pom.xml | 8 +-
commons-rng-sampling/src/site/site.xml | 2 +
commons-rng-simple/pom.xml | 6 +-
commons-rng-simple/src/site/site.xml | 2 +
dist-archive/pom.xml | 28 +++---
docs-archive/pom.xml | 10 +-
pom.xml | 6 +-
src/changes/changes.xml | 2 +-
.../resources/release-notes/RELEASE-NOTES-1.4.txt | 105 +++++++++++++++++++++
src/site/xdoc/download_rng.xml | 28 +++---
src/site/xdoc/release-history.xml | 3 +
24 files changed, 290 insertions(+), 69 deletions(-)
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index 167a288..3e5b3a7 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -1,4 +1,109 @@
+ Apache Commons RNG 1.4 RELEASE NOTES
+
+The Apache Commons RNG team is pleased to announce the release of Apache Commons RNG 1.4
+
+The Apache Commons RNG project provides pure-Java implementation
+of pseudo-random generators.
+
+This is a minor release of Apache Commons RNG, containing a
+few new features and performance improvements.
+
+Apache Commons RNG 1.4 contains the following library modules:
+ commons-rng-client-api (requires Java 8)
+ commons-rng-core (requires Java 8)
+ commons-rng-simple (requires Java 8)
+ commons-rng-sampling (requires Java 8)
+
+The code in module 'commons-rng-core' should not be accessed
+directly by applications as a future release might make use of
+the JPMS modularization feature available in Java 11+.
+
+Additional code is provided in the following modules:
+ commons-rng-examples-quadrature (requires Java 8)
+ commons-rng-examples-jmh (requires Java 8)
+ commons-rng-examples-sampling (requires Java 8)
+ commons-rng-examples-stress (requires Java 8)
+ commons-rng-examples-jpms (requires Java 11)
+
+It is however not part of the official API and no compatibility
+should be expected in subsequent releases.
+
+It must be noted that, due to the nature of random number generation, some unit tests
+are bound to fail with some probability. The 'maven-surefire-plugin' is configured
+to re-run tests that fail, and pass the build if they succeed within the allotted
+number of reruns (the test will be marked as 'flaky' in the report).
+
+Changes in this version include:
+
+New features:
+o RNG-156: New "DirichletSampler" class to sample from a Dirichlet distribution.
+o RNG-137: New "StableSampler" class to sample from a stable distribution.
+o RNG-138: New "CompositeSamplers" class to sample from a weighted combination of samplers.
+o RNG-140: New "LongSampler" interface for sampling a long. New "UniformLongSampler" to sample
+ from a range.
+o RNG-151: New "ZigguratSampler" implementation of the modified "Ziggurat" algorithm for
+ Gaussian and exponential sampling.
+o RNG-147: New "LevySampler" to sample from a Levy distribution.
+o RNG-145: "ContinuousUniformSampler": Add optional support for an open interval: (lower, upper).
+o RNG-143: "RandomSource": Add an instance create method. Deprecate the static create method.
+o RNG-136: New "ObjectSampler<T>" and "SharedStateObjectSampler<T>" interfaces.
+ These interfaces are implemented by samplers returning an object.
+ This changes the functional compatibility of existing samplers that implement
+ SharedStatedSampler<R>: CollectionSampler<T>; CombinationSampler;
+ DiscreteProbabilityCollectionSampler<T>; PermutationSampler; and UnitSphereSampler.
+ The method signature of the SharedStateSampler<R> interface remains
+ 'public R withUniformRandomProvider(UniformRandomProvider)'. The result can still be
+ assigned to an instance of the same class R; it can no longer be assigned to an instance
+ of SharedStatedSampler<R>. It can now be assigned to SharedStateObjectSampler<T>
+ which can be used to generate samples of type <T>.
+ Code that assigned to SharedStatedSampler<R> should be updated.
+o RNG-135: New "TetrahedronSampler" to sample uniformly from a tetrahedron.
+o RNG-134: New "BoxSampler" to sample uniformly from a box (or hyperrectangle).
+o RNG-133: New "LineSampler" to sample uniformly on a line segment.
+o RNG-131: New "TriangleSampler" to sample uniformly from a triangle.
+o RNG-132: New "o.a.c.rng.sampling.shape" package for sampling coordinates from shapes.
+o RNG-128: New "UnitBallSampler" to generate coordinates uniformly within an n-unit ball.
+o RNG-126: "PoissonSamplerCache": Method to return a SharedStateDiscreteSampler.
+o RNG-124: Add fixed increment versions of the PCG generators.
+
+Fixed Bugs:
+o RNG-159: "ZigguratSampler.NormalizedGaussian": Corrected biased sampling within convex regions
+ at the edge of the ziggurat.
+o RNG-146: "GaussianSampler": Prevent infinite mean and standard deviation.
+o RNG-144: "AhrensDieterExponentialSampler": Avoid possible infinite loop during sampling if the
+ underlying UniformRandomProvider creates a zero for the uniform deviate.
+o RNG-130: "UnitSphereSampler": Fix 1 dimension sampling to only return vectors containing 1 or -1.
+
+Changes:
+o RNG-163: Update test suite to JUnit 5.
+o Simplify assertions with simpler equivalent. Thanks to Arturo Bernal.
+o RNG-162: Update the minimum Java version to 1.8.
+o RNG-160: "ZigguratSampler.NormalizedGaussian": Performance improvement by extracting ziggurat
+ edge sampling to a separate method.
+o RNG-157: "UnitSphereSampler": Deprecate public constructor. Use the factory constructor to create
+ an optimal sampler.
+o RNG-155: "ZigguratNormalizedGaussianSampler": Update to a table size of 256.
+o RNG-152: Update samplers to use ZigguratSampler.NormalizedGaussian for Gaussian deviates.
+o RNG-154: Update Gaussian samplers to avoid infinity in the tails of the distribution. Applies
+ to: ZigguratNormalisedGaussianSampler; BoxMullerNormalizedGaussianSampler; and
+ BoxMullerGaussianSampler.
+o RNG-153: "UnitBallSampler": Update to use the ZigguratSampler for an exponential deviate for
+ ball point picking.
+o RNG-150: Update "LargeMeanPoissonSampler" and "GeometricSampler" to use the ZigguratSampler for
+ exponential deviates.
+o RNG-129: "UnitSphereSampler": Improve performance with specialisations for low order dimensions.
+ Added a factory constructor to create the sampler.
+
+
+For complete information on Apache Commons RNG, including instructions on how to submit bug reports,
+patches, or suggestions for improvement, see the Apache Commons RNG website:
+
+https://commons.apache.org/proper/commons-rng/
+
+
+=============================================================================
+
Apache Commons RNG 1.3 RELEASE NOTES
The Apache Commons RNG team is pleased to announce the release of Apache Commons RNG 1.3
diff --git a/commons-rng-client-api/pom.xml b/commons-rng-client-api/pom.xml
index 82eb825..b6cb383 100644
--- a/commons-rng-client-api/pom.xml
+++ b/commons-rng-client-api/pom.xml
@@ -21,11 +21,11 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-parent</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</parent>
<artifactId>commons-rng-client-api</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<name>Apache Commons RNG Client API</name>
<description>API for client code that uses random numbers generators.</description>
diff --git a/commons-rng-client-api/src/site/site.xml b/commons-rng-client-api/src/site/site.xml
index 71ecebd..ac31a36 100644
--- a/commons-rng-client-api/src/site/site.xml
+++ b/commons-rng-client-api/src/site/site.xml
@@ -28,6 +28,8 @@
<item name="Overview" href="index.html"/>
<item name="Latest API docs (development)"
href="apidocs/index.html"/>
+ <item name="Javadoc (1.4 release)"
+ href="https://commons.apache.org/rng/commons-rng-client-api/javadocs/api-1.4/index.html"/>
<item name="Javadoc (1.3 release)"
href="https://commons.apache.org/rng/commons-rng-client-api/javadocs/api-1.3/index.html"/>
<item name="Javadoc (1.2 release)"
diff --git a/commons-rng-core/pom.xml b/commons-rng-core/pom.xml
index fa683cf..654d350 100644
--- a/commons-rng-core/pom.xml
+++ b/commons-rng-core/pom.xml
@@ -21,11 +21,11 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-parent</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</parent>
<artifactId>commons-rng-core</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<name>Apache Commons RNG Core</name>
<description>Pure Java implementations of random numbers generator algorithms.
@@ -49,7 +49,7 @@
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-client-api</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</dependency>
<dependency>
<!-- For testing floating point precision -->
diff --git a/commons-rng-core/src/site/site.xml b/commons-rng-core/src/site/site.xml
index 56e2672..ea92b39 100644
--- a/commons-rng-core/src/site/site.xml
+++ b/commons-rng-core/src/site/site.xml
@@ -28,6 +28,8 @@
<item name="Overview" href="index.html"/>
<item name="Latest API docs (development)"
href="apidocs/index.html"/>
+ <item name="Javadoc (1.4 release)"
+ href="https://commons.apache.org/rng/commons-rng-core/javadocs/api-1.4/index.html"/>
<item name="Javadoc (1.3 release)"
href="https://commons.apache.org/rng/commons-rng-core/javadocs/api-1.3/index.html"/>
<item name="Javadoc (1.2 release)"
diff --git a/commons-rng-examples/examples-jmh/pom.xml b/commons-rng-examples/examples-jmh/pom.xml
index 3788d43..804bc06 100644
--- a/commons-rng-examples/examples-jmh/pom.xml
+++ b/commons-rng-examples/examples-jmh/pom.xml
@@ -21,11 +21,11 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-examples</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</parent>
<artifactId>commons-rng-examples-jmh</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<name>Apache Commons RNG JMH Benchmark</name>
<description>Code for running JMH benchmarks that assess the performance of the generators.
diff --git a/commons-rng-examples/examples-jpms/jpms-app/pom.xml b/commons-rng-examples/examples-jpms/jpms-app/pom.xml
index fa16173..b8cba51 100644
--- a/commons-rng-examples/examples-jpms/jpms-app/pom.xml
+++ b/commons-rng-examples/examples-jpms/jpms-app/pom.xml
@@ -21,11 +21,11 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-examples-jpms</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</parent>
<artifactId>commons-rng-examples-jpms-app</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<name>Apache Commons RNG JPMS Module Example (Application)</name>
<description>Testing JPMS. Code in this module is not part of the public API.</description>
@@ -39,7 +39,7 @@
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-examples-jpms-lib</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</dependency>
</dependencies>
diff --git a/commons-rng-examples/examples-jpms/jpms-lib/pom.xml b/commons-rng-examples/examples-jpms/jpms-lib/pom.xml
index b2a1e98..5216cc0 100644
--- a/commons-rng-examples/examples-jpms/jpms-lib/pom.xml
+++ b/commons-rng-examples/examples-jpms/jpms-lib/pom.xml
@@ -21,11 +21,11 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-examples-jpms</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</parent>
<artifactId>commons-rng-examples-jpms-lib</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<name>Apache Commons RNG JPMS Module Example (Library)</name>
<description>Testing JPMS. Code in this module is not part of the public API.</description>
diff --git a/commons-rng-examples/examples-jpms/pom.xml b/commons-rng-examples/examples-jpms/pom.xml
index 017e7a3..dd8495b 100644
--- a/commons-rng-examples/examples-jpms/pom.xml
+++ b/commons-rng-examples/examples-jpms/pom.xml
@@ -21,11 +21,11 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-examples</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</parent>
<artifactId>commons-rng-examples-jpms</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<packaging>pom</packaging>
<name>Apache Commons RNG JPMS Integration Test</name>
diff --git a/commons-rng-examples/examples-quadrature/pom.xml b/commons-rng-examples/examples-quadrature/pom.xml
index 787fb61..ff8666f 100644
--- a/commons-rng-examples/examples-quadrature/pom.xml
+++ b/commons-rng-examples/examples-quadrature/pom.xml
@@ -21,11 +21,11 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-examples</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</parent>
<artifactId>commons-rng-examples-quadrature</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<name>Apache Commons RNG Quadrature Example</name>
<description>Contains examples for computing numerical quadrature (integration).
diff --git a/commons-rng-examples/examples-sampling/pom.xml b/commons-rng-examples/examples-sampling/pom.xml
index e01b29a..89b4355 100644
--- a/commons-rng-examples/examples-sampling/pom.xml
+++ b/commons-rng-examples/examples-sampling/pom.xml
@@ -21,11 +21,11 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-examples</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</parent>
<artifactId>commons-rng-examples-sampling</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<!-- This name is used in the shaded jar to provide the application title for the version information. -->
<name>Apache Commons RNG Examples Sampling Utilities</name>
diff --git a/commons-rng-examples/examples-stress/pom.xml b/commons-rng-examples/examples-stress/pom.xml
index ce1f2d6..7053f87 100644
--- a/commons-rng-examples/examples-stress/pom.xml
+++ b/commons-rng-examples/examples-stress/pom.xml
@@ -21,11 +21,11 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-examples</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</parent>
<artifactId>commons-rng-examples-stress</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<!-- This name is used in the shaded jar to provide the application title for the version information. -->
<name>Apache Commons RNG Examples Stress Utilities</name>
diff --git a/commons-rng-examples/pom.xml b/commons-rng-examples/pom.xml
index 49fd72b..59b0d9a 100644
--- a/commons-rng-examples/pom.xml
+++ b/commons-rng-examples/pom.xml
@@ -21,11 +21,11 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-parent</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</parent>
<artifactId>commons-rng-examples</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<packaging>pom</packaging>
<name>Apache Commons RNG Examples</name>
@@ -58,17 +58,17 @@
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-simple</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-sampling</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-client-api</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</dependency>
<dependency>
<groupId>info.picocli</groupId>
diff --git a/commons-rng-sampling/pom.xml b/commons-rng-sampling/pom.xml
index b6e16fc..508a6c6 100644
--- a/commons-rng-sampling/pom.xml
+++ b/commons-rng-sampling/pom.xml
@@ -21,11 +21,11 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-parent</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</parent>
<artifactId>commons-rng-sampling</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<name>Apache Commons RNG Sampling</name>
<description>The Apache Commons RNG Sampling module provides samplers
@@ -46,13 +46,13 @@
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-client-api</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-simple</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<scope>test</scope>
</dependency>
diff --git a/commons-rng-sampling/src/site/site.xml b/commons-rng-sampling/src/site/site.xml
index c0e5cad..6ab2ed6 100644
--- a/commons-rng-sampling/src/site/site.xml
+++ b/commons-rng-sampling/src/site/site.xml
@@ -28,6 +28,8 @@
<item name="Overview" href="index.html"/>
<item name="Latest API docs (development)"
href="apidocs/index.html"/>
+ <item name="Javadoc (1.4 release)"
+ href="https://commons.apache.org/rng/commons-rng-sampling/javadocs/api-1.4/index.html"/>
<item name="Javadoc (1.3 release)"
href="https://commons.apache.org/rng/commons-rng-sampling/javadocs/api-1.3/index.html"/>
<item name="Javadoc (1.2 release)"
diff --git a/commons-rng-simple/pom.xml b/commons-rng-simple/pom.xml
index faabe26..f7a7761 100644
--- a/commons-rng-simple/pom.xml
+++ b/commons-rng-simple/pom.xml
@@ -21,11 +21,11 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-parent</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</parent>
<artifactId>commons-rng-simple</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<name>Apache Commons RNG Simple</name>
<description>Simple API for instantiating random numbers generators.</description>
@@ -46,7 +46,7 @@
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-core</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</dependency>
<dependency>
diff --git a/commons-rng-simple/src/site/site.xml b/commons-rng-simple/src/site/site.xml
index 8b2125e..43d021a 100644
--- a/commons-rng-simple/src/site/site.xml
+++ b/commons-rng-simple/src/site/site.xml
@@ -28,6 +28,8 @@
<item name="Overview" href="index.html"/>
<item name="Latest API docs (development)"
href="apidocs/index.html"/>
+ <item name="Javadoc (1.4 release)"
+ href="https://commons.apache.org/rng/commons-rng-simple/javadocs/api-1.4/index.html"/>
<item name="Javadoc (1.3 release)"
href="https://commons.apache.org/rng/commons-rng-simple/javadocs/api-1.3/index.html"/>
<item name="Javadoc (1.2 release)"
diff --git a/dist-archive/pom.xml b/dist-archive/pom.xml
index 6834677..34fc931 100644
--- a/dist-archive/pom.xml
+++ b/dist-archive/pom.xml
@@ -23,11 +23,11 @@ under the License.
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-parent</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</parent>
<artifactId>commons-rng</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<packaging>pom</packaging>
<name>Apache Commons RNG (full distribution)</name>
<description>This module creates the Apache Commons RNG distribution.</description>
@@ -67,18 +67,18 @@ under the License.
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-client-api</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-client-api</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<classifier>sources</classifier>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-client-api</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<classifier>javadoc</classifier>
</dependency>
@@ -86,18 +86,18 @@ under the License.
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-core</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-core</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<classifier>sources</classifier>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-core</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<classifier>javadoc</classifier>
</dependency>
@@ -105,18 +105,18 @@ under the License.
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-simple</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-simple</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<classifier>sources</classifier>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-simple</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<classifier>javadoc</classifier>
</dependency>
@@ -124,18 +124,18 @@ under the License.
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-sampling</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-sampling</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<classifier>sources</classifier>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-sampling</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<classifier>javadoc</classifier>
</dependency>
diff --git a/docs-archive/pom.xml b/docs-archive/pom.xml
index d7eeaa1..ba23e30 100644
--- a/docs-archive/pom.xml
+++ b/docs-archive/pom.xml
@@ -21,7 +21,7 @@
<parent>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-parent</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</parent>
<artifactId>commons-rng-docs</artifactId>
@@ -49,22 +49,22 @@
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-client-api</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-core</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-simple</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-rng-sampling</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
</dependency>
</dependencies>
diff --git a/pom.xml b/pom.xml
index ca65a7e..c81f574 100644
--- a/pom.xml
+++ b/pom.xml
@@ -24,7 +24,7 @@
</parent>
<artifactId>commons-rng-parent</artifactId>
- <version>1.4-SNAPSHOT</version>
+ <version>1.4</version>
<packaging>pom</packaging>
<name>Apache Commons RNG</name>
<description>The Apache Commons RNG project provides pure-Java implementation of pseudo-random generators.</description>
@@ -42,8 +42,8 @@
<!-- Java 9+ -->
<commons.automatic.module.name>org.apache.commons.rng.parent</commons.automatic.module.name>
<!-- do not use snapshot suffix here -->
- <commons.release.version>1.3</commons.release.version>
- <commons.bc.version>${commons.release.version}</commons.bc.version>
+ <commons.release.version>1.4</commons.release.version>
+ <commons.bc.version>1.3</commons.bc.version>
<commons.rc.version>RC1</commons.rc.version>
<commons.release.desc>(requires Java 8+)</commons.release.desc>
<commons.binary.suffix>-bin</commons.binary.suffix>
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index 62956d8..4f6c50d 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -53,7 +53,7 @@ If the output is not quite correct, check for invisible trailing spaces!
</properties>
<body>
- <release version="1.4" date="TBD" description="
+ <release version="1.4" date="2021-09-06" description="
This is a minor release of Apache Commons RNG, containing a
few new features and performance improvements.
Apache Commons RNG 1.4 contains the following library modules:
diff --git a/RELEASE-NOTES.txt b/src/site/resources/release-notes/RELEASE-NOTES-1.4.txt
similarity index 72%
copy from RELEASE-NOTES.txt
copy to src/site/resources/release-notes/RELEASE-NOTES-1.4.txt
index 167a288..3e5b3a7 100644
--- a/RELEASE-NOTES.txt
+++ b/src/site/resources/release-notes/RELEASE-NOTES-1.4.txt
@@ -1,4 +1,109 @@
+ Apache Commons RNG 1.4 RELEASE NOTES
+
+The Apache Commons RNG team is pleased to announce the release of Apache Commons RNG 1.4
+
+The Apache Commons RNG project provides pure-Java implementation
+of pseudo-random generators.
+
+This is a minor release of Apache Commons RNG, containing a
+few new features and performance improvements.
+
+Apache Commons RNG 1.4 contains the following library modules:
+ commons-rng-client-api (requires Java 8)
+ commons-rng-core (requires Java 8)
+ commons-rng-simple (requires Java 8)
+ commons-rng-sampling (requires Java 8)
+
+The code in module 'commons-rng-core' should not be accessed
+directly by applications as a future release might make use of
+the JPMS modularization feature available in Java 11+.
+
+Additional code is provided in the following modules:
+ commons-rng-examples-quadrature (requires Java 8)
+ commons-rng-examples-jmh (requires Java 8)
+ commons-rng-examples-sampling (requires Java 8)
+ commons-rng-examples-stress (requires Java 8)
+ commons-rng-examples-jpms (requires Java 11)
+
+It is however not part of the official API and no compatibility
+should be expected in subsequent releases.
+
+It must be noted that, due to the nature of random number generation, some unit tests
+are bound to fail with some probability. The 'maven-surefire-plugin' is configured
+to re-run tests that fail, and pass the build if they succeed within the allotted
+number of reruns (the test will be marked as 'flaky' in the report).
+
+Changes in this version include:
+
+New features:
+o RNG-156: New "DirichletSampler" class to sample from a Dirichlet distribution.
+o RNG-137: New "StableSampler" class to sample from a stable distribution.
+o RNG-138: New "CompositeSamplers" class to sample from a weighted combination of samplers.
+o RNG-140: New "LongSampler" interface for sampling a long. New "UniformLongSampler" to sample
+ from a range.
+o RNG-151: New "ZigguratSampler" implementation of the modified "Ziggurat" algorithm for
+ Gaussian and exponential sampling.
+o RNG-147: New "LevySampler" to sample from a Levy distribution.
+o RNG-145: "ContinuousUniformSampler": Add optional support for an open interval: (lower, upper).
+o RNG-143: "RandomSource": Add an instance create method. Deprecate the static create method.
+o RNG-136: New "ObjectSampler<T>" and "SharedStateObjectSampler<T>" interfaces.
+ These interfaces are implemented by samplers returning an object.
+ This changes the functional compatibility of existing samplers that implement
+ SharedStatedSampler<R>: CollectionSampler<T>; CombinationSampler;
+ DiscreteProbabilityCollectionSampler<T>; PermutationSampler; and UnitSphereSampler.
+ The method signature of the SharedStateSampler<R> interface remains
+ 'public R withUniformRandomProvider(UniformRandomProvider)'. The result can still be
+ assigned to an instance of the same class R; it can no longer be assigned to an instance
+ of SharedStatedSampler<R>. It can now be assigned to SharedStateObjectSampler<T>
+ which can be used to generate samples of type <T>.
+ Code that assigned to SharedStatedSampler<R> should be updated.
+o RNG-135: New "TetrahedronSampler" to sample uniformly from a tetrahedron.
+o RNG-134: New "BoxSampler" to sample uniformly from a box (or hyperrectangle).
+o RNG-133: New "LineSampler" to sample uniformly on a line segment.
+o RNG-131: New "TriangleSampler" to sample uniformly from a triangle.
+o RNG-132: New "o.a.c.rng.sampling.shape" package for sampling coordinates from shapes.
+o RNG-128: New "UnitBallSampler" to generate coordinates uniformly within an n-unit ball.
+o RNG-126: "PoissonSamplerCache": Method to return a SharedStateDiscreteSampler.
+o RNG-124: Add fixed increment versions of the PCG generators.
+
+Fixed Bugs:
+o RNG-159: "ZigguratSampler.NormalizedGaussian": Corrected biased sampling within convex regions
+ at the edge of the ziggurat.
+o RNG-146: "GaussianSampler": Prevent infinite mean and standard deviation.
+o RNG-144: "AhrensDieterExponentialSampler": Avoid possible infinite loop during sampling if the
+ underlying UniformRandomProvider creates a zero for the uniform deviate.
+o RNG-130: "UnitSphereSampler": Fix 1 dimension sampling to only return vectors containing 1 or -1.
+
+Changes:
+o RNG-163: Update test suite to JUnit 5.
+o Simplify assertions with simpler equivalent. Thanks to Arturo Bernal.
+o RNG-162: Update the minimum Java version to 1.8.
+o RNG-160: "ZigguratSampler.NormalizedGaussian": Performance improvement by extracting ziggurat
+ edge sampling to a separate method.
+o RNG-157: "UnitSphereSampler": Deprecate public constructor. Use the factory constructor to create
+ an optimal sampler.
+o RNG-155: "ZigguratNormalizedGaussianSampler": Update to a table size of 256.
+o RNG-152: Update samplers to use ZigguratSampler.NormalizedGaussian for Gaussian deviates.
+o RNG-154: Update Gaussian samplers to avoid infinity in the tails of the distribution. Applies
+ to: ZigguratNormalisedGaussianSampler; BoxMullerNormalizedGaussianSampler; and
+ BoxMullerGaussianSampler.
+o RNG-153: "UnitBallSampler": Update to use the ZigguratSampler for an exponential deviate for
+ ball point picking.
+o RNG-150: Update "LargeMeanPoissonSampler" and "GeometricSampler" to use the ZigguratSampler for
+ exponential deviates.
+o RNG-129: "UnitSphereSampler": Improve performance with specialisations for low order dimensions.
+ Added a factory constructor to create the sampler.
+
+
+For complete information on Apache Commons RNG, including instructions on how to submit bug reports,
+patches, or suggestions for improvement, see the Apache Commons RNG website:
+
+https://commons.apache.org/proper/commons-rng/
+
+
+=============================================================================
+
Apache Commons RNG 1.3 RELEASE NOTES
The Apache Commons RNG team is pleased to announce the release of Apache Commons RNG 1.3
diff --git a/src/site/xdoc/download_rng.xml b/src/site/xdoc/download_rng.xml
index 7c6630f..cf764a2 100644
--- a/src/site/xdoc/download_rng.xml
+++ b/src/site/xdoc/download_rng.xml
@@ -51,7 +51,7 @@ limitations under the License.
| |
| <properties> |
| <commons.componentid>math</commons.componentid> |
- | <commons.release.version>1.3</commons.release.version> |
+ | <commons.release.version>1.2</commons.release.version> |
| </properties> |
| |
+======================================================================+
@@ -113,32 +113,32 @@ limitations under the License.
</p>
</subsection>
</section>
- <section name="Apache Commons RNG 1.3 (requires Java 6+)">
+ <section name="Apache Commons RNG 1.4 (requires Java 8+)">
<subsection name="Binaries">
<table>
<tr>
- <td><a href="[preferred]/commons/rng/binaries/commons-rng-1.3-bin.tar.gz">commons-rng-1.3-bin.tar.gz</a></td>
- <td><a href="https://www.apache.org/dist/commons/rng/binaries/commons-rng-1.3-bin.tar.gz.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/rng/binaries/commons-rng-1.3-bin.tar.gz.asc">pgp</a></td>
+ <td><a href="[preferred]/commons/rng/binaries/commons-rng-1.4-bin.tar.gz">commons-rng-1.4-bin.tar.gz</a></td>
+ <td><a href="https://www.apache.org/dist/commons/rng/binaries/commons-rng-1.4-bin.tar.gz.sha512">sha512</a></td>
+ <td><a href="https://www.apache.org/dist/commons/rng/binaries/commons-rng-1.4-bin.tar.gz.asc">pgp</a></td>
</tr>
<tr>
- <td><a href="[preferred]/commons/rng/binaries/commons-rng-1.3-bin.zip">commons-rng-1.3-bin.zip</a></td>
- <td><a href="https://www.apache.org/dist/commons/rng/binaries/commons-rng-1.3-bin.zip.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/rng/binaries/commons-rng-1.3-bin.zip.asc">pgp</a></td>
+ <td><a href="[preferred]/commons/rng/binaries/commons-rng-1.4-bin.zip">commons-rng-1.4-bin.zip</a></td>
+ <td><a href="https://www.apache.org/dist/commons/rng/binaries/commons-rng-1.4-bin.zip.sha512">sha512</a></td>
+ <td><a href="https://www.apache.org/dist/commons/rng/binaries/commons-rng-1.4-bin.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
<subsection name="Source">
<table>
<tr>
- <td><a href="[preferred]/commons/rng/source/commons-rng-1.3-src.tar.gz">commons-rng-1.3-src.tar.gz</a></td>
- <td><a href="https://www.apache.org/dist/commons/rng/source/commons-rng-1.3-src.tar.gz.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/rng/source/commons-rng-1.3-src.tar.gz.asc">pgp</a></td>
+ <td><a href="[preferred]/commons/rng/source/commons-rng-1.4-src.tar.gz">commons-rng-1.4-src.tar.gz</a></td>
+ <td><a href="https://www.apache.org/dist/commons/rng/source/commons-rng-1.4-src.tar.gz.sha512">sha512</a></td>
+ <td><a href="https://www.apache.org/dist/commons/rng/source/commons-rng-1.4-src.tar.gz.asc">pgp</a></td>
</tr>
<tr>
- <td><a href="[preferred]/commons/rng/source/commons-rng-1.3-src.zip">commons-rng-1.3-src.zip</a></td>
- <td><a href="https://www.apache.org/dist/commons/rng/source/commons-rng-1.3-src.zip.sha512">sha512</a></td>
- <td><a href="https://www.apache.org/dist/commons/rng/source/commons-rng-1.3-src.zip.asc">pgp</a></td>
+ <td><a href="[preferred]/commons/rng/source/commons-rng-1.4-src.zip">commons-rng-1.4-src.zip</a></td>
+ <td><a href="https://www.apache.org/dist/commons/rng/source/commons-rng-1.4-src.zip.sha512">sha512</a></td>
+ <td><a href="https://www.apache.org/dist/commons/rng/source/commons-rng-1.4-src.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
diff --git a/src/site/xdoc/release-history.xml b/src/site/xdoc/release-history.xml
index 92f6d2a..db826d7 100644
--- a/src/site/xdoc/release-history.xml
+++ b/src/site/xdoc/release-history.xml
@@ -25,6 +25,9 @@ limitations under the License.
<table>
<tr><th>Version</th><th>Release date (YYYY-MM-DD)</th><th>Required Java Version</th><th>Release notes</th></tr>
<tr>
+ <td>1.4</td><td>2021-09-06</td><td>8+</td><td><a href="release-notes/RELEASE-NOTES-1.4.txt">release notes for 1.4</a></td>
+ </tr>
+ <tr>
<td>1.3</td><td>2019-11-08</td><td>6+</td><td><a href="release-notes/RELEASE-NOTES-1.3.txt">release notes for 1.3</a></td>
</tr>
<tr>