===================================================================== 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 two-layer feed-forward 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 two-layer, feed-forward 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 (Command-line 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 (Command-line 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 command-line 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 command-line 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.