=====================================================================
annie  Neural Network Library
Matlab Extensions Pack
http://annie.sourceforge.net/
Author(s):
Asim Shankar
Last Modified On:
January 12, 2003
=====================================================================
Installation:

You should have annie already installed in some directory, let's say
$ANNIE.
All files of this pack should be extracted to $ANNIE/matlab
=====================================================================
NOTE:

Unfortunately, I think I haven't documented this pack very well.
So if you need any help, feel free to contact me at
asimshankar@users.sourceforge.net
and I will try to get a speedy response back to you.
=====================================================================
Description:

This extension pack allows you to export training sets created in C++ programs
to matrices in Matlab. Then create and train your network in Matlab using
the Neural Network Toolbox. Finally, export your network to a format that
annie understands so that you can use the network you trained in Matlab in
any C++ application.
As of this release, this pack only allows twolayer feedforward networks
of Matlab to be exported.
In order to achieve this functionality, some command line utilities and
some Matlab code has been provided.
Here is a description of the things that form this pack:
* createNetwork.m (Matlab code)
Sample code to create a simple twolayer,
feedforward network in Matlab.
* toAnnie.m (Matlab code)
Code to show how to export the network specifications
(weights and biases) to a file so that they can be used
to create the corresponding network in annie using
matlab2annie (a command line utility)
* matlab2annie (Commandline utility)
Given the network specifications in text files created
using toAnnie.m, creates a network spefication file that
can be understood by annie using the
MultiLayerNetwork::MultiLayerNetwork(const char *filename)
constructor.
* trset2matlab (Commandline utility)
Converts an annie training set (training set file in binary format)
into two text files.
One specifies the input vectors
and the other specifies the desired output vectors.
Import these files into matrices in Matlab using loadTrset.m
and then use the loaded matrices to train a network.
* loadTrset.m (Matlab code)
Given the input vectors and desired output vectors created using
trset2matlab, imports them into matrices in Matlab.
Note that the code provided computes the transpose of the matrices
loaded because this is required in order to have Matlab train
the network.
=====================================================================
DIRECTORY STRUCTURE

$ANNIE/matlab/  Contains this README and the Makefile.
 Use the Makefile to compile the commandline utilities in Linux.
 Also contains the Visual Studio.NET solution file which can be
 used to build the binaries for Windows.

> MatlabCode/  Contains text files with code to be used in Matlab for
 loading training sets and exporting networks.

> src/  C++ sources for the commandline utilities

> vcproj/  The Visual Studio.NET project files
NOTE: The binaries are compiled and place in $ANNIE/bin with the other
binaries of the annie package.