mirror of
https://github.com/hanzoai/jube-fork.git
synced 2026-10-30 18:33:33 +00:00
richard-churchman
cc0a2bee21
Included open-source Accord.net library code natively to the solution given the deprecated state of that project. Accord.net will be supported inside Jube for own needs (such as upgrading to .Net 7+). Accord.net libraries modified to compile to .Net 6. Modified Accord.net libraries to better support Newtonsoft Json.net serialisation. Included annotations in the Accord.net libraries to house important dependency statistics. Serialised json can be used independently of Jube to recall a Neural Network. Removal of Binary Serializer totally as a precursor to the projects support of .Net 7+. Extensive bug fixing in crucial functions of Neural Network training and recall. While this part of the system remains in Alpha, it is substantially more fit for purpose.
256 lines
9.5 KiB
C#
256 lines
9.5 KiB
C#
// Accord Machine Learning Library
|
|
// The Accord.NET Framework
|
|
// http://accord-framework.net
|
|
//
|
|
// Copyright © César Souza <cesarsouza at gmail.com>
|
|
// and other contributors, 2009-2017.
|
|
//
|
|
// This library is free software; you can redistribute it and/or
|
|
// modify it under the terms of the GNU Lesser General Public
|
|
// License as published by the Free Software Foundation; either
|
|
// version 2.1 of the License, or (at your option) any later version.
|
|
//
|
|
// This library 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
|
|
// Lesser General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU Lesser General Public
|
|
// License along with this library; if not, write to the Free Software
|
|
// Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
//
|
|
|
|
namespace Accord.MachineLearning
|
|
{
|
|
using Accord.Math.Distances;
|
|
using Accord.Statistics.Distributions.Univariate;
|
|
using System;
|
|
using System.Collections;
|
|
using System.Collections.Generic;
|
|
using Accord.Compat;
|
|
|
|
/// <summary>
|
|
/// k-Modes cluster collection.
|
|
/// </summary>
|
|
///
|
|
/// <seealso cref="KModes{T}"/>
|
|
///
|
|
[Serializable]
|
|
public class KModesClusterCollection<T> : MulticlassScoreClassifierBase<T[]>,
|
|
ICentroidClusterCollection<T[], KModesClusterCollection<T>.KModesCluster>
|
|
{
|
|
KModesCluster.ClusterCollection collection;
|
|
|
|
/// <summary>
|
|
/// k-Modes' cluster.
|
|
/// </summary>
|
|
///
|
|
/// <seealso cref="KModes{T}"/>
|
|
///
|
|
[Serializable]
|
|
public class KModesCluster : CentroidCluster<KModesClusterCollection<T>, T[], KModesCluster>
|
|
{
|
|
}
|
|
|
|
|
|
/// <summary>
|
|
/// Gets the dimensionality of the data space.
|
|
/// </summary>
|
|
///
|
|
[Obsolete("Please use NumberOfInputs instead.")]
|
|
public int Dimension { get { return NumberOfInputs; } }
|
|
|
|
/// <summary>
|
|
/// Initializes a new instance of the <see cref="KModesClusterCollection{T}"/> class.
|
|
/// </summary>
|
|
///
|
|
/// <param name="k">The number of clusters K.</param>
|
|
/// <param name="distance">The distance metric to use.</param>
|
|
///
|
|
public KModesClusterCollection(int k, IDistance<T[]> distance)
|
|
{
|
|
this.collection = new KModesCluster.ClusterCollection(this, k, distance);
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
// Using composition over inheritance to achieve the closest as possible effect to a Mixin
|
|
// in C# - unfortunately needs a lot a boilerplate code to rewrire the interface methods to
|
|
// where their actual implementation is
|
|
|
|
/// <summary>
|
|
/// Gets or sets the clusters' centroids.
|
|
/// </summary>
|
|
/// <value>The clusters' centroids.</value>
|
|
public T[][] Centroids
|
|
{
|
|
get
|
|
{
|
|
return ((ICentroidClusterCollection<T[], KModesCluster>)collection).Centroids;
|
|
}
|
|
|
|
set
|
|
{
|
|
((ICentroidClusterCollection<T[], KModesCluster>)collection).Centroids = value;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets or sets the distance function used to measure the distance
|
|
/// between a point and the cluster centroid in this clustering definition.
|
|
/// </summary>
|
|
/// <value>The distance.</value>
|
|
public IDistance<T[], T[]> Distance
|
|
{
|
|
get
|
|
{
|
|
return ((ICentroidClusterCollection<T[], KModesCluster>)collection).Distance;
|
|
}
|
|
|
|
set
|
|
{
|
|
((ICentroidClusterCollection<T[], KModesCluster>)collection).Distance = value;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the collection of clusters currently modeled by the clustering algorithm.
|
|
/// </summary>
|
|
/// <value>The clusters.</value>
|
|
public KModesCluster[] Clusters
|
|
{
|
|
get
|
|
{
|
|
return ((ICentroidClusterCollection<T[], KModesCluster>)collection).Clusters;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the proportion of samples in each cluster.
|
|
/// </summary>
|
|
///
|
|
public double[] Proportions
|
|
{
|
|
get
|
|
{
|
|
return ((ICentroidClusterCollection<T[], KModesCluster>)collection).Proportions;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the number of clusters in the collection.
|
|
/// </summary>
|
|
/// <value>The count.</value>
|
|
public int Count
|
|
{
|
|
get
|
|
{
|
|
return ((ICentroidClusterCollection<T[], KModesCluster>)collection).Count;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets the <see cref="KModesCluster"/> at the specified index.
|
|
/// </summary>
|
|
/// <param name="index">The index.</param>
|
|
/// <returns>GaussianCluster.</returns>
|
|
public KModesCluster this[int index]
|
|
{
|
|
get
|
|
{
|
|
return ((ICentroidClusterCollection<T[], KModesCluster>)collection)[index];
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Randomizes the clusters inside a dataset.
|
|
/// </summary>
|
|
///
|
|
/// <param name="points">The data to randomize the algorithm.</param>
|
|
/// <param name="strategy">The seeding strategy to be used. Default is <see cref="Seeding.KMeansPlusPlus"/>.</param>
|
|
///
|
|
public void Randomize(T[][] points, Seeding strategy = Seeding.KMeansPlusPlus)
|
|
{
|
|
collection.Randomize(points, strategy);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Calculates the average square distance from the data points
|
|
/// to the nearest clusters' centroids.
|
|
/// </summary>
|
|
/// <param name="data">The data.</param>
|
|
/// <param name="labels">The labels.</param>
|
|
/// <param name="weights">The weights.</param>
|
|
/// <returns>The average square distance from the data points to the nearest
|
|
/// clusters' centroids.</returns>
|
|
/// <remarks>The average distance from centroids can be used as a measure
|
|
/// of the "goodness" of the clustering. The more the data are
|
|
/// aggregated around the centroids, the less the average distance.</remarks>
|
|
public double Distortion(T[][] data, int[] labels = null, double[] weights = null)
|
|
{
|
|
return ((ICentroidClusterCollection<T[], KModesCluster>)collection).Distortion(data, labels, weights);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Transform data points into feature vectors containing the
|
|
/// distance between each point and each of the clusters.
|
|
/// </summary>
|
|
/// <param name="points">The input points.</param>
|
|
/// <param name="weights">The weight associated with each point.</param>
|
|
/// <param name="result">An optional matrix to store the computed transformation.</param>
|
|
/// <returns>A vector containing the distance between the input points and the clusters.</returns>
|
|
public double[][] Transform(T[][] points, double[] weights = null, double[][] result = null)
|
|
{
|
|
return ((ICentroidClusterCollection<T[], KModesCluster>)collection).Transform(points, weights, result);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Transform data points into feature vectors containing the
|
|
/// distance between each point and each of the clusters.
|
|
/// </summary>
|
|
/// <param name="points">The input points.</param>
|
|
/// <param name="labels">The label of each input point.</param>
|
|
/// <param name="weights">The weight associated with each point.</param>
|
|
/// <param name="result">An optional matrix to store the computed transformation.</param>
|
|
/// <returns>A vector containing the distance between the input points and the clusters.</returns>
|
|
public double[] Transform(T[][] points, int[] labels, double[] weights = null, double[] result = null)
|
|
{
|
|
return ((ICentroidClusterCollection<T[], KModesCluster>)collection).Transform(points, labels, weights, result);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns an enumerator that iterates through the collection.
|
|
/// </summary>
|
|
/// <returns>An enumerator that can be used to iterate through the collection.</returns>
|
|
public IEnumerator<KModesCluster> GetEnumerator()
|
|
{
|
|
return ((ICentroidClusterCollection<T[], KModesCluster>)collection).GetEnumerator();
|
|
}
|
|
|
|
/// <summary>
|
|
/// Returns an enumerator that iterates through a collection.
|
|
/// </summary>
|
|
/// <returns>An <see cref="T:System.Collections.IEnumerator" /> object that can be used to iterate through the collection.</returns>
|
|
IEnumerator IEnumerable.GetEnumerator()
|
|
{
|
|
return ((ICentroidClusterCollection<T[], KModesCluster>)collection).GetEnumerator();
|
|
}
|
|
|
|
/// <summary>
|
|
/// Computes a numerical score measuring the association between
|
|
/// the given <paramref name="input" /> vector and a given
|
|
/// <paramref name="classIndex" />.
|
|
/// </summary>
|
|
/// <param name="input">The input vector.</param>
|
|
/// <param name="classIndex">The index of the class whose score will be computed.</param>
|
|
/// <returns>System.Double.</returns>
|
|
public override double Score(T[] input, int classIndex)
|
|
{
|
|
return collection.Score(input, classIndex);
|
|
}
|
|
}
|
|
}
|