% SOM Toolbox
% Version 2.0beta, 15-Nov-99
%
% SOM Toolbox version 2.0beta, Copyright (C) 1997-1999 by Esa Alhoniemi,
% Johan Himberg, Juha Parhankangas and Juha Vesanto.
%
% SOM Toolbox comes with ABSOLUTELY NO WARRANTY; for details
% see License.txt in the program package. This is free software, 
% and you are welcome to redistribute it under certain conditions; 
% see License.txt for details.
%
% Structs
%
%   map struct           - self-organizing map (sM, sMap)
%   data struct          - data set (sD, sData)
%   topology struct      - map topology (sT, sTopol)
%   training struct      - info on a training run (sTrain)
%   normalization struct - info on normalization operation (sN, sNorm)
%   grid struct          - a visualization struct (sG, sGrid)
%
% Functions
%  
%   som_set              - create & set (& check) values to structs
%   som_info             - print out information on a given struct
%   som_map_struct       - create & initialize a map struct 
%   som_data_struct      - create & initialize a data struct 
%   som_topol_struct     - create & initialize a topology struct 
%   som_train_struct     - create & initialize a train struct 
%   som_grid             - create & initialize a grid struct 
%
% Initialization and training
%
%   som_make             - create, initialize and train a self-organizing map
%   som_randinit         - random initialization algorithm
%   som_lininit          - linear initialization algorithm
%   som_seqtrain         - sequential training algorithm
%   som_batchtrain       - batch training algorithm
%   som_sompaktrain      - (see below)
%
% SOM_PAK & version 1.0 compatibility
%
%   som_read_cod         - reads a SOM_PAK format codebook file
%   som_read_data        - reads a SOM_PAK format data file
%   som_write_cod        - writes a SOM_PAK format codebook file
%   som_write_data       - writes a SOM_PAK format data file
%   som_sompaktrain      - uses SOM_PAK to train a map
%   som_vs1to2           - converts a version 1.0 struct to version 2.0 struct
%   som_vs2to1           - converts a version 2.0 struct to version 1.0 struct
% 
% Normalization 
%
%   som_normalize        - normalizes given data 
%   som_denormalize      - denormalizes given data
%   som_norm_variable    - (de)normalization for one variable 
%
% Tools 
%
%   som_bmus             - calculates BMUs for given data vectors
%   som_hits             - calculates the number of hits in each map unit
%   som_unit_coords      - calculates coordinates in output space for map units
%   som_unit_dists       - distances in output space between map units
%   som_unit_neighs      - units in 1-neighborhood for each map unit
%   som_neighborhood     - calculates neighborhood matrix for the given map
%   som_label            - give labels to map units
%   som_autolabel        - automatically labels the SOM based on given data
%   som_quality          - quality measures for the map
%   som_umat             - calculates the U-matrix
%   som_connection       - connection matrix for map 
%
% Visualization
%
%   som_show             - basic visualization
%   som_show_add         - add labels, hits and trajectories
%   som_show_clear       - remove extra markers
%   som_recolorbar       - refresh/reconfigure colorbars
%   som_grid             - visualization of SOM grid
%   som_cplane           - component planes and U-matrices
%   som_barplane         - bar chart visualization of map
%   som_pieplane         - pie chart visualization of map
%   som_plotplane        - plot chart visualization of map
%
%   low-level routines used by visualization functions
%   som_vis_coords
%   vis_PlaneAxisProperties
%   vis_footnote
%   vis_footnoteButtonDownFcn
%   vis_grid_struct
%   vis_patch
%   vis_som_show_data
%
% Contributed function
%  
%   som_normcolor        - simulates indexed colors, used with som_grid
%   som_gui              - starts the graphical user interface tool
%   preprocess           - data preprocessing tool
%   sammon               - calculates Sammon's projection 
%   cca                  - calculates CCA projection
%   pca                  - calculates PCA projection 
%   nanstats             - statistics of given data set, NaNs and Infs excluded
%   som_sub2ind          - converts map grid subscripts to linear index 
%   som_ind2sub          - converts linear index to map grid subscripts
%





