------------------------------
COPYRIGHT AND LICENSE
------------------------------

The copyright and license information for this software are detailed in file license_Nikolaos_Gkalelis.txt.

This software re-uses certain pre-existing parts of code; additional licenses apply to these software parts.
For details on licence and copyrights concerning these software parts see files license_Michael_Chen.txt, PCA.m, sqdistance.m, logdet.m.


------------------------------
HOW TO USE THE SOFTWARE
------------------------------

The function "learn_kmsda.m" and "test_kmsda.m" are central for using the software.
The function "learn_kmsda.m" receives as input a set of parameters concerning the training set and learns the KMSDA parameters for this dataset (e.g., KMSDA projection matrix, kernel function parameters etc.).
This software provides a a fast implementation for kernel mixture subclass-based DA.
It iteratively calls the functions "selectClassToRePartitionPost.m", "incrementSubclassesOfClass.m" and "KMSDA.m" to identify the best KMSDA parameters.
The actual nongaussianity of each subclass partition is computed using the function "negEntropyIncrement.m".
New subclass partitions are computed using an extended k-means algorithm that creates balanced subclass partitions.
Finally, the function "test_kmsda.m" receives as input the training set, the learned KMSDA parameters and the test set, and exploits the nearest neighbour classifier for classifying the test observations.

A comprehensive description concerning the functionality of each matlab function is provided in the header of the respective m-file.

For more details on using this software please refer to "notebook_kmsda.m" script, where an example application of this software is provided utilizing the first MONK Data Set of UCI repository.


------------------------------
RELATED PUBLICATIONS
------------------------------

If you find this software useful in your work, please cite the following publication:

1. N. Gkalelis, V. Mezaris, I. Kompatsiaris, T. Stathaki, "Mixture
subclass discriminant analysis link to restricted Gaussian model and
other generalizations", IEEE Transactions on Neural Networks and Learning 
Systems, vol. 24, no. 1, pp. 8-21, January 2013.


------------------------------
COMMENTS/QUESTIONS
------------------------------

Please send any comments and questions to gkalelis@iti.gr
