commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [math] Preparing 3.5 release.
Date Sun, 12 Apr 2015 18:21:27 GMT
Repository: commons-math
Updated Branches:
  refs/heads/release [created] 7efda3f0a

Preparing 3.5 release.


Branch: refs/heads/release
Commit: 7efda3f0a0941362e9e4152d0e0e92872a8ce8d3
Parents: 884524a
Author: Luc Maisonobe <>
Authored: Sun Apr 12 18:19:17 2015 +0200
Committer: Luc Maisonobe <>
Committed: Sun Apr 12 19:04:59 2015 +0200

 RELEASE-NOTES.txt               | 40 ++++++++++++++++++++++--------------
 build.xml                       |  2 +-
 pom.xml                         |  6 +++---
 src/changes/changes.xml         | 27 +++++++++++++++++++++++-
 src/site/xdoc/download_math.xml | 26 +++++++++++------------
 src/userguide/pom.xml           |  2 +-
 6 files changed, 69 insertions(+), 34 deletions(-)
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index 94e476f..6a6ac4e 100644
@@ -1,25 +1,35 @@
-              Apache Commons Math 3.4.1 RELEASE NOTES
-The Apache Commons Math team is pleased to announce the release of commons-math3-3.4.1
+The Apache Commons Math team is pleased to announce the commons-math3-3.5 release!
 The Apache Commons Math project is a library of lightweight, self-contained mathematics
 and statistics components addressing the most common practical problems not immediately
 available in the Java programming language or commons-lang.
-This is a maintenance release: It fixes issue MATH-1188.
 Changes in this version include:
+New features:
+o Added a way to build polyhedrons sets from a list of vertices and
+        facets specified using vertices indices. 
+o Simplified "FastMath#exp(double)" in order to avoid a potential
+        Java 1.5 JIT bug when calling with negative infinity as argument.  Issue: MATH-1198.

+o Added method "getQuadraticMean()" to "DescriptiveStatistics"
+        and "SummaryStatistics" which calculates the root mean square.  Issue: MATH-1199.

 Fixed Bugs:
-o MATH-1188:  Fixed non-Java1.5 code in BesselJ. 
-For complete information on Apache Commons Math, including instructions on how to submit
bug reports,
-patches, or suggestions for improvement, see the Apache Commons Math website:
+o Moved FastMathTestPerformance out of the main test tree, as is is
+        a benchmark rather than a test.  Issue: MATH-1195. 
+o Fixed ignored method parameters in QRDecomposition protected methods.  Issue: MATH-1191.

+o Fixed wrong selection of line/polyhedron intersection point.  Issue: MATH-1211. Thanks
to Mike Zimmerman. 
+o Improved fix for corner cases in BSP-tree merging, when cut sub-hyperplanes vanish.  Issue:
+o Fixed link to algorithm description in "PoissonDistribution#sample()".  Issue: MATH-1209.
Thanks to Jonathan Ogilvie. 
+o EmpiricalDistribution cumulativeProbability can return NaN when evaluated within a constant
bin.  Issue: MATH-1208. 
+o EmpiricalDistribution getKernel fails for buckets with only multiple instances of the same
value.  Issue: MATH-1203. 
+o "UnivariateSolverUtils#bracket(...)" sometimes failed to bracket
+        if a reached the lower bound.  Issue: MATH-1204. 
+o Added Laguerre complex solve methods taking maxEval parameters.  Issue: MATH-1213. 
+Have fun!
+-Apache Commons Math team
diff --git a/build.xml b/build.xml
index 09177b0..d205c29 100644
--- a/build.xml
+++ b/build.xml
@@ -50,7 +50,7 @@
   <property name="component.title"         value="Commons MATH"/>
   <!-- The current version number of this component -->
-  <property name="component.version"       value="3.1-SNAPSHOT"/>
+  <property name="component.version"       value="3.5"/>
   <!-- The base directory for component sources -->
   <property name="source.home"             value="src/main/java"/>
diff --git a/pom.xml b/pom.xml
index b0e266b..9c100e2 100644
--- a/pom.xml
+++ b/pom.xml
@@ -24,7 +24,7 @@
-  <version>3.5-SNAPSHOT</version>
+  <version>3.5</version>
   <name>Apache Commons Math</name>
@@ -363,9 +363,9 @@
     <!-- This value must reflect the current name of the base package. -->
     <!-- do not use snapshot suffix here -->
