
              Netica API Install for Linux, version 2.15
              ------------------------------------------

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

libnetica.so -------------- The Netica library (binary file)
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 for those using Linux:
    This version of Netica API was built using gcc 2.96, and it also
	works for gcc 3.0.2. (it was built using Linux kernel 2.4.7-10,
    which corresponds to the Red Hat 7.2 distribution)
    If you have an older environment (e.g. Red Hat 6.1 or 5.2), 
	you need to use an earlier version, such as:
	NeticaAPI_Linux61_130.zip  or  NeticaAPI_Linux52_130.zip
	available from:
    ftp://ftp.norsys.com/dl/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 NeticaEx.c Demo.c

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

Next, ensure that libnetica.so is on your LD_LIBRARY_PATH.
You can add it with the following commands, depending on your variety of shell:
  csh/tcsh:  setenv LD_LIBRARY_PATH <path to libnetica.so>
  ksh/bash:  LD_LIBRARY_PATH=<path to libnetica.so>
             export LD_LIBRARY_PATH
  For example, with csh you might type:   setenv LD_LIBRARY_PATH .
assuming that libnetica.so is in your current working directory (".").

Now link them all 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.so, 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_ns (NULL,NULL,NULL);

to one that says:

    env = NewNeticaEnviron_ns ("xxx",NULL,NULL);

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 CD-ROM
was shipped to you, then the manual will be included with it.
Otherwise, you can download the manual as a postscript file from the Norsys 
web site.  It is okay if the manual has an earlier version number.

Be sure to try the online HTML function reference for Netica API, available 
from the Norsys website and on Netica API CD-ROMs.  We recommend that you
install a copy of this HTML reference on your local harddrive, as this will
give you the quickest browser response.


PROGRAMMING LANGUAGES
---------------------

Netica API is available for programming in Java, Visual Basic, C and C++.
For more information on Netica API for different languages, see the
Norsys web site.


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

Your purchase price includes all version 2.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:        support@norsys.com


Norsys Software Corp.
www.norsys.com



