Author: psteitz
Date: Sat Mar 30 05:02:55 2013
New Revision: 1462704
URL: http://svn.apache.org/r1462704
Log:
Used template, fixed title.
Modified:
commons/proper/math/trunk/RELEASENOTES.txt
Modified: commons/proper/math/trunk/RELEASENOTES.txt
URL: http://svn.apache.org/viewvc/commons/proper/math/trunk/RELEASENOTES.txt?rev=1462704&r1=1462703&r2=1462704&view=diff
==============================================================================
 commons/proper/math/trunk/RELEASENOTES.txt (original)
+++ commons/proper/math/trunk/RELEASENOTES.txt Sat Mar 30 05:02:55 2013
@@ 1,81 +1,115 @@
The Commons Math team is pleased to announce the commonsmath33.2SNAPSHOT release!
+
+ Apache Commons Math 3.2 RELEASE NOTES
+
+The Commons Math team is pleased to announce the release of commonsmath33.2
The Math project is a library of lightweight, selfcontained mathematics and statistics components
addressing the most common practical problems not immediately available in the Java programming
language or commonslang.
+This is a minor release: It combines bug fixes and new features.
+Changes to existing features were made in a backwardscompatible
+way such as to allow dropin replacement of the v3.1[.1] JAR file.
+
+Most notable among the new features are: Framework for automatic
+differentiation, LÃ©vy distribution, prime numbers, enumerated
+distributions, real field allowing to use several algorithms
+(solvers, linear algebra, 3D geometry) with different reallike
+classes (high accuracy or automatic differentiation), spherical
+coordinates with gradients and Hessians, reorganized clustering
+package with different distance implementations.
+
+The minimum version of the Java platform required to compile and use
+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. MATH621): 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. MATH740 and MATH901).
+
Changes in this version include:
New features:
o All contents of package "o.a.c.m.stat.clustering" refactored into
+o MATH917,MATH918,MATH919,MATH920: All contents of package "o.a.c.m.stat.clustering"
refactored into
new package "o.a.c.m.ml.clustering" and added support for additional
distance measures in package "o.a.c.m.ml.distance": "CanberraDistance",
 "ChebyshevDistance", "EuclideanDistance" and "ManhattanDistance". Issue: MATH917,MATH918,MATH919,MATH920.
Thanks to Reid Hochstedler.
o Added Multivariate Normal Mixture Model Fitting by Expectation Maximization. Issue: MATH817.
Thanks to Jared Becksfort.
o Added a way to trigger only increasing or decreasing events in ODE integration. Issue:
MATH811.
o Added arrayscaling methods to MathArrays. Issue: MATH946. Thanks to Jared Becksfort.
o Added the LÃ©vy distribution. Issue: MATH460. Thanks to Andrew Waterman.
o Implementations for inverse error function and inverse complementary
 error functions have been added. Issue: MATH948.
o Added utilities for prime numbers. Issue: MATH845. Thanks to SÃ©bastien Riou.
o Check bounds in multistart vector optimizers. Issue: MATH914.
o Added discrete distributions. Issue: MATH941. Thanks to Piotr Wydrych.
o Added Hermite interpolator for RealFieldElement instances.
o Added RealFieldElement interface to represent anything that is
+ "ChebyshevDistance", "EuclideanDistance" and "ManhattanDistance". Thanks to Reid
Hochstedler.
+o MATH817: Added Multivariate Normal Mixture Model Fitting by Expectation Maximization.
Thanks to Jared Becksfort.
+o MATH811: Added a way to trigger only increasing or decreasing events in ODE integration.
+o MATH946: Added arrayscaling methods to MathArrays. Thanks to Jared Becksfort.
+o MATH460: Added the LÃ©vy distribution. Thanks to Andrew Waterman.
+o MATH948: Implementations for inverse error function and inverse complementary
+ error functions have been added.
+o MATH845: Added utilities for prime numbers. Thanks to SÃ©bastien Riou.
+o MATH914: Check bounds in multistart vector optimizers.
+o MATH941: Added discrete distributions. Thanks to Piotr Wydrych.
+o Added Hermite interpolator for RealFieldElement instances.
+o Added RealFieldElement interface to represent anything that is
real number like, implemented by both Decimal64, Dfp and DerivativeStructure.
o Added partial derivatives computation for 3D vectors and rotations.
o Added accurate linear combination of DerivativeStructure instances,
+o Added partial derivatives computation for 3D vectors and rotations.
+o Added accurate linear combination of DerivativeStructure instances,
avoiding cancellation.
o Added conversion of gradients and Hessians from spherical to Cartesian
+o Added conversion of gradients and Hessians from spherical to Cartesian
coordinates in 3D.
Fixed Bugs:
o Fixed inverse cumulative probability for uniform distribution. Issue: MATH957. Thanks
to Evan Ward.
o "SpearmansCorrelation" now works correctly in case of a provided
+o MATH957: Fixed inverse cumulative probability for uniform distribution. Thanks to Evan
Ward.
+o MATH891: "SpearmansCorrelation" now works correctly in case of a provided
"NaturalRanking" with a "NaNStrategy.REMOVED" strategy and the input
data contains NaN values. From version 4.0 onwards this strategy will
 not be supported anymore. Issue: MATH891.
o Fixed Complex.reciprocal() for zero argument. Issue: MATH934.
o AbstractRealMatrix will now check for rectangular input arrays in
 its copySubMatrix methods. Issue: MATH862.
