0.2.0 release (#36)

* Use v0.8.0 for itertools

* Update version number

* Add release notes

* Nitpicks - we now have a solid amount of routines implemented

* Add links

* Update version in Cargo.toml example

* Add summary statistics to brief menu

* Add some info directly in the README

* Add ndarray link

* Drop ErrorKind

* Add a note on extension traits on the changelog

* Rearrange 0.2.0 changes

Author: LukeMathWalker

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "ndarray-stats"
-version = "0.1.0"
+version = "0.2.0"
 authors = ["Jim Turner <[email protected]>", "LukeMathWalker <[email protected]>"]
 edition = "2018"
 
@@ -21,7 +21,7 @@ noisy_float = "0.1.8"
 num-integer = "0.1"
 num-traits = "0.2"
 rand = "0.6"
-itertools = { version = "0.7.0", default-features = false }
+itertools = { version = "0.8.0", default-features = false }
 indexmap = "1.0"
 
 [dev-dependencies]

README.md

@@ -6,24 +6,60 @@
 [![Crate](https://img.shields.io/crates/v/ndarray-stats.svg)](https://crates.io/crates/ndarray-stats)
 [![Documentation](https://docs.rs/ndarray-stats/badge.svg)](https://docs.rs/ndarray-stats)
 
-This crate provides statistical methods for [`ndarray`]'s `ArrayBase` type. See
-the [documentation](https://docs.rs/ndarray-stats) for more information.
+This crate provides statistical methods for [`ndarray`]'s `ArrayBase` type.
 
-[`ndarray`]: https://github.com/bluss/ndarray
+Currently available routines include:
+- order statistics (minimum, maximum, median, quantiles, etc.);
+- summary statistics (mean, skewness, kurtosis, central moments, etc.)
+- partitioning;
+- correlation analysis (covariance, pearson correlation);
+- measures from information theory (entropy, KL divergence, etc.);
+- histogram computation.
 
-Only some statistical routines are implemented. Please feel free to contribute
-new functionality!
+See the [documentation](https://docs.rs/ndarray-stats) for more information.
+
+Please feel free to contribute new functionality! A roadmap can be found [here](https://github.com/jturner314/ndarray-stats/issues/1).
+
+[`ndarray`]: https://github.com/rust-ndarray/ndarray
 
 ## Using with Cargo
 
 ```toml
 [dependencies]
 ndarray = "0.12.1"
-ndarray-stats = "0.1"
+ndarray-stats = "0.2"
 ```
 
 ## Releases
 
+* **0.2.0**
+
+  * New functionality:
+    * Summary statistics:
+      * Harmonic mean
+      * Geometric mean
+      * Central moments
+      * Kurtosis
+      * Skewness
+    * Information theory:
+      * Entropy
+      * Cross-entropy
+      * Kullback-Leibler divergence
+    * Quantiles and order statistics:
+      * `argmin` / `argmin_skipnan`
+      * `argmax` / `argmax_skipnan`
+      * Optimized bulk quantile computation (`quantiles_mut`, `quantiles_axis_mut`)
+  * Fixes:
+    * Reduced occurrences of overflow for `interpolate::midpoint`
+  * Improvements / breaking changes:
+    * Redesigned error handling across the whole crate, standardising on `Result`
+    * All `ndarray-stats`' extension traits are now impossible to implement by
+      users of the library (see [#34])
+
+  *Contributors*: [@jturner314](https://github.com/jturner314), [@LukeMathWalker](https://github.com/LukeMathWalker), [@phungleson](https://github.com/phungleson), [@munckymagik](https://github.com/munckymagik)
+
+  [#34]: https://github.com/jturner314/ndarray-stats/issues/34
+
 * **0.1.0**
 
   * Initial release by @LukeMathWalker and @jturner314.

src/lib.rs

@@ -2,7 +2,8 @@
 //! the *n*-dimensional array data structure provided by [`ndarray`].
 //!
 //! Currently available routines include:
-//! - [order statistics] (minimum, maximum, quantiles, etc.);
+//! - [order statistics] (minimum, maximum, median, quantiles, etc.);
+//! - [summary statistics] (mean, skewness, kurtosis, central moments, etc.)
 //! - [partitioning];
 //! - [correlation analysis] (covariance, pearson correlation);
 //! - [measures from information theory] (entropy, KL divergence, etc.);
@@ -18,6 +19,7 @@
 //! [`ndarray`]: https://github.com/rust-ndarray/ndarray
 //! [order statistics]: trait.QuantileExt.html
 //! [partitioning]: trait.Sort1dExt.html
+//! [summary statistics]: trait.SummaryStatisticsExt.html
 //! [correlation analysis]: trait.CorrelationExt.html
 //! [measures from information theory]: trait.EntropyExt.html
 //! [histogram computation]: histogram/index.html