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 2022/10/04 11:11:13 UTC
[commons-rng] branch master updated (eeeebc6d -> 8aabac1e)
This is an automated email from the ASF dual-hosted git repository.
aherbert pushed a change to branch master
in repository https://gitbox.apache.org/repos/asf/commons-rng.git
from eeeebc6d Use standard headers for pom xml files
new db6b2123 Correct version in release notes description
new 936388d1 Include Jira project prefix (RNG-) in changes issue attribute
new 8aabac1e Add note about matched versions required for client-api and core
The 3 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
src/changes/changes.xml | 107 +++++++++++++++++++++++++-----------------------
1 file changed, 55 insertions(+), 52 deletions(-)
[commons-rng] 01/03: Correct version in release notes description
Posted by ah...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
aherbert pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-rng.git
commit db6b2123e290ce8f42d54ca0dadb5e1d7231df5d
Author: aherbert <ah...@apache.org>
AuthorDate: Tue Oct 4 10:53:56 2022 +0100
Correct version in release notes description
---
src/changes/changes.xml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index bed33c92..ad18ea7c 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -56,7 +56,7 @@ If the output is not quite correct, check for invisible trailing spaces!
<release version="1.5" date="TBD" 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:
+Apache Commons RNG 1.5 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] 02/03: Include Jira project prefix (RNG-) in changes issue attribute
Posted by ah...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
aherbert pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-rng.git
commit 936388d1073aba49851c8c62ca1df010f1cda479
Author: aherbert <ah...@apache.org>
AuthorDate: Tue Oct 4 11:06:32 2022 +0100
Include Jira project prefix (RNG-) in changes issue attribute
---
src/changes/changes.xml | 100 ++++++++++++++++++++++++------------------------
1 file changed, 50 insertions(+), 50 deletions(-)
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index ad18ea7c..c503663e 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -86,57 +86,57 @@ behavioural compatibility between releases; derived types
may break behavioural compatibility. Any functional changes
will be recorded in the release notes.
">
- <action dev="aherbert" type="add" issue="182">
+ <action dev="aherbert" type="add" issue="RNG-182">
Add a Bill of Materials (BOM) to aid in dependency management when referencing multiple
Apache Commons RNG artifacts. The BOM should be used to ensure all imported artifacts are
compatible.
</action>
- <action dev="aherbert" type="add" issue="181">
+ <action dev="aherbert" type="add" issue="RNG-181">
LXM family to support SplittableUniformRandomProvider. This allows creating a parallel
stream of generators which will avoid sequence correlations between instances.
</action>
- <action dev="aherbert" type="add" issue="180">
+ <action dev="aherbert" type="add" issue="RNG-180">
New "SplittableUniformRandomProvider" interface to allow splitting a RNG into two
objects, each of which implements the same interface (and can be recursively split
indefinitely). Add default methods to support parallel stream implementations
of the UniformRandomProvider stream methods.
</action>
- <action dev="aherbert" type="add" issue="179">
+ <action dev="aherbert" type="add" issue="RNG-179">
"FastLoadedDiceRollerDiscreteSampler": Distribution sampler that uses the
Fast Loaded Dice Roller (FLDR) algorithm for exact sampling from a discrete
probability distribution.
</action>
- <action dev="aherbert" type="add" issue="178">
+ <action dev="aherbert" type="add" issue="RNG-178">
"JumpableUniformRandomProvider": Add support to generate Java 8 streams of new
random generator instances using the jump method.
</action>
- <action dev="aherbert" type="add" issue="176">
+ <action dev="aherbert" type="add" issue="RNG-176">
"UniformRandomProvider": Enhance the interface with default methods. Add range sample
methods with a lower and upper bound. Add support to generate Java 8 streams of sample
values.
</action>
- <action dev="aherbert" type="add" issue="177">
+ <action dev="aherbert" type="add" issue="RNG-177">
"sampling": Add samples() method to the API to generate Java 8 streams of sample values.
</action>
- <action dev="aherbert" type="add" issue="168">
+ <action dev="aherbert" type="add" issue="RNG-168">
New LXM family of random generators. Added implementations of the LXM generators
included in JDK 17.
</action>
- <action dev="aherbert" type="add" issue="174">
+ <action dev="aherbert" type="add" issue="RNG-174">
"RandomSource": Improve support for non-zero seeds. Seeding has been changed to specify
a sub-range of the seed that must not be all zero. Introduces a functional change where
byte[] seeds generated by RandomSource with a fixed UniformRandomProvider may be different.
Seeds are now reproducible across calls using an input random source in an identical state.
</action>
- <action dev="aherbert" type="fix" issue="175">
+ <action dev="aherbert" type="fix" issue="RNG-175">
"RandomSource.MSWS": createSeed(UniformRandomProvider) to handle a bad RNG.
This fixes an infinite loop when the RNG output is not suitably random to create a seed.
</action>
- <action dev="aherbert" type="add" issue="173">
+ <action dev="aherbert" type="add" issue="RNG-173">
"BaseProvider": Add a static method to extend input int[] and long[] seeds to a
minimum length.
</action>
- <action dev="aherbert" type="update" issue="171">
+ <action dev="aherbert" type="update" issue="RNG-171">
Reduce the memory footprint of the cached boolean and int source for the IntProvider
and LongProvider. This change has a performance improvement on some JDKs.
Note: This introduces a functional compatibility change to the output from the
@@ -144,10 +144,10 @@ will be recorded in the release notes.
each long is returned as the low 32-bits then the high 32-bits.
The bit output from nextBoolean is unchanged (little-endian order).
</action>
- <action dev="aherbert" type="update" issue="172">
+ <action dev="aherbert" type="update" issue="RNG-172">
"UniformLongSampler": Precompute rejection threshold for a non-power of 2 range.
</action>
- <action dev="aherbert" type="update" issue="169">
+ <action dev="aherbert" type="update" issue="RNG-169">
"RandomSource.create": Update array seed conversion to use optimum seed length.
Avoid duplication of input bytes and conversion of bytes that will be discarded.
This introduces a behavioural change for int[], long[], and int seed conversions.
@@ -158,22 +158,22 @@ will be recorded in the release notes.
additional bytes. Conversion of int[] to long avoids loss of bits
changing the possible output seeds from 2^32 to 2^64.
</action>
- <action dev="aherbert" type="fix" issue="170">
+ <action dev="aherbert" type="fix" issue="RNG-170">
Update implementations of "UniformRandomProvider.nextBytes" with a range
[start, start + length) to be consistent with the exception conditions of the
JDK array range checks.
</action>
- <action dev="aherbert" type="add" issue="167">
+ <action dev="aherbert" type="add" issue="RNG-167">
New "TSampler" class to sample from Student's t-distribution.
</action>
- <action dev="aherbert" type="fix" issue="166">
+ <action dev="aherbert" type="fix" issue="RNG-166">
Update "LogNormalSampler" and "BoxMullerLogNormalSampler" to allow a negative mean for
the natural logarithm of the distribution values.
</action>
- <action dev="aherbert" type="fix" issue="165">
+ <action dev="aherbert" type="fix" issue="RNG-165">
"RejectionInversionZipfSampler": Allow a zero exponent in the Zipf sampler.
</action>
- <action dev="aherbert" type="update" issue="160">
+ <action dev="aherbert" type="update" issue="RNG-160">
"ZigguratSampler": Performance improvement using ternary operator to sort values.
</action>
</release>
@@ -206,80 +206,80 @@ 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).
">
- <action dev="aherbert" type="update" issue="163">
+ <action dev="aherbert" type="update" issue="RNG-163">
Update test suite to JUnit 5.
</action>
<action dev="aherbert" due-to="Arturo Bernal" type="update">
Simplify assertions with simpler equivalent.
</action>
- <action dev="aherbert" type="update" issue="162">
+ <action dev="aherbert" type="update" issue="RNG-162">
Update the minimum Java version to 1.8.
</action>
- <action dev="aherbert" type="update" issue="160">
+ <action dev="aherbert" type="update" issue="RNG-160">
"ZigguratSampler.NormalizedGaussian": Performance improvement by extracting ziggurat
edge sampling to a separate method.
</action>
- <action dev="aherbert" type="fix" issue="159">
+ <action dev="aherbert" type="fix" issue="RNG-159">
"ZigguratSampler.NormalizedGaussian": Corrected biased sampling within convex regions
at the edge of the ziggurat.
</action>
- <action dev="aherbert" type="add" issue="156">
+ <action dev="aherbert" type="add" issue="RNG-156">
New "DirichletSampler" class to sample from a Dirichlet distribution.
</action>
- <action dev="aherbert" type="update" issue="157">
+ <action dev="aherbert" type="update" issue="RNG-157">
"UnitSphereSampler": Deprecate public constructor. Use the factory constructor to create
an optimal sampler.
</action>
- <action dev="aherbert" type="add" issue="137">
+ <action dev="aherbert" type="add" issue="RNG-137">
New "StableSampler" class to sample from a stable distribution.
</action>
- <action dev="aherbert" type="add" issue="138">
+ <action dev="aherbert" type="add" issue="RNG-138">
New "CompositeSamplers" class to sample from a weighted combination of samplers.
</action>
- <action dev="aherbert" type="add" issue="140">
+ <action dev="aherbert" type="add" issue="RNG-140">
New "LongSampler" interface for sampling a long. New "UniformLongSampler" to sample
from a range.
</action>
- <action dev="aherbert" type="update" issue="155">
+ <action dev="aherbert" type="update" issue="RNG-155">
"ZigguratNormalizedGaussianSampler": Update to a table size of 256.
</action>
- <action dev="aherbert" type="update" issue="152">
+ <action dev="aherbert" type="update" issue="RNG-152">
Update samplers to use ZigguratSampler.NormalizedGaussian for Gaussian deviates.
</action>
- <action dev="aherbert" type="fix" issue="146">
+ <action dev="aherbert" type="fix" issue="RNG-146">
"GaussianSampler": Prevent infinite mean and standard deviation.
</action>
- <action dev="aherbert" type="update" issue="154">
+ <action dev="aherbert" type="update" issue="RNG-154">
Update Gaussian samplers to avoid infinity in the tails of the distribution. Applies
to: ZigguratNormalisedGaussianSampler; BoxMullerNormalizedGaussianSampler; and
BoxMullerGaussianSampler.
</action>
- <action dev="aherbert" type="update" issue="153">
+ <action dev="aherbert" type="update" issue="RNG-153">
"UnitBallSampler": Update to use the ZigguratSampler for an exponential deviate for
ball point picking.
</action>
- <action dev="aherbert" type="update" issue="150">
+ <action dev="aherbert" type="update" issue="RNG-150">
Update "LargeMeanPoissonSampler" and "GeometricSampler" to use the ZigguratSampler for
exponential deviates.
</action>
- <action dev="aherbert" type="add" issue="151">
+ <action dev="aherbert" type="add" issue="RNG-151">
New "ZigguratSampler" implementation of the modified "Ziggurat" algorithm for
Gaussian and exponential sampling.
</action>
- <action dev="aherbert" type="add" issue="147">
+ <action dev="aherbert" type="add" issue="RNG-147">
New "LevySampler" to sample from a Levy distribution.
</action>
- <action dev="aherbert" type="add" issue="145">
+ <action dev="aherbert" type="add" issue="RNG-145">
"ContinuousUniformSampler": Add optional support for an open interval: (lower, upper).
</action>
- <action dev="aherbert" type="fix" issue="144">
+ <action dev="aherbert" type="fix" issue="RNG-144">
"AhrensDieterExponentialSampler": Avoid possible infinite loop during sampling if the
underlying UniformRandomProvider creates a zero for the uniform deviate.
</action>
- <action dev="aherbert" type="add" issue="143">
+ <action dev="aherbert" type="add" issue="RNG-143">
"RandomSource": Add an instance create method. Deprecate the static create method.
</action>
- <action dev="aherbert" type="add" issue="136">
+ <action dev="aherbert" type="add" issue="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
@@ -292,35 +292,35 @@ as 'flaky' in the report).
which can be used to generate samples of type <T>.
Code that assigned to SharedStatedSampler<R> should be updated.
</action>
- <action dev="aherbert" type="add" issue="135">
+ <action dev="aherbert" type="add" issue="RNG-135">
New "TetrahedronSampler" to sample uniformly from a tetrahedron.
</action>
- <action dev="aherbert" type="add" issue="134">
+ <action dev="aherbert" type="add" issue="RNG-134">
New "BoxSampler" to sample uniformly from a box (or hyperrectangle).
</action>
- <action dev="aherbert" type="add" issue="133">
+ <action dev="aherbert" type="add" issue="RNG-133">
New "LineSampler" to sample uniformly on a line segment.
</action>
- <action dev="aherbert" type="add" issue="131">
+ <action dev="aherbert" type="add" issue="RNG-131">
New "TriangleSampler" to sample uniformly from a triangle.
</action>
- <action dev="aherbert" type="add" issue="132">
+ <action dev="aherbert" type="add" issue="RNG-132">
New "o.a.c.rng.sampling.shape" package for sampling coordinates from shapes.
</action>
- <action dev="aherbert" type="fix" issue="130">
+ <action dev="aherbert" type="fix" issue="RNG-130">
"UnitSphereSampler": Fix 1 dimension sampling to only return vectors containing 1 or -1.
</action>
- <action dev="aherbert" type="update" issue="129">
+ <action dev="aherbert" type="update" issue="RNG-129">
"UnitSphereSampler": Improve performance with specialisations for low order dimensions.
Added a factory constructor to create the sampler.
</action>
- <action dev="aherbert" type="add" issue="128">
+ <action dev="aherbert" type="add" issue="RNG-128">
New "UnitBallSampler" to generate coordinates uniformly within an n-unit ball.
</action>
- <action dev="aherbert" type="add" issue="126">
+ <action dev="aherbert" type="add" issue="RNG-126">
"PoissonSamplerCache": Method to return a SharedStateDiscreteSampler.
</action>
- <action dev="aherbert" type="add" issue="124">
+ <action dev="aherbert" type="add" issue="RNG-124">
Add fixed increment versions of the PCG generators.
</action>
</release>
[commons-rng] 03/03: Add note about matched versions required for client-api and core
Posted by ah...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
aherbert pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/commons-rng.git
commit 8aabac1ecd4d8ecd9e1882b0b8be74a758641dc1
Author: aherbert <ah...@apache.org>
AuthorDate: Tue Oct 4 11:40:38 2022 +0100
Add note about matched versions required for client-api and core
Relates to RNG-176: The addition of default methods to
UniformRandomProvider in the client-api removed the same method
implementations from the core module.
---
src/changes/changes.xml | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index c503663e..f51271fb 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -113,7 +113,10 @@ will be recorded in the release notes.
<action dev="aherbert" type="add" issue="RNG-176">
"UniformRandomProvider": Enhance the interface with default methods. Add range sample
methods with a lower and upper bound. Add support to generate Java 8 streams of sample
- values.
+ values. Note: This moves some method implementations from the core module to the client-api
+ module. Binary compatibility is supported if the versions of these modules are matched.
+ Users of the simple module should ensure the client-api and core modules are resolved as
+ matched versions and not mismatched by transitive dependency resolution.
</action>
<action dev="aherbert" type="add" issue="RNG-177">
"sampling": Add samples() method to the API to generate Java 8 streams of sample values.