o Increment iteration counter in optimization algorithms. Issue: MATH949.
o Fixed missing update in ODE event handlers, when a RESET_STATE is triggered. Issue: MATH950.
o Fixed infinite loop when NaN occurs in singular value decomposition. Issue: MATH947.
o Extended ranges for FastMath performance tests. Issue: MATH580.
o Finalized implementation of diagonal matrix. Issue: MATH925.
o Added rank revealing QR decomposition. Issue: MATH630. Thanks to Christopher Nix.
o ArrayFieldVector can now be constructed from any FieldVector. Issue: MATH570. Thanks
to Arne PlÃ¶se.
o Improved checking of null vector elements. Issue: MATH861. Thanks to SÃ©bastien Brisard.
o Fixed generation of long random numbers between two bounds. Issue: MATH936.
o Fixed creation of generic array. Issue: MATH942. Thanks to Piotr Wydrych.
o Fixed abstract test class naming that broke ant builds. Issue: MATH940. Thanks to Piotr
Wydrych.
o Allow covariance to be computed for onedimensional variables. Issue: MATH939. Thanks
to Piotr Wydrych.
o Fixed accuracy of 3D Line.revert(). Issue: MATH938.
o Improved javadoc to explain how switching functions should
 behave across events in ODE events detection. Issue: MATH937.
o Fixed DerivativeStructure.atan2 for special cases when both arguments are +/0. Issue:
MATH935.
o Improved class javadoc wrt convergence criteria and added
+ not be supported anymore.
+o MATH934: Fixed Complex.reciprocal() for zero argument.
+o MATH862: AbstractRealMatrix will now check for rectangular input arrays in
+ its copySubMatrix methods.
+o MATH949: Increment iteration counter in optimization algorithms.
+o MATH950: Fixed missing update in ODE event handlers, when a RESET_STATE is triggered.
+o MATH947: Fixed infinite loop when NaN occurs in singular value decomposition.
+o MATH580: Extended ranges for FastMath performance tests.
+o MATH925: Finalized implementation of diagonal matrix.
+o MATH630: Added rank revealing QR decomposition. Thanks to Christopher Nix.
+o MATH570: ArrayFieldVector can now be constructed from any FieldVector. Thanks to Arne
PlÃ¶se.
+o MATH861: Improved checking of null vector elements. Thanks to SÃ©bastien Brisard.
+o MATH936: Fixed generation of long random numbers between two bounds.
+o MATH942: Fixed creation of generic array. Thanks to Piotr Wydrych.
+o MATH940: Fixed abstract test class naming that broke ant builds. Thanks to Piotr Wydrych.
+o MATH939: Allow covariance to be computed for onedimensional variables. Thanks to Piotr
Wydrych.
+o MATH938: Fixed accuracy of 3D Line.revert().
+o MATH937: Improved javadoc to explain how switching functions should
+ behave across events in ODE events detection.
+o MATH935: Fixed DerivativeStructure.atan2 for special cases when both arguments are +/0.
+o MATH930: Improved class javadoc wrt convergence criteria and added
additional constructors to override the default epsilon and cutoff
 values in class "SimplexSolver". Issue: MATH930.
o Fixed truncated value in "MultivariateNormalDistribution". Issue: MATH929. Thanks to
Piotr Wydrych.
o Made "BitStreamGenerator" implement the "Serializable" interface. Issue: MATH927. Thanks
to Dennis Hendriks.
+ values in class "SimplexSolver".
+o MATH929: Fixed truncated value in "MultivariateNormalDistribution". Thanks to Piotr Wydrych.
+o MATH927: Made "BitStreamGenerator" implement the "Serializable" interface. Thanks to
Dennis Hendriks.
Changes:
o Replaced hardcoded numbers in "LevenbergMarquardtOptimizer". Issue: MATH956.
o Fixed loading of test file when path contains a space. Issue: MATH955. Thanks to Evan
Ward.
o Improved speed of FastMath.abs methods for all signatures, by removing branching. Issue:
MATH954. Thanks to Charles Cooper.
o Improved speed of several FastMath methods. Issue: MATH953. Thanks to Charles Cooper.
o Improved speed of FastMath copysign methods. Issue: MATH951. Thanks to Charles Cooper.
o Made EmpiricalDisribution smoothing kernel pluggable. Issue: MATH671.
o Allow direct use of SummaryStatistics in oneway ANOVA. Issue: MATH877. Thanks to Peter
Andrews.
o Normal distribution now uses a direct implementation of the
+o MATH956: Replaced hardcoded numbers in "LevenbergMarquardtOptimizer".
+o MATH955: Fixed loading of test file when path contains a space. Thanks to Evan Ward.
+o MATH954: Improved speed of FastMath.abs methods for all signatures, by removing branching.
Thanks to Charles Cooper.
+o MATH953: Improved speed of several FastMath methods. Thanks to Charles Cooper.
+o MATH951: Improved speed of FastMath copysign methods. Thanks to Charles Cooper.
+o MATH671: Made EmpiricalDisribution smoothing kernel pluggable.
+o MATH877: Allow direct use of SummaryStatistics in oneway ANOVA. Thanks to Peter Andrews.
+o Normal distribution now uses a direct implementation of the
inverse error function to compute inverse cumulative probability
instead of relying on a numerical solver. This is much faster,
more accurate and does not need convergence threshold.
o Throw "MathUnsupportedOperationException" from optimizers that do
+o MATH933: Throw "MathUnsupportedOperationException" from optimizers that do
not support constraints (previous behaviour was to silently ignore
 the "SimpleBounds" argument). Issue: MATH933.
o Greater efficiency in "UnitSphereRandomVectorGenerator". Issue: MATH931. Thanks to Sean
Owen.
+ the "SimpleBounds" argument).
+o MATH931: Greater efficiency in "UnitSphereRandomVectorGenerator". Thanks to Sean Owen.
+
+
+For complete information on Commons Math, including instructions on how to submit bug reports,
+patches, or suggestions for improvement, see the Apache Commons Math website:
+http://commons.apache.org/proper/commonsmath/
Have fun!
Commons Math team
