
            Netica API Install for older Linux, version 1.30
            ------------------------------------------------

After unzipping, 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.txt ---------------- This file

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

WARNING:
    This version of Netica API was built using Linux kernel 2.0.36,
    gcc version 2.7.2.3, g++ 2.8.1, egcs-2.90.29 980515 (egcs-1.0.3 release),
    which corresponds to the Red Hat 5.2 distribution.
    If you have an older environment, it may work, or you may need to
    use NeticaAPI_Linux-106.zip, available from 
    ftp://ftp.norsys.com/pub/norsys/old_versions


DEMO PROJECT
------------

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:

    g++ -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).  In some environments, you
may be able to type "gcc" instead of "g++", but in others you will get link
errors for the missing exception handling routines.

This creates an executable called 'netdemo', which you can run by 
typing "./netdemo" without the quotes (which means run netdemo from
the current directory).  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.


LICENSE PASSWORD
----------------

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.  


MANUAL
------

To use the Netica API, you will need the reference manual.  If the floppy
disks were shipped to you, then the manual will be included with them.
Otherwise, you can download the manual as a postscript file or a rich text
format file from the Norsys web site.  It is okay if the manual has an 
earlier version number.
 
Along with this file, you may have received a file called "API New Funcs".
If so, it documents new functions available to you that are not yet in
the regular manual.


FUTURE VERSIONS
---------------

Your purchase price includes all version 1.xx releases of Netica, so your 
license password will work on all of them.  They may be downloaded from 
the Norsys web site.


SPECIAL BUILDS
--------------

Versions of the Netica API library built with different options,
or for different compilers or operating systems, may be purchased from 
Norsys.  Contact Norsys with your request.


PROBLEMS
--------

If you have problems, contact Norsys at:    norsys_info@norsys.com


Norsys Software Corp.
www.norsys.com


