[MATH-917] deprecated old stat.clustering package.

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/math/trunk@1461871 13f79535-47bb-0310-9956-ffa450edef68

src/main/java/org/apache/commons/math3/stat/clustering/Cluster.java

@@ -26,7 +26,10 @@ import java.util.List;
  * @param <T> the type of points that can be clustered
  * @version $Id$
  * @since 2.0
+ * @deprecated As of 3.2 (to be removed in 4.0),
+ * use {@link org.apache.commons.math3.ml.clustering.Cluster} instead
  */
+@Deprecated
 public class Cluster<T extends Clusterable<T>> implements Serializable {
 
     /** Serializable version identifier. */

src/main/java/org/apache/commons/math3/stat/clustering/Clusterable.java

@@ -24,7 +24,10 @@ import java.util.Collection;
  * @param <T> the type of point that can be clustered
  * @version $Id$
  * @since 2.0
+ * @deprecated As of 3.2 (to be removed in 4.0),
+ * use {@link org.apache.commons.math3.ml.clustering.Clusterable} instead
  */
+@Deprecated
 public interface Clusterable<T> {
 
     /**

src/main/java/org/apache/commons/math3/stat/clustering/DBSCANClusterer.java

@@ -57,7 +57,10 @@ import org.apache.commons.math3.util.MathUtils;
  * A Density-Based Algorithm for Discovering Clusters in Large Spatial Databases with Noise</a>
  * @version $Id$
  * @since 3.1
+ * @deprecated As of 3.2 (to be removed in 4.0),
+ * use {@link org.apache.commons.math3.ml.clustering.DBSCANClusterer} instead
  */
+@Deprecated
 public class DBSCANClusterer<T extends Clusterable<T>> {
 
     /** Maximum radius of the neighborhood to be considered. */

src/main/java/org/apache/commons/math3/stat/clustering/EuclideanDoublePoint.java

@@ -26,7 +26,10 @@ import org.apache.commons.math3.util.MathArrays;
  * A simple implementation of {@link Clusterable} for points with double coordinates.
  * @version $Id$
  * @since 3.1
+ * @deprecated As of 3.2 (to be removed in 4.0),
+ * use {@link org.apache.commons.math3.ml.clustering.DoublePoint} instead
  */
+@Deprecated
 public class EuclideanDoublePoint implements Clusterable<EuclideanDoublePoint>, Serializable {
 
     /** Serializable version identifier. */

src/main/java/org/apache/commons/math3/stat/clustering/EuclideanIntegerPoint.java

@@ -27,7 +27,10 @@ import org.apache.commons.math3.util.MathArrays;
  * A simple implementation of {@link Clusterable} for points with integer coordinates.
  * @version $Id$
  * @since 2.0
+ * @deprecated As of 3.2 (to be removed in 4.0),
+ * use {@link org.apache.commons.math3.ml.clustering.DoublePoint} instead
  */
+@Deprecated
 public class EuclideanIntegerPoint implements Clusterable<EuclideanIntegerPoint>, Serializable {
 
     /** Serializable version identifier. */

src/main/java/org/apache/commons/math3/stat/clustering/KMeansPlusPlusClusterer.java

@@ -36,7 +36,10 @@ import org.apache.commons.math3.util.MathUtils;
  * @see <a href="http://en.wikipedia.org/wiki/K-means%2B%2B">K-means++ (wikipedia)</a>
  * @version $Id$
  * @since 2.0
+ * @deprecated As of 3.2 (to be removed in 4.0),
+ * use {@link org.apache.commons.math3.ml.clustering.KMeansPlusPlusClusterer} instead
  */
+@Deprecated
 public class KMeansPlusPlusClusterer<T extends Clusterable<T>> {
 
     /** Strategies to use for replacing an empty cluster. */

src/main/java/org/apache/commons/math3/stat/clustering/package-info.java

@@ -15,6 +15,15 @@
  * limitations under the License.
  */
 /**
- * Clustering algorithms
+ * <h2>All classes and sub-packages of this package are deprecated.</h2>
+ * <h3>Please use their replacements, to be found under
+ *  <ul>
+ *   <li>{@link org.apache.commons.math3.ml.clustering}</li>
+ *  </ul>
+ * </h3>
+ *
+ * <p>
+ * Clustering algorithms.
+ * </p>
  */
 package org.apache.commons.math3.stat.clustering;