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-numbers.git
commit c4b9ef491c7da8e3efd10db7189472c5cf730e67 Author: aherbert <aherb...@apache.org> AuthorDate: Tue Nov 1 10:44:09 2022 +0000 Update following release 1.1 --- RELEASE-NOTES.txt | 71 ++++++++++++++++++++++ commons-numbers-angle/pom.xml | 2 +- commons-numbers-angle/src/site/site.xml | 2 + commons-numbers-arrays/pom.xml | 2 +- commons-numbers-arrays/src/site/site.xml | 2 + commons-numbers-bom/pom.xml | 4 +- commons-numbers-combinatorics/pom.xml | 2 +- commons-numbers-combinatorics/src/site/site.xml | 2 + commons-numbers-complex-streams/pom.xml | 2 +- commons-numbers-complex/pom.xml | 2 +- commons-numbers-complex/src/site/site.xml | 2 + commons-numbers-core/pom.xml | 2 +- commons-numbers-core/src/site/site.xml | 2 + commons-numbers-docs/pom.xml | 26 ++++---- commons-numbers-examples/examples-jmh/pom.xml | 2 +- commons-numbers-examples/pom.xml | 2 +- commons-numbers-field/pom.xml | 2 +- commons-numbers-field/src/site/site.xml | 2 + commons-numbers-fraction/pom.xml | 2 +- commons-numbers-fraction/src/site/site.xml | 2 + commons-numbers-gamma/pom.xml | 2 +- commons-numbers-gamma/src/site/site.xml | 2 + commons-numbers-primes/pom.xml | 2 +- commons-numbers-primes/src/site/site.xml | 2 + commons-numbers-quaternion/pom.xml | 2 +- commons-numbers-quaternion/src/site/site.xml | 2 + commons-numbers-rootfinder/pom.xml | 2 +- commons-numbers-rootfinder/src/site/site.xml | 2 + dist-archive/pom.xml | 10 ++- pom.xml | 2 +- src/changes/changes.xml | 23 ++++--- .../resources/release-notes/RELEASE-NOTES-1.1.txt | 71 ++++++++++++++++++++++ src/site/xdoc/download_numbers.xml | 26 ++++---- src/site/xdoc/release-history.xml | 3 + 34 files changed, 228 insertions(+), 58 deletions(-) diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt index b7f93984..2d8e52a9 100644 --- a/RELEASE-NOTES.txt +++ b/RELEASE-NOTES.txt @@ -1,4 +1,75 @@ + Apache Commons Numbers 1.1 RELEASE NOTES + +The Apache Commons Numbers team is pleased to announce the release of +commons-numbers-parent-1.1 + +The Apache Commons Numbers project provides number types and utilities. + +New features, updates and bug fixes. Adds a commons-numbers-bom module. Requires Java 8. + +Changes in this version include: + +New features: +o NUMBERS-70: Add a user guide. +o NUMBERS-190: Add a Bill of Materials (BOM) to aid in dependency management when referencing + multiple Apache Commons Numbers artifacts. The BOM should be used to ensure all + imported artifacts are compatible. +o NUMBERS-181: Updated support for the beta functions. "RegularizedBeta": Added the + complement and derivative of the regularized beta function. + Added "IncompleteBeta" and "Beta" classes. + Functionality is ported from the Boost C++ library. +o NUMBERS-180: "GammaRatio": Compute the ratio of two gamma functions. +o NUMBERS-177: "Erfcx": Compute a scaled complementary error function: + erfcx(z) = erfc(z) * exp(z*z). +o NUMBERS-175: "GeneralizedContinuedFraction": A continued fraction class to compute using a + generator. Allows evaluation of continued fractions from a regular series where + coefficients can be computed iteratively from the previous coefficients. + +Fixed Bugs: +o NUMBERS-185: "Precision": Allow Precision.compareTo using a maxUlps to be used for sorting. + This corrects handling of NaN comparisons. +o NUMBERS-182: "LogBeta": Avoid overflow for tiny arguments. +o "BrentSolver": Avoid overflow creating the initial value between the lower and upper. +o NUMBERS-173: "ContinuedFraction": Set a minimum bound on the relative error epsilon. Prevents + an infinite loop when the epsilon is zero. +o "FactorialDouble": Prevent caching values that are infinite. The cache will support + factorials up to 170. +o NUMBERS-170: "RegularizedBeta": Detect edge cases for arguments that can be evaluated by + exploiting properties of the regularized beta function. +o NUMBERS-168: "BrentSolver": Identify brackets with small objective values. +o Fix wrong javadoc. Thanks to Arturo Bernal. + +Changes: +o NUMBERS-184: "Precision": Reduce number of operations in Precision.equals using a maxUlps. +o NUMBERS-183: Improve the binomial coefficient classes. Avoid recursive method calls. + Avoid overflow for BinomialCoefficientDouble for large results close to infinity. + Use precomputed factorials and the LogBeta function for efficiency. +o NUMBERS-178: "Factorial/FactorialDouble": Tabulate all factorials with exact 64-bit double + representations of n! up to n=170. This change deprecates the FactorialDouble + class and removes obsolete caching functionality. +o NUMBERS-176: "ContinuedFraction": Update to use a shared implementation with + GeneralizedContinuedFraction. +o NUMBERS-174: "Gamma/LogGamma/RegularizedGamma": Update the gamma function implementations to + increase accuracy and support for extreme values. + Functionality is ported from the Boost C++ library. +o NUMBERS-172: "Erf/Erfc": Use a rational function approximation accurate to 53-bits of precision. + This replaces the use of the regularized gamma functions P and Q and increases accuracy + at extreme limits of the function. Execution speed is improved. + Functionality is ported from the Boost C++ library. +o NUMBERS-171: "InverseErfc": Support full range of [0, 2]. This lowers the supported + minimum value from 2^-53 to double min value. Execution speed is improved. + Functionality is ported from the Boost C++ library. + + +For complete information on Apache Commons Numbers, including instructions on how to submit bug +reports, patches, or suggestions for improvement, see the Apache Commons Numbers website: + +http://commons.apache.org/proper/commons-numbers/ + + +============================================================================= + Apache Commons Numbers 1.0 RELEASE NOTES The Apache Commons Numbers team is pleased to announce the release of diff --git a/commons-numbers-angle/pom.xml b/commons-numbers-angle/pom.xml index caebc1e8..3d296e0b 100644 --- a/commons-numbers-angle/pom.xml +++ b/commons-numbers-angle/pom.xml @@ -21,7 +21,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers-angle</artifactId> diff --git a/commons-numbers-angle/src/site/site.xml b/commons-numbers-angle/src/site/site.xml index e404cae1..f00f802a 100644 --- a/commons-numbers-angle/src/site/site.xml +++ b/commons-numbers-angle/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.1 release)" + href="http://commons.apache.org/numbers/commons-numbers-angle/javadocs/api-1.1/index.html"/> <item name="Javadoc (1.0 release)" href="http://commons.apache.org/numbers/commons-numbers-angle/javadocs/api-1.0/index.html"/> <item name="Javadoc (1.0-beta1 release)" diff --git a/commons-numbers-arrays/pom.xml b/commons-numbers-arrays/pom.xml index 3a7ceb8b..2d86e9a1 100644 --- a/commons-numbers-arrays/pom.xml +++ b/commons-numbers-arrays/pom.xml @@ -21,7 +21,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers-arrays</artifactId> diff --git a/commons-numbers-arrays/src/site/site.xml b/commons-numbers-arrays/src/site/site.xml index f4ea4ce9..82974642 100644 --- a/commons-numbers-arrays/src/site/site.xml +++ b/commons-numbers-arrays/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.1 release)" + href="http://commons.apache.org/numbers/commons-numbers-arrays/javadocs/api-1.1/index.html"/> <item name="Javadoc (1.0 release)" href="http://commons.apache.org/numbers/commons-numbers-arrays/javadocs/api-1.0/index.html"/> <item name="Javadoc (1.0-beta1 release)" diff --git a/commons-numbers-bom/pom.xml b/commons-numbers-bom/pom.xml index 60e64cd9..ab8950c6 100644 --- a/commons-numbers-bom/pom.xml +++ b/commons-numbers-bom/pom.xml @@ -21,11 +21,11 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers-bom</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> <name>Apache Commons Numbers (Bill of Materials)</name> <packaging>pom</packaging> diff --git a/commons-numbers-combinatorics/pom.xml b/commons-numbers-combinatorics/pom.xml index 4eb8bfa4..223480b1 100644 --- a/commons-numbers-combinatorics/pom.xml +++ b/commons-numbers-combinatorics/pom.xml @@ -21,7 +21,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers-combinatorics</artifactId> diff --git a/commons-numbers-combinatorics/src/site/site.xml b/commons-numbers-combinatorics/src/site/site.xml index 0d968268..1bd05daf 100644 --- a/commons-numbers-combinatorics/src/site/site.xml +++ b/commons-numbers-combinatorics/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.1 release)" + href="http://commons.apache.org/numbers/commons-numbers-combinatorics/javadocs/api-1.1/index.html"/> <item name="Javadoc (1.0 release)" href="http://commons.apache.org/numbers/commons-numbers-combinatorics/javadocs/api-1.0/index.html"/> <item name="Javadoc (1.0-beta1 release)" diff --git a/commons-numbers-complex-streams/pom.xml b/commons-numbers-complex-streams/pom.xml index 994797ae..1c57118e 100644 --- a/commons-numbers-complex-streams/pom.xml +++ b/commons-numbers-complex-streams/pom.xml @@ -23,7 +23,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers-complex-streams</artifactId> diff --git a/commons-numbers-complex/pom.xml b/commons-numbers-complex/pom.xml index dcc7c230..11b7b6f1 100644 --- a/commons-numbers-complex/pom.xml +++ b/commons-numbers-complex/pom.xml @@ -21,7 +21,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers-complex</artifactId> diff --git a/commons-numbers-complex/src/site/site.xml b/commons-numbers-complex/src/site/site.xml index 7cddab35..d02437fb 100644 --- a/commons-numbers-complex/src/site/site.xml +++ b/commons-numbers-complex/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.1 release)" + href="http://commons.apache.org/numbers/commons-numbers-complex/javadocs/api-1.1/index.html"/> <item name="Javadoc (1.0 release)" href="http://commons.apache.org/numbers/commons-numbers-complex/javadocs/api-1.0/index.html"/> <item name="Javadoc (1.0-beta1 release)" diff --git a/commons-numbers-core/pom.xml b/commons-numbers-core/pom.xml index 488f8715..bd449875 100644 --- a/commons-numbers-core/pom.xml +++ b/commons-numbers-core/pom.xml @@ -21,7 +21,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers-core</artifactId> diff --git a/commons-numbers-core/src/site/site.xml b/commons-numbers-core/src/site/site.xml index 96513336..409ad3eb 100644 --- a/commons-numbers-core/src/site/site.xml +++ b/commons-numbers-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.1 release)" + href="http://commons.apache.org/numbers/commons-numbers-core/javadocs/api-1.1/index.html"/> <item name="Javadoc (1.0 release)" href="http://commons.apache.org/numbers/commons-numbers-core/javadocs/api-1.0/index.html"/> <item name="Javadoc (1.0-beta1 release)" diff --git a/commons-numbers-docs/pom.xml b/commons-numbers-docs/pom.xml index edb1fd62..b52fe188 100644 --- a/commons-numbers-docs/pom.xml +++ b/commons-numbers-docs/pom.xml @@ -21,7 +21,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers-docs</artifactId> @@ -57,59 +57,59 @@ <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-angle</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </dependency> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-arrays</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </dependency> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-combinatorics</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </dependency> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-complex</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </dependency> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-core</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </dependency> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-field</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </dependency> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-fraction</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </dependency> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-gamma</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </dependency> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-primes</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </dependency> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-quaternion</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </dependency> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-rootfinder</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </dependency> - </dependencies > + </dependencies> <build> <sourceDirectory>src</sourceDirectory> diff --git a/commons-numbers-examples/examples-jmh/pom.xml b/commons-numbers-examples/examples-jmh/pom.xml index ff219a39..ab519301 100644 --- a/commons-numbers-examples/examples-jmh/pom.xml +++ b/commons-numbers-examples/examples-jmh/pom.xml @@ -21,7 +21,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-examples</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers-examples-jmh</artifactId> diff --git a/commons-numbers-examples/pom.xml b/commons-numbers-examples/pom.xml index e20d3052..4da22327 100644 --- a/commons-numbers-examples/pom.xml +++ b/commons-numbers-examples/pom.xml @@ -21,7 +21,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers-examples</artifactId> diff --git a/commons-numbers-field/pom.xml b/commons-numbers-field/pom.xml index d3c20a0d..09933a61 100644 --- a/commons-numbers-field/pom.xml +++ b/commons-numbers-field/pom.xml @@ -21,7 +21,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers-field</artifactId> diff --git a/commons-numbers-field/src/site/site.xml b/commons-numbers-field/src/site/site.xml index bfdbc9c1..f1aab286 100644 --- a/commons-numbers-field/src/site/site.xml +++ b/commons-numbers-field/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.1 release)" + href="http://commons.apache.org/numbers/commons-numbers-field/javadocs/api-1.1/index.html"/> <item name="Javadoc (1.0 release)" href="http://commons.apache.org/numbers/commons-numbers-field/javadocs/api-1.0/index.html"/> <item name="Javadoc (1.0-beta1 release)" diff --git a/commons-numbers-fraction/pom.xml b/commons-numbers-fraction/pom.xml index 732b2cb2..2adf5efa 100644 --- a/commons-numbers-fraction/pom.xml +++ b/commons-numbers-fraction/pom.xml @@ -21,7 +21,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers-fraction</artifactId> diff --git a/commons-numbers-fraction/src/site/site.xml b/commons-numbers-fraction/src/site/site.xml index c9866cb6..e51f5834 100644 --- a/commons-numbers-fraction/src/site/site.xml +++ b/commons-numbers-fraction/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.1 release)" + href="http://commons.apache.org/numbers/commons-numbers-fraction/javadocs/api-1.1/index.html"/> <item name="Javadoc (1.0 release)" href="http://commons.apache.org/numbers/commons-numbers-fraction/javadocs/api-1.0/index.html"/> <item name="Javadoc (1.0-beta1 release)" diff --git a/commons-numbers-gamma/pom.xml b/commons-numbers-gamma/pom.xml index d02769d1..5ce3fb0d 100644 --- a/commons-numbers-gamma/pom.xml +++ b/commons-numbers-gamma/pom.xml @@ -21,7 +21,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers-gamma</artifactId> diff --git a/commons-numbers-gamma/src/site/site.xml b/commons-numbers-gamma/src/site/site.xml index db5ac5c1..d5f5fbe2 100644 --- a/commons-numbers-gamma/src/site/site.xml +++ b/commons-numbers-gamma/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.1 release)" + href="http://commons.apache.org/numbers/commons-numbers-gamma/javadocs/api-1.1/index.html"/> <item name="Javadoc (1.0 release)" href="http://commons.apache.org/numbers/commons-numbers-gamma/javadocs/api-1.0/index.html"/> <item name="Javadoc (1.0-beta1 release)" diff --git a/commons-numbers-primes/pom.xml b/commons-numbers-primes/pom.xml index d617bc21..76e2de4b 100644 --- a/commons-numbers-primes/pom.xml +++ b/commons-numbers-primes/pom.xml @@ -21,7 +21,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers-primes</artifactId> diff --git a/commons-numbers-primes/src/site/site.xml b/commons-numbers-primes/src/site/site.xml index 31866df5..1f39d2e2 100644 --- a/commons-numbers-primes/src/site/site.xml +++ b/commons-numbers-primes/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.1 release)" + href="http://commons.apache.org/numbers/commons-numbers-primes/javadocs/api-1.1/index.html"/> <item name="Javadoc (1.0 release)" href="http://commons.apache.org/numbers/commons-numbers-primes/javadocs/api-1.0/index.html"/> <item name="Javadoc (1.0-beta1 release)" diff --git a/commons-numbers-quaternion/pom.xml b/commons-numbers-quaternion/pom.xml index c9167a60..3fa10d5f 100644 --- a/commons-numbers-quaternion/pom.xml +++ b/commons-numbers-quaternion/pom.xml @@ -21,7 +21,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers-quaternion</artifactId> diff --git a/commons-numbers-quaternion/src/site/site.xml b/commons-numbers-quaternion/src/site/site.xml index d842ec6c..699cd872 100644 --- a/commons-numbers-quaternion/src/site/site.xml +++ b/commons-numbers-quaternion/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.1 release)" + href="http://commons.apache.org/numbers/commons-numbers-quaternion/javadocs/api-1.1/index.html"/> <item name="Javadoc (1.0 release)" href="http://commons.apache.org/numbers/commons-numbers-quaternion/javadocs/api-1.0/index.html"/> <item name="Javadoc (1.0-beta1 release)" diff --git a/commons-numbers-rootfinder/pom.xml b/commons-numbers-rootfinder/pom.xml index c507f572..01b5ccec 100644 --- a/commons-numbers-rootfinder/pom.xml +++ b/commons-numbers-rootfinder/pom.xml @@ -21,7 +21,7 @@ <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers-rootfinder</artifactId> diff --git a/commons-numbers-rootfinder/src/site/site.xml b/commons-numbers-rootfinder/src/site/site.xml index ab8caccb..48ec5ada 100644 --- a/commons-numbers-rootfinder/src/site/site.xml +++ b/commons-numbers-rootfinder/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.1 release)" + href="http://commons.apache.org/numbers/commons-numbers-rootfinder/javadocs/api-1.1/index.html"/> <item name="Javadoc (1.0 release)" href="http://commons.apache.org/numbers/commons-numbers-rootfinder/javadocs/api-1.0/index.html"/> <item name="Javadoc (1.0-beta1 release)" diff --git a/dist-archive/pom.xml b/dist-archive/pom.xml index 0906edcc..deeb9514 100644 --- a/dist-archive/pom.xml +++ b/dist-archive/pom.xml @@ -17,15 +17,13 @@ KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> -<project xmlns="http://maven.apache.org/POM/4.0.0" - xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" - xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> +<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <parent> <groupId>org.apache.commons</groupId> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> </parent> <artifactId>commons-numbers</artifactId> @@ -41,8 +39,8 @@ under the License. <commons.siteOutputDirectory>${basedir}/../target/site</commons.siteOutputDirectory> <commons.releaseNotesLocation>${basedir}/../RELEASE-NOTES.txt</commons.releaseNotesLocation> <commons.distSvnStagingUrl>scm:svn:https://dist.apache.org/repos/dist/dev/commons/${commons.componentid}</commons.distSvnStagingUrl> - <commons.releaseManagerName>Matt Juntunen</commons.releaseManagerName> - <commons.releaseManagerKey>7DD53AEFEDF1C3D392B51EBE346F4FCECFB70B1A</commons.releaseManagerKey> + <commons.releaseManagerName>Alex Herbert</commons.releaseManagerName> + <commons.releaseManagerKey>BC87A3FD0A54480F0BADBEBD21939FF0CA2A6567</commons.releaseManagerKey> </properties> <build> diff --git a/pom.xml b/pom.xml index 385e80af..54963b5c 100644 --- a/pom.xml +++ b/pom.xml @@ -25,7 +25,7 @@ </parent> <artifactId>commons-numbers-parent</artifactId> - <version>1.1-SNAPSHOT</version> + <version>1.2-SNAPSHOT</version> <packaging>pom</packaging> <name>Apache Commons Numbers</name> <description>The Apache Commons Numbers project provides number types and utilities.</description> diff --git a/src/changes/changes.xml b/src/changes/changes.xml index ce0dba1e..d745b9ce 100644 --- a/src/changes/changes.xml +++ b/src/changes/changes.xml @@ -52,13 +52,16 @@ If the output is not quite correct, check for invisible trailing spaces! <title>Apache Commons Numbers Release Notes</title> </properties> <body> - <release version="1.1" date="TBD" description=" + <release version="1.1" date="2022-11-01" description=" New features, updates and bug fixes. Adds a commons-numbers-bom module. Requires Java 8. "> + <action dev="aherbert" type="add" issue="NUMBERS-70"> + Add a user guide. + </action> <action dev="aherbert" type="add" issue="NUMBERS-190"> - Add a Bill of Materials (BOM) to aid in dependency management when referencing multiple - Apache Commons Numbers artifacts. The BOM should be used to ensure all imported artifacts are - compatible. + Add a Bill of Materials (BOM) to aid in dependency management when referencing + multiple Apache Commons Numbers artifacts. The BOM should be used to ensure all + imported artifacts are compatible. </action> <action dev="aherbert" type="fix" issue="NUMBERS-185"> "Precision": Allow Precision.compareTo using a maxUlps to be used for sorting. @@ -88,7 +91,8 @@ New features, updates and bug fixes. Adds a commons-numbers-bom module. Requires "BrentSolver": Avoid overflow creating the initial value between the lower and upper. </action> <action dev="aherbert" type="add" issue="NUMBERS-177"> - "Erfcx": Compute a scaled complementary error function: erfcx(z) = erfc(z) * exp(z*z). + "Erfcx": Compute a scaled complementary error function: + erfcx(z) = erfc(z) * exp(z*z). </action> <action dev="aherbert" type="update" issue="NUMBERS-178"> "Factorial/FactorialDouble": Tabulate all factorials with exact 64-bit double @@ -96,7 +100,8 @@ New features, updates and bug fixes. Adds a commons-numbers-bom module. Requires class and removes obsolete caching functionality. </action> <action dev="aherbert" type="update" issue="NUMBERS-176"> - "ContinuedFraction": Update to use a shared implementation with GeneralizedContinuedFraction. + "ContinuedFraction": Update to use a shared implementation with + GeneralizedContinuedFraction. </action> <action dev="aherbert" type="update" issue="NUMBERS-174"> "Gamma/LogGamma/RegularizedGamma": Update the gamma function implementations to @@ -104,9 +109,9 @@ New features, updates and bug fixes. Adds a commons-numbers-bom module. Requires Functionality is ported from the Boost C++ library. </action> <action dev="aherbert" type="add" issue="NUMBERS-175"> - "GeneralizedContinuedFraction": A continued fraction class to compute using a generator. - Allows evaluation of continued fractions from a regular series where coefficients can - be computed iteratively from the previous coefficients. + "GeneralizedContinuedFraction": A continued fraction class to compute using a + generator. Allows evaluation of continued fractions from a regular series where + coefficients can be computed iteratively from the previous coefficients. </action> <action dev="aherbert" type="fix" issue="NUMBERS-173"> "ContinuedFraction": Set a minimum bound on the relative error epsilon. Prevents diff --git a/RELEASE-NOTES.txt b/src/site/resources/release-notes/RELEASE-NOTES-1.1.txt similarity index 54% copy from RELEASE-NOTES.txt copy to src/site/resources/release-notes/RELEASE-NOTES-1.1.txt index b7f93984..2d8e52a9 100644 --- a/RELEASE-NOTES.txt +++ b/src/site/resources/release-notes/RELEASE-NOTES-1.1.txt @@ -1,4 +1,75 @@ + Apache Commons Numbers 1.1 RELEASE NOTES + +The Apache Commons Numbers team is pleased to announce the release of +commons-numbers-parent-1.1 + +The Apache Commons Numbers project provides number types and utilities. + +New features, updates and bug fixes. Adds a commons-numbers-bom module. Requires Java 8. + +Changes in this version include: + +New features: +o NUMBERS-70: Add a user guide. +o NUMBERS-190: Add a Bill of Materials (BOM) to aid in dependency management when referencing + multiple Apache Commons Numbers artifacts. The BOM should be used to ensure all + imported artifacts are compatible. +o NUMBERS-181: Updated support for the beta functions. "RegularizedBeta": Added the + complement and derivative of the regularized beta function. + Added "IncompleteBeta" and "Beta" classes. + Functionality is ported from the Boost C++ library. +o NUMBERS-180: "GammaRatio": Compute the ratio of two gamma functions. +o NUMBERS-177: "Erfcx": Compute a scaled complementary error function: + erfcx(z) = erfc(z) * exp(z*z). +o NUMBERS-175: "GeneralizedContinuedFraction": A continued fraction class to compute using a + generator. Allows evaluation of continued fractions from a regular series where + coefficients can be computed iteratively from the previous coefficients. + +Fixed Bugs: +o NUMBERS-185: "Precision": Allow Precision.compareTo using a maxUlps to be used for sorting. + This corrects handling of NaN comparisons. +o NUMBERS-182: "LogBeta": Avoid overflow for tiny arguments. +o "BrentSolver": Avoid overflow creating the initial value between the lower and upper. +o NUMBERS-173: "ContinuedFraction": Set a minimum bound on the relative error epsilon. Prevents + an infinite loop when the epsilon is zero. +o "FactorialDouble": Prevent caching values that are infinite. The cache will support + factorials up to 170. +o NUMBERS-170: "RegularizedBeta": Detect edge cases for arguments that can be evaluated by + exploiting properties of the regularized beta function. +o NUMBERS-168: "BrentSolver": Identify brackets with small objective values. +o Fix wrong javadoc. Thanks to Arturo Bernal. + +Changes: +o NUMBERS-184: "Precision": Reduce number of operations in Precision.equals using a maxUlps. +o NUMBERS-183: Improve the binomial coefficient classes. Avoid recursive method calls. + Avoid overflow for BinomialCoefficientDouble for large results close to infinity. + Use precomputed factorials and the LogBeta function for efficiency. +o NUMBERS-178: "Factorial/FactorialDouble": Tabulate all factorials with exact 64-bit double + representations of n! up to n=170. This change deprecates the FactorialDouble + class and removes obsolete caching functionality. +o NUMBERS-176: "ContinuedFraction": Update to use a shared implementation with + GeneralizedContinuedFraction. +o NUMBERS-174: "Gamma/LogGamma/RegularizedGamma": Update the gamma function implementations to + increase accuracy and support for extreme values. + Functionality is ported from the Boost C++ library. +o NUMBERS-172: "Erf/Erfc": Use a rational function approximation accurate to 53-bits of precision. + This replaces the use of the regularized gamma functions P and Q and increases accuracy + at extreme limits of the function. Execution speed is improved. + Functionality is ported from the Boost C++ library. +o NUMBERS-171: "InverseErfc": Support full range of [0, 2]. This lowers the supported + minimum value from 2^-53 to double min value. Execution speed is improved. + Functionality is ported from the Boost C++ library. + + +For complete information on Apache Commons Numbers, including instructions on how to submit bug +reports, patches, or suggestions for improvement, see the Apache Commons Numbers website: + +http://commons.apache.org/proper/commons-numbers/ + + +============================================================================= + Apache Commons Numbers 1.0 RELEASE NOTES The Apache Commons Numbers team is pleased to announce the release of diff --git a/src/site/xdoc/download_numbers.xml b/src/site/xdoc/download_numbers.xml index 8ef0aca7..5fd700be 100644 --- a/src/site/xdoc/download_numbers.xml +++ b/src/site/xdoc/download_numbers.xml @@ -113,32 +113,32 @@ limitations under the License. </p> </subsection> </section> - <section name="Apache Commons Numbers 1.0 (requires Java 8+)"> + <section name="Apache Commons Numbers 1.1 (requires Java 8+)"> <subsection name="Binaries"> <table> <tr> - <td><a href="[preferred]/commons/numbers/binaries/commons-numbers-1.0-bin.tar.gz">commons-numbers-1.0-bin.tar.gz</a></td> - <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.0-bin.tar.gz.sha512">sha512</a></td> - <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.0-bin.tar.gz.asc">pgp</a></td> + <td><a href="[preferred]/commons/numbers/binaries/commons-numbers-1.1-bin.tar.gz">commons-numbers-1.1-bin.tar.gz</a></td> + <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.1-bin.tar.gz.sha512">sha512</a></td> + <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.1-bin.tar.gz.asc">pgp</a></td> </tr> <tr> - <td><a href="[preferred]/commons/numbers/binaries/commons-numbers-1.0-bin.zip">commons-numbers-1.0-bin.zip</a></td> - <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.0-bin.zip.sha512">sha512</a></td> - <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.0-bin.zip.asc">pgp</a></td> + <td><a href="[preferred]/commons/numbers/binaries/commons-numbers-1.1-bin.zip">commons-numbers-1.1-bin.zip</a></td> + <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.1-bin.zip.sha512">sha512</a></td> + <td><a href="https://www.apache.org/dist/commons/numbers/binaries/commons-numbers-1.1-bin.zip.asc">pgp</a></td> </tr> </table> </subsection> <subsection name="Source"> <table> <tr> - <td><a href="[preferred]/commons/numbers/source/commons-numbers-1.0-src.tar.gz">commons-numbers-1.0-src.tar.gz</a></td> - <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.0-src.tar.gz.sha512">sha512</a></td> - <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.0-src.tar.gz.asc">pgp</a></td> + <td><a href="[preferred]/commons/numbers/source/commons-numbers-1.1-src.tar.gz">commons-numbers-1.1-src.tar.gz</a></td> + <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.1-src.tar.gz.sha512">sha512</a></td> + <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.1-src.tar.gz.asc">pgp</a></td> </tr> <tr> - <td><a href="[preferred]/commons/numbers/source/commons-numbers-1.0-src.zip">commons-numbers-1.0-src.zip</a></td> - <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.0-src.zip.sha512">sha512</a></td> - <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.0-src.zip.asc">pgp</a></td> + <td><a href="[preferred]/commons/numbers/source/commons-numbers-1.1-src.zip">commons-numbers-1.1-src.zip</a></td> + <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.1-src.zip.sha512">sha512</a></td> + <td><a href="https://www.apache.org/dist/commons/numbers/source/commons-numbers-1.1-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 24f7b478..e5c425ad 100644 --- a/src/site/xdoc/release-history.xml +++ b/src/site/xdoc/release-history.xml @@ -24,6 +24,9 @@ limitations under the License. <p><em>Note.</em> For older release javadocs see the individual artifact sub-sites.</p> <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.0</td><td>2022-11-01</td><td>8+</td><td><a href="release-notes/RELEASE-NOTES-1.1.txt">release notes for 1.1</a></td> + </tr> <tr> <td>1.0</td><td>2021-07-17</td><td>8+</td><td><a href="release-notes/RELEASE-NOTES-1.0.txt">release notes for 1.0</a></td> </tr>