1. Basic example with default values

To illustrate the general usage of the library, an example clustering 10 data vectors with all parameters in default values is presented below.

// Prepare your data as a 2D float array
// Each row represents a data vector
float[][] dataMatrix = {
        {0.1f, 0.2f, 0.3f},
        {0.2f, 0.1f, 0.4f},
        {0.9f, 0.8f, 0.7f},
        {0.8f, 0.9f, 0.6f},
        {0.15f, 0.25f, 0.35f},
        {0.85f, 0.75f, 0.65f},
        {0.05f, 0.15f, 0.25f},
        {0.95f, 0.85f, 0.75f},
        {0.12f, 0.22f, 0.32f},
        {0.88f, 0.78f, 0.68f}
};

// Configure clustering parameters
//Vigilance parameter in interval [0,1]
float vigilance = 0.5f;
//Maximum number of clusters in interval [2, number of data row vectors of getDataMatrix]
int maximumNumberOfClusters = 10;
//default value
int maximumNumberOfEpochs = 10;
//default value
float convergenceThreshold = 0.99f;
//default value
float learningParameter = 0.01f;
//default value
float offsetForContrastEnhancement = 1.0f;
//default value
long randomSeed = 1L;
//do not preprocess data because it is already in range [0,1]
boolean isDataPreprocessing = false;

// Validate data matrix (same length in all rows, no empty rows, etc.)
if (Utils.isDataMatrixValid(dataMatrix)) {
    // Create ART-2a kernel
    Art2aKernel art2aKernel = new Art2aKernel(
            dataMatrix,
            maximumNumberOfClusters,
            maximumNumberOfEpochs,
            convergenceThreshold,
            learningParameter,
            offsetForContrastEnhancement,
            randomSeed,
            isDataPreprocessing
    );

    // Perform clustering with set vigilance parameter and do the determination 
    //  of which cluster is closest to the new data point sequentially
    Art2aResult result = art2aKernel.getClusterResult(vigilance, false);

    // Access results
    int numberOfClusters = result.getNumberOfDetectedClusters();
    System.out.println("Number of epochs: " + result.getNumberOfEpochs());
    System.out.println("Is converged: " + result.isConverged());

    // Get cluster information
    for (int i = 0; i < numberOfClusters; i++) {
        System.out.println("Cluster " + i + ":");
        System.out.println("\tSize: " + result.getClusterSize(i));
        System.out.println("\tMembers: " + Arrays.toString(result.getDataVectorIndicesOfCluster(i)));
        System.out.println("\tRepresentative Index: " + result.getClusterRepresentativeIndex(i));
    }
}

Output:

Number of epochs: 2
Is converged: true
Cluster 0:
	Size: 1
	Members: [6]
	Representative Index: 6
Cluster 1:
	Size: 9
	Members: [0, 1, 2, 3, 4, 5, 7, 8, 9]
	Representative Index: 7