-    <commons.release.version>3.4.1</commons.release.version>
+    <commons.release.version>3.5</commons.release.version>
     <commons.release.desc>(requires Java 1.5+)</commons.release.desc>
-    <!-- <commons.rc.version>RC1</commons.rc.version> -->
+    <commons.rc.version>RC1</commons.rc.version>
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
index cd1f930..2be9918 100644
--- a/src/changes/changes.xml
+++ b/src/changes/changes.xml
@@ -50,7 +50,32 @@ If the output is not quite correct, check for invisible trailing spaces!
     <title>Commons Math Release Notes</title>
-    <release version="3.5" date="TBD" description="TBD">
+    <release version="3.5" date="2015-04-16" description="
+This is a minor release: It combines bug fixes and new features.
+ Changes to existing features were made in a backwards-compatible
+ way such as to allow drop-in replacement of the v3.4.1 JAR file.
+Most notable among the new features are:
+ getQuadraticMean method added to DescriptiveStatistics SummaryStatistics
+ which calculates the root mean square, and a way to build polyhedrons sets
+ from list of vertices and the facets they belong too. There have been
+ numerous bug fixes. See below for a full list.
+The minimum version of the Java platform required to compile and use
+ Apache Commons Math is Java 5.
+Users are encouraged to upgrade to this version as this release not
+ only includes bug fixes but also deprecates numerous classes and
+ methods that will be deleted from the next major release (4.0).
+  Caveat:
+  1. The implementation of the BOBYQA optimization algorithm is in alpha
+  state (cf. MATH-621): Many code paths are untested, and we are looking
+  for volunteers to improve the code readability, robustness and performance
+  and to extend the unit tests suite.
+  2. A few methods in the FastMath class are in fact slower that their
+  counterpart in either Math or StrictMath (cf. MATH-740 and MATH-901).
       <action dev="luc" type="fix" issue="MATH-1195">
         Moved FastMathTestPerformance out of the main test tree, as is is
         a benchmark rather than a test.
diff --git a/src/site/xdoc/download_math.xml b/src/site/xdoc/download_math.xml
index a934068..3e6a093 100644
--- a/src/site/xdoc/download_math.xml
+++ b/src/site/xdoc/download_math.xml
@@ -95,32 +95,32 @@ limitations under the License.
-    <section name="Apache Commons Math 3.4.1 (requires Java 1.5+)">
+    <section name="Apache Commons Math 3.5 (requires Java 1.5+)">
       <subsection name="Binaries">
-              <td><a href="[preferred]/commons/math/binaries/commons-math3-3.4.1-bin.tar.gz">commons-math3-3.4.1-bin.tar.gz</a></td>
-              <td><a href="">md5</a></td>
-              <td><a href="">pgp</a></td>
+              <td><a href="[preferred]/commons/math/binaries/commons-math3-3.5-bin.tar.gz">commons-math3-3.5-bin.tar.gz</a></td>
+              <td><a href="">md5</a></td>
+              <td><a href="">pgp</a></td>
-              <td><a href="[preferred]/commons/math/binaries/"></a></td>
-              <td><a href="">md5</a></td>
-              <td><a href="">pgp</a></td>
+              <td><a href="[preferred]/commons/math/binaries/"></a></td>
+              <td><a href="">md5</a></td>
+              <td><a href="">pgp</a></td>
       <subsection name="Source">
-              <td><a href="[preferred]/commons/math/source/commons-math3-3.4.1-src.tar.gz">commons-math3-3.4.1-src.tar.gz</a></td>
-              <td><a href="">md5</a></td>
-              <td><a href="">pgp</a></td>
+              <td><a href="[preferred]/commons/math/source/commons-math3-3.5-src.tar.gz">commons-math3-3.5-src.tar.gz</a></td>
+              <td><a href="">md5</a></td>
+              <td><a href="">pgp</a></td>
-              <td><a href="[preferred]/commons/math/source/"></a></td>
-              <td><a href="">md5</a></td>
-              <td><a href="">pgp</a></td>
+              <td><a href="[preferred]/commons/math/source/"></a></td>
+              <td><a href="">md5</a></td>
+              <td><a href="">pgp</a></td>
diff --git a/src/userguide/pom.xml b/src/userguide/pom.xml
index 1daa91f..1c5ee06 100644
--- a/src/userguide/pom.xml
+++ b/src/userguide/pom.xml
@@ -22,7 +22,7 @@
-  <version>3.5-SNAPSHOT</version>  
+  <version>3.5</version>  
   <name>Commons Math User Guide</name>

View raw message