			Net Tools
			---------

		by Simon Dennis and Steven Phillips

The following package contains three tools for network analysis:

	gea - Group Error Analysis
	pca - Principal Components Analysis
	cda - Canonical Discriminants Analysis

TOOL DESCRIPTIONS

Group Error Analysis (gea)

Gea counts errors. It takes an output file and a target file and
optionally a groups file. Each line in the output file is an output
vector and the lines in the targets file are the corresponding correct
values. If all values in the output file are within criterion of the
those in the target file then the pattern is considered correct. Note
that this is a more stringent measure of correctness than the total
sum of squares. In particular it requires the outputs to be either high
or low rather than taking some average intermediate value. If a groups 
file is provided then gea will separate the error count into the groups
provided. 

Principal Components Analysis (pca)

Principle components analysis takes a set of points in a high dimensional space 
and determines the major components of variation. The principal components are
labeled 0-(n-1) where n is the dimensionality of the space (i.e. the
number of hidden units). The original points can be projected onto these
vectors. The result is a low dimensional plot which has hopefully extracted
the important information from the high dimensional space. 

Canonical Discriminants Analysis (cda)

Canonical discriminant analysis takes a set of grouped points in a high
dimensional space and determines the components such that points within
a group form tight clusters. These points are called the canonical
variates and are labeled 0-(n-1) where n is the dimensionality of the
space (i.e. the number of hidden units). The original points can be
projected on to these vectors. The result is a low dimensional plot
which has clustered the points belonging to each group.

TECHNICAL REPORT

Reference: Simon Dennis and Steven Phillips.
	   Analysis Tools for Neural Networks.
	   Technical Report 207,
	   Department of Computer,
	   University of Queensland,
	   Queensland, 4072
	   Australia
	   May, 1991

NetTools.ps is a technical report which demonstrates the results which
can be obtained from pca and cda. It outlines the advantages of each 
and points out some interpretive pitfalls which should be avoided.

COMPILATION

To compile the tools, cd to the bin directory and type "make". All of the
tools are self contained. 

MANUAL ENTRIES

man/man1 contains the manual entries for the tools. 

TUTORIAL

The directory tute contains a tutorial designed at the University of 
Queensland by Janet Wiles and Simon Dennis to introduce students
to network analysis. It uses the iris data first published
by Fisher in 1936. The backpropagation simulator is tlearn developed at
UCSD by Jeffery Elman and colleagues. In addition the tutorial uses the
hierarchical clustering program, cluster, which was written by Yoshiro Miyata
and modified by Andreas Stolcke.

Shalom
       Simon 

PS Please mail all bug reports and comments to mav@cs.uq.oz.au

