###############################################################################
########################         Overview          ############################
###############################################################################
#                                                                             #
# This file describes the contents and usage of project written for course    #
# CIS9603 Artificial Inteligence.                                             #
# Project covers Chapter 9 of textbook, Unsupervised Learning: k-Means,       #
# Vector Quantization, Self-Organizing Maps.                                  #
#                                                                             #
###############################################################################
#######################         Contents          #############################
###############################################################################
#                                                                             #
# Dataset files:                                                              #
#    ecoli_desc.txt      % Description of E. coli dataset.                    #
#    ecoli.txt           % E. coli dataset.                                   #
#    iris_desc.txt       % Description of Iris dataset.                       #
#    iris.txt            % Iris dataset.                                      #
#                                                                             #
# Main .m files:                                                              #
#    k_means_iris.m      % Run k-means on Iris dataset, and plot the results. #
#    som_9_12.m          % Run SOM on random 2-D data, and plot the results.  #
#    som_9_13.m          % Run SOM on Iris dataset, and plot the results.     #
#    som_9_14.m          % Run SOM on E. coli dataset, and plot the results.  #
#                                                                             #
# Ancillary files:                                                            #
#    create_ecoli_data.m % Preprocess E. coli dataset, create matrix form.    #
#    divideset.m         % Divide dataset into training and testing sets.     #
#    normalize.m         % Normalize the data.                                #
#    plot_iris.m         % Plot Iris dataset (used only in k_means_iris.m).   #
#    petal-sepal.jpg     % Image explaining features in Iris dataset.	      #
#                                                                             #
###############################################################################
#######################         Examples          #############################
###############################################################################
#                                                                             #
# Examples of usage (type the following statements in Matlab command prompt): #
#    k_means_iris(3);    % Find 3 clusters in Iris data.                      #
#    som_9_12(25);       % Train SOM for 25 epochs on random data.            #
#    som_9_13(25);       % Train SOM for 25 epochs on Iris data.              #
#    som_9_14(25);       % Train SOM for 25 epochs on E. coli data.           #
#                                                                             #
###############################################################################
#######################          Credits          #############################
###############################################################################
#                                                                             #
# Date created: September 25th, 2010                                          #
# Author      :                                                               #
#        ____  _____                                         _                #
#       |_   \|_   _|                                       (_)               #
#         |   \ | |  .---.  _ .--..--.   ,--.   _ .--.      __  ,--.          #
#         | |\ \| | / /__\\[ `.-. .-. | `'_\ : [ `.-. |    [  |`'_\ :         #
#        _| |_\   |_| \__., | | | | | | // | |, | | | |  _  | |// | |,        #
#       |_____|\____|'.__.'[___||__||__]\'-;__/[___||__][ \_| |\'-;__/        #
#                                                        \____/               #
#                ______       _                    _                          #
#               |_   _ `.    (_)                  (_)                         #
#                 | | `. \   __  __   _   _ .--.  __   .---.                  #
#                 | |  | |  [  |[  | | | [ `/'`\][  | / /'`\]                 #
#                _| |_.' /_  | | | \_/ |, | |     | | | \__.                  #
#               |______.'[ \_| | '.__.'_/[___]   [___]'.___.'                 #
#                         \____/                                              #
#                                                                             #
###############################################################################
#######################        End of file        #############################
###############################################################################