This is the ICS 172 public directory.  Here's some helpful pointers to
get you started.  First, some preliminaries - you will be compiling,
exercising, and modifying programs in several subdirectories to learn
about different artificial neural network algorithms.  Some document
files to help you do this are located in the subdirectory "Help".  If
you have never used the bonnie machine or its mail facilities, you
will want to look at the file "Bonnie".  You can examine a file using
the command "more" as in:

 % more ~ics172ta/public/Help/Bonnie

The computing facility also publishes a small booklet titled
"Getting started with UNIX at UCI" (or something like that) which
you can purchase from them.  It is strongly urged that you purchase
this booklet if you are a novice Bonnie user.

The programs here are written in the C language.  If you do not
know the C language, you may want to find out about it using the
"learn" program.  Simply enter:

 % learn C

and you can take advantage of the on-line self-paced computer-aided
instruction facilities (don't forget to type "bye" to exit the
learn program!).

Assuming you understand how to use Bonnie and C, you can begin
exercising the neural network programs.  Much of the complicated
infrastructure has been extracted and placed in a library and include
files.  Consequently, you need only copy the relevant file to one
of your personal directories, compile, and run.  The file "Compile"
in the "Help" subdirectory contains information on how to do this.
This file also defines the alias "scc" to simplify C compiling -
you should add this to your .cshrc file.  If you do not know any
of the editors, you can also use the learn program to assist you
by entering the command "learn editor".

The first assignment deals with Hopfield networks.  The directory
~ics172ta/public/Hopfield contains a simple Hopfield program:
"Hopfield-sim.c". To get started, copy the relevant files to one of
your directories (the file "v1.mem" is a test data file you will start
with):

 % cp ~ics172ta/public/Hopfield/Hopfield-sim.c shop.c
				        ^-- your file name
 % cp ~ics172ta/public/Hopfield/v1.mem v1.mem

Compile the copied C source file using the "scc" alias to include the
appropriate files (the "-o shop" option places the generated executable 
file in a file called "shop"):

 % scc Hopfield-sim.c -o Hopfield-sim

Before running "Hopfield-sim" you should look at the file
~ics172ta/Help/Hopfield-Example for a listing of a typical program
run.  You may also find it helpful to have a copy of the example at
hand while you exercise "Hopfield-sim".  To run "Hopfield-sim" just 
enter its name:

 % Hopfield-sim

You will recieve the simulator prompt:

 SHoP>

where you can enter ONLY simulator commands.  You can enter "help"
to get information on available simulator commands.  You can exit
by typing:

 SHoP> quit

To explore the impact of a different set of memory patterns, you can
use the program "makervec" in the ~ics172ta/public/Hopfield directory
to generate random vectors.  You can find out how to use this program
by just running "makervec" without any arguments.  You can modify the
source file "makervec.c" (i.e., your copy of it) to create vectors
with different characteristics.

If you have any questions or problems, feel free to send mail to the
TA.  The TA mail address is "ics172ta".

Good Luck!
