You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by ch...@apache.org on 2018/08/14 13:23:10 UTC
[24/33] commons-rng git commit: RELEASE-NOTES.txt,
changes to add RNG-50, and make minor edits
RELEASE-NOTES.txt, changes to add RNG-50, and make minor edits
Project: http://git-wip-us.apache.org/repos/asf/commons-rng/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-rng/commit/cc2dbe74
Tree: http://git-wip-us.apache.org/repos/asf/commons-rng/tree/cc2dbe74
Diff: http://git-wip-us.apache.org/repos/asf/commons-rng/diff/cc2dbe74
Branch: refs/heads/master
Commit: cc2dbe748fb2be6a3d58fb1429bf8bfadd53752d
Parents: 406a41d
Author: Rob Tompkins <ch...@gmail.com>
Authored: Mon Aug 6 08:28:29 2018 -0400
Committer: Rob Tompkins <ch...@gmail.com>
Committed: Mon Aug 6 08:28:29 2018 -0400
----------------------------------------------------------------------
RELEASE-NOTES.txt | 17 +++++++++++------
.../resources/release-notes/RELEASE-NOTES-1.1.txt | 17 +++++++++++------
2 files changed, 22 insertions(+), 12 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/commons-rng/blob/cc2dbe74/RELEASE-NOTES.txt
----------------------------------------------------------------------
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index 29ee3e2..230a1e7 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -14,18 +14,19 @@ Apache Commons RNG 1.1 contains the following library modules:
commons-rng-sampling (requires Java 6)
The code in module 'commons-rng-core' should not be accessed
-directly by applications as future release might make use of
-the JPMS modularization feature available from Java 9.
+directly by applications as a future release might make use of
+the JPMS modularization feature available in Java 9+.
Additional code is provided in the following module:
commons-rng-examples (requires Java 9)
It is however not part of the official API and no compatibility
should be expected in subsequent releases.
-We would like to also note that commons-rng-sampling has mildly 'flaky' tests due to the
-non-deterministic nature of random number generation. For this purpose, we have set
-failing tests to be re-run in the maven-surefire-plugin. Our current guess is that
-the build process could fail somewhere in the realm of 1 - 5 in 100 runs.
+We would like to also note that unit tests in module 'commons-rng-sampling'
+are bound to fail with some probability; this is expected due to the nature
+of random number generation. The 'maven-surefire-plugin' can be configured
+to re-run tests that fail and pass the build if they succeed (the test will
+be marked as 'flaky' in the report).
Changes in this version include:
@@ -48,6 +49,10 @@ o RNG-35: New generic "GaussianSampler" based on "NormalizedGaussianSampler"
Changes:
+o RNG-50: "PoissonSampler": Algorithms for small mean and large mean have
+ been separated into dedicated classes. Cache precomputation has
+ been disabled as it is only marginally used and is a performance
+ hit for small sampling sets.Thanks to Alex D. Herbert.
o RNG-42: Use "ZigguratNormalizedGaussianSampler" within the library.
o RNG-46: Following RNG-43, "BoxMullerLogNormalSampler" has been deprecated.
Furthermore, its base class has been removed; although it is a binary
http://git-wip-us.apache.org/repos/asf/commons-rng/blob/cc2dbe74/src/site/resources/release-notes/RELEASE-NOTES-1.1.txt
----------------------------------------------------------------------
diff --git a/src/site/resources/release-notes/RELEASE-NOTES-1.1.txt b/src/site/resources/release-notes/RELEASE-NOTES-1.1.txt
index 29ee3e2..230a1e7 100644
--- a/src/site/resources/release-notes/RELEASE-NOTES-1.1.txt
+++ b/src/site/resources/release-notes/RELEASE-NOTES-1.1.txt
@@ -14,18 +14,19 @@ Apache Commons RNG 1.1 contains the following library modules:
commons-rng-sampling (requires Java 6)
The code in module 'commons-rng-core' should not be accessed
-directly by applications as future release might make use of
-the JPMS modularization feature available from Java 9.
+directly by applications as a future release might make use of
+the JPMS modularization feature available in Java 9+.
Additional code is provided in the following module:
commons-rng-examples (requires Java 9)
It is however not part of the official API and no compatibility
should be expected in subsequent releases.
-We would like to also note that commons-rng-sampling has mildly 'flaky' tests due to the
-non-deterministic nature of random number generation. For this purpose, we have set
-failing tests to be re-run in the maven-surefire-plugin. Our current guess is that
-the build process could fail somewhere in the realm of 1 - 5 in 100 runs.
+We would like to also note that unit tests in module 'commons-rng-sampling'
+are bound to fail with some probability; this is expected due to the nature
+of random number generation. The 'maven-surefire-plugin' can be configured
+to re-run tests that fail and pass the build if they succeed (the test will
+be marked as 'flaky' in the report).
Changes in this version include:
@@ -48,6 +49,10 @@ o RNG-35: New generic "GaussianSampler" based on "NormalizedGaussianSampler"
Changes:
+o RNG-50: "PoissonSampler": Algorithms for small mean and large mean have
+ been separated into dedicated classes. Cache precomputation has
+ been disabled as it is only marginally used and is a performance
+ hit for small sampling sets.Thanks to Alex D. Herbert.
o RNG-42: Use "ZigguratNormalizedGaussianSampler" within the library.
o RNG-46: Following RNG-43, "BoxMullerLogNormalSampler" has been deprecated.
Furthermore, its base class has been removed; although it is a binary