///
/// This file is part of ILNumerics Community Edition.
///
/// ILNumerics Community Edition - high performance computing for applications.
/// Copyright (C) 2006 - 2012 Haymo Kutschbach, http://ilnumerics.net
///
/// ILNumerics Community Edition is free software: you can redistribute it and/or modify
/// it under the terms of the GNU General Public License version 3 as published by
/// the Free Software Foundation.
///
/// ILNumerics Community Edition is distributed in the hope that it will be useful,
/// but WITHOUT ANY WARRANTY; without even the implied warranty of
/// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
/// GNU General Public License for more details.
///
/// You should have received a copy of the GNU General Public License
/// along with ILNumerics Community Edition. See the file License.txt in the root
/// of your distribution package. If not, see .
///
/// In addition this software uses the following components and/or licenses:
///
/// =================================================================================
/// The Open Toolkit Library License
///
/// Copyright (c) 2006 - 2009 the Open Toolkit library.
///
/// Permission is hereby granted, free of charge, to any person obtaining a copy
/// of this software and associated documentation files (the "Software"), to deal
/// in the Software without restriction, including without limitation the rights to
/// use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
/// the Software, and to permit persons to whom the Software is furnished to do
/// so, subject to the following conditions:
///
/// The above copyright notice and this permission notice shall be included in all
/// copies or substantial portions of the Software.
///
/// =================================================================================
///
using System;
using System.Collections.Generic;
using System.Threading;
using System.Text;
using ILNumerics.Exceptions;
namespace ILNumerics {
public partial class ILMath {
///
/// find clusters for data matrix X
///
/// data matrix, data points are given as columns
/// initial number of clusters expected
/// false: pick the first k data points as initial centers, true: pick random datapoints
/// maximum number of iterations, the computation will exit after that many iterations.
/// vector of length n with with indices of clusters assigned to each datapoint
public static ILRetArray kMeansClustMT(ILInArray X, ILBaseArray k, int maxIterations, bool centerInitRandom) {
return kMeansClustMT(X, k, maxIterations, centerInitRandom, null);
}
///
/// find clusters for data matrix X
///
/// data matrix, data points are given as columns
/// initial number of clusters expected
/// false: pick the first k data points as initial centers, true: pick random datapoints
/// maximum number of iterations, the computation will exit after that many iterations.
/// return type. if assigned on entry, outCenters will contain the centers of the clusters found.
/// vector of length n with with indices of clusters assigned to each datapoint
public static ILRetArray kMeansClustMT (ILInArray X, ILBaseArray k, int maxIterations, bool centerInitRandom, ILOutArray outCenters) {
using (ILScope.Enter(X, k)) {
if (object.Equals(X,null)) {
throw new ILArgumentException("X must be data matrix (not null)");
}
if (X.IsEmpty) {
if (!object.Equals(outCenters, null)) {
if (X.D[0] > 0) {
outCenters.a = empty(new ILSize(X.D[0], 0));
} else {
outCenters.a = empty(new ILSize(0, X.D[1]));
}
return empty(X.D);
}
}
if (object.Equals(k,null) || !k.IsScalar || !k.IsNumeric) {
throw new ILArgumentException("number of clusters k must be numeric scalar");
}
int iK = toint32(k).GetValue(0);
if (X.D[1] < iK) {
throw new ILArgumentException("too few datapoints provided for " + iK.ToString() + " clusters");
}
if (iK < 0) {
throw new ILArgumentException("number of clusters must be positive");
}
int d = X.D[0], n = X.D[1];
if (iK == 0) {
if (!object.Equals(outCenters, null)) {
outCenters.a = empty(new ILSize(d,iK));
}
return empty(new ILSize(0,n));
}
// initialize centers by using random datapoints
ILArray centers = empty();
if (centerInitRandom) {
ILArray pickIndices = empty();
sort(rand(1,n),pickIndices,1,false).Dispose();
centers.a = X[full,pickIndices[r(0,iK-1)]];
} else {
centers.a = X[full,r(0,iK-1)];
}
ILArray classes = zeros(1,n);
ILArray oldCenters = centers.C;
#if KMEANSVERBOSE
System.Diagnostics.Stopwatch sw = new System.Diagnostics.Stopwatch();
#endif
int maxNTSetting = Settings.MaxNumberThreads, workerCount = 1, workItemLen = 0;
int workItemCount = maxNTSetting;
int wi = 0;
Settings.MaxNumberThreads = 1;
Action