
                README For UNIX Installation
                ----------------------------

After unpacking, you should have a directory called Netica with
the following files in it:

libnetica.a --------------- The Netica library (archive of object files)
Netica.h ------------------ Header file for Netica API
NeticaEx.c ---------------- Extra C source code for Netica API
NeticaEx.h ---------------- Header file for NeticaEx.c
Demo.c -------------------- Source code to get Netica API working
LicAgree.txt -------------- License agreement
README -------------------- This file

If you haven't read the license agreement yet, read it now, and if you
don't agree to it, delete the Netica directory.

For those using a Sun Microsystems computer:
    The current version of Netica API is for SunOS 5.x (Solaris).
    If you are working under SunOS 4.x, then you must download
    NeticaAPI_Sun-101.tar.gz from the pub/norsys/old_versions
    directory of our ftp site:  ftp.norsys.com

To check your installation, it is best to first get the program Demo.c
working.  First compile Demo.c and NeticaEx.c:

    gcc -c Demo.c
    gcc -c NeticaEx.c

These commands will put the resulting object code in Demo.o and NeticaEx.o.

Then link them together with Netica and the Standard C math library:

    gcc -o netdemo Demo.o NeticaEx.o -L. -lnetica -lm

The -L. means look for libraries in the current directory (as well as the 
system library directory), the -lnetica means link in libnetica.a, and the 
-lm means link in libm.a (the math library).

This creates an executable called 'netdemo', which you can run by 
typing 'netdemo'.  If it prints out a welcome message, and prints out 
the probability of tuberculosis as 0.0104, 0.0924109, 0.337716, and 0.05
under various conditions, and doesn't print any error messages, your
installation is good.

If you have a license password, the next step is to make sure it works.
In Demo.c, change the line that says:

    env = NewNeticaEnviron_bn (NULL);

to one that says:

    env = NewNeticaEnviron_bn ("xxx");

where xxx is the license password that has been emailed to you, or appears 
on your invoice.  Then recompile, relink and run it again.
If you get the same message as before (except without the "Netica operating 
without a password ..." line), then your password is working properly.

Now you can replace the Demo.c file with your own source files that
use Netica, and generate your own executables.  

If you wish to obtain a password, download the manual for Netica API,
download some already constructed networks, or find more information,
see our web site:   www.norsys.com

If you have any problems send a message to norsys_info@norsys.com.

